Hi Branden, On 2026-05-08T15:41:18-0500, G. Branden Robinson wrote: > .LS type [compactness [indentation]] > Start a list. type is one of "itemized", "enumerated", or > "definition". compactness is a Boolean value indicating
I forgot to ask what those three types are.
I have many different types of lists documented in man-pages(7), and
would like to understand how I should map each to these.
Lists
There are different kinds of lists:
Tagged paragraphs
These are used for a list of tags and their de‐
scriptions. When the tags are constants (either
macros or numbers) they are in bold. Use the .TP
macro.
An example is this "Tagged paragraphs" subsection
is itself.
Ordered lists
Elements are preceded by a number in parentheses
(1), (2). These represent a set of steps that have
an order.
When there are substeps, they will be numbered like
(4.2).
Positional lists
Elements are preceded by a number (index) in square
brackets [4], [5]. These represent fields in a
set. The first index will be:
0 When it represents fields of a C data struc‐
ture, to be consistent with arrays.
1 When it represents fields of a file, to be
consistent with tools like cut(1).
Alternatives list
Elements are preceded by a letter in parentheses
(a), (b). These represent a set of (normally) ex‐
clusive alternatives.
Bullet lists
Elements are preceded by bullet symbols (\[bu]).
Anything that doesn’t fit elsewhere is usually cov‐
ered by this type of list.
Numbered notes
Not really a list, but the syntax is identical to
"positional lists".
There should always be exactly 2 spaces between the list
symbol and the elements. This doesn’t apply to "tagged
paragraphs", which use the default indentation rules.
> that inter-paragraph spacing between list items should be
> suppressed. indentation specifies an indentation amount
> for the body of each list item; it is then unnecessary to
> specify this argument to the list item macros. Use IP with
> a mark argument to represent an itemized or enumerated list
> item, and TP for a definition list item. Use IP without
> arguments to associate successive paragraphs with an
> existing list item; to these, inter-paragraph spacing
> applies even in compact lists. LS can be nested.
Have a lovely day!
Alex
--
<https://www.alejandro-colomar.es>
signature.asc
Description: PGP signature
