article-unix-calendar-command.mw - tgtimes - The Gopher Times
HTML 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