diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md index 5ce28d787..7d97fe9e4 100644 --- a/hledger/hledger.m4.md +++ b/hledger/hledger.m4.md @@ -113,13 +113,10 @@ So, trying to read non-ascii files which have the wrong text encoding, or when no system locale is configured, will fail. To fix this, configure your system locale appropriately, and/or convert the files to your system's text encoding (using `iconv` on unix, or powershell or notepad on Windows). +See [Install: Text encoding](/install.md#text-encoding) for more tips. hledger's output will use the system locale's encoding. -You may be able to override the system encoding for input or output temporarily, but it's platform-specific and can be tricky. - -See for more tips. - hledger's docs and example files mostly use UTF-8 encoding. ## Data formats @@ -802,9 +799,9 @@ If these don't work well, you can set your preferred options in the `HLEDGER_LES HTML output can be styled by an optional `hledger.css` file in the same directory. -HTML output will be UTF-8 encoded. If your web browser is showing junk characters, -you may need to change its text encoding to UTF-8. -Eg in Safari, see View -> Text Encoding and Settings -> Advanced -> Default Encoding. +HTML output will be a HTML fragment, not a complete HTML document. +Like other hledger output, for non-ascii characters it will use the system locale's text encoding +(see [Text encoding](#text-encoding)). ### CSV / TSV output @@ -7010,8 +7007,7 @@ Some known issues and limitations: The need to precede add-on command options with `--` when invoked from hledger is awkward. (See Command options, Constructing command lines.) -A system locale with a text encoding must be configured to work with non-ascii data. -hledger should try UTF-8 if no encoding is configured. +A system locale with a suitable text encoding must be configured to work with non-ascii data. (See Text encoding, Troubleshooting.) On Microsoft Windows, depending whether you are running in a CMD window or a Cygwin/MSYS/Mintty window @@ -7045,10 +7041,8 @@ and/or open a new terminal window. A simple way is to close your terminal window and open a new one. **Text decoding issues: I get errors like "Illegal byte sequence" or "Invalid or incomplete multibyte or wide character" or "commitAndReleaseBuffer: invalid argument (invalid character)"**\ -Programs compiled with GHC (hledger, GHC itself, all haskell build tools..) -need the system to be configured with a suitable locale for decoding non-ascii text, -or they will fail when they encounter such text. -See [Text encoding](#text-encoding) and . +hledger usually needs non-ascii input to be decodable with the system locale's text encoding. +See [Text encoding](#text-encoding) and [Install: Text encoding](/install.md#text-encoding). **COMPATIBILITY ISSUES: hledger gives an error with my Ledger file**\ Not all of Ledger's journal file syntax or feature set is supported.