diff --git a/MANUAL.md b/MANUAL.md index 8f7833851..44fbbb0e2 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -57,9 +57,11 @@ Some add-on packages are available on Hackage: [hledger-interest](http://hackage.haskell.org/package/hledger-interest). These are without an active maintainer, and/or platform-specific, so installing them may be harder. -Note to use non-ascii characters in journal files, you must have a [suitable locale configured](#locale). +Note: to use non-ascii characters like £, you might need to [configure a suitable locale](#locale). -Trouble with any of the above ? Please proceed to [Troubleshooting](#troubleshooting). + +Trouble with any of the above ? Proceed to [Troubleshooting](#troubleshooting). + ## Usage @@ -1365,7 +1367,7 @@ or get help. - **can't load .so/.DLL for: ncursesw (/usr/lib/libncursesw.so: file too short)** (or similar): cf [GHC bug #5551](http://hackage.haskell.org/trac/ghc/ticket/5551). - Upgrade your GHC to 7.2.1, or try your luck with [this workaround](http://eclipsefp.github.com/faq.html). + Upgrade GHC to 7.2.1, or try your luck with [this workaround](http://eclipsefp.github.com/faq.html). - **ExitFailure 11** See @@ -1413,10 +1415,11 @@ Here are some issues you might encounter when you run hledger: See [file format compatibility](#file-format-compatibility). - **hledger gives "Illegal byte sequence" or "Invalid or incomplete multibyte or wide character" errors** - hledger, like all GHC executables, requires an appropriate system locale - in order to handle non-ascii data. Eg, it's common for journal files to - contain UTF8-encoded text, and in this case you would need to have a - UTF8-aware locale configured. + 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 + supports UTF-8, if you built hledger with GHC < 7.2 (or possibly always, + I'm not sure yet). Here's an example of setting the locale temporarily, on ubuntu gnu/linux: @@ -1428,12 +1431,12 @@ Here are some issues you might encounter when you run hledger: POSIX $ LANG=en_US.utf8 hledger -f my.journal print # <- use it for this command - Here's one way to set it permanently, there may be better ways: + Here's one way to set it permanently, there are probably better ways: $ echo "export LANG=en_US.UTF-8" >>~/.bash_profile $ bash --login - If we preferred to use eg `fr_FR.utf8` here, we'd have to install it first: + If we preferred to use eg `fr_FR.utf8`, we might have to install that first: $ apt-get install language-pack-fr $ locale -a @@ -1447,8 +1450,8 @@ Here are some issues you might encounter when you run hledger: POSIX $ LANG=fr_FR.utf8 hledger -f my.journal print - Note some platforms allow variant locale spellings, but not all - (ubuntu accepts `fr_FR.UTF8`, mac osx requires exactly `fr_FR.UTF-8`). + Note some platforms allow variant locale spellings, but not all (ubuntu + accepts `fr_FR.UTF8`, mac osx requires exactly `fr_FR.UTF-8`). ### Examples and recipes