App::JobLog::Command::edit - edit the log
version 1.035
houghton@NorthernSpy:~$ job edit --help job <command> job edit [--validate] [-c <date and time>] -c --close-task --close add a "DONE" line to the log at the specified moment -v --validate check log for errors, commenting out any found --help this usage screen houghton@NorthernSpy:~$ job today Monday, 7 March, 2011 8:01 am - ongoing 4.56 bar, foo something to add; and still more TOTAL HOURS 4.56 bar 4.56 foo 4.56 houghton@NorthernSpy:~$ job e --close today at 8:05 houghton@NorthernSpy:~$ job t Monday, 7 March, 2011 8:01 - 8:05 am 0.05 bar, foo something to add; and still more TOTAL HOURS 0.05 bar 0.05 foo 0.05 houghton@NorthernSpy:~$ job e
A text editor opens up displaying the log. Appropriate edits are performed. The user saves and quits.
saved backup log in /home/houghton/.joblog/log.bak log is valid houghton@NorthernSpy:~$
Generally you won't have need to modify the log except through App::JobLog::Command::add, App::JobLog::Command::done, App::JobLog::Command::modify, or App::JobLog::Command::resume. There will sometimes be glitches, though: you will be away from the log when you do something or you will quit for the day without having punched out with App::JobLog::Command::done. This is when you need App::JobLog::Command::edit.
Most of the time you will simply need to add a missing DONE line -- the --close option. For this you need no text editor external to App::JobLog itself. If you need a full function editor you will need to define the editor parameter using App::JobLog::Command::configure. Then invoke this command without any options or arguments.
When you invoke the editor, App::JobLog reviews the log after you save, commenting out ill-formed lines and emitting warnings.
App::JobLog::Command::modify
David F. Houghton <dfhoughton@gmail.com>
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.
To install App::JobLog, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::JobLog
CPAN shell
perl -MCPAN -e shell install App::JobLog
For more information on module installation, please visit the detailed CPAN module installation guide.