;doc: update manuals
This commit is contained in:
		
							parent
							
								
									35b16346a9
								
							
						
					
					
						commit
						568b39734b
					
				| @ -321,6 +321,16 @@ reliably reset to normal mode. | ||||
| \f[C]q\f[R] quits the application. | ||||
| .PP | ||||
| Additional screen-specific keys are described below. | ||||
| .SH MOUSE | ||||
| .PP | ||||
| In most modern terminals, you can also control hledger-ui with a mouse | ||||
| or touchpad as follows: | ||||
| .IP \[bu] 2 | ||||
| Use mouse wheel or trackpad slide to scroll lists up and down | ||||
| .IP \[bu] 2 | ||||
| Left click on list items to go deeper (like \f[C]RIGHT\f[R]) | ||||
| .IP \[bu] 2 | ||||
| Left click on the left-most column go back (like \f[C]LEFT\f[R]) | ||||
| .SH SCREENS | ||||
| .SS Accounts screen | ||||
| .PP | ||||
|  | ||||
| @ -44,6 +44,7 @@ enable "forecast mode". | ||||
| 
 | ||||
| * OPTIONS:: | ||||
| * KEYS:: | ||||
| * MOUSE:: | ||||
| * SCREENS:: | ||||
| * TIPS:: | ||||
| * ENVIRONMENT:: | ||||
| @ -236,7 +237,7 @@ should contain one command line option/argument per line. (To prevent | ||||
| this, insert a `--' argument before.) | ||||
| 
 | ||||
|  | ||||
| File: hledger-ui.info,  Node: KEYS,  Next: SCREENS,  Prev: OPTIONS,  Up: Top | ||||
| File: hledger-ui.info,  Node: KEYS,  Next: MOUSE,  Prev: OPTIONS,  Up: Top | ||||
| 
 | ||||
| 2 KEYS | ||||
| ****** | ||||
| @ -328,9 +329,24 @@ mode. | ||||
|    Additional screen-specific keys are described below. | ||||
| 
 | ||||
|  | ||||
| File: hledger-ui.info,  Node: SCREENS,  Next: TIPS,  Prev: KEYS,  Up: Top | ||||
| File: hledger-ui.info,  Node: MOUSE,  Next: SCREENS,  Prev: KEYS,  Up: Top | ||||
| 
 | ||||
| 3 SCREENS | ||||
| 3 MOUSE | ||||
| ******* | ||||
| 
 | ||||
| In most modern terminals, you can also control hledger-ui with a mouse | ||||
| or touchpad as follows: | ||||
| 
 | ||||
|    * Use mouse wheel or trackpad slide to scroll lists up and down | ||||
| 
 | ||||
|    * Left click on list items to go deeper (like `RIGHT') | ||||
| 
 | ||||
|    * Left click on the left-most column go back (like `LEFT') | ||||
| 
 | ||||
|  | ||||
| File: hledger-ui.info,  Node: SCREENS,  Next: TIPS,  Prev: MOUSE,  Up: Top | ||||
| 
 | ||||
| 4 SCREENS | ||||
| ********* | ||||
| 
 | ||||
| * Menu: | ||||
| @ -343,7 +359,7 @@ File: hledger-ui.info,  Node: SCREENS,  Next: TIPS,  Prev: KEYS,  Up: Top | ||||
|  | ||||
| File: hledger-ui.info,  Node: Accounts screen,  Next: Register screen,  Up: SCREENS | ||||
| 
 | ||||
| 3.1 Accounts screen | ||||
| 4.1 Accounts screen | ||||
| =================== | ||||
| 
 | ||||
| This is normally the first screen displayed. It lists accounts and their | ||||
| @ -391,7 +407,7 @@ command-line hledger). | ||||
|  | ||||
| File: hledger-ui.info,  Node: Register screen,  Next: Transaction screen,  Prev: Accounts screen,  Up: SCREENS | ||||
| 
 | ||||
| 3.2 Register screen | ||||
| 4.2 Register screen | ||||
| =================== | ||||
| 
 | ||||
| This screen shows the transactions affecting a particular account, like | ||||
| @ -440,7 +456,7 @@ detail. | ||||
|  | ||||
| File: hledger-ui.info,  Node: Transaction screen,  Next: Error screen,  Prev: Register screen,  Up: SCREENS | ||||
| 
 | ||||
| 3.3 Transaction screen | ||||
| 4.3 Transaction screen | ||||
| ====================== | ||||
| 
 | ||||
| This screen shows a single transaction, as a general journal entry, | ||||
| @ -464,7 +480,7 @@ reload). | ||||
|  | ||||
| File: hledger-ui.info,  Node: Error screen,  Prev: Transaction screen,  Up: SCREENS | ||||
| 
 | ||||
| 3.4 Error screen | ||||
| 4.4 Error screen | ||||
| ================ | ||||
| 
 | ||||
| This screen will appear if there is a problem, such as a parse error, | ||||
| @ -475,7 +491,7 @@ to cancel the reload attempt.) | ||||
|  | ||||
| File: hledger-ui.info,  Node: TIPS,  Next: ENVIRONMENT,  Prev: SCREENS,  Up: Top | ||||
| 
 | ||||
| 4 TIPS | ||||
| 5 TIPS | ||||
| ****** | ||||
| 
 | ||||
| * Menu: | ||||
| @ -486,7 +502,7 @@ File: hledger-ui.info,  Node: TIPS,  Next: ENVIRONMENT,  Prev: SCREENS,  Up: Top | ||||
|  | ||||
| File: hledger-ui.info,  Node: Watch mode,  Next: Watch mode limitations,  Up: TIPS | ||||
| 
 | ||||
| 4.1 Watch mode | ||||
| 5.1 Watch mode | ||||
| ============== | ||||
| 
 | ||||
| One of hledger-ui's best features is the auto-reloading `--watch' mode. | ||||
| @ -510,7 +526,7 @@ history. | ||||
|  | ||||
| File: hledger-ui.info,  Node: Watch mode limitations,  Prev: Watch mode,  Up: TIPS | ||||
| 
 | ||||
| 4.2 Watch mode limitations | ||||
| 5.2 Watch mode limitations | ||||
| ========================== | ||||
| 
 | ||||
| There are situations in which it won't work, ie the display will not | ||||
| @ -541,7 +557,7 @@ gradually using more and more memory and CPU over time, as seen in | ||||
|  | ||||
| File: hledger-ui.info,  Node: ENVIRONMENT,  Next: FILES,  Prev: TIPS,  Up: Top | ||||
| 
 | ||||
| 5 ENVIRONMENT | ||||
| 6 ENVIRONMENT | ||||
| ************* | ||||
| 
 | ||||
| *COLUMNS* The screen width to use. Default: the full terminal width. | ||||
| @ -570,7 +586,7 @@ GUI (say, an Emacs dock icon). Eg on MacOS Catalina I have a | ||||
|  | ||||
| File: hledger-ui.info,  Node: FILES,  Next: BUGS,  Prev: ENVIRONMENT,  Up: Top | ||||
| 
 | ||||
| 6 FILES | ||||
| 7 FILES | ||||
| ******* | ||||
| 
 | ||||
| Reads data from one or more files in hledger journal, timeclock, | ||||
| @ -581,7 +597,7 @@ timedot, or CSV format specified with `-f', or `$LEDGER_FILE', or | ||||
|  | ||||
| File: hledger-ui.info,  Node: BUGS,  Prev: FILES,  Up: Top | ||||
| 
 | ||||
| 7 BUGS | ||||
| 8 BUGS | ||||
| ****** | ||||
| 
 | ||||
| The need to precede options with `--' when invoked from hledger is | ||||
| @ -610,31 +626,33 @@ program is restarted. | ||||
|  | ||||
| Tag Table: | ||||
| Node: Top232 | ||||
| Node: OPTIONS1637 | ||||
| Ref: #options1734 | ||||
| Node: KEYS6606 | ||||
| Ref: #keys6701 | ||||
| Node: SCREENS10750 | ||||
| Ref: #screens10848 | ||||
| Node: Accounts screen10938 | ||||
| Ref: #accounts-screen11066 | ||||
| Node: Register screen13270 | ||||
| Ref: #register-screen13425 | ||||
| Node: Transaction screen15420 | ||||
| Ref: #transaction-screen15578 | ||||
| Node: Error screen16445 | ||||
| Ref: #error-screen16567 | ||||
| Node: TIPS16809 | ||||
| Ref: #tips16908 | ||||
| Node: Watch mode16960 | ||||
| Ref: #watch-mode17077 | ||||
| Node: Watch mode limitations17821 | ||||
| Ref: #watch-mode-limitations17962 | ||||
| Node: ENVIRONMENT19095 | ||||
| Ref: #environment19206 | ||||
| Node: FILES20011 | ||||
| Ref: #files20110 | ||||
| Node: BUGS20323 | ||||
| Ref: #bugs20400 | ||||
| Node: OPTIONS1647 | ||||
| Ref: #options1744 | ||||
| Node: KEYS6616 | ||||
| Ref: #keys6709 | ||||
| Node: MOUSE10758 | ||||
| Ref: #mouse10853 | ||||
| Node: SCREENS11139 | ||||
| Ref: #screens11238 | ||||
| Node: Accounts screen11328 | ||||
| Ref: #accounts-screen11456 | ||||
| Node: Register screen13660 | ||||
| Ref: #register-screen13815 | ||||
| Node: Transaction screen15810 | ||||
| Ref: #transaction-screen15968 | ||||
| Node: Error screen16835 | ||||
| Ref: #error-screen16957 | ||||
| Node: TIPS17199 | ||||
| Ref: #tips17298 | ||||
| Node: Watch mode17350 | ||||
| Ref: #watch-mode17467 | ||||
| Node: Watch mode limitations18211 | ||||
| Ref: #watch-mode-limitations18352 | ||||
| Node: ENVIRONMENT19485 | ||||
| Ref: #environment19596 | ||||
| Node: FILES20401 | ||||
| Ref: #files20500 | ||||
| Node: BUGS20713 | ||||
| Ref: #bugs20790 | ||||
|  | ||||
| End Tag Table | ||||
|  | ||||
| @ -294,46 +294,56 @@ KEYS | ||||
| 
 | ||||
|        Additional screen-specific keys are described below. | ||||
| 
 | ||||
| MOUSE | ||||
|        In most modern terminals, you can also control hledger-ui with a  mouse | ||||
|        or touchpad as follows: | ||||
| 
 | ||||
|        o Use mouse wheel or trackpad slide to scroll lists up and down | ||||
| 
 | ||||
|        o Left click on list items to go deeper (like RIGHT) | ||||
| 
 | ||||
|        o Left click on the left-most column go back (like LEFT) | ||||
| 
 | ||||
| SCREENS | ||||
|    Accounts screen | ||||
|        This is normally the first screen displayed.   It  lists  accounts  and | ||||
|        their  balances,  like hledger's balance command.  By default, it shows | ||||
|        all accounts and their latest ending balances (including  the  balances | ||||
|        of  subaccounts).  If you specify a query on the command line, it shows | ||||
|        This  is  normally  the  first screen displayed.  It lists accounts and | ||||
|        their balances, like hledger's balance command.  By default,  it  shows | ||||
|        all  accounts  and their latest ending balances (including the balances | ||||
|        of subaccounts).  If you specify a query on the command line, it  shows | ||||
|        just the matched accounts and the balances from matched transactions. | ||||
| 
 | ||||
|        Account names are shown as a flat list by default; press  t  to  toggle | ||||
|        tree  mode.   In  list  mode,  account balances are exclusive of subac- | ||||
|        counts, except where subaccounts are  hidden  by  a  depth  limit  (see | ||||
|        below).   In  tree  mode,  all account balances are inclusive of subac- | ||||
|        Account  names  are  shown as a flat list by default; press t to toggle | ||||
|        tree mode.  In list mode, account  balances  are  exclusive  of  subac- | ||||
|        counts,  except  where  subaccounts  are  hidden  by a depth limit (see | ||||
|        below).  In tree mode, all account balances  are  inclusive  of  subac- | ||||
|        counts. | ||||
| 
 | ||||
|        To see less detail, press a number key, 1 to 9, to set a  depth  limit. | ||||
|        To  see  less detail, press a number key, 1 to 9, to set a depth limit. | ||||
|        Or use - to decrease and +/= to increase the depth limit.  0 shows even | ||||
|        less detail, collapsing all accounts to a single total.  To remove  the | ||||
|        depth  limit,  set  it  higher than the maximum account depth, or press | ||||
|        less  detail, collapsing all accounts to a single total.  To remove the | ||||
|        depth limit, set it higher than the maximum  account  depth,  or  press | ||||
|        ESCAPE. | ||||
| 
 | ||||
|        H toggles between showing historical balances or period balances.  His- | ||||
|        torical  balances  (the  default) are ending balances at the end of the | ||||
|        report period, taking into account all transactions  before  that  date | ||||
|        (filtered  by  the  filter query if any), including transactions before | ||||
|        the start of the report period.  In other  words,  historical  balances | ||||
|        are  what  you  would  see on a bank statement for that account (unless | ||||
|        disturbed by a filter  query).   Period  balances  ignore  transactions | ||||
|        torical balances (the default) are ending balances at the  end  of  the | ||||
|        report  period,  taking  into account all transactions before that date | ||||
|        (filtered by the filter query if any),  including  transactions  before | ||||
|        the  start  of  the report period.  In other words, historical balances | ||||
|        are what you would see on a bank statement  for  that  account  (unless | ||||
|        disturbed  by  a  filter  query).   Period balances ignore transactions | ||||
|        before the report start date, so they show the change in balance during | ||||
|        the report period.  They are more useful eg when viewing a time log. | ||||
| 
 | ||||
|        U toggles filtering by unmarked status, including or excluding unmarked | ||||
|        postings in the balances.  Similarly, P toggles pending postings, and C | ||||
|        toggles cleared postings.  (By default, balances include all  postings; | ||||
|        if  you  activate  one  or  two status filters, only those postings are | ||||
|        toggles  cleared postings.  (By default, balances include all postings; | ||||
|        if you activate one or two status  filters,  only  those  postings  are | ||||
|        included; and if you activate all three, the filter is removed.) | ||||
| 
 | ||||
|        R toggles real mode, in which virtual postings are ignored. | ||||
| 
 | ||||
|        Z toggles nonzero mode, in which only accounts  with  nonzero  balances | ||||
|        are  shown (hledger-ui shows zero items by default, unlike command-line | ||||
|        Z  toggles  nonzero  mode, in which only accounts with nonzero balances | ||||
|        are shown (hledger-ui shows zero items by default, unlike  command-line | ||||
|        hledger). | ||||
| 
 | ||||
|        Press right or enter to view an account's transactions register. | ||||
| @ -342,124 +352,124 @@ SCREENS | ||||
|        This screen shows the transactions affecting a particular account, like | ||||
|        a check register.  Each line represents one transaction and shows: | ||||
| 
 | ||||
|        o the  other  account(s)  involved, in abbreviated form.  (If there are | ||||
|          both real and virtual postings, it shows only the  accounts  affected | ||||
|        o the other account(s) involved, in abbreviated form.   (If  there  are | ||||
|          both  real  and virtual postings, it shows only the accounts affected | ||||
|          by real postings.) | ||||
| 
 | ||||
|        o the  overall change to the current account's balance; positive for an | ||||
|        o the overall change to the current account's balance; positive for  an | ||||
|          inflow to this account, negative for an outflow. | ||||
| 
 | ||||
|        o the running historical total or period total for the current account, | ||||
|          after  the  transaction.  This can be toggled with H.  Similar to the | ||||
|          accounts screen, the historical total  is  affected  by  transactions | ||||
|          (filtered  by  the  filter query) before the report start date, while | ||||
|          after the transaction.  This can be toggled with H.  Similar  to  the | ||||
|          accounts  screen,  the  historical  total is affected by transactions | ||||
|          (filtered by the filter query) before the report  start  date,  while | ||||
|          the period total is not.  If the historical total is not disturbed by | ||||
|          a  filter  query, it will be the running historical balance you would | ||||
|          a filter query, it will be the running historical balance  you  would | ||||
|          see on a bank register for the current account. | ||||
| 
 | ||||
|        Transactions affecting this account's subaccounts will be  included  in | ||||
|        Transactions  affecting  this account's subaccounts will be included in | ||||
|        the register if the accounts screen is in tree mode, or if it's in list | ||||
|        mode but this account has subaccounts which are  not  shown  due  to  a | ||||
|        depth  limit.   In  other words, the register always shows the transac- | ||||
|        tions contributing to the balance shown on the accounts  screen.   Tree | ||||
|        mode  but  this  account  has  subaccounts which are not shown due to a | ||||
|        depth limit.  In other words, the register always  shows  the  transac- | ||||
|        tions  contributing  to the balance shown on the accounts screen.  Tree | ||||
|        mode/list mode can be toggled with t here also. | ||||
| 
 | ||||
|        U  toggles  filtering  by  unmarked  status, showing or hiding unmarked | ||||
|        U toggles filtering by unmarked  status,  showing  or  hiding  unmarked | ||||
|        transactions.  Similarly, P toggles pending transactions, and C toggles | ||||
|        cleared  transactions.  (By default, transactions with all statuses are | ||||
|        shown; if you activate one or two status filters, only  those  transac- | ||||
|        cleared transactions.  (By default, transactions with all statuses  are | ||||
|        shown;  if  you activate one or two status filters, only those transac- | ||||
|        tions are shown; and if you activate all three, the filter is removed.) | ||||
| 
 | ||||
|        R toggles real mode, in which virtual postings are ignored. | ||||
| 
 | ||||
|        Z toggles nonzero mode, in which only transactions  posting  a  nonzero | ||||
|        change  are  shown (hledger-ui shows zero items by default, unlike com- | ||||
|        Z  toggles  nonzero  mode, in which only transactions posting a nonzero | ||||
|        change are shown (hledger-ui shows zero items by default,  unlike  com- | ||||
|        mand-line hledger). | ||||
| 
 | ||||
|        Press right (or enter) to view the selected transaction in detail. | ||||
| 
 | ||||
|    Transaction screen | ||||
|        This screen shows a single transaction, as  a  general  journal  entry, | ||||
|        similar  to  hledger's  print command and journal format (hledger_jour- | ||||
|        This  screen  shows  a  single transaction, as a general journal entry, | ||||
|        similar to hledger's print command and  journal  format  (hledger_jour- | ||||
|        nal(5)). | ||||
| 
 | ||||
|        The transaction's date(s)  and  any  cleared  flag,  transaction  code, | ||||
|        description,  comments,  along  with  all  of  its account postings are | ||||
|        shown.  Simple transactions have two postings, but there  can  be  more | ||||
|        The  transaction's  date(s)  and  any  cleared  flag, transaction code, | ||||
|        description, comments, along with  all  of  its  account  postings  are | ||||
|        shown.   Simple  transactions  have two postings, but there can be more | ||||
|        (or in certain cases, fewer). | ||||
| 
 | ||||
|        up  and  down will step through all transactions listed in the previous | ||||
|        account register screen.  In the title bar, the numbers in  parentheses | ||||
|        show  your  position  within  that  account  register.   They will vary | ||||
|        up and down will step through all transactions listed in  the  previous | ||||
|        account  register screen.  In the title bar, the numbers in parentheses | ||||
|        show your position  within  that  account  register.   They  will  vary | ||||
|        depending on which account register you came from (remember most trans- | ||||
|        actions appear in multiple account registers).  The #N number preceding | ||||
|        them is the transaction's position within the complete unfiltered jour- | ||||
|        nal, which is a more stable id (at least until the next reload). | ||||
| 
 | ||||
|    Error screen | ||||
|        This  screen  will appear if there is a problem, such as a parse error, | ||||
|        when you press g to reload.  Once you have fixed the problem,  press  g | ||||
|        This screen will appear if there is a problem, such as a  parse  error, | ||||
|        when  you  press g to reload.  Once you have fixed the problem, press g | ||||
|        again to reload and resume normal operation.  (Or, you can press escape | ||||
|        to cancel the reload attempt.) | ||||
| 
 | ||||
| TIPS | ||||
|    Watch mode | ||||
|        One of hledger-ui's best features is the auto-reloading  --watch  mode. | ||||
|        With  this  flag,  it  will  update  the display automatically whenever | ||||
|        One  of  hledger-ui's best features is the auto-reloading --watch mode. | ||||
|        With this flag, it  will  update  the  display  automatically  whenever | ||||
|        changes are saved to the data files. | ||||
| 
 | ||||
|        This is very useful when reconciling.  A good workflow is to have  your | ||||
|        bank's  online  register  open  in a browser window, for reference; the | ||||
|        journal file open in an editor window; and hledger-ui in watch mode  in | ||||
|        This  is very useful when reconciling.  A good workflow is to have your | ||||
|        bank's online register open in a browser  window,  for  reference;  the | ||||
|        journal  file open in an editor window; and hledger-ui in watch mode in | ||||
|        a terminal window, eg: | ||||
| 
 | ||||
|               $ hledger-ui --watch --register checking -C | ||||
| 
 | ||||
|        As  you mark things cleared in the editor, you can see the effect imme- | ||||
|        diately without having to context  switch.   This  leaves  more  mental | ||||
|        bandwidth  for  your accounting.  Of course you can still interact with | ||||
|        hledger-ui when needed, eg to toggle cleared mode, or  to  explore  the | ||||
|        As you mark things cleared in the editor, you can see the effect  imme- | ||||
|        diately  without  having  to  context  switch.  This leaves more mental | ||||
|        bandwidth for your accounting.  Of course you can still  interact  with | ||||
|        hledger-ui  when  needed,  eg to toggle cleared mode, or to explore the | ||||
|        history. | ||||
| 
 | ||||
|    Watch mode limitations | ||||
|        There  are  situations  in which it won't work, ie the display will not | ||||
|        update when you save a change (because the underlying  inotify  library | ||||
|        There are situations in which it won't work, ie the  display  will  not | ||||
|        update  when  you save a change (because the underlying inotify library | ||||
|        does not support it).  Here are some that we know of: | ||||
| 
 | ||||
|        o Certain  editors:  saving  with gedit, and perhaps any Gnome applica- | ||||
|          tion, won't be detected (#1617).  Jetbrains IDEs, such as IDEA,  also | ||||
|        o Certain editors: saving with gedit, and perhaps  any  Gnome  applica- | ||||
|          tion,  won't be detected (#1617).  Jetbrains IDEs, such as IDEA, also | ||||
|          may not work (#911). | ||||
| 
 | ||||
|        o Certain  unusual  filesystems might not be supported.  (All the usual | ||||
|        o Certain unusual filesystems might not be supported.  (All  the  usual | ||||
|          ones on unix, mac and windows are supported.) | ||||
| 
 | ||||
|        In such cases, the workaround is to switch to the hledger-ui window and | ||||
|        press  g  each  time  you  want it to reload.  (Actually, see #1617 for | ||||
|        press g each time you want it to  reload.   (Actually,  see  #1617  for | ||||
|        another workaround, and let us know if it works for you.) | ||||
| 
 | ||||
|        If you leave hledger-ui --watch running for days, on certain  platforms | ||||
|        (?),  perhaps  with many transactions in your journal (?), perhaps with | ||||
|        large numbers of other files present (?),  you  may  see  it  gradually | ||||
|        using  more and more memory and CPU over time, as seen in top or Activ- | ||||
|        If  you leave hledger-ui --watch running for days, on certain platforms | ||||
|        (?), perhaps with many transactions in your journal (?),  perhaps  with | ||||
|        large  numbers  of  other  files  present (?), you may see it gradually | ||||
|        using more and more memory and CPU over time, as seen in top or  Activ- | ||||
|        ity Monitor or Task Manager. | ||||
| 
 | ||||
|        A workaround is to quit and restart it, or to suspend it  (CTRL-z)  and | ||||
|        A  workaround  is to quit and restart it, or to suspend it (CTRL-z) and | ||||
|        restart it (fg) if your shell supports that. | ||||
| 
 | ||||
| ENVIRONMENT | ||||
|        COLUMNS The screen width to use.  Default: the full terminal width. | ||||
| 
 | ||||
|        LEDGER_FILE The journal file path when not specified with -f.  Default: | ||||
|        ~/.hledger.journal (on  windows,  perhaps  C:/Users/USER/.hledger.jour- | ||||
|        ~/.hledger.journal  (on  windows,  perhaps C:/Users/USER/.hledger.jour- | ||||
|        nal). | ||||
| 
 | ||||
|        A  typical  value  is  ~/DIR/YYYY.journal,  where DIR is a version-con- | ||||
|        trolled finance directory and YYYY is the current year.  Or  ~/DIR/cur- | ||||
|        A typical value is ~/DIR/YYYY.journal,  where  DIR  is  a  version-con- | ||||
|        trolled  finance directory and YYYY is the current year.  Or ~/DIR/cur- | ||||
|        rent.journal, where current.journal is a symbolic link to YYYY.journal. | ||||
| 
 | ||||
|        On Mac computers, you can set this and other environment variables in a | ||||
|        more  thorough  way that also affects applications started from the GUI | ||||
|        (say,  an  Emacs  dock  icon).   Eg  on  MacOS  Catalina   I   have   a | ||||
|        more thorough way that also affects applications started from  the  GUI | ||||
|        (say,   an   Emacs   dock  icon).   Eg  on  MacOS  Catalina  I  have  a | ||||
|        ~/.MacOSX/environment.plist file containing | ||||
| 
 | ||||
|               { | ||||
| @ -469,13 +479,13 @@ ENVIRONMENT | ||||
|        To see the effect you may need to killall Dock, or reboot. | ||||
| 
 | ||||
| FILES | ||||
|        Reads  data from one or more files in hledger journal, timeclock, time- | ||||
|        dot,  or  CSV  format  specified   with   -f,   or   $LEDGER_FILE,   or | ||||
|        $HOME/.hledger.journal           (on          windows,          perhaps | ||||
|        Reads data from one or more files in hledger journal, timeclock,  time- | ||||
|        dot,   or   CSV   format   specified   with  -f,  or  $LEDGER_FILE,  or | ||||
|        $HOME/.hledger.journal          (on          windows,           perhaps | ||||
|        C:/Users/USER/.hledger.journal). | ||||
| 
 | ||||
| BUGS | ||||
|        The need to precede options with -- when invoked from hledger  is  awk- | ||||
|        The  need  to precede options with -- when invoked from hledger is awk- | ||||
|        ward. | ||||
| 
 | ||||
|        -f- doesn't work (hledger-ui can't read from stdin). | ||||
| @ -483,24 +493,24 @@ BUGS | ||||
|        -V affects only the accounts screen. | ||||
| 
 | ||||
|        When you press g, the current and all previous screens are regenerated, | ||||
|        which may cause a noticeable pause with large files.  Also there is  no | ||||
|        which  may cause a noticeable pause with large files.  Also there is no | ||||
|        visual indication that this is in progress. | ||||
| 
 | ||||
|        --watch  is  not yet fully robust.  It works well for normal usage, but | ||||
|        many file changes in a short time (eg  saving  the  file  thousands  of | ||||
|        times  with an editor macro) can cause problems at least on OSX.  Symp- | ||||
|        toms include: unresponsive UI, periodic resetting of the  cursor  posi- | ||||
|        --watch is not yet fully robust.  It works well for normal  usage,  but | ||||
|        many  file  changes  in  a  short time (eg saving the file thousands of | ||||
|        times with an editor macro) can cause problems at least on OSX.   Symp- | ||||
|        toms  include:  unresponsive UI, periodic resetting of the cursor posi- | ||||
|        tion, momentary display of parse errors, high CPU usage eventually sub- | ||||
|        siding, and possibly a small but persistent build-up of CPU usage until | ||||
|        the program is restarted. | ||||
| 
 | ||||
|        Also,  if  you  are viewing files mounted from another machine, --watch | ||||
|        Also, if you are viewing files mounted from  another  machine,  --watch | ||||
|        requires that both machine clocks are roughly in step. | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| REPORTING BUGS | ||||
|        Report bugs at http://bugs.hledger.org (or on the #hledger IRC  channel | ||||
|        Report  bugs at http://bugs.hledger.org (or on the #hledger IRC channel | ||||
|        or hledger mail list) | ||||
| 
 | ||||
| 
 | ||||
|  | ||||
| @ -3104,9 +3104,13 @@ Output as HTML and view with a browser: | ||||
| .SS Commodity layout | ||||
| .PP | ||||
| With \f[C]--layout\f[R], you can control how amounts with more than one | ||||
| commodity are displayed: - \f[C]--layout=wide[,WIDTH]\f[R]: on a single | ||||
| line, possibly elided to the specified width - \f[C]--layout=tall\f[R]: | ||||
| each commodity is displayed on a separate line - | ||||
| commodity are displayed: | ||||
| .IP \[bu] 2 | ||||
| \f[C]--layout=wide[,WIDTH]\f[R]: on a single line, possibly elided to | ||||
| the specified width | ||||
| .IP \[bu] 2 | ||||
| \f[C]--layout=tall\f[R]: each commodity is displayed on a separate line | ||||
| .IP \[bu] 2 | ||||
| \f[C]--layout=bare\f[R]: commodity symbols are displayed in a separate | ||||
| column, and amounts are displayed as bare numbers | ||||
| .IP | ||||
|  | ||||
| @ -2726,11 +2726,15 @@ File: hledger.info,  Node: Commodity layout,  Next: Sorting by amount,  Prev: Mu | ||||
| ----------------------- | ||||
| 
 | ||||
| With `--layout', you can control how amounts with more than one | ||||
| commodity are displayed: - `--layout=wide[,WIDTH]': on a single line, | ||||
| possibly elided to the specified width - `--layout=tall': each | ||||
| commodity is displayed on a separate line - `--layout=bare': commodity | ||||
| symbols are displayed in a separate column, and amounts are displayed | ||||
| as bare numbers | ||||
| commodity are displayed: | ||||
| 
 | ||||
|    * `--layout=wide[,WIDTH]': on a single line, possibly elided to the | ||||
|      specified width | ||||
| 
 | ||||
|    * `--layout=tall': each commodity is displayed on a separate line | ||||
| 
 | ||||
|    * `--layout=bare': commodity symbols are displayed in a separate | ||||
|      column, and amounts are displayed as bare numbers | ||||
| 
 | ||||
| 
 | ||||
| $ hledger -f examples/bcexample.hledger bal assets:us:etrade -3 -T -Y --layout=wide | ||||
| @ -9679,379 +9683,379 @@ Node: Multi-period balance report87607 | ||||
| Ref: #multi-period-balance-report87811 | ||||
| Node: Commodity layout90090 | ||||
| Ref: #commodity-layout90262 | ||||
| Node: Sorting by amount95557 | ||||
| Ref: #sorting-by-amount95715 | ||||
| Node: Percentages96380 | ||||
| Ref: #percentages96538 | ||||
| Node: Balance change end balance97497 | ||||
| Ref: #balance-change-end-balance97690 | ||||
| Node: Balance report types99114 | ||||
| Ref: #balance-report-types99304 | ||||
| Node: Useful balance reports103675 | ||||
| Ref: #useful-balance-reports103856 | ||||
| Node: Budget report104940 | ||||
| Ref: #budget-report105124 | ||||
| Node: Budget report start date110329 | ||||
| Ref: #budget-report-start-date110507 | ||||
| Node: Budgets and subaccounts111834 | ||||
| Ref: #budgets-and-subaccounts112041 | ||||
| Node: Selecting budget goals115428 | ||||
| Ref: #selecting-budget-goals115600 | ||||
| Node: Customising single-period balance reports116630 | ||||
| Ref: #customising-single-period-balance-reports116839 | ||||
| Node: balancesheet119023 | ||||
| Ref: #balancesheet119161 | ||||
| Node: balancesheetequity120459 | ||||
| Ref: #balancesheetequity120610 | ||||
| Node: cashflow121990 | ||||
| Ref: #cashflow122114 | ||||
| Node: check123260 | ||||
| Ref: #check123365 | ||||
| Node: Basic checks123998 | ||||
| Ref: #basic-checks124116 | ||||
| Node: Strict checks124668 | ||||
| Ref: #strict-checks124809 | ||||
| Node: Other checks125245 | ||||
| Ref: #other-checks125385 | ||||
| Node: Custom checks125742 | ||||
| Ref: #custom-checks125862 | ||||
| Node: close126280 | ||||
| Ref: #close126384 | ||||
| Node: close and prices128470 | ||||
| Ref: #close-and-prices128599 | ||||
| Node: close date128993 | ||||
| Ref: #close-date129177 | ||||
| Node: Example close asset/liability accounts for file transition129923 | ||||
| Ref: #example-close-assetliability-accounts-for-file-transition130224 | ||||
| Node: Hiding opening/closing transactions131086 | ||||
| Ref: #hiding-openingclosing-transactions131357 | ||||
| Node: close and balance assertions132738 | ||||
| Ref: #close-and-balance-assertions132996 | ||||
| Node: Example close revenue/expense accounts to retained earnings134350 | ||||
| Ref: #example-close-revenueexpense-accounts-to-retained-earnings134628 | ||||
| Node: codes135521 | ||||
| Ref: #codes135631 | ||||
| Node: commodities136344 | ||||
| Ref: #commodities136473 | ||||
| Node: descriptions136555 | ||||
| Ref: #descriptions136685 | ||||
| Node: diff136989 | ||||
| Ref: #diff137097 | ||||
| Node: files138142 | ||||
| Ref: #files138244 | ||||
| Node: help138390 | ||||
| Ref: #help138492 | ||||
| Node: import139307 | ||||
| Ref: #import139423 | ||||
| Node: Deduplication140285 | ||||
| Ref: #deduplication140410 | ||||
| Node: Import testing142298 | ||||
| Ref: #import-testing142463 | ||||
| Node: Importing balance assignments142953 | ||||
| Ref: #importing-balance-assignments143159 | ||||
| Node: Commodity display styles143806 | ||||
| Ref: #commodity-display-styles143979 | ||||
| Node: incomestatement144108 | ||||
| Ref: #incomestatement144243 | ||||
| Node: notes145544 | ||||
| Ref: #notes145659 | ||||
| Node: payees146026 | ||||
| Ref: #payees146134 | ||||
| Node: prices146660 | ||||
| Ref: #prices146768 | ||||
| Node: print147133 | ||||
| Ref: #print147245 | ||||
| Node: print-unique152555 | ||||
| Ref: #print-unique152683 | ||||
| Node: register152969 | ||||
| Ref: #register153098 | ||||
| Node: Custom register output157542 | ||||
| Ref: #custom-register-output157673 | ||||
| Node: register-match159010 | ||||
| Ref: #register-match159146 | ||||
| Node: rewrite159494 | ||||
| Ref: #rewrite159611 | ||||
| Node: Re-write rules in a file161517 | ||||
| Ref: #re-write-rules-in-a-file161680 | ||||
| Node: Diff output format162830 | ||||
| Ref: #diff-output-format163013 | ||||
| Node: rewrite vs print --auto164105 | ||||
| Ref: #rewrite-vs.-print---auto164265 | ||||
| Node: roi164815 | ||||
| Ref: #roi164915 | ||||
| Node: Spaces and special characters in --inv and --pnl166603 | ||||
| Ref: #spaces-and-special-characters-in---inv-and---pnl166844 | ||||
| Node: Semantics of --inv and --pnl167337 | ||||
| Ref: #semantics-of---inv-and---pnl167576 | ||||
| Node: IRR and TWR explained169422 | ||||
| Ref: #irr-and-twr-explained169582 | ||||
| Node: stats172644 | ||||
| Ref: #stats172745 | ||||
| Node: tags173532 | ||||
| Ref: #tags173632 | ||||
| Node: test174149 | ||||
| Ref: #test174265 | ||||
| Node: About add-on commands175010 | ||||
| Ref: #about-add-on-commands175147 | ||||
| Node: JOURNAL FORMAT176280 | ||||
| Ref: #journal-format176408 | ||||
| Node: Transactions178628 | ||||
| Ref: #transactions178743 | ||||
| Node: Dates179760 | ||||
| Ref: #dates179876 | ||||
| Node: Simple dates179941 | ||||
| Ref: #simple-dates180061 | ||||
| Node: Secondary dates180568 | ||||
| Ref: #secondary-dates180716 | ||||
| Node: Posting dates182050 | ||||
| Ref: #posting-dates182173 | ||||
| Node: Status183542 | ||||
| Ref: #status183652 | ||||
| Node: Code185357 | ||||
| Ref: #code185469 | ||||
| Node: Description185700 | ||||
| Ref: #description185828 | ||||
| Node: Payee and note186146 | ||||
| Ref: #payee-and-note186254 | ||||
| Node: Comments186588 | ||||
| Ref: #comments186710 | ||||
| Node: Tags187903 | ||||
| Ref: #tags-1188014 | ||||
| Node: Postings189412 | ||||
| Ref: #postings189536 | ||||
| Node: Virtual postings190560 | ||||
| Ref: #virtual-postings190671 | ||||
| Node: Account names191973 | ||||
| Ref: #account-names192110 | ||||
| Node: Amounts192596 | ||||
| Ref: #amounts192733 | ||||
| Node: Decimal marks digit group marks193720 | ||||
| Ref: #decimal-marks-digit-group-marks193897 | ||||
| Node: Commodity194918 | ||||
| Ref: #commodity195107 | ||||
| Node: Directives influencing number parsing and display196057 | ||||
| Ref: #directives-influencing-number-parsing-and-display196318 | ||||
| Node: Commodity display style196810 | ||||
| Ref: #commodity-display-style197018 | ||||
| Node: Rounding199213 | ||||
| Ref: #rounding199333 | ||||
| Node: Transaction prices199743 | ||||
| Ref: #transaction-prices199909 | ||||
| Node: Lot prices lot dates202339 | ||||
| Ref: #lot-prices-lot-dates202522 | ||||
| Node: Balance assertions203009 | ||||
| Ref: #balance-assertions203187 | ||||
| Node: Assertions and ordering204217 | ||||
| Ref: #assertions-and-ordering204399 | ||||
| Node: Assertions and included files205096 | ||||
| Ref: #assertions-and-included-files205333 | ||||
| Node: Assertions and multiple -f options205664 | ||||
| Ref: #assertions-and-multiple--f-options205914 | ||||
| Node: Assertions and commodities206045 | ||||
| Ref: #assertions-and-commodities206271 | ||||
| Node: Assertions and prices207426 | ||||
| Ref: #assertions-and-prices207634 | ||||
| Node: Assertions and subaccounts208075 | ||||
| Ref: #assertions-and-subaccounts208298 | ||||
| Node: Assertions and virtual postings208622 | ||||
| Ref: #assertions-and-virtual-postings208858 | ||||
| Node: Assertions and precision208999 | ||||
| Ref: #assertions-and-precision209186 | ||||
| Node: Balance assignments209451 | ||||
| Ref: #balance-assignments209621 | ||||
| Node: Balance assignments and prices210784 | ||||
| Ref: #balance-assignments-and-prices210950 | ||||
| Node: Directives211176 | ||||
| Ref: #directives211339 | ||||
| Node: Directives and multiple files217082 | ||||
| Ref: #directives-and-multiple-files217278 | ||||
| Node: Comment blocks217940 | ||||
| Ref: #comment-blocks218117 | ||||
| Node: Including other files218292 | ||||
| Ref: #including-other-files218466 | ||||
| Node: Default year219390 | ||||
| Ref: #default-year219548 | ||||
| Node: Declaring payees219955 | ||||
| Ref: #declaring-payees220126 | ||||
| Node: Declaring the decimal mark220371 | ||||
| Ref: #declaring-the-decimal-mark220571 | ||||
| Node: Declaring commodities220969 | ||||
| Ref: #declaring-commodities221160 | ||||
| Node: Commodity error checking223674 | ||||
| Ref: #commodity-error-checking223824 | ||||
| Node: Default commodity224080 | ||||
| Ref: #default-commodity224260 | ||||
| Node: Declaring market prices225134 | ||||
| Ref: #declaring-market-prices225323 | ||||
| Node: Declaring accounts226135 | ||||
| Ref: #declaring-accounts226315 | ||||
| Node: Account error checking227522 | ||||
| Ref: #account-error-checking227688 | ||||
| Node: Account comments228865 | ||||
| Ref: #account-comments229049 | ||||
| Node: Account subdirectives229475 | ||||
| Ref: #account-subdirectives229660 | ||||
| Node: Account types229975 | ||||
| Ref: #account-types230149 | ||||
| Node: Declaring account types230806 | ||||
| Ref: #declaring-account-types230985 | ||||
| Node: Auto-detected account types232037 | ||||
| Ref: #auto-detected-account-types232224 | ||||
| Node: Account display order234236 | ||||
| Ref: #account-display-order234396 | ||||
| Node: Rewriting accounts235547 | ||||
| Ref: #rewriting-accounts235726 | ||||
| Node: Basic aliases236485 | ||||
| Ref: #basic-aliases236621 | ||||
| Node: Regex aliases237363 | ||||
| Ref: #regex-aliases237525 | ||||
| Node: Combining aliases238245 | ||||
| Ref: #combining-aliases238428 | ||||
| Node: Aliases and multiple files239705 | ||||
| Ref: #aliases-and-multiple-files239904 | ||||
| Node: end aliases240485 | ||||
| Ref: #end-aliases240632 | ||||
| Node: Default parent account240734 | ||||
| Ref: #default-parent-account240924 | ||||
| Node: Periodic transactions241808 | ||||
| Ref: #periodic-transactions241991 | ||||
| Node: Periodic rule syntax243908 | ||||
| Ref: #periodic-rule-syntax244108 | ||||
| Node: Two spaces between period expression and description!244811 | ||||
| Ref: #two-spaces-between-period-expression-and-description245124 | ||||
| Node: Forecasting with periodic transactions245809 | ||||
| Ref: #forecasting-with-periodic-transactions246108 | ||||
| Node: Budgeting with periodic transactions248876 | ||||
| Ref: #budgeting-with-periodic-transactions249109 | ||||
| Node: Auto postings249516 | ||||
| Ref: #auto-postings249652 | ||||
| Node: Auto postings and multiple files251835 | ||||
| Ref: #auto-postings-and-multiple-files252033 | ||||
| Node: Auto postings and dates252241 | ||||
| Ref: #auto-postings-and-dates252509 | ||||
| Node: Auto postings and transaction balancing / inferred amounts / balance assertions252684 | ||||
| Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions253030 | ||||
| Node: Auto posting tags253536 | ||||
| Ref: #auto-posting-tags253745 | ||||
| Node: CSV FORMAT254382 | ||||
| Ref: #csv-format254510 | ||||
| Node: Examples257134 | ||||
| Ref: #examples257237 | ||||
| Node: Basic257444 | ||||
| Ref: #basic257546 | ||||
| Node: Bank of Ireland258090 | ||||
| Ref: #bank-of-ireland258227 | ||||
| Node: Amazon259692 | ||||
| Ref: #amazon259812 | ||||
| Node: Paypal261533 | ||||
| Ref: #paypal261629 | ||||
| Node: CSV rules269277 | ||||
| Ref: #csv-rules269395 | ||||
| Node: skip269728 | ||||
| Ref: #skip269828 | ||||
| Node: fields list270200 | ||||
| Ref: #fields-list270339 | ||||
| Node: field assignment271844 | ||||
| Ref: #field-assignment271996 | ||||
| Node: Field names273028 | ||||
| Ref: #field-names273168 | ||||
| Node: date field273547 | ||||
| Ref: #date-field273667 | ||||
| Node: date2 field273715 | ||||
| Ref: #date2-field273858 | ||||
| Node: status field273914 | ||||
| Ref: #status-field274059 | ||||
| Node: code field274108 | ||||
| Ref: #code-field274255 | ||||
| Node: description field274300 | ||||
| Ref: #description-field274462 | ||||
| Node: comment field274521 | ||||
| Ref: #comment-field274678 | ||||
| Node: account field274977 | ||||
| Ref: #account-field275129 | ||||
| Node: amount field275703 | ||||
| Ref: #amount-field275854 | ||||
| Node: currency field277092 | ||||
| Ref: #currency-field277247 | ||||
| Node: balance field277503 | ||||
| Ref: #balance-field277637 | ||||
| Node: separator278009 | ||||
| Ref: #separator278141 | ||||
| Node: if block278683 | ||||
| Ref: #if-block278810 | ||||
| Node: Matching the whole record279208 | ||||
| Ref: #matching-the-whole-record279385 | ||||
| Node: Matching individual fields280188 | ||||
| Ref: #matching-individual-fields280394 | ||||
| Node: Combining matchers280618 | ||||
| Ref: #combining-matchers280816 | ||||
| Node: Rules applied on successful match281130 | ||||
| Ref: #rules-applied-on-successful-match281323 | ||||
| Node: if table281980 | ||||
| Ref: #if-table282101 | ||||
| Node: end283837 | ||||
| Ref: #end283951 | ||||
| Node: date-format284175 | ||||
| Ref: #date-format284309 | ||||
| Node: decimal-mark285306 | ||||
| Ref: #decimal-mark285453 | ||||
| Node: newest-first285790 | ||||
| Ref: #newest-first285933 | ||||
| Node: include286616 | ||||
| Ref: #include286749 | ||||
| Node: balance-type287191 | ||||
| Ref: #balance-type287313 | ||||
| Node: Tips288013 | ||||
| Ref: #tips288104 | ||||
| Node: Rapid feedback288403 | ||||
| Ref: #rapid-feedback288522 | ||||
| Node: Valid CSV288973 | ||||
| Ref: #valid-csv289105 | ||||
| Node: File Extension289297 | ||||
| Ref: #file-extension289451 | ||||
| Node: Reading multiple CSV files289880 | ||||
| Ref: #reading-multiple-csv-files290067 | ||||
| Node: Valid transactions290307 | ||||
| Ref: #valid-transactions290487 | ||||
| Node: Deduplicating importing291115 | ||||
| Ref: #deduplicating-importing291296 | ||||
| Node: Setting amounts292328 | ||||
| Ref: #setting-amounts292485 | ||||
| Node: Amount signs294926 | ||||
| Ref: #amount-signs295080 | ||||
| Node: Setting currency/commodity295767 | ||||
| Ref: #setting-currencycommodity295955 | ||||
| Node: Amount decimal places297135 | ||||
| Ref: #amount-decimal-places297327 | ||||
| Node: Referencing other fields297639 | ||||
| Ref: #referencing-other-fields297838 | ||||
| Node: How CSV rules are evaluated298736 | ||||
| Ref: #how-csv-rules-are-evaluated298911 | ||||
| Node: TIMECLOCK FORMAT300360 | ||||
| Ref: #timeclock-format300500 | ||||
| Node: TIMEDOT FORMAT302568 | ||||
| Ref: #timedot-format302706 | ||||
| Node: COMMON TASKS307265 | ||||
| Ref: #common-tasks307394 | ||||
| Node: Getting help307801 | ||||
| Ref: #getting-help307935 | ||||
| Node: Constructing command lines308486 | ||||
| Ref: #constructing-command-lines308680 | ||||
| Node: Starting a journal file309379 | ||||
| Ref: #starting-a-journal-file309579 | ||||
| Node: Setting opening balances310766 | ||||
| Ref: #setting-opening-balances310964 | ||||
| Node: Recording transactions314097 | ||||
| Ref: #recording-transactions314279 | ||||
| Node: Reconciling314836 | ||||
| Ref: #reconciling314981 | ||||
| Node: Reporting317226 | ||||
| Ref: #reporting317368 | ||||
| Node: Migrating to a new file321288 | ||||
| Ref: #migrating-to-a-new-file321438 | ||||
| Node: LIMITATIONS321736 | ||||
| Ref: #limitations321864 | ||||
| Node: TROUBLESHOOTING322605 | ||||
| Ref: #troubleshooting322720 | ||||
| Node: Sorting by amount95579 | ||||
| Ref: #sorting-by-amount95737 | ||||
| Node: Percentages96402 | ||||
| Ref: #percentages96560 | ||||
| Node: Balance change end balance97519 | ||||
| Ref: #balance-change-end-balance97712 | ||||
| Node: Balance report types99136 | ||||
| Ref: #balance-report-types99326 | ||||
| Node: Useful balance reports103697 | ||||
| Ref: #useful-balance-reports103878 | ||||
| Node: Budget report104962 | ||||
| Ref: #budget-report105146 | ||||
| Node: Budget report start date110351 | ||||
| Ref: #budget-report-start-date110529 | ||||
| Node: Budgets and subaccounts111856 | ||||
| Ref: #budgets-and-subaccounts112063 | ||||
| Node: Selecting budget goals115450 | ||||
| Ref: #selecting-budget-goals115622 | ||||
| Node: Customising single-period balance reports116652 | ||||
| Ref: #customising-single-period-balance-reports116861 | ||||
| Node: balancesheet119045 | ||||
| Ref: #balancesheet119183 | ||||
| Node: balancesheetequity120481 | ||||
| Ref: #balancesheetequity120632 | ||||
| Node: cashflow122012 | ||||
| Ref: #cashflow122136 | ||||
| Node: check123282 | ||||
| Ref: #check123387 | ||||
| Node: Basic checks124020 | ||||
| Ref: #basic-checks124138 | ||||
| Node: Strict checks124690 | ||||
| Ref: #strict-checks124831 | ||||
| Node: Other checks125267 | ||||
| Ref: #other-checks125407 | ||||
| Node: Custom checks125764 | ||||
| Ref: #custom-checks125884 | ||||
| Node: close126302 | ||||
| Ref: #close126406 | ||||
| Node: close and prices128492 | ||||
| Ref: #close-and-prices128621 | ||||
| Node: close date129015 | ||||
| Ref: #close-date129199 | ||||
| Node: Example close asset/liability accounts for file transition129945 | ||||
| Ref: #example-close-assetliability-accounts-for-file-transition130246 | ||||
| Node: Hiding opening/closing transactions131108 | ||||
| Ref: #hiding-openingclosing-transactions131379 | ||||
| Node: close and balance assertions132760 | ||||
| Ref: #close-and-balance-assertions133018 | ||||
| Node: Example close revenue/expense accounts to retained earnings134372 | ||||
| Ref: #example-close-revenueexpense-accounts-to-retained-earnings134650 | ||||
| Node: codes135543 | ||||
| Ref: #codes135653 | ||||
| Node: commodities136366 | ||||
| Ref: #commodities136495 | ||||
| Node: descriptions136577 | ||||
| Ref: #descriptions136707 | ||||
| Node: diff137011 | ||||
| Ref: #diff137119 | ||||
| Node: files138164 | ||||
| Ref: #files138266 | ||||
| Node: help138412 | ||||
| Ref: #help138514 | ||||
| Node: import139329 | ||||
| Ref: #import139445 | ||||
| Node: Deduplication140307 | ||||
| Ref: #deduplication140432 | ||||
| Node: Import testing142320 | ||||
| Ref: #import-testing142485 | ||||
| Node: Importing balance assignments142975 | ||||
| Ref: #importing-balance-assignments143181 | ||||
| Node: Commodity display styles143828 | ||||
| Ref: #commodity-display-styles144001 | ||||
| Node: incomestatement144130 | ||||
| Ref: #incomestatement144265 | ||||
| Node: notes145566 | ||||
| Ref: #notes145681 | ||||
| Node: payees146048 | ||||
| Ref: #payees146156 | ||||
| Node: prices146682 | ||||
| Ref: #prices146790 | ||||
| Node: print147155 | ||||
| Ref: #print147267 | ||||
| Node: print-unique152577 | ||||
| Ref: #print-unique152705 | ||||
| Node: register152991 | ||||
| Ref: #register153120 | ||||
| Node: Custom register output157564 | ||||
| Ref: #custom-register-output157695 | ||||
| Node: register-match159032 | ||||
| Ref: #register-match159168 | ||||
| Node: rewrite159516 | ||||
| Ref: #rewrite159633 | ||||
| Node: Re-write rules in a file161539 | ||||
| Ref: #re-write-rules-in-a-file161702 | ||||
| Node: Diff output format162852 | ||||
| Ref: #diff-output-format163035 | ||||
| Node: rewrite vs print --auto164127 | ||||
| Ref: #rewrite-vs.-print---auto164287 | ||||
| Node: roi164837 | ||||
| Ref: #roi164937 | ||||
| Node: Spaces and special characters in --inv and --pnl166625 | ||||
| Ref: #spaces-and-special-characters-in---inv-and---pnl166866 | ||||
| Node: Semantics of --inv and --pnl167359 | ||||
| Ref: #semantics-of---inv-and---pnl167598 | ||||
| Node: IRR and TWR explained169444 | ||||
| Ref: #irr-and-twr-explained169604 | ||||
| Node: stats172666 | ||||
| Ref: #stats172767 | ||||
| Node: tags173554 | ||||
| Ref: #tags173654 | ||||
| Node: test174171 | ||||
| Ref: #test174287 | ||||
| Node: About add-on commands175032 | ||||
| Ref: #about-add-on-commands175169 | ||||
| Node: JOURNAL FORMAT176302 | ||||
| Ref: #journal-format176430 | ||||
| Node: Transactions178650 | ||||
| Ref: #transactions178765 | ||||
| Node: Dates179782 | ||||
| Ref: #dates179898 | ||||
| Node: Simple dates179963 | ||||
| Ref: #simple-dates180083 | ||||
| Node: Secondary dates180590 | ||||
| Ref: #secondary-dates180738 | ||||
| Node: Posting dates182072 | ||||
| Ref: #posting-dates182195 | ||||
| Node: Status183564 | ||||
| Ref: #status183674 | ||||
| Node: Code185379 | ||||
| Ref: #code185491 | ||||
| Node: Description185722 | ||||
| Ref: #description185850 | ||||
| Node: Payee and note186168 | ||||
| Ref: #payee-and-note186276 | ||||
| Node: Comments186610 | ||||
| Ref: #comments186732 | ||||
| Node: Tags187925 | ||||
| Ref: #tags-1188036 | ||||
| Node: Postings189434 | ||||
| Ref: #postings189558 | ||||
| Node: Virtual postings190582 | ||||
| Ref: #virtual-postings190693 | ||||
| Node: Account names191995 | ||||
| Ref: #account-names192132 | ||||
| Node: Amounts192618 | ||||
| Ref: #amounts192755 | ||||
| Node: Decimal marks digit group marks193742 | ||||
| Ref: #decimal-marks-digit-group-marks193919 | ||||
| Node: Commodity194940 | ||||
| Ref: #commodity195129 | ||||
| Node: Directives influencing number parsing and display196079 | ||||
| Ref: #directives-influencing-number-parsing-and-display196340 | ||||
| Node: Commodity display style196832 | ||||
| Ref: #commodity-display-style197040 | ||||
| Node: Rounding199235 | ||||
| Ref: #rounding199355 | ||||
| Node: Transaction prices199765 | ||||
| Ref: #transaction-prices199931 | ||||
| Node: Lot prices lot dates202361 | ||||
| Ref: #lot-prices-lot-dates202544 | ||||
| Node: Balance assertions203031 | ||||
| Ref: #balance-assertions203209 | ||||
| Node: Assertions and ordering204239 | ||||
| Ref: #assertions-and-ordering204421 | ||||
| Node: Assertions and included files205118 | ||||
| Ref: #assertions-and-included-files205355 | ||||
| Node: Assertions and multiple -f options205686 | ||||
| Ref: #assertions-and-multiple--f-options205936 | ||||
| Node: Assertions and commodities206067 | ||||
| Ref: #assertions-and-commodities206293 | ||||
| Node: Assertions and prices207448 | ||||
| Ref: #assertions-and-prices207656 | ||||
| Node: Assertions and subaccounts208097 | ||||
| Ref: #assertions-and-subaccounts208320 | ||||
| Node: Assertions and virtual postings208644 | ||||
| Ref: #assertions-and-virtual-postings208880 | ||||
| Node: Assertions and precision209021 | ||||
| Ref: #assertions-and-precision209208 | ||||
| Node: Balance assignments209473 | ||||
| Ref: #balance-assignments209643 | ||||
| Node: Balance assignments and prices210806 | ||||
| Ref: #balance-assignments-and-prices210972 | ||||
| Node: Directives211198 | ||||
| Ref: #directives211361 | ||||
| Node: Directives and multiple files217104 | ||||
| Ref: #directives-and-multiple-files217300 | ||||
| Node: Comment blocks217962 | ||||
| Ref: #comment-blocks218139 | ||||
| Node: Including other files218314 | ||||
| Ref: #including-other-files218488 | ||||
| Node: Default year219412 | ||||
| Ref: #default-year219570 | ||||
| Node: Declaring payees219977 | ||||
| Ref: #declaring-payees220148 | ||||
| Node: Declaring the decimal mark220393 | ||||
| Ref: #declaring-the-decimal-mark220593 | ||||
| Node: Declaring commodities220991 | ||||
| Ref: #declaring-commodities221182 | ||||
| Node: Commodity error checking223696 | ||||
| Ref: #commodity-error-checking223846 | ||||
| Node: Default commodity224102 | ||||
| Ref: #default-commodity224282 | ||||
| Node: Declaring market prices225156 | ||||
| Ref: #declaring-market-prices225345 | ||||
| Node: Declaring accounts226157 | ||||
| Ref: #declaring-accounts226337 | ||||
| Node: Account error checking227544 | ||||
| Ref: #account-error-checking227710 | ||||
| Node: Account comments228887 | ||||
| Ref: #account-comments229071 | ||||
| Node: Account subdirectives229497 | ||||
| Ref: #account-subdirectives229682 | ||||
| Node: Account types229997 | ||||
| Ref: #account-types230171 | ||||
| Node: Declaring account types230828 | ||||
| Ref: #declaring-account-types231007 | ||||
| Node: Auto-detected account types232059 | ||||
| Ref: #auto-detected-account-types232246 | ||||
| Node: Account display order234258 | ||||
| Ref: #account-display-order234418 | ||||
| Node: Rewriting accounts235569 | ||||
| Ref: #rewriting-accounts235748 | ||||
| Node: Basic aliases236507 | ||||
| Ref: #basic-aliases236643 | ||||
| Node: Regex aliases237385 | ||||
| Ref: #regex-aliases237547 | ||||
| Node: Combining aliases238267 | ||||
| Ref: #combining-aliases238450 | ||||
| Node: Aliases and multiple files239727 | ||||
| Ref: #aliases-and-multiple-files239926 | ||||
| Node: end aliases240507 | ||||
| Ref: #end-aliases240654 | ||||
| Node: Default parent account240756 | ||||
| Ref: #default-parent-account240946 | ||||
| Node: Periodic transactions241830 | ||||
| Ref: #periodic-transactions242013 | ||||
| Node: Periodic rule syntax243930 | ||||
| Ref: #periodic-rule-syntax244130 | ||||
| Node: Two spaces between period expression and description!244833 | ||||
| Ref: #two-spaces-between-period-expression-and-description245146 | ||||
| Node: Forecasting with periodic transactions245831 | ||||
| Ref: #forecasting-with-periodic-transactions246130 | ||||
| Node: Budgeting with periodic transactions248898 | ||||
| Ref: #budgeting-with-periodic-transactions249131 | ||||
| Node: Auto postings249538 | ||||
| Ref: #auto-postings249674 | ||||
| Node: Auto postings and multiple files251857 | ||||
| Ref: #auto-postings-and-multiple-files252055 | ||||
| Node: Auto postings and dates252263 | ||||
| Ref: #auto-postings-and-dates252531 | ||||
| Node: Auto postings and transaction balancing / inferred amounts / balance assertions252706 | ||||
| Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions253052 | ||||
| Node: Auto posting tags253558 | ||||
| Ref: #auto-posting-tags253767 | ||||
| Node: CSV FORMAT254404 | ||||
| Ref: #csv-format254532 | ||||
| Node: Examples257156 | ||||
| Ref: #examples257259 | ||||
| Node: Basic257466 | ||||
| Ref: #basic257568 | ||||
| Node: Bank of Ireland258112 | ||||
| Ref: #bank-of-ireland258249 | ||||
| Node: Amazon259714 | ||||
| Ref: #amazon259834 | ||||
| Node: Paypal261555 | ||||
| Ref: #paypal261651 | ||||
| Node: CSV rules269299 | ||||
| Ref: #csv-rules269417 | ||||
| Node: skip269750 | ||||
| Ref: #skip269850 | ||||
| Node: fields list270222 | ||||
| Ref: #fields-list270361 | ||||
| Node: field assignment271866 | ||||
| Ref: #field-assignment272018 | ||||
| Node: Field names273050 | ||||
| Ref: #field-names273190 | ||||
| Node: date field273569 | ||||
| Ref: #date-field273689 | ||||
| Node: date2 field273737 | ||||
| Ref: #date2-field273880 | ||||
| Node: status field273936 | ||||
| Ref: #status-field274081 | ||||
| Node: code field274130 | ||||
| Ref: #code-field274277 | ||||
| Node: description field274322 | ||||
| Ref: #description-field274484 | ||||
| Node: comment field274543 | ||||
| Ref: #comment-field274700 | ||||
| Node: account field274999 | ||||
| Ref: #account-field275151 | ||||
| Node: amount field275725 | ||||
| Ref: #amount-field275876 | ||||
| Node: currency field277114 | ||||
| Ref: #currency-field277269 | ||||
| Node: balance field277525 | ||||
| Ref: #balance-field277659 | ||||
| Node: separator278031 | ||||
| Ref: #separator278163 | ||||
| Node: if block278705 | ||||
| Ref: #if-block278832 | ||||
| Node: Matching the whole record279230 | ||||
| Ref: #matching-the-whole-record279407 | ||||
| Node: Matching individual fields280210 | ||||
| Ref: #matching-individual-fields280416 | ||||
| Node: Combining matchers280640 | ||||
| Ref: #combining-matchers280838 | ||||
| Node: Rules applied on successful match281152 | ||||
| Ref: #rules-applied-on-successful-match281345 | ||||
| Node: if table282002 | ||||
| Ref: #if-table282123 | ||||
| Node: end283859 | ||||
| Ref: #end283973 | ||||
| Node: date-format284197 | ||||
| Ref: #date-format284331 | ||||
| Node: decimal-mark285328 | ||||
| Ref: #decimal-mark285475 | ||||
| Node: newest-first285812 | ||||
| Ref: #newest-first285955 | ||||
| Node: include286638 | ||||
| Ref: #include286771 | ||||
| Node: balance-type287213 | ||||
| Ref: #balance-type287335 | ||||
| Node: Tips288035 | ||||
| Ref: #tips288126 | ||||
| Node: Rapid feedback288425 | ||||
| Ref: #rapid-feedback288544 | ||||
| Node: Valid CSV288995 | ||||
| Ref: #valid-csv289127 | ||||
| Node: File Extension289319 | ||||
| Ref: #file-extension289473 | ||||
| Node: Reading multiple CSV files289902 | ||||
| Ref: #reading-multiple-csv-files290089 | ||||
| Node: Valid transactions290329 | ||||
| Ref: #valid-transactions290509 | ||||
| Node: Deduplicating importing291137 | ||||
| Ref: #deduplicating-importing291318 | ||||
| Node: Setting amounts292350 | ||||
| Ref: #setting-amounts292507 | ||||
| Node: Amount signs294948 | ||||
| Ref: #amount-signs295102 | ||||
| Node: Setting currency/commodity295789 | ||||
| Ref: #setting-currencycommodity295977 | ||||
| Node: Amount decimal places297157 | ||||
| Ref: #amount-decimal-places297349 | ||||
| Node: Referencing other fields297661 | ||||
| Ref: #referencing-other-fields297860 | ||||
| Node: How CSV rules are evaluated298758 | ||||
| Ref: #how-csv-rules-are-evaluated298933 | ||||
| Node: TIMECLOCK FORMAT300382 | ||||
| Ref: #timeclock-format300522 | ||||
| Node: TIMEDOT FORMAT302590 | ||||
| Ref: #timedot-format302728 | ||||
| Node: COMMON TASKS307287 | ||||
| Ref: #common-tasks307416 | ||||
| Node: Getting help307823 | ||||
| Ref: #getting-help307957 | ||||
| Node: Constructing command lines308508 | ||||
| Ref: #constructing-command-lines308702 | ||||
| Node: Starting a journal file309401 | ||||
| Ref: #starting-a-journal-file309601 | ||||
| Node: Setting opening balances310788 | ||||
| Ref: #setting-opening-balances310986 | ||||
| Node: Recording transactions314119 | ||||
| Ref: #recording-transactions314301 | ||||
| Node: Reconciling314858 | ||||
| Ref: #reconciling315003 | ||||
| Node: Reporting317248 | ||||
| Ref: #reporting317390 | ||||
| Node: Migrating to a new file321310 | ||||
| Ref: #migrating-to-a-new-file321460 | ||||
| Node: LIMITATIONS321758 | ||||
| Ref: #limitations321886 | ||||
| Node: TROUBLESHOOTING322627 | ||||
| Ref: #troubleshooting322742 | ||||
|  | ||||
| End Tag Table | ||||
|  | ||||
							
								
								
									
										2298
									
								
								hledger/hledger.txt
									
									
									
									
									
								
							
							
						
						
									
										2298
									
								
								hledger/hledger.txt
									
									
									
									
									
								
							
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							
		Loading…
	
		Reference in New Issue
	
	Block a user