README 1.2 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. The manpages are generated by processing *.m4 files using m4.
  2. Roff cheatsheet:
  3. Inline formatting ("escapes"):
  4. \fB - set bold
  5. \fI - set italic (shows as underlined when output on console)
  6. \fR - set regular (i.e. unset bold & italic)
  7. Line commands ("requests"):
  8. .\" - begins a comment line (may be used for spacing in source document)
  9. .LP - begin a new normal paragraph
  10. .HP - begin a hanging paragraph
  11. .TP - begin an indented paragraph with unindented label (first line)
  12. .IP \(bu - indented paragraph with bullet point
  13. .sp - vertical space (i.e. blank line without breaking paragraph)
  14. Gotchas:
  15. * Sentences should always end at the end of a line (this affects spacing in output).
  16. * hyphens which are actually dashes (part of a setting name for example) should be
  17. preceded by a backslash ("\-").
  18. * A blank line doesn't technically start a new paragraph (but does produce a blank line in the output).
  19. It's probably better to use ".sp" instead. Use .LP/.HP/.TP for example to start a paragraph.
  20. For synopsis:
  21. .PD 0 -- no space between paragraphs
  22. .nh -- disable hyphenation
  23. .HP -- begin hanging paragraph
  24. (command goes here)
  25. .HP
  26. (next command variant)
  27. .PD -- default paragraph spacing
  28. .hy -- default hyphenation