slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: some manual updates

Browse Source
This commit is contained in:
Simon Michael 2011-08-25 22:58:05 +00:00
parent e24d4e7514
commit 70961880d5
1 changed files with 24 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
MANUAL.md
View File

@ -4,7 +4,7 @@ title: hledger user manual
# User manual # User manual
## About ## Introduction
hledger is a program for tracking money, time, or any other commodity, hledger is a program for tracking money, time, or any other commodity,
using a simple, editable file format and the powerful principles of using a simple, editable file format and the powerful principles of
@ -31,7 +31,7 @@ hledger is copyright (c) 2007-2011
[Simon&nbsp;Michael&nbsp;<simon@joyful.com>](mailto:simon@joyful.com) and [Simon&nbsp;Michael&nbsp;<simon@joyful.com>](mailto:simon@joyful.com) and
contributors, and released as Free Software under GPL version 3 or later. contributors, and released as Free Software under GPL version 3 or later.
This is the manual for hledger 0.14.0. This is the user manual and reference for hledger version 0.14.0.
<a name="faq" /> <a name="faq" />
@ -82,8 +82,9 @@ version 0.13; to be fixed)*. You can download and run current release
binaries from the [download page](DOWNLOAD.html). binaries from the [download page](DOWNLOAD.html).
Or, you can build the current release from source using cabal-install. Or, you can build the current release from source using cabal-install.
Ensure you have a working Ensure you have [GHC](http://hackage.haskell.org/ghc/) (6.12 or greater)
[haskell environment](http://hackage.haskell.org/platform/), then: or the [Haskell Platform](http://hackage.haskell.org/platform/) installed,
then:
$ cabal update $ cabal update
$ cabal install hledger $ cabal install hledger
@ -94,8 +95,9 @@ extra features:
$ cabal install hledger-web $ cabal install hledger-web
$ cabal install hledger-vty $ cabal install hledger-vty
$ cabal install hledger-chart $ cabal install hledger-chart
$ cabal install hledger-interest
Or, you can build the latest [development version](http://joyful.com/darcsweb/darcsweb.cgi?r=hledger): Or, you can build the latest [development version](http://joyful.com/darcsweb/darcsweb.cgi?r=hledger) of (most of) these:
$ cabal update $ cabal update
$ darcs get --lazy http://joyful.com/repos/hledger $ darcs get --lazy http://joyful.com/repos/hledger
@ -104,17 +106,15 @@ Or, you can build the latest [development version](http://joyful.com/darcsweb/da
**Installation notes:** **Installation notes:**
- When installing with cabal you may encounter dependency issues. These
can often be worked around by making sure to cabal update, using
--constraint, and/or ghc-pkg unregister-ing obsolete package versions.
- Whatever installation method you use, you may need to - Whatever installation method you use, you may need to
[set a suitable locale](#usage-issues) if you're working with non-ascii [set a suitable locale](#usage-issues) if you're working with non-ascii
journal data. journal data.
- When installing with cabal you may encounter dependency issues. These - hledger-chart requires additional GTK-related libraries, see [Gtk2Hs installation notes](http://code.haskell.org/gtk2hs/INSTALL). On ubuntu, install the `libghc6-gtk-dev` package.
can often be worked around by: making sure to cabal update; using - hledger-vty requires curses-related libraries (ubuntu package: `libncurses5-dev`). Not buildable on microsoft windows, except possibly via cygwin.
--constraint; and/or ghc-pkg unregister-ing obsolete package versions. - If you have trouble, please see [Troubleshooting](#troubleshooting) and
- hledger-chart: requires additional GTK-related libraries, see [Gtk2Hs installation notes](http://code.haskell.org/gtk2hs/INSTALL). On ubuntu, install the `libghc6-gtk-dev` package.
- hledger-vty: requires curses-related libraries (ubuntu package: `libncurses5-dev`). Not buildable on microsoft windows, except possibly via cygwin.
- hledger-web: building requires GHC 6.12 or greater.
If you have trouble, please see [Troubleshooting](#troubleshooting) and
ask for [Support](DEVELOPMENT.html#support). ask for [Support](DEVELOPMENT.html#support).
## Basic usage ## Basic usage
@ -789,19 +789,19 @@ balances not matching the sign of the first one will be ignored.
chart-specific options: chart-specific options:
#### --output -o/--chart-output=IMGFILE output filename (default: hledger.png)
You can specify a different output file name with -o/--output. The data You can specify a different output file name with -o/--output. The data
currently will always be in PNG format. currently will always be in PNG format.
#### --size --chart-items=N number of accounts to show (default: 10)
You can adjust the image resolution with --size=WIDTHxHEIGHT (in pixels).
#### --items
Set the number of accounts to show with --items=N (default is 10). Set the number of accounts to show with --items=N (default is 10).
--chart-size=WIDTHxHEIGHT image size (default: 600x400)
You can adjust the image resolution with --size=WIDTHxHEIGHT (in pixels).
To show only accounts above a certain depth, use the --depth option; To show only accounts above a certain depth, use the --depth option;
otherwise the chart can include accounts of any depth. When a parent and otherwise the chart can include accounts of any depth. When a parent and
child account both appear in a chart, the parent's balance will be child account both appear in a chart, the parent's balance will be
@ -823,8 +823,6 @@ your numbers quickly with less typing.
vty-specific options: vty-specific options:
#### --debug-vty
--debug-vty run with no terminal output, showing console --debug-vty run with no terminal output, showing console
Examples: Examples:
@ -843,14 +841,10 @@ here: [current release demo](http://demo.hledger.org),
There are some web-specific options: There are some web-specific options:
#### --port
--port=N serve on tcp port N (default 5000) --port=N serve on tcp port N (default 5000)
The server listens on port 5000 by default; use --port to change that. The server listens on port 5000 by default; use --port to change that.
#### --base-url
--base-url=URL use this base url (default http://localhost:PORT) --base-url=URL use this base url (default http://localhost:PORT)
If you want to visit the web UI from other machines, you'll need to use If you want to visit the web UI from other machines, you'll need to use
@ -1422,10 +1416,10 @@ Here are some issues you might encounter when you run hledger:
hledger and other executables produced by GHC will give this error if hledger and other executables produced by GHC will give this error if
asked to read a non-ascii file when a proper system locale is not asked to read a non-ascii file when a proper system locale is not
configured. Eg, it's common for journal files to be UTF-8-encoded, in configured. Eg, it's common for journal files to be UTF-8-encoded, in
which case the system must have a (installed) UTF-8-aware locale which case the system must have a UTF-8-aware locale installed and
configured. You can also configure it temporarily by setting the LANG selected. You can also select such a locale temporarily by setting
environment variable on the command line. Here's an example, using the LANG environment variable on the command line. Here's an example,
ubuntu: using ubuntu:
$ file my.journal $ file my.journal
my.journal: UTF-8 Unicode text my.journal: UTF-8 Unicode text