_ _ ___ | |__ __ _ _______ | |_ / _ \| '_ \ / _` |_ / _ \| __| | (_) | | | | (_| |/ / (_) | |_ \___/|_| |_|\__,_/___\___/ \__|
| ohazot | docs | links | dev | conf | txt |
| es | en |
| mdoc file |
| search |
mdoc —
usage
- WIP: This document is a work in progress, it does not have all examples.
- NOTE: The results in these examples are affected by the site css, the results would be different on the terminal or with a different css.
LISTS
List have the following format:
.Bl -[TYPE] .It item .El
| Type | | Result |
| dash | | - |
| bullet | | • |
| enum | | 1,2,3... |
Columnated list
.Bl -column string1
string2- string : defines the width of the column by using the length of the string.
- strings can be quoted if it contains spaces.
- Any number of strings can be used.
.It col1 Ta col2- The contents of the line as specified in the It line.
- The cells are separated by Ta.
- To specify the headers, add Sy to the cell to set the bold font in the first item.
LITERAL_DISPLAY
Single line
| Macro | | Description | | Usage | | Result |
| Li | | literal display font | | Li words | |
words |
| Ql | | inline quoted literal display | | Ql words | | ‘words’ |
ESCAPING
If a character is not displayed, it may be need to be escaped. Most chracters or words conflicting with mdoc commands can be escaped adding \& before the required character or command.
| " | | \&" |
| . | | \&. |
| \ | | \e |
| No | | \&No |
TODO
- Review this document on OpenBSD 7.8 release.
- Add lists definitions: inset, diag, hang, ohang, tag.
SEE ALSO
documentation , mandoc , roff , mdoc_list_examples
- examples:
</man/manoh>
- OpenBSD manpages: mdoc(7) , mandoc_char(7)