toolbox

Check-in [ccd58e040b]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:doc: use plain text man pages instead of markdown
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | trunk
Files: files | file ages | folders
SHA3-256: ccd58e040ba2bc569c4a09912db354718c4b56f16f5c4ed75007718016872fbf
User & Date: jef 2019-09-12 11:44:47
Context
2019-09-12
11:44
doc: use plain text man pages instead of markdown Leaf check-in: ccd58e040b user: jef tags: trunk
2019-09-06
21:24
radios-check: fix typo in man page check-in: d22c440c86 user: jef tags: trunk
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to Makefile.

6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
	i3notify rss i3status-notif i3radio i3codemusic \
	townsign phone ipmi-lcd-set natospell

all: progs

doc:
	@for proj in ${PROJS}; do \
		echo "# $$proj" > doc/$${proj}.md ; \
		mandoc -T markdown src/$${proj}/$${proj}.1 \
			| tail -n +2 | sed '$$d' | sed '$$d' \
			| sed 's/^#/##/' >> doc/$${proj}.md ; \
	done

progs:
	@for proj in ${PROJS}; do \
		make -C src/$${proj} ; \
	done








<
|
<
|







6
7
8
9
10
11
12

13

14
15
16
17
18
19
20
21
	i3notify rss i3status-notif i3radio i3codemusic \
	townsign phone ipmi-lcd-set natospell

all: progs

doc:
	@for proj in ${PROJS}; do \

		mandoc -T locale src/$${proj}/$${proj}.1 \

			| col -bx > doc/$${proj}.txt; \
	done

progs:
	@for proj in ${PROJS}; do \
		make -C src/$${proj} ; \
	done

Changes to doc/README.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# toolbox

Collection of programs used on a daily basis:

* [arte7dump](/doc/tip/doc/arte7dump.md): Arte video retriever
* [calc](/doc/tip/doc/calc.md): RPN calculator
* [chrono](/doc/tip/doc/chrono.md): chronometer
* [cook](/doc/tip/doc/cook.md): cooking timer
* [flooze](/doc/tip/doc/flooze.md): cash converter using ECB exchange rates
* [http-code](/doc/tip/doc/http-code.md): display HTTP status code for an url
* [i3codemusic](/doc/tip/doc/i3codemusic.md): play ambient music for coding
* [i3notify](/doc/tip/doc/i3notify.md): notification fifo for i3
* [i3radio](/doc/tip/doc/i3radio.md): wrapper around radio(1) for i3 integration
* [i3status-notif](/doc/tip/doc/i3status-notif.md): custom i3status with notification area
* [ipmi-lcd-set](/doc/tip/doc/ipmi-lcd-set.md): set LCD display on Dell servers
* [natospell](/doc/tip/doc/natospell.md): spell words using NATO phonetic alphabet
* [phone](/doc/tip/doc/phone.md): list contacts in a phonebook
* [radio](/doc/tip/doc/radio.md): command line radio player
* [radios-check](/doc/tip/doc/radios-check.md): check foutaise.org radios stream availability
* [renew](/doc/tip/doc/renew.md): monitor expiration of domains, certificates and discrete events
* [rss](/doc/tip/doc/rss.md): RSS reader for the command line
* [soundmachine](/doc/tip/doc/soundmachine.md): command line soundmachine
* [taillast](/doc/tip/doc/taillast.md): tail file from last saved offset
* [thread](/doc/tip/doc/thread.md): execute commands in parallel on a collection of hosts
* [townsign](/doc/tip/doc/townsign.md): french town sign generator

## Installation

Clone this repository using [fossil](https://www.fossil-scm.org/index.html/uv/download.html):

	$ fossil clone https://foutaise.org/fossil/toolbox toolbox.fossil
	$ mdkir toolbox




|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# toolbox

Collection of programs used on a daily basis:

* [arte7dump](/doc/tip/doc/arte7dump.txt): Arte video retriever
* [calc](/doc/tip/doc/calc.txt): RPN calculator
* [chrono](/doc/tip/doc/chrono.txt): chronometer
* [cook](/doc/tip/doc/cook.txt): cooking timer
* [flooze](/doc/tip/doc/flooze.txt): cash converter using ECB exchange rates
* [http-code](/doc/tip/doc/http-code.txt): display HTTP status code for an url
* [i3codemusic](/doc/tip/doc/i3codemusic.txt): play ambient music for coding
* [i3notify](/doc/tip/doc/i3notify.txt): notification fifo for i3
* [i3radio](/doc/tip/doc/i3radio.txt): wrapper around radio(1) for i3 integration
* [i3status-notif](/doc/tip/doc/i3status-notif.txt): custom i3status with notification area
* [ipmi-lcd-set](/doc/tip/doc/ipmi-lcd-set.txt): set LCD display on Dell servers
* [natospell](/doc/tip/doc/natospell.txt): spell words using NATO phonetic alphabet
* [phone](/doc/tip/doc/phone.txt): list contacts in a phonebook
* [radio](/doc/tip/doc/radio.txt): command line radio player
* [radios-check](/doc/tip/doc/radios-check.txt): check foutaise.org radios stream availability
* [renew](/doc/tip/doc/renew.txt): monitor expiration of domains, certificates and discrete events
* [rss](/doc/tip/doc/rss.txt): RSS reader for the command line
* [soundmachine](/doc/tip/doc/soundmachine.txt): command line soundmachine
* [taillast](/doc/tip/doc/taillast.txt): tail file from last saved offset
* [thread](/doc/tip/doc/thread.txt): execute commands in parallel on a collection of hosts
* [townsign](/doc/tip/doc/townsign.txt): french town sign generator

## Installation

Clone this repository using [fossil](https://www.fossil-scm.org/index.html/uv/download.html):

	$ fossil clone https://foutaise.org/fossil/toolbox toolbox.fossil
	$ mdkir toolbox

Deleted doc/arte7dump.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# arte7dump

## NAME

**arte7dump** - Arte video retriever

## SYNOPSIS

**arte7dump**
*arte-url*  
**arte7dump**
**-d**&nbsp;*arte-url&nbsp;&gt;&nbsp;video.mp4*

## DESCRIPTION

**arte7dump**
extract the mp4 url associated to an arte tv program.

## OPTIONS

**-d**

> Dump video to stdout.

**-l** *lang*

> Specify video language (fr, de, en, pl, it or ov). Default fr.

**-w** *int*

> Expected video width (384, 640, 720 or 1280). Default 1280.

## EXAMPLES

	$ arte7dump https://www.arte.tv/fr/videos/087393-000-A/the-assassin/
	https://arteptweb-a.akamaihd.net/am/ptweb/087000/087300/087393-000-A_SQ_0_VO-STF_04463777_MP4-2200_AMM-PTWEB_1Bo4rsLZc0.mp4

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
















































































Added doc/arte7dump.txt.

























































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
arte7dump(1)            FreeBSD General Commands Manual           arte7dump(1)

NAME
     arte7dump – Arte video retriever

SYNOPSIS
     arte7dump arte-url
     arte7dump -d arte-url > video.mp4

DESCRIPTION
     arte7dump extract the mp4 url associated to an arte tv program.

OPTIONS
     -d      Dump video to stdout.

     -l lang
             Specify video language (fr, de, en, pl, it or ov). Default fr.

     -w int  Expected video width (384, 640, 720 or 1280). Default 1280.

EXAMPLES
     $ arte7dump https://www.arte.tv/fr/videos/087393-000-A/the-assassin/
     https://arteptweb-a.akamaihd.net/am/ptweb/087000/087300/087393-000-A_SQ_0_VO-STF_04463777_MP4-2200_AMM-PTWEB_1Bo4rsLZc0.mp4

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/calc.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
# calc

## Name

**calc** - RPN calculator

## SYNOPSIS

**calc**  
**calc**
&lt;
*commands*

## DESCRIPTION

**calc**
is a RPN calculator in the spirit of the HP calculators.

## CALC SETTINGS

### dsp

Control the number of stack entries to display (4 by default).

	4:
	3:
	2:
	1:                 1.00
	> 2 dsp
	
	2:
	1:                 1.00
	>

### prec

Specify float precision (2 by default).

	1:                 3.14
	> 4 prec
	
	1:               3.1416
	>

### rad

Switch to radius mode.

### deg

Switch to degree mode.

## STACK MANAGEMENT

### clear

Clear the stack.

### dropn

Remove the n topmost elements of the stack.

	4:                 2.00
	3:                33.00
	2:                44.00
	1:                55.00
	> 3 dropn
	
	4:
	3:
	2:
	1:                 2.00
	>

### drop2

Shortcut for 2 dropn.

### drop

Shortcut for 1 dropn.

### dupn

Duplicate the n topmost elements of the stack.

	4:
	3:
	2:                 3.14
	1:                34.00
	> 2 dupn
	
	4:                 3.14
	3:                34.00
	2:                 3.14
	1:                34.00
	>

### dup2

Shortcut for 2 dupn.

### dup

Shortcut for 1 dupn.

### pick

Pick an element in the stack and copy it at the top of the stack.

	4:
	3:               123.00
	2:                33.00
	1:                44.00
	> 3 pick
	
	4:               123.00
	3:                33.00
	2:                44.00
	1:               123.00
	>

### over

Shortcut for 2 pick.

### roll

Pick an element in the stack and move it at the top of the stack.

	4:
	3:               123.00
	2:                33.00
	1:                44.00
	> 3 roll
	
	4:
	3:                33.00
	2:                44.00
	1:               123.00
	>

### swap

Shortcut for 2 roll.

### rot

Shortcut for 3 roll.

### rolld

Pick the topmost element and move it downward the stack.

	4:                 1.00
	3:                 2.00
	2:                 3.00
	1:                 4.00
	> 3 rolld
	
	4:                 1.00
	3:                 4.00
	2:                 2.00
	1:                 3.00
	>

### depth

Push the size of the stack on the stack.

## ARITHMETIC OPERATORS

### add, +

Add two topmost elements of the stack.

### sub, -

Substract two topmost elements of the stack.

### mul, \*

Multiply two topmost elements of the stack.

### div, /

Divide two topmost elements of the stack.

### modulo, %

Modulo of two topmost elements of the stack.

### pow

Exponentiation operator of two topmost elements of the stack.

### sq

Shortcut for 2 pow (square value of topmost element).

### sqrt

Shortcut for .5 pow (square root value of topmost element).

### neg

Negate topmost element of the stack.

### abs

Replace topmost element of the stack by its absolute value.

### ceil

Replace topmost element of the stack by its ceiling value.

### floor

Replace topmost element of the stack by its floor value.

### round

Replace topmost element of the stack by its round value.

### sum

Sum every element of the stack.

### avg

Compute average value of the stack.

## COMPARATORS

### equal

Test if second element equals first one.

### le

Test if second element is less or equal compared to first one.

### lt

Test if second element is less than first one.

### ge

Test if second element is greater or equal compared to first one.

### gt

Test if second element is greater than first one.

## BASE NUMBERS

**calc**
accepts numbers in 'base mode' format, using the following syntax:

\#...b

> binary base number (example #01b)

\#...o

> octal base number (example #12o)

\#...d

> decimal base number (example #23d)

\#...h

> hexadecimal base number (example #ea1h)

Base numbers are displayed in decimal base by default.
See commands
*bin*,
*oct*,
*dec*,
*hex*
to change the default base number display mode.

### base

Turn a float number into a base number.

### float

Turn a base number into a float number.

### bin

Display base numbers in base 2.

### oct

Display base numbers in base 8.

### dec

Display base numbers in base 10.

### hex

Display base numbers in base 16.

## BITWISE OPERATORS

### blshift

Binary left shift operator.

	4:
	3:
	2:
	1:                 1.00
	> 2 blshift
	
	4:
	3:
	2:
	1:                 4.00
	>

### brshift

Binary right shift operator.

### band

Binary and between two topmost elements.

### bor

Binary or between two topmost elements.

### bxor

Binary xor between two topmost elements.

## CONSTANTS

### pi

The Pi constant.

### e

Natural logarithm.

## TRIGONOMETRY

### cos

Cosinus.

### sin

Sinus.

### tan

Tangent.

### acos

Arc-cosinus.

### asin

Arc-sinus.

### atan

Arc-tangent.

### cosh

Hyperbolic-cosinus.

### sinh

Hyperbolic-sinus.

### tanh

Hyperbolic-tangent.

## LABELS

**calc**
supports the notion of labels, where values can be stored to / retrieved
from. A valid label name is made of alphabetic characters and underscore
character.

A label can be entered as is. If a value is already assigned to a label,
the stored value is pushed on the stack. Otherwise, the label name is put
on the stack. To put a label on the stack without evaluation, enter it in
single quotes.

### mem

Dump a list of labels and their associated value.

### sto

Store a value into a label:

	4:
	3:
	2:
	1:
	> 2 'two' sto
	
	4:
	3:
	2:
	1:
	> mem
	
	two: 2.00
	
	4:
	3:
	2:
	1:
	> two
	
	4:
	3:
	2:
	1:                 2.00
	>

### sto+

Increment value stored in a label with the topmost value of the stack.

	4:
	3:
	2:
	1:                 5.00
	> 'two' sto+
	
	4:
	3:
	2:
	1:
	> two
	
	4:
	3:
	2:
	1:                 7.00
	>

### rcl

Recall a value stored in a label.

	4:
	3:
	2:
	1:
	> 'two' rcl
	
	4:
	3:
	2:
	1:                 7.00
	>

### purge

Unassign value stored in a label.

	4:
	3:
	2:
	1:
	> 'two' purge

## PROGRAMS

### &lt;&lt;...&gt;&gt;

Sequences of commands can be specified between double angle brackets:

	4:
	3:
	2:
	1:
	> <<3 4 5 6>>
	
	4:
	3:
	2:
	1: <<3.00 4.00 5.00 6.00>>
	>

### eval

A program on top of the stack can be evaluted with the eval command:

	4:
	3:
	2:
	1: <<3.00 4.00 5.00 6.00>>
	> eval
	
	4:                 3.00
	3:                 4.00
	2:                 5.00
	1:                 6.00
	>

## CONTROL FLOW

### ift

If-then conditionnal. Expect a program as a first argument, and an int value
as a second argument. program is evaluated if float value is not zero.

	4:
	3:
	2: 1
	1: <<3.00 4.00 add>>
	> ift
	
	4:
	3:
	2:
	1:                 7.00
	>

### ifte

If-then-else conditionnal. Expect programs on first and second arguments,
and an int value as a third argument. Evaluate first program if third
argument is not zero, evaluate second program otherwise.

	4:
	3: 0
	2: <<1.00 1.00 add>>
	1: <<2.00 2.00 mul>>
	> ifte
	
	4:
	3:
	2:
	1:                 2.00
	>

### whileop

While loop operator. Expect programs on first and second arguments.
Evaluate first program as long a second program evaluate to a float
value that is not zero.

## COMMENTS

The '@' character mark the beginning of a comment. Following characters
until EOL are discarded.

	4:
	3:
	2:
	1:
	> @ this is a comment

## RCFILE

On startup,
**calc**
parse the $HOME/.config/calc/calcrc if it exists. You can store there
your custom commands. For example, this rc file defines a rgb command
by storing a program into the 'rgb' label:

	$ cat ~/.config/calc/calcrc
	@ 'rgb' command to convert an hexadecimal color value into RGB format
	<<dup 16 brshift #ffh band swap dup 8 brshift #ffh band swap #ffh band>> 'rgb' sto
	
	$ calc
	
	4:
	3:
	2:
	1:
	> #63c6a5h rgb
	
	4:
	3:                 #99d
	2:                #198d
	1:                #165d
	>

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
















































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































Added doc/calc.txt.



































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
calc(1)                 FreeBSD General Commands Manual                calc(1)

Name
     calc – RPN calculator

SYNOPSIS
     calc
     calc < commands

DESCRIPTION
     calc is a RPN calculator in the spirit of the HP calculators.

CALC SETTINGS
   dsp
     Control the number of stack entries to display (4 by default).

     4:
     3:
     2:
     1:                 1.00
     > 2 dsp

     2:
     1:                 1.00
     >

   prec
     Specify float precision (2 by default).

     1:                 3.14
     > 4 prec

     1:               3.1416
     >

   rad
     Switch to radius mode.

   deg
     Switch to degree mode.

STACK MANAGEMENT
   clear
     Clear the stack.

   dropn
     Remove the n topmost elements of the stack.

     4:                 2.00
     3:                33.00
     2:                44.00
     1:                55.00
     > 3 dropn

     4:
     3:
     2:
     1:                 2.00
     >

   drop2
     Shortcut for 2 dropn.

   drop
     Shortcut for 1 dropn.

   dupn
     Duplicate the n topmost elements of the stack.

     4:
     3:
     2:                 3.14
     1:                34.00
     > 2 dupn

     4:                 3.14
     3:                34.00
     2:                 3.14
     1:                34.00
     >

   dup2
     Shortcut for 2 dupn.

   dup
     Shortcut for 1 dupn.

   pick
     Pick an element in the stack and copy it at the top of the stack.

     4:
     3:               123.00
     2:                33.00
     1:                44.00
     > 3 pick

     4:               123.00
     3:                33.00
     2:                44.00
     1:               123.00
     >

   over
     Shortcut for 2 pick.

   roll
     Pick an element in the stack and move it at the top of the stack.

     4:
     3:               123.00
     2:                33.00
     1:                44.00
     > 3 roll

     4:
     3:                33.00
     2:                44.00
     1:               123.00
     >

   swap
     Shortcut for 2 roll.

   rot
     Shortcut for 3 roll.

   rolld
     Pick the topmost element and move it downward the stack.

     4:                 1.00
     3:                 2.00
     2:                 3.00
     1:                 4.00
     > 3 rolld

     4:                 1.00
     3:                 4.00
     2:                 2.00
     1:                 3.00
     >

   depth
     Push the size of the stack on the stack.

ARITHMETIC OPERATORS
   add, +
     Add two topmost elements of the stack.

   sub, -
     Substract two topmost elements of the stack.

   mul, *
     Multiply two topmost elements of the stack.

   div, /
     Divide two topmost elements of the stack.

   modulo, %
     Modulo of two topmost elements of the stack.

   pow
     Exponentiation operator of two topmost elements of the stack.

   sq
     Shortcut for 2 pow (square value of topmost element).

   sqrt
     Shortcut for .5 pow (square root value of topmost element).

   neg
     Negate topmost element of the stack.

   abs
     Replace topmost element of the stack by its absolute value.

   ceil
     Replace topmost element of the stack by its ceiling value.

   floor
     Replace topmost element of the stack by its floor value.

   round
     Replace topmost element of the stack by its round value.

   sum
     Sum every element of the stack.

   avg
     Compute average value of the stack.

COMPARATORS
   equal
     Test if second element equals first one.

   le
     Test if second element is less or equal compared to first one.

   lt
     Test if second element is less than first one.

   ge
     Test if second element is greater or equal compared to first one.

   gt
     Test if second element is greater than first one.

BASE NUMBERS
     calc accepts numbers in 'base mode' format, using the following syntax:

     #...b   binary base number (example #01b)

     #...o   octal base number (example #12o)

     #...d   decimal base number (example #23d)

     #...h   hexadecimal base number (example #ea1h)

     Base numbers are displayed in decimal base by default.  See commands bin,
     oct, dec, hex to change the default base number display mode.


   base
     Turn a float number into a base number.

   float
     Turn a base number into a float number.

   bin
     Display base numbers in base 2.

   oct
     Display base numbers in base 8.

   dec
     Display base numbers in base 10.

   hex
     Display base numbers in base 16.

BITWISE OPERATORS
   blshift
     Binary left shift operator.

     4:
     3:
     2:
     1:                 1.00
     > 2 blshift

     4:
     3:
     2:
     1:                 4.00
     >

   brshift
     Binary right shift operator.

   band
     Binary and between two topmost elements.

   bor
     Binary or between two topmost elements.

   bxor
     Binary xor between two topmost elements.

CONSTANTS
   pi
     The Pi constant.

   e
     Natural logarithm.

TRIGONOMETRY
   cos
     Cosinus.

   sin
     Sinus.

   tan
     Tangent.

   acos
     Arc-cosinus.

   asin
     Arc-sinus.

   atan
     Arc-tangent.

   cosh
     Hyperbolic-cosinus.

   sinh
     Hyperbolic-sinus.

   tanh
     Hyperbolic-tangent.

LABELS
     calc supports the notion of labels, where values can be stored to /
     retrieved from. A valid label name is made of alphabetic characters and
     underscore character.

     A label can be entered as is. If a value is already assigned to a label,
     the stored value is pushed on the stack. Otherwise, the label name is put
     on the stack. To put a label on the stack without evaluation, enter it in
     single quotes.

   mem
     Dump a list of labels and their associated value.

   sto
     Store a value into a label:

     4:
     3:
     2:
     1:
     > 2 'two' sto

     4:
     3:
     2:
     1:
     > mem

     two: 2.00

     4:
     3:
     2:
     1:
     > two

     4:
     3:
     2:
     1:                 2.00
     >

   sto+
     Increment value stored in a label with the topmost value of the stack.

     4:
     3:
     2:
     1:                 5.00
     > 'two' sto+

     4:
     3:
     2:
     1:
     > two

     4:
     3:
     2:
     1:                 7.00
     >

   rcl
     Recall a value stored in a label.

     4:
     3:
     2:
     1:
     > 'two' rcl

     4:
     3:
     2:
     1:                 7.00
     >

   purge
     Unassign value stored in a label.

     4:
     3:
     2:
     1:
     > 'two' purge

PROGRAMS
   <<...>>
     Sequences of commands can be specified between double angle brackets:

     4:
     3:
     2:
     1:
     > <<3 4 5 6>>

     4:
     3:
     2:
     1: <<3.00 4.00 5.00 6.00>>
     >

   eval
     A program on top of the stack can be evaluted with the eval command:

     4:
     3:
     2:
     1: <<3.00 4.00 5.00 6.00>>
     > eval

     4:                 3.00
     3:                 4.00
     2:                 5.00
     1:                 6.00
     >

CONTROL FLOW
   ift
     If-then conditionnal. Expect a program as a first argument, and an int
     value as a second argument. program is evaluated if float value is not
     zero.

     4:
     3:
     2: 1
     1: <<3.00 4.00 add>>
     > ift

     4:
     3:
     2:
     1:                 7.00
     >

   ifte
     If-then-else conditionnal. Expect programs on first and second arguments,
     and an int value as a third argument. Evaluate first program if third
     argument is not zero, evaluate second program otherwise.

     4:
     3: 0
     2: <<1.00 1.00 add>>
     1: <<2.00 2.00 mul>>
     > ifte

     4:
     3:
     2:
     1:                 2.00
     >

   whileop
     While loop operator. Expect programs on first and second arguments.
     Evaluate first program as long a second program evaluate to a float value
     that is not zero.

COMMENTS
     The '@' character mark the beginning of a comment. Following characters
     until EOL are discarded.

     4:
     3:
     2:
     1:
     > @ this is a comment

RCFILE
     On startup, calc parse the $HOME/.config/calc/calcrc if it exists. You
     can store there your custom commands. For example, this rc file defines a
     rgb command by storing a program into the 'rgb' label:

     $ cat ~/.config/calc/calcrc
     @ 'rgb' command to convert an hexadecimal color value into RGB format
     <<dup 16 brshift #ffh band swap dup 8 brshift #ffh band swap #ffh band>> 'rgb' sto

     $ calc

     4:
     3:
     2:
     1:
     > #63c6a5h rgb

     4:
     3:                 #99d
     2:                #198d
     1:                #165d
     >

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10           May 2019           FreeBSD 12.0-RELEASE-p10

Deleted doc/chrono.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# chrono

## NAME

**chrono** - Chronometer

## SYNOPSIS

**chrono**

## DESCRIPTION

**chrono**
is a simple chronometer for the terminal.

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<




































Added doc/chrono.txt.































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
chrono(1)               FreeBSD General Commands Manual              chrono(1)

NAME
     chrono – Chronometer

SYNOPSIS
     chrono

DESCRIPTION
     chrono is a simple chronometer for the terminal.

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/cook.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# cook

## NAME

**cook** - Cooking timer

## SYNOPSIS

**cook**
*mm:ss*

## DESCRIPTION

**cook**
is a cooking timer for the terminal. A sound notification is
played when time is over.

## DEPENDENCIES

**cook**
depends on
soundmachine(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<




















































Added doc/cook.txt.







































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
cook(1)                 FreeBSD General Commands Manual                cook(1)

NAME
     cook – Cooking timer

SYNOPSIS
     cook mm:ss

DESCRIPTION
     cook is a cooking timer for the terminal. A sound notification is played
     when time is over.

DEPENDENCIES
     cook depends on soundmachine(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/flooze.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# flooze

## NAME

**flooze** - Cash converter using ECB exchange rates

## SYNOPSIS

**flooze**
*currency\_from&nbsp;currency\_to&nbsp;amount*

## DESCRIPTION

**flooze**
is a currency converter, using the European Central Bank
exchange rates.

## OPTIONS

**-l**

> List available currencies.

**-p** *int*

> Specify the float precision. Default 4.

## EXAMPLE

	$ flooze eur chf 10
	11.3270

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<






































































Added doc/flooze.txt.



















































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
flooze(1)               FreeBSD General Commands Manual              flooze(1)

NAME
     flooze – Cash converter using ECB exchange rates

SYNOPSIS
     flooze currency_from currency_to amount

DESCRIPTION
     flooze is a currency converter, using the European Central Bank exchange
     rates.

OPTIONS
     -l      List available currencies.

     -p int  Specify the float precision. Default 4.

EXAMPLE
     $ flooze eur chf 10
     11.3270

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/http-code.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# http-code

## NAME

**http-code** - Display HTTP status code for an url

## SYNOPSIS

**http-code**
*url*

## DESCRIPTION

**http-code**
display the HTTP status code for an url.

## OPTIONS

**-r**

> Follow redirects (off by default)

**-t** *int*

> Timeout in milliseconds (off by default)

## EXAMPLE

	$ http-code https://foutaise.org
	200

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<




































































Added doc/http-code.txt.

















































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
http-code(1)            FreeBSD General Commands Manual           http-code(1)

NAME
     http-code – Display HTTP status code for an url

SYNOPSIS
     http-code url

DESCRIPTION
     http-code display the HTTP status code for an url.

OPTIONS
     -r      Follow redirects (off by default)

     -t int  Timeout in milliseconds (off by default)

EXAMPLE
     $ http-code https://foutaise.org
     200

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/i3codemusic.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# i3codemusic

## NAME

**i3codemusic** - Play ambient music for coding

## SYNOPSIS

**i3codemusic**

## DESCRIPTION

**i3codemusic**
prompts for different kind of ambient music to choose
from, then play the selected one.

## DEPENDENCIES

**i3codemusic**
depends on dmenu(1) and mpv(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
















































Added doc/i3codemusic.txt.







































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
i3codemusic(1)          FreeBSD General Commands Manual         i3codemusic(1)

NAME
     i3codemusic – Play ambient music for coding

SYNOPSIS
     i3codemusic

DESCRIPTION
     i3codemusic prompts for different kind of ambient music to choose from,
     then play the selected one.

DEPENDENCIES
     i3codemusic depends on dmenu(1) and mpv(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/i3notify.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# i3notify

## NAME

**i3notify** - Notification fifo for i3

## SYNOPSIS

**i3notify**
**-s**  
**i3notify**
push
*msg*  
**i3notify**
pop

## DESCRIPTION

**i3notify**
is a fifo queue to implement a notification area for
i3status, the status bar of the i3 window manager.

An instance of i3notify should be started in server mode, then applications
can push / pop messages to / from this fifo queue.

## OPTIONS

**-s**

> Start i3notify in server mode.

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<




































































Added doc/i3notify.txt.

















































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
i3notify(1)             FreeBSD General Commands Manual            i3notify(1)

NAME
     i3notify – Notification fifo for i3

SYNOPSIS
     i3notify -s
     i3notify push msg
     i3notify pop

DESCRIPTION
     i3notify is a fifo queue to implement a notification area for i3status,
     the status bar of the i3 window manager.

     An instance of i3notify should be started in server mode, then
     applications can push / pop messages to / from this fifo queue.

OPTIONS
     -s      Start i3notify in server mode.

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/i3radio.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# i3radio

## NAME

**i3radio** - Wrapper around
radio(1)
for i3 integration

## SYNOPSIS

**i3radio**

## DESCRIPTION

**i3radio**
plays a radio through dmenu, and update i3notify with songs titles.

## DEPENDENCIES

**i3radio**
depends on
dmenu(1),
radio(1), and
i3notify(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
























































Added doc/i3radio.txt.







































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
i3radio(1)              FreeBSD General Commands Manual             i3radio(1)

NAME
     i3radio – Wrapper around radio(1) for i3 integration

SYNOPSIS
     i3radio

DESCRIPTION
     i3radio plays a radio through dmenu, and update i3notify with songs
     titles.

DEPENDENCIES
     i3radio depends on dmenu(1), radio(1), and i3notify(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/i3status-notif.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# i3status-notif

## NAME

**i3status-notif** - Custom i3status with notification area

## SYNOPSIS

**i3status-notif**

## DESCRIPTION

**i3status-notif**
is a wrapper around i3status, appending a notification
area to the status bar.

## DEPENDENCIES

**i3status-notif**
depends on
i3notify(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<


















































Added doc/i3status-notif.txt.







































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
i3status-notif(1)       FreeBSD General Commands Manual      i3status-notif(1)

NAME
     i3status-notif – Custom i3status with notification area

SYNOPSIS
     i3status-notif

DESCRIPTION
     i3status-notif is a wrapper around i3status, appending a notification
     area to the status bar.

DEPENDENCIES
     i3status-notif depends on i3notify(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/ipmi-lcd-set.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# ipmi-lcd-set

## NAME

**ipmi-lcd-set** - Set LCD display on Dell servers

## SYNOPSIS

**ipmi-lcd-set**
*text*

## DESCRIPTION

**ipmi-lcd-set**
set a text to display on the LCD front panel of Dell servers.

## OPTIONS

**-I** *interface*

> IPMI interface to use. Default "lanplus".

**-H** *host*

> Remote server to set the LCD display. Default "localhost".

**-U** *user*

> Remote server username. Default "root".

**-P** *passwd*

> Remote server password. User is prompted for password by default.

## EXAMPLES

	$ ipmi-lcd-set -H 192.168.1.100 MYSERVER

## DEPENDENCIES

**ipmi-lcd-set**
depends on
ipmitool(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<






























































































Added doc/ipmi-lcd-set.txt.







































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
ipmi-lcd-set(1)         FreeBSD General Commands Manual        ipmi-lcd-set(1)

NAME
     ipmi-lcd-set – Set LCD display on Dell servers

SYNOPSIS
     ipmi-lcd-set text

DESCRIPTION
     ipmi-lcd-set set a text to display on the LCD front panel of Dell
     servers.

OPTIONS
     -I interface
             IPMI interface to use. Default "lanplus".

     -H host
             Remote server to set the LCD display. Default "localhost".

     -U user
             Remote server username. Default "root".

     -P passwd
             Remote server password. User is prompted for password by default.

EXAMPLES
     $ ipmi-lcd-set -H 192.168.1.100 MYSERVER

DEPENDENCIES
     ipmi-lcd-set depends on ipmitool(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/natospell.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# natospell

## NAME

**natospell** - Spell words using NATO phonetic alphabet

## SYNOPSIS

**natospell**
*word&nbsp;...*

## DESCRIPTION

**natospell**
split a word in list of characters and display the
corresponding NATO phonetic code associated to each
character.

## EXAMPLE

	$ natospell bird
	b Bravo
	i India
	r Romeo
	d Delta

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<


























































Added doc/natospell.txt.















































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
natospell(1)            FreeBSD General Commands Manual           natospell(1)

NAME
     natospell – Spell words using NATO phonetic alphabet

SYNOPSIS
     natospell word ...

DESCRIPTION
     natospell split a word in list of characters and display the
     corresponding NATO phonetic code associated to each character.

EXAMPLE
     $ natospell bird
     b Bravo
     i India
     r Romeo
     d Delta

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/phone.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# phone

## NAME

**phone** - List contacts in a phonebook

## SYNOPSIS

**phone**
\[**-f**&nbsp;*field*]
\[*pattern*]  
**phone**
**-e**

## DESCRIPTION

**phone**
list contacts in the phonebook. If a
*pattern*
is specified, only entries matching the
*pattern*
are displayed.

The phonebook is stored in the following file:

	~/.config/phone/phonebook.txt

Each phonebook entry is made of a body which contains
the name and address of the contact, then a list of fields
to specify telephones, email addresses:

	Jean Bonnot
	15 avenue machin
	25000 Besancon
	tel: +33 12 34 56 78 90
	email: jean@example.com

Each contact is separated by a blank line.

## OPTIONS

**-f** *field*

> Specify a field where the search pattern is applied. By default,
> the pattern is applied on the whole contact.

**-e**

> Edit the phonebook

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<










































































































Added doc/phone.txt.

















































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
phone(1)                FreeBSD General Commands Manual               phone(1)

NAME
     phone – List contacts in a phonebook

SYNOPSIS
     phone [-f field] [pattern]
     phone -e

DESCRIPTION
     phone list contacts in the phonebook. If a pattern is specified, only
     entries matching the pattern are displayed.

     The phonebook is stored in the following file:

           ~/.config/phone/phonebook.txt

     Each phonebook entry is made of a body which contains the name and
     address of the contact, then a list of fields to specify telephones,
     email addresses:

           Jean Bonnot
           15 avenue machin
           25000 Besancon
           tel: +33 12 34 56 78 90
           email: jean@example.com

     Each contact is separated by a blank line.

OPTIONS
     -f field
             Specify a field where the search pattern is applied. By default,
             the pattern is applied on the whole contact.

     -e      Edit the phonebook

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/radio.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# radio

## NAME

**radio** - Command line radio player

## SYNOPSIS

**radio**
*radio-name*

## DESCRIPTION

**radio**
play radio streams, and display ICY metada information if
available on stdout.

## OPTIONS

**-l**

> List available radios.

## EXAMPLE

	$ radio "Radio Paradise"
	The Smashing Pumpkins - Drown
	Zola Blood - Play Out

## DEPENDENCIES

**radio**
depends on
mpv(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<












































































Added doc/radio.txt.























































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
radio(1)                FreeBSD General Commands Manual               radio(1)

NAME
     radio – Command line radio player

SYNOPSIS
     radio radio-name

DESCRIPTION
     radio play radio streams, and display ICY metada information if available
     on stdout.

OPTIONS
     -l      List available radios.

EXAMPLE
     $ radio "Radio Paradise"
     The Smashing Pumpkins - Drown
     Zola Blood - Play Out

DEPENDENCIES
     radio depends on mpv(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/radios-check.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# radios-check

## NAME

**radios-check** - Check foutaise.org radios stream availability

## SYNOPSIS

**radios-check**

## DESCRIPTION

**radios-check**
lists broken radios stream available on
foutaise.org radio player.

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<






































Added doc/radios-check.txt.

































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
radios-check(1)         FreeBSD General Commands Manual        radios-check(1)

NAME
     radios-check – Check foutaise.org radios stream availability

SYNOPSIS
     radios-check

DESCRIPTION
     radios-check lists broken radios stream available on foutaise.org radio
     player.

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/renew.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# renew

## NAME

**renew** - Monitor expiration of domains, certificates and discrete events

## SYNOPSIS

**renew**
\[*cfgfile*]

## DESCRIPTION

**renew**
is a reminder tool to monitor future expiration of domains,
certificates and discrete events. It can take its configuration from an
explicit configuration file, or from stdin.

The configuration file should contain one check per line, using the
following syntax:

### Domains:

	domain domainname

### Certificates:

	tls host:port [servername]

### Events:

	event YYYY-MM-DD comment

## OPTIONS

**-f** *uint*

> Specify the minimum number of valid days before reporting an expiration.
> Default 7.

**-v**

> Verbose mode, display the expiration date of every event.

## EXAMPLES

Example of renew usage with configuration taken from stdin:

	$ renew -v
	domain foutaise.org
	tls foutaise.org:443
	event 2019-02-06 buy milk
	^D

Output:

	2019-02-06 event buy milk (22 days)
	2019-04-07 tls foutaise.org:443 (82 days)
	2021-01-23 domain foutaise.org (740 days)

## DEPENDENCIES

**renew**
depends on
whois(1)
and
openssl(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<














































































































































Added doc/renew.txt.













































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
renew(1)                FreeBSD General Commands Manual               renew(1)

NAME
     renew – Monitor expiration of domains, certificates and discrete events

SYNOPSIS
     renew [cfgfile]

DESCRIPTION
     renew is a reminder tool to monitor future expiration of domains,
     certificates and discrete events. It can take its configuration from an
     explicit configuration file, or from stdin.

     The configuration file should contain one check per line, using the
     following syntax:

   Domains:
     domain domainname

   Certificates:
     tls host:port [servername]

   Events:
     event YYYY-MM-DD comment

OPTIONS
     -f uint
             Specify the minimum number of valid days before reporting an
             expiration.  Default 7.

     -v      Verbose mode, display the expiration date of every event.

EXAMPLES
     Example of renew usage with configuration taken from stdin:

           $ renew -v
           domain foutaise.org
           tls foutaise.org:443
           event 2019-02-06 buy milk
           ^D

     Output:

           2019-02-06 event buy milk (22 days)
           2019-04-07 tls foutaise.org:443 (82 days)
           2021-01-23 domain foutaise.org (740 days)

DEPENDENCIES
     renew depends on whois(1) and openssl(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/rss.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# rss

## NAME

**rss** - RSS reader for the command line

## SYNOPSIS

**rss**  
**rss&nbsp;**-r**&nbsp;**-b**&nbsp;**-f**&zwnj;**

## DESCRIPTION

**rss**
is a featureless RSS reader, with a single goal in mind:

*	fetch new RSS items

*	send unread items to an external browser

*	mark those unread items as read

## OPTIONS

**-a** *feedlink*

> Add a RSS feed.

**-d** *feedlink*

> Delete a RSS feed.

**-r**

> Refresh feed items.

**-b**

> Browse unread items.

**-f**

> Flush unread items as read.

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<






























































































Added doc/rss.txt.







































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
rss(1)                  FreeBSD General Commands Manual                 rss(1)

NAME
     rss – RSS reader for the command line

SYNOPSIS
     rss
     rss -r -b -f

DESCRIPTION
     rss is a featureless RSS reader, with a single goal in mind:

     •   fetch new RSS items

     •   send unread items to an external browser

     •   mark those unread items as read

OPTIONS
     -a feedlink
             Add a RSS feed.

     -d feedlink
             Delete a RSS feed.

     -r      Refresh feed items.

     -b      Browse unread items.

     -f      Flush unread items as read.

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/soundmachine.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# soundmachine

## NAME

**soundmachine** - Command line soundmachine

## SYNOPSIS

**soundmachine**
*sound*

## DESCRIPTION

**soundmachine**
plays a sound form a collection of sounds.

## OPTIONS

**-l**

> List available sounds.

## EXAMPLE

	$ soundmachine fart

## DEPENDENCIES

**soundmachine**
depends on
mpg123(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<






































































Added doc/soundmachine.txt.

















































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
soundmachine(1)         FreeBSD General Commands Manual        soundmachine(1)

NAME
     soundmachine – Command line soundmachine

SYNOPSIS
     soundmachine sound

DESCRIPTION
     soundmachine plays a sound form a collection of sounds.

OPTIONS
     -l      List available sounds.

EXAMPLE
     $ soundmachine fart

DEPENDENCIES
     soundmachine depends on mpg123(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/taillast.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# taillast

## NAME

**taillast** - Tail file from last saved offset

## SYNOPSIS

**taillast**
*file&nbsp;offsetfile*

## DESCRIPTION

**taillast**
dumps file and saves current offset in offsetfile. Next call
to taillast will continue to dump from that offset.

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<








































Added doc/taillast.txt.

































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
taillast(1)             FreeBSD General Commands Manual            taillast(1)

NAME
     taillast – Tail file from last saved offset

SYNOPSIS
     taillast file offsetfile

DESCRIPTION
     taillast dumps file and saves current offset in offsetfile. Next call to
     taillast will continue to dump from that offset.

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/thread.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# thread

## NAME

**thread** - Execute commands in parallel on a collection of hosts

## SYNOPSIS

**thread**
\[**-i**&nbsp;*hosts*]
\[**-n**&nbsp;*nthreads*]
*cmd*

## DESCRIPTION

**thread**
execute commands on a collection of hosts. Each
occurence of HOST in the
*cmd*
argument is replaced by the name
of the target host before execution.

## OPTIONS

**-i** *hosts*

> File holding list of hosts

**-n** *uint*

> Specify the number of concurrent threads. Default 10.

## EXAMPLE

Prepare a list of hosts:

	$ cat > list
	host1
	host2
	^D

Execute a command on this list of hosts:

	$ thread -i list ssh HOST uptime

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
































































































Added doc/thread.txt.









































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
thread(1)               FreeBSD General Commands Manual              thread(1)

NAME
     thread – Execute commands in parallel on a collection of hosts

SYNOPSIS
     thread [-i hosts] [-n nthreads] cmd

DESCRIPTION
     thread execute commands on a collection of hosts. Each occurence of HOST
     in the cmd argument is replaced by the name of the target host before
     execution.

OPTIONS
     -i hosts
             File holding list of hosts

     -n uint
             Specify the number of concurrent threads. Default 10.

EXAMPLE
     Prepare a list of hosts:

           $ cat > list
           host1
           host2
           ^D

     Execute a command on this list of hosts:

           $ thread -i list ssh HOST uptime

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10

Deleted doc/townsign.md.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# townsign

## NAME

**townsign** - French town sign generator

## SYNOPSIS

**townsign**
*town\_name*
&gt;
*sign.png*

## DESCRIPTION

**townsign**
generates a french town sign in PNG.

## OPTIONS

**-r** *number*

> Specify country road number.

**-s** *factor*

> Specify scale factor. Default 1.

## DEPENDENCIES

**townsign**
depends on
magick(1).

## AUTHOR

Gerome Fournier &lt;[jef@foutaise.org](mailto:jef@foutaise.org)&gt;.
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<










































































Added doc/townsign.txt.



















































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
townsign(1)             FreeBSD General Commands Manual            townsign(1)

NAME
     townsign – French town sign generator

SYNOPSIS
     townsign town_name > sign.png

DESCRIPTION
     townsign generates a french town sign in PNG.

OPTIONS
     -r number
             Specify country road number.

     -s factor
             Specify scale factor. Default 1.

DEPENDENCIES
     townsign depends on magick(1).

AUTHOR
     Gerome Fournier <jef@foutaise.org>.

FreeBSD 12.0-RELEASE-p10         January 2019         FreeBSD 12.0-RELEASE-p10