Davin McCall 71b090e070 Add command line option to specify cgroup base path hace 2 años
..
Makefile 1541bc2442 Add man page for dinit-monitor hace 2 años
README adc0299191 Add cheatsheat for roff/man formatting etc hace 2 años
dinit-monitor.8.m4 8d5a977d02 Correction to dinit-monitor man page heading hace 2 años
dinit-service.5.m4 71b090e070 Add command line option to specify cgroup base path hace 2 años
dinit.8.m4 71b090e070 Add command line option to specify cgroup base path hace 2 años
dinitcheck.8.m4 f84a240890 Formatting and other fixes for man pages hace 2 años
dinitctl.8.m4 f84a240890 Formatting and other fixes for man pages hace 2 años
generate-html.sh 1541bc2442 Add man page for dinit-monitor hace 2 años
shutdown.8.m4 59b9d04907 provide "poweroff" compatibility symlink hace 2 años

README

The manpages are generated by processing *.m4 files using m4.

Roff cheatsheet:

Inline formatting ("escapes"):

\fB - set bold
\fI - set italic (shows as underlined when output on console)
\fR - set regular (i.e. unset bold & italic)



Line commands ("requests"):

.\" - begins a comment line (may be used for spacing in source document)
.LP - begin a new normal paragraph
.HP - begin a hanging paragraph
.TP - begin an indented paragraph with unindented label (first line)
.IP \(bu - indented paragraph with bullet point
.sp - vertical space (i.e. blank line without breaking paragraph)

Gotchas:

* Sentences should always end at the end of a line (this affects spacing in output).
* hyphens which are actually dashes (part of a setting name for example) should be
preceded by a backslash ("\-").
* A blank line doesn't technically start a new paragraph (but does produce a blank line in the output).
It's probably better to use ".sp" instead. Use .LP/.HP/.TP for example to start a paragraph.

For synopsis:

.PD 0 -- no space between paragraphs
.nh -- disable hyphenation
.HP -- begin hanging paragraph
(command goes here)
.HP
(next command variant)
.PD -- default paragraph spacing
.hy -- default hyphenation