sbase

suckless unix tools
git clone git://git.suckless.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.
     31 The Gregorian calendar is used starting the next day on Sep 14, 1752.
     32 .Sh OPTIONS
     33 .Bl -tag -width Ds
     34 .It Fl 1
     35 Print current month.
     36 This is the default.
     37 .It Fl 3
     38 Print previous, current and next month.
     39 .It Fl c Ar num
     40 Print
     41 .Ar num
     42 calendars in a row.
     43 The default is 3.
     44 .It Fl f Ar num
     45 Set
     46 .Ar num
     47 (0 is Sunday, 6 is Saturday) as first day of week.
     48 .It Fl m
     49 Set Monday as first day of week.
     50 .It Fl n Ar num
     51 Output
     52 .Ar num
     53 months starting from and including the current month.
     54 .It Fl s
     55 Set Sunday as first day of week.
     56 .It Fl y
     57 Print the entire
     58 .Ar year
     59 or current year.
     60 .El
     61 .Sh SEE ALSO
     62 .Xr localtime 3
     63 .Sh STANDARDS
     64 The
     65 .Nm
     66 utility is compliant with the
     67 .St -p1003.1-2013
     68 specification.
     69 .Pp
     70 The flags
     71 .Op Fl 13cfmnsy
     72 are an extension to that specification.