mirror of
https://github.com/simonmichael/hledger.git
synced 2024-09-20 10:47:29 +03:00
docs: manual tweaks
This commit is contained in:
parent
1d4e249ada
commit
49e799d9cc
@ -1021,9 +1021,9 @@ entries, and the following c++ ledger options and commands:
|
|||||||
prices for amounts which have them. (This currently means that
|
prices for amounts which have them. (This currently means that
|
||||||
it does not print multi-commodity transactions in valid journal format.)
|
it does not print multi-commodity transactions in valid journal format.)
|
||||||
|
|
||||||
### Troubleshooting
|
## Troubleshooting
|
||||||
|
|
||||||
#### Installation issues
|
### Installation issues
|
||||||
|
|
||||||
cabal builds a lot of fast-evolving software, and it's not always smooth
|
cabal builds a lot of fast-evolving software, and it's not always smooth
|
||||||
sailing. Here are some known issues and things to try:
|
sailing. Here are some known issues and things to try:
|
||||||
@ -1088,20 +1088,9 @@ sailing. Here are some known issues and things to try:
|
|||||||
$ cabal install yesod --reinstall --constraint 'parsec == 3.1.0"
|
$ cabal install yesod --reinstall --constraint 'parsec == 3.1.0"
|
||||||
|
|
||||||
- **Another error while building a hledger package.**
|
- **Another error while building a hledger package.**
|
||||||
The current hledger release might have a coding error, or dependency
|
The current hledger release might have an error in its code or package
|
||||||
error. You could try installing the
|
dependencies. You could try [installing](#installing) the latest
|
||||||
[previous version](http://hackage.haskell.org/package/hledger):
|
development version.
|
||||||
|
|
||||||
$ cabal install hledger-0.x
|
|
||||||
|
|
||||||
or (preferably) the latest development version: install
|
|
||||||
[darcs](http://darcs.net) and then:
|
|
||||||
|
|
||||||
$ darcs get --lazy http://joyful.com/repos/hledger
|
|
||||||
$ cd hledger/hledger-lib
|
|
||||||
$ cabal install
|
|
||||||
$ cd ..
|
|
||||||
$ cabal install [-f...]
|
|
||||||
|
|
||||||
- **Do you have a new enough version of cabal-install ?**
|
- **Do you have a new enough version of cabal-install ?**
|
||||||
Recent versions tend to be better at resolving dependencies. The error
|
Recent versions tend to be better at resolving dependencies. The error
|
||||||
@ -1122,13 +1111,14 @@ sailing. Here are some known issues and things to try:
|
|||||||
versions by removing (or renaming) ~/.ghc, then trying cabal install
|
versions by removing (or renaming) ~/.ghc, then trying cabal install
|
||||||
again.
|
again.
|
||||||
|
|
||||||
#### Usage issues
|
### Usage issues
|
||||||
|
|
||||||
Here are some issues you might encounter when you run hledger:
|
Here are some issues you might encounter when you run hledger:
|
||||||
|
|
||||||
- <a name="locale" />**hledger: ... hGetContents: invalid argument (Illegal byte sequence)**
|
- <a name="locale" />**hledger: ... hGetContents: invalid argument (Illegal byte sequence)**
|
||||||
You may get this error when running hledger built with GHC 6.12 on a
|
You may get this error when running hledger with a journal containing
|
||||||
machine using the default C locale, eg a mac:
|
non-ascii text, on a machine using the default C locale. You can check
|
||||||
|
this like so:
|
||||||
|
|
||||||
$ locale
|
$ locale
|
||||||
LANG=
|
LANG=
|
||||||
@ -1139,14 +1129,11 @@ Here are some issues you might encounter when you run hledger:
|
|||||||
LC_NUMERIC="C"
|
LC_NUMERIC="C"
|
||||||
LC_TIME="C"
|
LC_TIME="C"
|
||||||
LC_ALL=
|
LC_ALL=
|
||||||
|
|
||||||
if there is non-ascii text in your journal file:
|
|
||||||
|
|
||||||
$ file my.journal
|
$ file my.journal
|
||||||
.../.journal: UTF-8 Unicode C++ program text
|
.../.journal: UTF-8 Unicode C++ program text
|
||||||
|
|
||||||
In this case you need to set the `LANG` environment variable to a
|
In this case you need to set the `LANG` environment variable to a
|
||||||
locale suitable for the encoding shown (probably UTF-8). You
|
locale suitable for the encoding shown (eg UTF-8). You
|
||||||
can set it temporarily when you run hledger:
|
can set it temporarily when you run hledger:
|
||||||
|
|
||||||
$ LANG=en_US.UTF-8 hledger ...
|
$ LANG=en_US.UTF-8 hledger ...
|
||||||
|
Loading…
Reference in New Issue
Block a user