docs: time logging, misc updates
This commit is contained in:
		
							parent
							
								
									4e7408cac7
								
							
						
					
					
						commit
						ec93c555be
					
				
							
								
								
									
										23
									
								
								MANUAL.md
									
									
									
									
									
								
							
							
						
						
									
										23
									
								
								MANUAL.md
									
									
									
									
									
								
							@ -484,7 +484,7 @@ The add command tries to be helpful, providing:
 | 
				
			|||||||
  key will auto-complete as far as possible, or list the available
 | 
					  key will auto-complete as far as possible, or list the available
 | 
				
			||||||
  options.
 | 
					  options.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Default commodity awareness: if the journal specifies a
 | 
					- Default commodity awareness: if the journal has a
 | 
				
			||||||
  [default commodity directive](#default-commodity), that will be applied
 | 
					  [default commodity directive](#default-commodity), that will be applied
 | 
				
			||||||
  to any bare numbers entered.
 | 
					  to any bare numbers entered.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -1011,8 +1011,8 @@ in the account tree, down to level N. See the [balance](#balance),
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
### Timelog reporting
 | 
					### Timelog reporting
 | 
				
			||||||
 | 
					
 | 
				
			||||||
hledger can also read time log files in timeclock.el's format, containing
 | 
					hledger can also read time log files in (a subset of) timeclock.el's
 | 
				
			||||||
clock-in and clock-out entries like so:
 | 
					format, containing clock-in and clock-out entries like so:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    i 2009/03/31 22:21:45 projects:A
 | 
					    i 2009/03/31 22:21:45 projects:A
 | 
				
			||||||
    o 2009/04/01 02:00:34
 | 
					    o 2009/04/01 02:00:34
 | 
				
			||||||
@ -1035,18 +1035,18 @@ download and some queries to try:
 | 
				
			|||||||
    hledger -f sample.timelog register -p 2009/3                    # sessions in march 2009
 | 
					    hledger -f sample.timelog register -p 2009/3                    # sessions in march 2009
 | 
				
			||||||
    hledger -f sample.timelog register -p weekly --depth 1 --empty  # time summary by week
 | 
					    hledger -f sample.timelog register -p weekly --depth 1 --empty  # time summary by week
 | 
				
			||||||
 | 
					
 | 
				
			||||||
To record time logs, ie to clock in and clock out, you could:
 | 
					To generate time logs, ie to clock in and clock out, you could:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- use emacs and
 | 
					- use emacs and the built-in timeclock.el, or
 | 
				
			||||||
  [timeclock-x.el](http://www.emacswiki.org/emacs/timeclock-x.el) and perhaps
 | 
					  the extended [timeclock-x.el](http://www.emacswiki.org/emacs/timeclock-x.el)
 | 
				
			||||||
  [ledgerutils.el](http://joyful.com/repos/ledgertools/ledgerutils.el)
 | 
					  and perhaps the extras in [ledgerutils.el](http://joyful.com/repos/ledgertools/ledgerutils.el)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- at the command line, use these bash aliases:
 | 
					- at the command line, use these bash aliases:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
        alias ti="echo i `date '+%Y-%m-%d %H:%M:%S'` \$* >>$TIMELOG"
 | 
					        alias ti="echo i `date '+%Y-%m-%d %H:%M:%S'` \$* >>$TIMELOG"
 | 
				
			||||||
        alias to="echo o `date '+%Y-%m-%d %H:%M:%S'` >>$TIMELOG"
 | 
					        alias to="echo o `date '+%Y-%m-%d %H:%M:%S'` >>$TIMELOG"
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- or the old "ti" and "to" scripts in the [c++ ledger 2.x repository](https://github.com/jwiegley/ledger/tree/maint/scripts).
 | 
					- or use the old `ti` and `to` scripts in the [c++ ledger 2.x repository](https://github.com/jwiegley/ledger/tree/maint/scripts).
 | 
				
			||||||
  These rely on a "timeclock" executable which I think is just the ledger 2 executable renamed.
 | 
					  These rely on a "timeclock" executable which I think is just the ledger 2 executable renamed.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Custom output formats
 | 
					### Custom output formats
 | 
				
			||||||
@ -1168,7 +1168,9 @@ Generally, it's easy to keep a journal file that works with both hledger
 | 
				
			|||||||
and c++ledger if you avoid these.  Occasionally you'll need to make small
 | 
					and c++ledger if you avoid these.  Occasionally you'll need to make small
 | 
				
			||||||
adjustments to restore compatibility for one or the other.
 | 
					adjustments to restore compatibility for one or the other.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
(See also [usage issues](#usage-issues))
 | 
					See also:
 | 
				
			||||||
 | 
					[other differences](#other-differences),
 | 
				
			||||||
 | 
					[usage issues](#usage-issues).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Features not supported
 | 
					### Features not supported
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -1263,6 +1265,9 @@ entries, and the following c++ ledger options and commands:
 | 
				
			|||||||
    display settings. ledger uses D only for commodity display settings
 | 
					    display settings. ledger uses D only for commodity display settings
 | 
				
			||||||
    and for the entry command.
 | 
					    and for the entry command.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					-   hledger generates a description for timelog sessions, instead of
 | 
				
			||||||
 | 
					    taking it from the clock-out entry
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Troubleshooting
 | 
					## Troubleshooting
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Installation issues
 | 
					### Installation issues
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
		Reference in New Issue
	
	Block a user