mirror of
git://sourceware.org/git/lvm2.git
synced 2025-08-25 13:49:28 +03:00
c1bfc8737f
Manually enhance pages for thin, cache, raid, vdo. Replace usage of .HP with .TP when it makes sense (but keep .HP where so far we don't have replacement giving same visual results). Use .CMS, .CME macros in dmsetup/dmstats so it easy to switch But keep using .HP when the rendering looks simply better in terminal although HTML output does not looks that well - so we may eventually switch here to .TP. For basic command synopsis use .NSY macro that will use .SY for graphical rendering (postscript/pdf) but keep using .TP for ASCII terminal output, as here many HTML renderers are emitting unreadable pages. For options use '\ ' (non-breakable space) between option and its argument and option are not across line. Reformat lines to fit in 80 columns. Use .EX .. .EE for example output - this improves character alignment for poststrict/pdf rendering as it use monospace fonts (unlike .nf .. .fi). Also with Example section never let the line being with space and use '\' for such line. If the Example line should being with '.' it needs to be prefix with \&. Add .nf/.fi macros for cases where .EX & .EE are undefined (this happens i.e. with man2html) Avoid use of tables (.TS .. .TE) as HTML renderers often use images (.png) files for such tables and this does not scale well when user changes font size in browser. (and the large/long table were split into 2 pieces so it does fit to 80 columns). Use .MT .ME for emails. Use .UR .UE. for URL. Use .\|.\|.\& as sequence of 3 dots and add \& to not create end of sentence and possibly wrong alignment. On lines starting with .BR & .IR avoid using \fB \fI as this can cause problem when i.e. html rendered may keep use italic bold when just italic was really wanted. When using series of .TP/.IP - set the size only with the first tag - and let renderer align others to match the column. Correct some small typographical rendering issues. Rendering was evaluated for readable results with: - mandoc -T html (-O style=mandoc.css) - groff -Thtml -mman - man2html - man -Thtml - man -Tps - man Unfortunatelly various g/troff troubles are with each of them, so we need to select usage of macros in a way, that is not mangling results for above engines.
14 lines
148 B
Plaintext
14 lines
148 B
Plaintext
.
|
|
.SH NOTES
|
|
.
|
|
The pv_attr bits are:
|
|
.
|
|
.IP 1 3
|
|
(\fBd\fP)uplicate, (\fBa\fP)llocatable, (\fBu\fP)sed
|
|
.
|
|
.IP 2
|
|
e(\fBx\fP)ported
|
|
.
|
|
.IP 3
|
|
(\fBm\fP)issing
|