NAME

App::JobLog::Command::summary - show what you did during a particular period

VERSION

version 1.009

SYNOPSIS

houghton@NorthernSpy:~$ job summary --help
job <command>

job summary [-ciMmTtVW] [long options...] <date or date range>
	Use 'job help summary' to see full details.
	                                  
	-t --tag                            filter events to include only
	                                    those with given tags; multiple
	                                    tags may be specified
	-T --exclude-tag                    filter events to exclude those
	                                    with given tags; multiple tags
	                                    may be specified
	-m --match                          filter events to include only
	                                    those one of whose descriptions
	                                    matches the given regex; multiple
	                                    regexes may be specified
	-M --no-match                       filter events to include only
	                                    those one of whose descriptions
	                                    do not match the given regex;
	                                    multiple regexes may be specified
	-i --time                           consider only those portions of
	                                    events that overlap the given
	                                    time range
	--ma --mall --merge-all             glom all events into one synopsis
	--madj --merge-adjacent             merge contiguous events
	--mast --merge-adjacent-same-tags   merge contiguous,
	                                    identically-tagged events
	                                    (default)
	--mst --merge-same-tags             merge all identically tagged
	                                    events
	--msd --merge-same-day              merge all events in a given day
	--msdst --merge-same-day-same-tags  merge all events in a given day
	--nm --no-merge                     keep all events separate
	-V --no-vacation                    do not display vacation hours
	--no-date                           do not display a date before each
	                                    distinct day
	--no-time                           do not display event start and
	                                    end times
	--no-duration                       do not display event durations
	--no-tags                           do not display tags
	--no-description                    do not display event descriptions
	--no-totals                         do not display the footer
	                                    containing total hours worked,
	                                    etc.
	-c --columns                        limit the width of the report to
	                                    the specified number of columns; 
	                                    by default the width of the
	                                    terminal is automatically
	                                    detected and, if that fails, a
	                                    width of 76 is used
	-W --no-wrap                        do not wrap the text to fit
	                                    columns
	--help                              this usage screen
houghton@NorthernSpy:~$ job s this week
Sunday,  6 March, 2011
     7:36 - 7:37 pm  0.01  bar, foo  something to add; and still more                                                                                                  

Monday,  7 March
  8:01 am - ongoing  1.05  bar, foo  something to add; and still more                                                                                                  

  TOTAL HOURS 1.07
  bar         1.07
  foo         1.07
houghton@NorthernSpy:~$ job s this month
Tuesday,  1 March, 2011
     8:00 - 9:23 am  1.39  widgets   adding handling of simplified pdf docs                                                                                            

Friday,  4 March
     1:48 - 2:55 pm  1.11  widgets   trying to get Eclipse working properly again                                                                                      
     3:50 - 5:30 pm  1.66  widgets   figuring out why some files are really, really slow                                                                               

Sunday,  6 March
     7:36 - 7:37 pm  0.01  bar, foo  something to add; and still more                                                                                                  

Monday,  7 March
  8:01 am - ongoing  1.05  bar, foo  something to add; and still more                                                                                                  

  TOTAL HOURS 5.23
  bar         1.07
  foo         1.07
  widgets     4.16
houghton@NorthernSpy:~$ job s 2011/3/1
Tuesday,  1 March, 2011
  8:00 - 9:23 am  1.39  widgets  adding handling of simplified pdf docs                                                                                            

  TOTAL HOURS 1.39
  widgets     1.39
houghton@NorthernSpy:~$ job s Friday through today
Friday,  4 March, 2011
     1:48 - 2:55 pm  1.11  widgets   trying to get Eclipse working properly again                                                                                      
     3:50 - 5:30 pm  1.66  widgets   figuring out why some files are really, really slow                                                                               

Sunday,  6 March
     7:36 - 7:37 pm  0.01  bar, foo  something to add; and still more                                                                                                  

Monday,  7 March
  8:01 am - ongoing  1.06  bar, foo  something to add; and still more                                                                                                  

  TOTAL HOURS 3.84
  bar         1.07
  foo         1.07
  widgets     2.77
houghton@NorthernSpy:~$ job s --merge-same-tags Friday through today
  2.77  widgets   trying to get Eclipse working properly again; figuring out why some files are really, really slow                                   
  1.07  bar, foo  something to add; and still more                                                                                                    

  TOTAL HOURS 3.85
  bar         1.07
  foo         1.07
  widgets     2.77

DESCRIPTION

App::JobLog::Command::summary is the command that extracts pretty reports from the log. Its options are all concerned with filtering events and formatting the report.

SEE ALSO

App::JobLog::Command::today, App::JobLog::Command::last, App::JobLog::TimeGrammar

AUTHOR

David F. Houghton <dfhoughton@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by David F. Houghton.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.