Davin McCall 834c9addb9 Tweaks to dinitctl man page 2 years ago
..
Makefile 7788798e14 Make Makefiles honor SHUTDOWN_PREFIX properly. 2 years ago
README adc0299191 Add cheatsheat for roff/man formatting etc 2 years ago
dinit-monitor.8.m4 8d5a977d02 Correction to dinit-monitor man page heading 2 years ago
dinit-service.5.m4 b856c50c5a Document "before" and "after" ordering constraints 2 years ago
dinit.8.m4 54a474e590 Tweak documentation re --setting\-t option 2 years ago
dinitcheck.8.m4 f84a240890 Formatting and other fixes for man pages 2 years ago
dinitctl.8.m4 834c9addb9 Tweaks to dinitctl man page 2 years ago
generate-html.sh 1541bc2442 Add man page for dinit-monitor 2 years ago
shutdown.8.m4 59b9d04907 provide "poweroff" compatibility symlink 2 years ago

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