article-unix-calendar-command.mw - tgtimes - The Gopher Times
 (HTM) git clone git://bitreich.org/tgtimes git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/tgtimes
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) Tags
 (DIR) README
       ---
       article-unix-calendar-command.mw (1975B)
       ---
            1 .SH tgtimes
            2 The UNIX calendar(1) command
            3 .
            4 .PP
            5 It is probably there sitting in \fC/usr/bin\fR, the
            6 calendar(1) command can offer you a fair dose of flexibility that
            7 web-based or smartphone-based calendars lacks.
            8 .
            9 .PP
           10 By storing events in a single file of text edited by hand, calendar(1)
           11 brings the comfort of your existing text editor to manage events with
           12 a simple syntax:
           13 .
           14 .IP -
           15 one line per event: first a date, then a tab, then a description.
           16 .
           17 .IP -
           18 A line starting with a tab implicitly has the
           19 same date as the previous event.
           20 .
           21 .IP -
           22 Empty lines are ignored, and the C preprocessor brings \fC#include\fR
           23 and \fC/* comments */\fR as needed.
           24 .
           25 .PP
           26 No need to format everything right away: taking notes at the bottom
           27 of the file, in the middle of a phone call and formatting after
           28 hanging-up... It is it trivial to manage a calendar file.
           29 .
           30 .PP
           31 While the calendar(1) command is run, events for today and tomorrow
           32 are printed: as a digest of what is upcoming.
           33 .
           34 .PP
           35 A command line flag permits sending this digest to all users by email,
           36 making it a complete calendar software suite from edition to reminder.
           37 .
           38 .PP
           39 There is even support for weekly, monthly and yearly (birthdays)
           40 events.
           41 .
           42 .PP
           43 Sharing calendar events is as easy as sending the section of the
           44 calendar file by email, and synchronising the calendar across devices
           45 is a matter of synchronising a single file.
           46 .
           47 .PP
           48 By adding a few more custom syntax rules on top of those supported by
           49 calendar(1), readable text can be maintained with little effort.
           50 .
           51 .DS
           52 Jan 23  09:00   Breakfast: cooked eggs and fruits
           53                 @ Home Sweet Home
           54 
           55         10:30   The Gopher Times proof-reading
           56                 @ ircs://irc.bitreich.org/
           57 
           58         15:30   On-call duty untill!
           59                 @ https://the-dull-gull.corp/login
           60 
           61 Jan 24  12:30   Lunch break in town with folks
           62                 @ that small cafe that does snacks
           63 
           64 Jan 26  19:15   Call with friends abroad
           65                 @ mumble://example.com/
           66 .DE