From e23f61b771dd6a62bb4ce02a9279c4f2ff7a0fec Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Thu, 21 May 2015 07:24:20 -0700 Subject: [PATCH] doc: manual: de-emphasize troubleshooting subtopics --- doc/manual.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/manual.md b/doc/manual.md index 1419905c7..477c23b6e 100644 --- a/doc/manual.md +++ b/doc/manual.md @@ -1720,12 +1720,12 @@ Here are some issues you might encounter when you run hledger [mail list](http://list.hledger.org) or [bug tracker](http://bugs.hledger.org)): -##### Successfully installed, but "No command 'hledger' found" +**Successfully installed, but "No command 'hledger' found"** cabal installs binaries into a special directory, which should be added to your PATH environment variable. On unix-like systems, it is ~/.cabal/bin. -##### "Illegal byte sequence" or "Invalid or incomplete multibyte or wide character" errors +**"Illegal byte sequence" or "Invalid or incomplete multibyte or wide character" errors** In order to handle non-ascii letters and symbols (like £), hledger needs an appropriate locale. This is usually configured system-wide; you can also configure it temporarily. The locale may need to be one that @@ -1769,33 +1769,33 @@ accepts `fr_FR.UTF8`, mac osx requires exactly `fr_FR.UTF-8`). Here are some things to be aware of. -##### Add-on-specific options must follow -- +**Add-on-specific options must follow --** When invoking an add-on via hledger, add-on flags which are not also understood by the main hledger executable must have a `--` argument preceding them. Eg hledger-web's `--server` flag must be used like so: `hledger web -- --server`. -##### -w/--width and --debug options must be written without whitespace +**-w/--width and --debug options must be written without whitespace** Up to hledger 0.23, these optional-value flags [did not work](https://github.com/simonmichael/hledger/issues/149) with whitespace between the flag and value. IE these worked: `--debug`, `-w`, `--debug=2`, `-w100`, but these did not: `--debug 2`, `-w 100`. From 0.24, a value is required and the whitespace does not matter. -##### Not all of Ledger's journal file syntax is supported +**Not all of Ledger's journal file syntax is supported** See [file format differences](faq#file-format-differences). -##### balance is less speedy than Ledger's on large data files +**balance is less speedy than Ledger's on large data files** hledger's balance command (in particular) takes more time, and uses more memory, than Ledger's. This becomes more noticeable with large data files. -##### Windows CMD.EXE +**Windows CMD.EXE** Non-ascii characters and colours are not supported. -##### Windows cygwin/msys/mintty +**Windows cygwin/msys/mintty** The tab key is not supported in hledger add.