On Thu, Oct 4, 2012 at 2:33 PM, Craig Earls <[email protected]> wrote:

> for the reference section do you prefer tabular format with shorts
> descriptions, or long form prose with longer explanations for each command,
> or both?


I would prefer a tabular format for options and longer-form prose sections
for subcommands. For example (using Markdown syntax):

## Global options

`-f, --file` *FILE*
:  Load ledger data from FILE. This overrides the settings in ~/.ledgerrc
and the LEDGER_FILE environment variable.

## Commands

### bal

Run a balance report. <insert long description of balance report here,
including short self-contained examples>

<insert balance report specific options here>

Reply via email to