cli: clearer command-line help for --date2 (fixes #604)
This commit is contained in:
		
							parent
							
								
									e0d9efeb86
								
							
						
					
					
						commit
						d8696c5ea0
					
				| @ -127,7 +127,7 @@ m4_define({{_reportingoptions_}}, {{ | ||||
| : set start date, end date, and/or reporting interval all at once (overrides the flags above) | ||||
| 
 | ||||
| `--date2` | ||||
| : show, and match with -b/-e/-p/date:, secondary dates instead | ||||
| : match the secondary date instead (see command help for other effects) | ||||
| 
 | ||||
| `-U --unmarked` | ||||
| : include only unmarked postings/txns (can combine with -P or -C) | ||||
|  | ||||
| @ -142,7 +142,7 @@ set start date, end date, and/or reporting interval all at once | ||||
| .RE | ||||
| .TP | ||||
| .B \f[C]\-\-date2\f[] | ||||
| show, and match with \-b/\-e/\-p/date:, secondary dates instead | ||||
| match the secondary date instead (see command help for other effects) | ||||
| .RS | ||||
| .RE | ||||
| .TP | ||||
|  | ||||
| @ -103,7 +103,8 @@ the data. | ||||
|      (overrides the flags above) | ||||
| '--date2' | ||||
| 
 | ||||
|      show, and match with -b/-e/-p/date:, secondary dates instead | ||||
|      match the secondary date instead (see command help for other | ||||
|      effects) | ||||
| '-U --unmarked' | ||||
| 
 | ||||
|      include only unmarked postings/txns (can combine with -P or -C) | ||||
| @ -357,17 +358,17 @@ Tag Table: | ||||
| Node: Top73 | ||||
| Node: OPTIONS831 | ||||
| Ref: #options930 | ||||
| Node: KEYS3465 | ||||
| Ref: #keys3562 | ||||
| Node: SCREENS6358 | ||||
| Ref: #screens6445 | ||||
| Node: Accounts screen6535 | ||||
| Ref: #accounts-screen6665 | ||||
| Node: Register screen8895 | ||||
| Ref: #register-screen9052 | ||||
| Node: Transaction screen11126 | ||||
| Ref: #transaction-screen11286 | ||||
| Node: Error screen12156 | ||||
| Ref: #error-screen12280 | ||||
| Node: KEYS3479 | ||||
| Ref: #keys3576 | ||||
| Node: SCREENS6372 | ||||
| Ref: #screens6459 | ||||
| Node: Accounts screen6549 | ||||
| Ref: #accounts-screen6679 | ||||
| Node: Register screen8909 | ||||
| Ref: #register-screen9066 | ||||
| Node: Transaction screen11140 | ||||
| Ref: #transaction-screen11300 | ||||
| Node: Error screen12170 | ||||
| Ref: #error-screen12294 | ||||
|  | ||||
| End Tag Table | ||||
|  | ||||
| @ -99,7 +99,8 @@ OPTIONS | ||||
|               (overrides the flags above) | ||||
| 
 | ||||
|        --date2 | ||||
|               show, and match with -b/-e/-p/date:, secondary dates instead | ||||
|               match the secondary date instead (see  command  help  for  other | ||||
|               effects) | ||||
| 
 | ||||
|        -U --unmarked | ||||
|               include only unmarked postings/txns (can combine with -P or -C) | ||||
| @ -120,11 +121,11 @@ OPTIONS | ||||
|               show items with zero amount, normally hidden | ||||
| 
 | ||||
|        -B --cost | ||||
|               convert amounts to their cost at  transaction  time  (using  the | ||||
|               convert  amounts  to  their  cost at transaction time (using the | ||||
|               transaction price, if any) | ||||
| 
 | ||||
|        -V --value | ||||
|               convert  amounts  to  their  market value on the report end date | ||||
|               convert amounts to their market value on  the  report  end  date | ||||
|               (using the most recent applicable market price, if any) | ||||
| 
 | ||||
|        hledger help options: | ||||
| @ -139,56 +140,56 @@ OPTIONS | ||||
|               show debug output (levels 1-9, default: 1) | ||||
| 
 | ||||
| KEYS | ||||
|        ? shows a help dialog listing all keys.  (Some of these also appear  in | ||||
|        ?  shows a help dialog listing all keys.  (Some of these also appear in | ||||
|        the quick help at the bottom of each screen.) Press ? again (or ESCAPE, | ||||
|        or LEFT) to close it.  The following keys work on most screens: | ||||
| 
 | ||||
|        The cursor keys navigate: right (or enter) goes deeper, left returns to | ||||
|        the  previous  screen,  up/down/page up/page down/home/end  move up and | ||||
|        down   through   lists.     Vi-style    (h/j/k/l)    and    Emacs-style | ||||
|        the previous screen,  up/down/page up/page down/home/end  move  up  and | ||||
|        down    through    lists.     Vi-style    (h/j/k/l)   and   Emacs-style | ||||
|        (CTRL-p/CTRL-n/CTRL-f/CTRL-b) movement keys are also supported.  A tip: | ||||
|        movement speed is limited by your keyboard repeat rate, to move  faster | ||||
|        you  may  want to adjust it.  (If you're on a mac, the Karabiner app is | ||||
|        movement  speed is limited by your keyboard repeat rate, to move faster | ||||
|        you may want to adjust it.  (If you're on a mac, the Karabiner  app  is | ||||
|        one way to do that.) | ||||
| 
 | ||||
|        With shift pressed, the cursor keys adjust the report period,  limiting | ||||
|        the   transactions   to   be   shown   (by  default,  all  are  shown). | ||||
|        shift-down/up steps downward and upward through these  standard  report | ||||
|        With  shift pressed, the cursor keys adjust the report period, limiting | ||||
|        the  transactions  to  be  shown   (by   default,   all   are   shown). | ||||
|        shift-down/up  steps  downward and upward through these standard report | ||||
|        period   durations:   year,   quarter,   month,   week,   day.    Then, | ||||
|        shift-left/right moves to the previous/next period.  t sets the  report | ||||
|        period  to  today.   With  the --watch option, when viewing a "current" | ||||
|        period (the current day, week, month, quarter,  or  year),  the  period | ||||
|        will  move automatically to track the current date.  To set a non-stan- | ||||
|        shift-left/right  moves to the previous/next period.  t sets the report | ||||
|        period to today.  With the --watch option,  when  viewing  a  "current" | ||||
|        period  (the  current  day,  week, month, quarter, or year), the period | ||||
|        will move automatically to track the current date.  To set a  non-stan- | ||||
|        dard period, you can use / and a date: query. | ||||
| 
 | ||||
|        / lets you set a general filter query limiting the  data  shown,  using | ||||
|        the  same query terms as in hledger and hledger-web.  While editing the | ||||
|        query, you can use CTRL-a/e/d/k, BS, cursor keys; press  ENTER  to  set | ||||
|        /  lets  you  set a general filter query limiting the data shown, using | ||||
|        the same query terms as in hledger and hledger-web.  While editing  the | ||||
|        query,  you  can  use CTRL-a/e/d/k, BS, cursor keys; press ENTER to set | ||||
|        it, or ESCAPEto cancel.  There are also keys for quickly adjusting some | ||||
|        common filters like account depth and transaction status  (see  below). | ||||
|        common  filters  like account depth and transaction status (see below). | ||||
|        BACKSPACE or DELETE removes all filters, showing all transactions. | ||||
| 
 | ||||
|        ESCAPE  removes  all  filters and jumps back to the top screen.  Or, it | ||||
|        ESCAPE removes all filters and jumps back to the top  screen.   Or,  it | ||||
|        cancels a minibuffer edit or help dialog in progress. | ||||
| 
 | ||||
|        CTRL-l redraws the screen and centers the selection if possible (selec- | ||||
|        tions  near  the top won't be centered, since we don't scroll above the | ||||
|        tions near the top won't be centered, since we don't scroll  above  the | ||||
|        top). | ||||
| 
 | ||||
|        g reloads from the data file(s) and updates the current screen and  any | ||||
|        previous  screens.   (With  large  files, this could cause a noticeable | ||||
|        g  reloads from the data file(s) and updates the current screen and any | ||||
|        previous screens.  (With large files, this  could  cause  a  noticeable | ||||
|        pause.) | ||||
| 
 | ||||
|        I toggles balance assertion  checking.   Disabling  balance  assertions | ||||
|        I  toggles  balance  assertion  checking.  Disabling balance assertions | ||||
|        temporarily can be useful for troubleshooting. | ||||
| 
 | ||||
|        a  runs  command-line  hledger's  add  command, and reloads the updated | ||||
|        a runs command-line hledger's add  command,  and  reloads  the  updated | ||||
|        file.  This allows some basic data entry. | ||||
| 
 | ||||
|        E  runs  $HLEDGER_UI_EDITOR,  or   $EDITOR,   or   a   default   (emac- | ||||
|        E   runs   $HLEDGER_UI_EDITOR,   or   $EDITOR,   or  a  default  (emac- | ||||
|        sclient -a "" -nw) on the journal file.  With some editors (emacs, vi), | ||||
|        the cursor will be positioned at the current transaction  when  invoked | ||||
|        from  the  register  and transaction screens, and at the error location | ||||
|        the  cursor  will be positioned at the current transaction when invoked | ||||
|        from the register and transaction screens, and at  the  error  location | ||||
|        (if possible) when invoked from the error screen. | ||||
| 
 | ||||
|        q quits the application. | ||||
| @ -197,44 +198,44 @@ KEYS | ||||
| 
 | ||||
| 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 normally indented to show the hierarchy (tree  mode). | ||||
|        Account  names are normally indented to show the hierarchy (tree mode). | ||||
|        To see less detail, set a depth limit by pressing a number key, 1 to 9. | ||||
|        0 shows even less detail, collapsing all accounts to a single total.  - | ||||
|        and  +  (or  =)  decrease  and increase the depth limit.  To remove the | ||||
|        depth limit, set it higher than the maximum  account  depth,  or  press | ||||
|        and + (or =) decrease and increase the  depth  limit.   To  remove  the | ||||
|        depth  limit,  set  it  higher than the maximum account depth, or press | ||||
|        ESCAPE. | ||||
| 
 | ||||
|        F  toggles  flat mode, in which accounts are shown as a flat list, with | ||||
|        their full names.  In this mode, account balances exclude  subaccounts, | ||||
|        except  for accounts at the depth limit (as with hledger's balance com- | ||||
|        F toggles flat mode, in which accounts are shown as a flat  list,  with | ||||
|        their  full names.  In this mode, account balances exclude subaccounts, | ||||
|        except for accounts at the depth limit (as with hledger's balance  com- | ||||
|        mand). | ||||
| 
 | ||||
|        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. | ||||
| @ -243,65 +244,65 @@ 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. | ||||
| 
 | ||||
|        If the accounts screen was in  tree  mode,  the  register  screen  will | ||||
|        If  the  accounts  screen  was  in  tree mode, the register screen will | ||||
|        include transactions from both the current account and its subaccounts. | ||||
|        If the accounts screen  was  in  flat  mode,  and  a  non-depth-clipped | ||||
|        account  was  selected,  the  register screen will exclude transactions | ||||
|        If  the  accounts  screen  was  in  flat  mode, and a non-depth-clipped | ||||
|        account was selected, the register  screen  will  exclude  transactions | ||||
|        from subaccounts.  In other words, the register always shows the trans- | ||||
|        actions  responsible  for  the  period  balance  shown  on the accounts | ||||
|        actions responsible for  the  period  balance  shown  on  the  accounts | ||||
|        screen.  As on the accounts screen, this can be toggled with F. | ||||
| 
 | ||||
|        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- | ||||
|        tions are  shown;  and  if  you  activate  all  three,  the  filter  is | ||||
|        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.)q | ||||
| 
 | ||||
|        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.) | ||||
| 
 | ||||
| @ -309,17 +310,17 @@ 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). | ||||
| 
 | ||||
| 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). | ||||
| @ -327,13 +328,13 @@ 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. | ||||
| @ -341,7 +342,7 @@ BUGS | ||||
| 
 | ||||
| 
 | ||||
| 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) | ||||
| 
 | ||||
| 
 | ||||
| @ -355,7 +356,7 @@ COPYRIGHT | ||||
| 
 | ||||
| 
 | ||||
| SEE ALSO | ||||
|        hledger(1),     hledger-ui(1),     hledger-web(1),      hledger-api(1), | ||||
|        hledger(1),      hledger-ui(1),     hledger-web(1),     hledger-api(1), | ||||
|        hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time- | ||||
|        dot(5), ledger(1) | ||||
| 
 | ||||
|  | ||||
| @ -198,7 +198,7 @@ set start date, end date, and/or reporting interval all at once | ||||
| .RE | ||||
| .TP | ||||
| .B \f[C]\-\-date2\f[] | ||||
| show, and match with \-b/\-e/\-p/date:, secondary dates instead | ||||
| match the secondary date instead (see command help for other effects) | ||||
| .RS | ||||
| .RE | ||||
| .TP | ||||
|  | ||||
| @ -148,7 +148,8 @@ options as shown above. | ||||
|      (overrides the flags above) | ||||
| '--date2' | ||||
| 
 | ||||
|      show, and match with -b/-e/-p/date:, secondary dates instead | ||||
|      match the secondary date instead (see command help for other | ||||
|      effects) | ||||
| '-U --unmarked' | ||||
| 
 | ||||
|      include only unmarked postings/txns (can combine with -P or -C) | ||||
|  | ||||
| @ -144,7 +144,8 @@ OPTIONS | ||||
|               (overrides the flags above) | ||||
| 
 | ||||
|        --date2 | ||||
|               show, and match with -b/-e/-p/date:, secondary dates instead | ||||
|               match  the  secondary  date  instead (see command help for other | ||||
|               effects) | ||||
| 
 | ||||
|        -U --unmarked | ||||
|               include only unmarked postings/txns (can combine with -P or -C) | ||||
| @ -165,11 +166,11 @@ OPTIONS | ||||
|               show items with zero amount, normally hidden | ||||
| 
 | ||||
|        -B --cost | ||||
|               convert  amounts  to  their  cost at transaction time (using the | ||||
|               convert amounts to their cost at  transaction  time  (using  the | ||||
|               transaction price, if any) | ||||
| 
 | ||||
|        -V --value | ||||
|               convert amounts to their market value on  the  report  end  date | ||||
|               convert  amounts  to  their  market value on the report end date | ||||
|               (using the most recent applicable market price, if any) | ||||
| 
 | ||||
|        hledger help options: | ||||
| @ -185,17 +186,17 @@ OPTIONS | ||||
| 
 | ||||
| ENVIRONMENT | ||||
|        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). | ||||
| 
 | ||||
| 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-web can't read from stdin). | ||||
| @ -209,7 +210,7 @@ BUGS | ||||
| 
 | ||||
| 
 | ||||
| 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) | ||||
| 
 | ||||
| 
 | ||||
| @ -223,7 +224,7 @@ COPYRIGHT | ||||
| 
 | ||||
| 
 | ||||
| SEE ALSO | ||||
|        hledger(1),     hledger-ui(1),     hledger-web(1),      hledger-api(1), | ||||
|        hledger(1),      hledger-ui(1),     hledger-web(1),     hledger-api(1), | ||||
|        hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time- | ||||
|        dot(5), ledger(1) | ||||
| 
 | ||||
|  | ||||
| @ -138,7 +138,7 @@ reportflags = [ | ||||
|  ,flagNone ["quarterly","Q"] (setboolopt "quarterly") "multiperiod/multicolumn report by quarter" | ||||
|  ,flagNone ["yearly","Y"]    (setboolopt "yearly") "multiperiod/multicolumn report by year" | ||||
|  ,flagReq  ["period","p"]    (\s opts -> Right $ setopt "period" s opts) "PERIODEXP" "set start date, end date, and/or report interval all at once (overrides the flags above)" | ||||
|  ,flagNone ["date2"]         (setboolopt "date2") "show, and make -b/-e/-p/date: match, secondary dates instead" | ||||
|  ,flagNone ["date2"]         (setboolopt "date2") "match the secondary date instead (see command help for other effects)" | ||||
| 
 | ||||
|  ,flagNone ["unmarked","U"]  (setboolopt "unmarked") "include only unmarked postings/txns (can combine with -P or -C)" | ||||
|  ,flagNone ["pending","P"]   (setboolopt "pending") "include only pending postings/txns" | ||||
|  | ||||
| @ -28,7 +28,7 @@ import Hledger.Cli.Add ( transactionsSimilarTo ) | ||||
| 
 | ||||
| 
 | ||||
| printmode = (defCommandMode $ ["print"] ++ aliases) { | ||||
|   modeHelp = "show transaction journal entries" `withAliases` aliases | ||||
|   modeHelp = "show transaction journal entries, sorted by date. With --date2, sort by secondary date instead." `withAliases` aliases | ||||
|  ,modeGroupFlags = Group { | ||||
|      groupUnnamed = [ | ||||
|         let matcharg = "STR" | ||||
|  | ||||
| @ -29,7 +29,7 @@ import Hledger.Cli.Utils | ||||
| 
 | ||||
| 
 | ||||
| registermode = (defCommandMode $ ["register"] ++ aliases) { | ||||
|   modeHelp = "show postings and running total" `withAliases` aliases | ||||
|   modeHelp = "show postings and running total. With --date2, show and sort by secondary date instead." `withAliases` aliases | ||||
|  ,modeGroupFlags = Group { | ||||
|      groupUnnamed = [ | ||||
|       flagNone ["cumulative"]         (\opts -> setboolopt "change" opts) | ||||
|  | ||||
| @ -253,7 +253,7 @@ set start date, end date, and/or reporting interval all at once | ||||
| .RE | ||||
| .TP | ||||
| .B \f[C]\-\-date2\f[] | ||||
| show, and match with \-b/\-e/\-p/date:, secondary dates instead | ||||
| match the secondary date instead (see command help for other effects) | ||||
| .RS | ||||
| .RE | ||||
| .TP | ||||
|  | ||||
| @ -203,7 +203,8 @@ different, like git.) | ||||
|      (overrides the flags above) | ||||
| '--date2' | ||||
| 
 | ||||
|      show, and match with -b/-e/-p/date:, secondary dates instead | ||||
|      match the secondary date instead (see command help for other | ||||
|      effects) | ||||
| '-U --unmarked' | ||||
| 
 | ||||
|      include only unmarked postings/txns (can combine with -P or -C) | ||||
| @ -2087,121 +2088,121 @@ Node: OPTIONS3640 | ||||
| Ref: #options3744 | ||||
| Node: General options4025 | ||||
| Ref: #general-options4152 | ||||
| Node: Command options6484 | ||||
| Ref: #command-options6637 | ||||
| Node: Command arguments7035 | ||||
| Ref: #command-arguments7195 | ||||
| Node: Special characters7316 | ||||
| Ref: #special-characters7474 | ||||
| Node: Input files8642 | ||||
| Ref: #input-files8780 | ||||
| Node: Smart dates10743 | ||||
| Ref: #smart-dates10886 | ||||
| Node: Report start & end date11865 | ||||
| Ref: #report-start-end-date12037 | ||||
| Node: Report intervals13103 | ||||
| Ref: #report-intervals13268 | ||||
| Node: Period expressions13669 | ||||
| Ref: #period-expressions13829 | ||||
| Node: Depth limiting16169 | ||||
| Ref: #depth-limiting16315 | ||||
| Node: Pivoting16516 | ||||
| Ref: #pivoting16636 | ||||
| Node: Cost18407 | ||||
| Ref: #cost18517 | ||||
| Node: Market value18635 | ||||
| Ref: #market-value18772 | ||||
| Node: Regular expressions20072 | ||||
| Ref: #regular-expressions20210 | ||||
| Node: QUERIES21571 | ||||
| Ref: #queries21675 | ||||
| Node: COMMANDS25340 | ||||
| Ref: #commands25454 | ||||
| Node: accounts26110 | ||||
| Ref: #accounts26210 | ||||
| Node: activity27192 | ||||
| Ref: #activity27304 | ||||
| Node: add27663 | ||||
| Ref: #add27764 | ||||
| Node: balance30422 | ||||
| Ref: #balance30535 | ||||
| Node: Flat mode33550 | ||||
| Ref: #flat-mode33677 | ||||
| Node: Depth limited balance reports34097 | ||||
| Ref: #depth-limited-balance-reports34300 | ||||
| Node: Multicolumn balance reports34720 | ||||
| Ref: #multicolumn-balance-reports34931 | ||||
| Node: Custom balance output39579 | ||||
| Ref: #custom-balance-output39763 | ||||
| Node: Colour support41856 | ||||
| Ref: #colour-support42017 | ||||
| Node: Output destination42190 | ||||
| Ref: #output-destination42348 | ||||
| Node: CSV output42618 | ||||
| Ref: #csv-output42737 | ||||
| Node: balancesheet43134 | ||||
| Ref: #balancesheet43262 | ||||
| Node: cashflow45169 | ||||
| Ref: #cashflow45286 | ||||
| Node: help47154 | ||||
| Ref: #help47266 | ||||
| Node: incomestatement48340 | ||||
| Ref: #incomestatement48471 | ||||
| Node: print50363 | ||||
| Ref: #print50478 | ||||
| Node: register54234 | ||||
| Ref: #register54347 | ||||
| Node: Custom register output58843 | ||||
| Ref: #custom-register-output58974 | ||||
| Node: stats60271 | ||||
| Ref: #stats60377 | ||||
| Node: test61258 | ||||
| Ref: #test61345 | ||||
| Node: ADD-ON COMMANDS61713 | ||||
| Ref: #add-on-commands61825 | ||||
| Node: Official add-ons63112 | ||||
| Ref: #official-add-ons63254 | ||||
| Node: api63341 | ||||
| Ref: #api63432 | ||||
| Node: ui63484 | ||||
| Ref: #ui63585 | ||||
| Node: web63643 | ||||
| Ref: #web63734 | ||||
| Node: Third party add-ons63780 | ||||
| Ref: #third-party-add-ons63957 | ||||
| Node: diff64092 | ||||
| Ref: #diff64191 | ||||
| Node: iadd64290 | ||||
| Ref: #iadd64406 | ||||
| Node: interest64489 | ||||
| Ref: #interest64612 | ||||
| Node: irr64707 | ||||
| Ref: #irr64807 | ||||
| Node: Experimental add-ons64885 | ||||
| Ref: #experimental-add-ons65039 | ||||
| Node: autosync65441 | ||||
| Ref: #autosync65555 | ||||
| Node: budget65794 | ||||
| Ref: #budget65918 | ||||
| Node: chart65984 | ||||
| Ref: #chart66103 | ||||
| Node: check66174 | ||||
| Ref: #check66298 | ||||
| Node: check-dates66365 | ||||
| Ref: #check-dates66507 | ||||
| Node: check-dupes66580 | ||||
| Ref: #check-dupes66723 | ||||
| Node: equity66800 | ||||
| Ref: #equity66928 | ||||
| Node: prices67047 | ||||
| Ref: #prices67176 | ||||
| Node: print-unique67231 | ||||
| Ref: #print-unique67380 | ||||
| Node: register-match67473 | ||||
| Ref: #register-match67629 | ||||
| Node: rewrite67727 | ||||
| Ref: #rewrite67861 | ||||
| Node: tags67939 | ||||
| Ref: #tags68044 | ||||
| Node: Command options6498 | ||||
| Ref: #command-options6651 | ||||
| Node: Command arguments7049 | ||||
| Ref: #command-arguments7209 | ||||
| Node: Special characters7330 | ||||
| Ref: #special-characters7488 | ||||
| Node: Input files8656 | ||||
| Ref: #input-files8794 | ||||
| Node: Smart dates10757 | ||||
| Ref: #smart-dates10900 | ||||
| Node: Report start & end date11879 | ||||
| Ref: #report-start-end-date12051 | ||||
| Node: Report intervals13117 | ||||
| Ref: #report-intervals13282 | ||||
| Node: Period expressions13683 | ||||
| Ref: #period-expressions13843 | ||||
| Node: Depth limiting16183 | ||||
| Ref: #depth-limiting16329 | ||||
| Node: Pivoting16530 | ||||
| Ref: #pivoting16650 | ||||
| Node: Cost18421 | ||||
| Ref: #cost18531 | ||||
| Node: Market value18649 | ||||
| Ref: #market-value18786 | ||||
| Node: Regular expressions20086 | ||||
| Ref: #regular-expressions20224 | ||||
| Node: QUERIES21585 | ||||
| Ref: #queries21689 | ||||
| Node: COMMANDS25354 | ||||
| Ref: #commands25468 | ||||
| Node: accounts26124 | ||||
| Ref: #accounts26224 | ||||
| Node: activity27206 | ||||
| Ref: #activity27318 | ||||
| Node: add27677 | ||||
| Ref: #add27778 | ||||
| Node: balance30436 | ||||
| Ref: #balance30549 | ||||
| Node: Flat mode33564 | ||||
| Ref: #flat-mode33691 | ||||
| Node: Depth limited balance reports34111 | ||||
| Ref: #depth-limited-balance-reports34314 | ||||
| Node: Multicolumn balance reports34734 | ||||
| Ref: #multicolumn-balance-reports34945 | ||||
| Node: Custom balance output39593 | ||||
| Ref: #custom-balance-output39777 | ||||
| Node: Colour support41870 | ||||
| Ref: #colour-support42031 | ||||
| Node: Output destination42204 | ||||
| Ref: #output-destination42362 | ||||
| Node: CSV output42632 | ||||
| Ref: #csv-output42751 | ||||
| Node: balancesheet43148 | ||||
| Ref: #balancesheet43276 | ||||
| Node: cashflow45183 | ||||
| Ref: #cashflow45300 | ||||
| Node: help47168 | ||||
| Ref: #help47280 | ||||
| Node: incomestatement48354 | ||||
| Ref: #incomestatement48485 | ||||
| Node: print50377 | ||||
| Ref: #print50492 | ||||
| Node: register54248 | ||||
| Ref: #register54361 | ||||
| Node: Custom register output58857 | ||||
| Ref: #custom-register-output58988 | ||||
| Node: stats60285 | ||||
| Ref: #stats60391 | ||||
| Node: test61272 | ||||
| Ref: #test61359 | ||||
| Node: ADD-ON COMMANDS61727 | ||||
| Ref: #add-on-commands61839 | ||||
| Node: Official add-ons63126 | ||||
| Ref: #official-add-ons63268 | ||||
| Node: api63355 | ||||
| Ref: #api63446 | ||||
| Node: ui63498 | ||||
| Ref: #ui63599 | ||||
| Node: web63657 | ||||
| Ref: #web63748 | ||||
| Node: Third party add-ons63794 | ||||
| Ref: #third-party-add-ons63971 | ||||
| Node: diff64106 | ||||
| Ref: #diff64205 | ||||
| Node: iadd64304 | ||||
| Ref: #iadd64420 | ||||
| Node: interest64503 | ||||
| Ref: #interest64626 | ||||
| Node: irr64721 | ||||
| Ref: #irr64821 | ||||
| Node: Experimental add-ons64899 | ||||
| Ref: #experimental-add-ons65053 | ||||
| Node: autosync65455 | ||||
| Ref: #autosync65569 | ||||
| Node: budget65808 | ||||
| Ref: #budget65932 | ||||
| Node: chart65998 | ||||
| Ref: #chart66117 | ||||
| Node: check66188 | ||||
| Ref: #check66312 | ||||
| Node: check-dates66379 | ||||
| Ref: #check-dates66521 | ||||
| Node: check-dupes66594 | ||||
| Ref: #check-dupes66737 | ||||
| Node: equity66814 | ||||
| Ref: #equity66942 | ||||
| Node: prices67061 | ||||
| Ref: #prices67190 | ||||
| Node: print-unique67245 | ||||
| Ref: #print-unique67394 | ||||
| Node: register-match67487 | ||||
| Ref: #register-match67643 | ||||
| Node: rewrite67741 | ||||
| Ref: #rewrite67875 | ||||
| Node: tags67953 | ||||
| Ref: #tags68058 | ||||
|  | ||||
| End Tag Table | ||||
|  | ||||
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							
		Loading…
	
		Reference in New Issue
	
	Block a user