sbase

suckless unix tools
git clone git://git.2f30.org/sbase
Log | Files | Refs | README | LICENSE

cal.1 (1259B)


      1 .Dd 2015-10-08
      2 .Dt CAL 1
      3 .Os sbase
      4 .Sh NAME
      5 .Nm cal
      6 .Nd show calendar
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl 1 | Fl 3 | Fl y | Fl n Ar num
     10 .Op Fl s | Fl m | Fl f Ar num
     11 .Op Fl c Ar num
     12 .Oo Oo Ar month Oc Ar year Oc
     13 .Sh DESCRIPTION
     14 .Nm
     15 writes a calendar of
     16 .Ar month
     17 and
     18 .Ar year
     19 or the current month to stdout.
     20 If
     21 .Ar year
     22 is given without
     23 .Ar month ,
     24 .Nm
     25 writes a 3-column calendar of the whole
     26 year to stdout.
     27 The date formatting is according to
     28 .Xr localtime 3 .
     29 .Pp
     30 The Julian calendar is used until Sep 2, 1752. The Gregorian calendar is used
     31 starting the next day on Sep 14, 1752.
     32 .Sh OPTIONS
     33 .Bl -tag -width Ds
     34 .It Fl 1
     35 Print current month. This is the default.
     36 .It Fl 3
     37 Print previous, current and next month.
     38 .It Fl c Ar num
     39 Print
     40 .Ar num
     41 calendars in a row. The default is 3.
     42 .It Fl f Ar num
     43 Set
     44 .Ar num
     45 (0 is Sunday, 6 is Saturday) as first day of week.
     46 .It Fl m
     47 Set Monday as first day of week.
     48 .It Fl n Ar num
     49 Output
     50 .Ar num
     51 months starting from and including the current month.
     52 .It Fl s
     53 Set Sunday as first day of week.
     54 .It Fl y
     55 Print the entire
     56 .Ar year
     57 or current year.
     58 .El
     59 .Sh SEE ALSO
     60 .Xr localtime 3
     61 .Sh STANDARDS
     62 The
     63 .Nm
     64 utility is compliant with the
     65 .St -p1003.1-2013
     66 specification.
     67 .Pp
     68 The flags
     69 .Op Fl 13cfmnsy
     70 are an extension to that specification.