]> git.armaanb.net Git - lightcards.git/blobdiff - man/lightcards.1.md
Change flip cards option to a view
[lightcards.git] / man / lightcards.1.md
index 0cc98b280e80be8987a82355a83e0370f16a1217..2cdd2b284b1ec93152475f684b68845cff532195 100644 (file)
@@ -1,46 +1,42 @@
-% lightcards(1) 0.5.0
-% Armaan Bhojwani
-% February 2021
+---
+title: lightcards
+section: 1
+header: General Commands Manual
+footer: VERSION_HERE
+date: February 2021
+---
 
 # NAME
 lightcards - terminal flashcards from Markdown
 
 # SYNOPSIS
-lightcards [[options]] [input file]
+lightcards \[options\] \[input file\]
 
 # DESCRIPTION
-**lightcards** is a Python program that reads data from a two column Markdown (and by extension, HTML) table, and displays flashcards from their contents.
-
-# POSITIONAL ARGUMENTS
-**input file**
-: Relative or absolute path to the input Markdown or HTML file
+**lightcards** is a Python program that reads data from a two column Markdown (and by extension, HTML) table in the **input file**, and displays flashcards from their contents.
 
 # OPTIONS
+## Generic Program Information
 **-h**, **--help**
 : Show a help message and exit
 
+**-v**, **--version**
+: Print version and exit
+
+## Stack sorting
 **-a**, **--alphabetize**
 : Alphabetize card order
 
-**-f**, **--flip**
-: Show second column first
-
 **-p**, **--purge**
 : Purge cache for chosen set
 
-**-P**, **--purge-all**
-: Purge all caches
-
 **-r**, **--reverse**
 : Reverse card order
 
 **-s**, **--shuffle**
 : Shuffle card order
 
-**-v**, **--version**
-: Print version and exit
-
-# KEYBINDINGS
+# KEYS
 **l**, **right**
 : Next card
 
@@ -68,18 +64,24 @@ lightcards [[options]] [input file]
 **m**
 : Open control menu
 
-# EXIT VALUES
+**1**, **2**
+: Switch views
+
+# INPUT FILE
+Lightcards takes the first table from a valid Markdown or HTML file. Each row is a card, and the two columns are the front and back.
+
+# EXIT STATUS
 **0**
 : Success
 
 **1**
-: Cannot find input file
+: Parse error
 
 **2**
 : Invalid option
 
-# BUGS, PATCHES
+# BUGS
 https://lists.sr.ht/~armaan/public-inbox
 
 # COPYRIGHT
-Copyright 2021 Armaan Bhojwani <me@armaanb.net>. MIT License
+Copyright 2021 Armaan Bhojwani <me@armaanb.net>, MIT License.