update cal documentation (#1746)

This commit is contained in:
Joseph T. Lyons
2020-05-10 21:19:14 -04:00
committed by GitHub
parent f702aae72f
commit 8951a01e58

View File

@ -14,160 +14,160 @@ Use `cal` to display a calendar.
```shell
> cal
───┬──────┬───────┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ year │ month │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
───┼──────┼───────┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────
0 20205 │ │ │ │ │ 12
1 20205 3456789
2 20205 10111213141516
3 20205 17181920212223
4 20205 24252627282930
52020 531 │ │ │ │ │ │
───┴──────┴───────┴────────┴────────┴─────────┴───────────┴─────────┴────────┴──────────
───┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
───┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────
0 │ │ │ │ │ │ 12
13456789
210111213141516
317181920212223
424252627282930
531 │ │ │ │ │ │
───┴────────┴────────┴─────────┴───────────┴─────────┴────────┴──────────
```
```shell
> cal -y 2020
────┬──────┬───────┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ year │ month │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
────┼──────┼───────┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────
020201 │ │ │ │ 1234
120201567891011
22020112131415161718
32020119202122232425
420201262728293031
520202 │ │ │ │ │ │ │ 1
6202022345678
7202029101112131415
82020216171819202122
92020223242526272829
10202031234567
1120203891011121314
122020315161718192021
132020322232425262728
1420203293031 │ │ │ │
1520204 │ │ │ │ 1234
1620204567891011
172020412131415161718
182020419202122232425
19202042627282930 │ │
2020205 │ │ │ │ │ │ 12
21202053456789
222020510111213141516
232020517181920212223
242020524252627282930
252020531 │ │ │ │ │ │
2620206 │ │ 123456
272020678910111213
282020614151617181920
292020621222324252627
3020206282930 │ │ │ │
3120207 │ │ │ │ 1234
3220207567891011
332020712131415161718
342020719202122232425
3520207262728293031
3620208 │ │ │ │ │ │ │ 1
37202082345678
38202089101112131415
392020816171819202122
402020823242526272829
41202083031 │ │ │ │ │
4220209 │ │ │ 12345
43202096789101112
442020913141516171819
452020920212223242526
462020927282930 │ │ │
47202010 │ │ │ │ │ 123
4820201045678910
4920201011121314151617
5020201018192021222324
5120201025262728293031
522020111234567
53202011891011121314
5420201115161718192021
5520201122232425262728
562020112930 │ │ │ │ │
57202012 │ │ │ 12345
582020126789101112
5920201213141516171819
6020201220212223242526
612020122728293031 │ │
────┴──────┴───────┴────────┴────────┴─────────┴───────────┴─────────┴────────┴──────────
> cal -yqm --full-year 2020
────┬──────┬─────────┬───────┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ year │ quarter │ month │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
────┼──────┼─────────┼───────┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────
02020 1 1 │ │ │ │ 1234
12020 1 1567891011
22020 1 112131415161718
32020 1 119202122232425
42020 1 1262728293031
52020 1 2 │ │ │ │ │ │ │ 1
62020 1 22345678
72020 1 29101112131415
82020 1 216171819202122
92020 1 223242526272829
102020 1 31234567
112020 1 3891011121314
122020 1 315161718192021
132020 1 322232425262728
142020 1 3293031 │ │ │ │
152020 2 4 │ │ │ │ 1234
162020 2 4567891011
172020 2 412131415161718
182020 2 419202122232425
192020 2 42627282930 │ │
202020 2 5 │ │ │ │ │ │ 12
212020 2 53456789
222020 2 510111213141516
232020 2 517181920212223
242020 2 524252627282930
252020 2 531 │ │ │ │ │ │
262020 2 6 │ │ 123456
272020 2 678910111213
282020 2 614151617181920
292020 2 621222324252627
302020 2 6282930 │ │ │ │
312020 3 7 │ │ │ │ 1234
322020 3 7567891011
332020 3 712131415161718
342020 3 719202122232425
352020 3 7262728293031
362020 3 8 │ │ │ │ │ │ │ 1
372020 3 82345678
382020 3 89101112131415
392020 3 816171819202122
402020 3 823242526272829
412020 3 83031 │ │ │ │ │
422020 3 9 │ │ │ 12345
432020 3 96789101112
442020 3 913141516171819
452020 3 920212223242526
462020 3 927282930 │ │ │
472020 4 10 │ │ │ │ │ 123
482020 4 1045678910
492020 4 1011121314151617
502020 4 1018192021222324
512020 4 1025262728293031
522020 4 111234567
532020 4 11891011121314
542020 4 1115161718192021
552020 4 1122232425262728
562020 4 112930 │ │ │ │ │
572020 4 12 │ │ │ 12345
582020 4 126789101112
592020 4 1213141516171819
602020 4 1220212223242526
612020 4 122728293031 │ │
────┴──────┴─────────┴───────┴────────┴────────┴─────────┴───────────┴─────────┴────────┴──────────
```
```shell
> cal -my 2020
────┬──────┬───────────┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ year │ month │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
────┼──────┼───────────┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────
02020 │ january │ │ │ │ 1234
12020 │ january │ 567891011
22020 │ january │ 12131415161718
32020 │ january │ 19202122232425
42020 │ january │ 262728293031
52020 │ february │ │ │ │ │ │ │ 1
62020 │ february │ 2345678
72020 │ february │ 9101112131415
82020 │ february │ 16171819202122
92020 │ february │ 23242526272829
102020 │ march │ 1234567
112020 │ march │ 891011121314
122020 │ march │ 15161718192021
132020 │ march │ 22232425262728
142020 │ march │ 293031 │ │ │ │
152020 │ april │ │ │ │ 1234
162020 │ april │ 567891011
172020 │ april │ 12131415161718
182020 │ april │ 19202122232425
192020 │ april │ 2627282930 │ │
202020 │ may │ │ │ │ │ │ 12
212020 │ may │ 3456789
222020 │ may │ 10111213141516
232020 │ may │ 17181920212223
242020 │ may │ 24252627282930
252020 │ may │ 31 │ │ │ │ │ │
262020 │ june │ │ 123456
272020 │ june │ 78910111213
282020 │ june │ 14151617181920
292020 │ june │ 21222324252627
302020 │ june │ 282930 │ │ │ │
312020 │ july │ │ │ │ 1234
322020 │ july │ 567891011
332020 │ july │ 12131415161718
342020 │ july │ 19202122232425
352020 │ july │ 262728293031
362020 │ august │ │ │ │ │ │ │ 1
372020 │ august │ 2345678
382020 │ august │ 9101112131415
392020 │ august │ 16171819202122
402020 │ august │ 23242526272829
412020 │ august │ 3031 │ │ │ │ │
422020 │ september │ │ │ 12345
432020 │ september │ 6789101112
442020 │ september │ 13141516171819
452020 │ september │ 20212223242526
462020 │ september │ 27282930 │ │ │
472020 │ october │ │ │ │ │ 123
482020 │ october │ 45678910
492020 │ october │ 11121314151617
502020 │ october │ 18192021222324
512020 │ october │ 25262728293031
522020 │ november │ 1234567
532020 │ november │ 891011121314
542020 │ november │ 15161718192021
552020 │ november │ 22232425262728
562020 │ november │ 2930 │ │ │ │ │
572020 │ december │ │ │ 12345
582020 │ december │ 6789101112
592020 │ december │ 13141516171819
602020 │ december │ 20212223242526
612020 │ december │ 2728293031 │ │
────┴──────┴───────────┴────────┴────────┴─────────┴───────────┴─────────┴────────┴──────────
> cal -yqm --full-year 2020 --month-names
────┬──────┬─────────┬───────────┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ year │ quarter │ month │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
────┼──────┼─────────┼───────────┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────
02020 1 january │ │ │ │ 1234
12020 1 january │ 567891011
22020 1 january │ 12131415161718
32020 1 january │ 19202122232425
42020 1 january │ 262728293031
52020 1 february │ │ │ │ │ │ │ 1
62020 1 february │ 2345678
72020 1 february │ 9101112131415
82020 1 february │ 16171819202122
92020 1 february │ 23242526272829
102020 1 march │ 1234567
112020 1 march │ 891011121314
122020 1 march │ 15161718192021
132020 1 march │ 22232425262728
142020 1 march │ 293031 │ │ │ │
152020 2 april │ │ │ │ 1234
162020 2 april │ 567891011
172020 2 april │ 12131415161718
182020 2 april │ 19202122232425
192020 2 april │ 2627282930 │ │
202020 2 may │ │ │ │ │ │ 12
212020 2 may │ 3456789
222020 2 may │ 10111213141516
232020 2 may │ 17181920212223
242020 2 may │ 24252627282930
252020 2 may │ 31 │ │ │ │ │ │
262020 2 june │ │ 123456
272020 2 june │ 78910111213
282020 2 june │ 14151617181920
292020 2 june │ 21222324252627
302020 2 june │ 282930 │ │ │ │
312020 3 july │ │ │ │ 1234
322020 3 july │ 567891011
332020 3 july │ 12131415161718
342020 3 july │ 19202122232425
352020 3 july │ 262728293031
362020 3 august │ │ │ │ │ │ │ 1
372020 3 august │ 2345678
382020 3 august │ 9101112131415
392020 3 august │ 16171819202122
402020 3 august │ 23242526272829
412020 3 august │ 3031 │ │ │ │ │
422020 3 september │ │ │ 12345
432020 3 september │ 6789101112
442020 3 september │ 13141516171819
452020 3 september │ 20212223242526
462020 3 september │ 27282930 │ │ │
472020 4 october │ │ │ │ │ 123
482020 4 october │ 45678910
492020 4 october │ 11121314151617
502020 4 october │ 18192021222324
512020 4 october │ 25262728293031
522020 4 november │ 1234567
532020 4 november │ 891011121314
542020 4 november │ 15161718192021
552020 4 november │ 22232425262728
562020 4 november │ 2930 │ │ │ │ │
572020 4 december │ │ │ 12345
582020 4 december │ 6789101112
592020 4 december │ 13141516171819
602020 4 december │ 20212223242526
612020 4 december │ 2728293031 │ │
────┴──────┴─────────┴───────────┴────────┴────────┴─────────┴───────────┴─────────┴────────┴──────────
```
```shell
> cal -my 2303 | where month == "june"
> cal -ym --full-year 2303 --month-names | where month == "june"
───┬──────┬───────┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ year │ month │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
───┼──────┼───────┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────
@ -180,7 +180,7 @@ Use `cal` to display a calendar.
```
```shell
> cal -my 2020 | where friday == 13
> cal -my --full-year 2020 --month-names | where friday == 13
───┬──────┬──────────┬────────┬────────┬─────────┬───────────┬─────────┬────────┬──────────
# │ year │ month │ sunday │ monday │ tuesday │ wednesday │ thurday │ friday │ saturday
───┼──────┼──────────┼────────┼────────┼─────────┼───────────┼─────────┼────────┼──────────