caldis -- Calendar entries: display, maintain, email reminders about.
caldis --ascii-output-size=WIDTHxHEIGHT --begin-date=DATE --calendar-dir=DIRECTORY --date-format=STRING --end-date=DATE --graphic-output-size=WIDTHxHEIGHT --help --line-split={true,false} --mail-reminder[=EMAIL_ADDRESS] --number-days=INTEGER --output-type={ascii,gif} --output-file=FILE --output-size=WIDTHxHEIGHT --run-calendar[=COMMAND] --run-calendar-program=COMMAND --run-builtin-calendar[=EDITOR] --run-builtin-calendar-program=EDITOR --write-to-root[=COMMAND] --write-to-root-program[=COMMAND] --verbose[=INTEGER]
caldis reads calendar entries in xcalendar file format and writes them out as ASCII text or as a GIF. It allows you to specify the range of days to display and the dimensions of the output. It can also mail reminders about certain calendar entries if desired. I like to run it from cron at midnight each day and have it write its output to my root window, so I always have a current calendar in my background, it also mails me about those important birthdays that I dare not forget.
The size of the output in characters for the width and lines for the height. Only used for --output-type=ascii.
The day to start the calendar at.
The directory to read the xcalendar calendar entries from.
The format to write the date for each day in the calendar. See POD documentation for Date::Manip for more information.
The day to end the calendar at (can not use along with --number-days).
The size of the output in pixels. Used for any graphic --output-type, just GIF right now.
This message.
If set to true, fit as much text as possible into the available space. If false, display each seperate line up to N characters (N depends on the --output-size options) and then cut it off after that, this way a long line won't push all other lines out of the limited window space.
Mail reminders. If EMAIL_ADDRESS is not specified, it defaults to --mail-reminder-to, and if that is not specified it falls back to the LOGNAME environment variable. See Reminders By Mail for more.
Who to mail a reminder to if --mail-reminder is specified. Mainly for use in the RC file to provide a default if --mail-reminder doesn't specify an email address.
The number of days to display in the calendar (can not use along with --end-date).
What kind of output caldis will give. Defaults to GIF if --write-to-root is given.
Where to print caldis's output (standard output is default).
The size of caldis's output. If the output is ascii, this is interpreted in terms of characters, and for GIF's it is interpreted as pixels.
Run xcalendar before doing anything else, allows you to update your calendar entries and then generate new output, if an argument is given, then it will be used in place of the default xcalendar program. You probably don't want to use this in the RC file, use --run-calendar-program instead.
This is mainly for use in the RC file to provide a default if --run-calendar is given without the optional =COMMAND.
Use the built-in calendar editor, this gives you a command line interface to modifying calendar entries. EDITOR is the name of the editor to use to edit the files, if not given then the EDITOR environment variable is used.
This is mainly for use in the RC file to provide a default if --run-builtin-alendar-program is given without the optional =EDITOR.
Write the output to the root window, valid only for GIF output. If the optional argument is given, then that argument will be used as the command to write to root with. You probably don't want to use this in the RC file, use --write-to-root-program instead.
This is mainly for use in the RC file to provide a default if --write-to-root is given without the optional =COMMAND.
Give extra output. -1 is no extra output, 0 is some output, and 1 gives it all.
If .caldisrc exists, it is read each time caldis is run. Its contents are the command line options, each option on it's own line. Blank lines and lines whose first non-whitespace character are a # will be ignored.
In addition to the xcDDMonYYYY daily files, caldis also reads etDDMon files which are ``eternal'' files that will span years. Useful for remembering those important birthdays and anniversaries.
caldis will mail a calendar entry if the first line of the entry starts with a string of the form {mail DAYS}. DAYS is a comma or space seperated list of positive integers, additionally N-M will be interpreted as the integers N, N+1, N+2, .., M-1, M. So 4-8 is short for 4,5,6,7. If the number of days from today to the date of a calendar entry is K and K is in the DAYS list, then caldis mails that calendar entry.
Commands: ? help ll [FILE [FILE [...]]] ls [-l] [FILE [FILE [...]]] rm FILE [FILE [...]] vi FILE [FILE [...]] emacs FILE [FILE [...]] edit FILE [FILE [...]] quit exit
FILE can be a perl regex and you can use tab filename completion.
gabriel m deal, gmd@yellowleaf.org, http://www.yellowleaf.org/gmd/