refentry.example.1.sgm [plain text]
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<refentry id="ls">
<refmeta>
<refentrytitle>ls</refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>
<refnamediv>
<refname>ls</refname>
<refpurpose>list contents of a directory</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>/usr/bin/ls</command>
<arg choice="opt">
<option>aAbcCdfFgilLmnopqrRstux1</option>
</arg>
<arg choice="opt" rep="repeat">file</arg>
</cmdsynopsis>
<refsect1><title>Description</title>
<para>
For each file that is a directory, <command>ls</> lists the contents of
the directory; for each file that is an ordinary file, <command>ls</>
repeats its name and any other information requested.
</para>
<para>…</para>
</refsect1>
</refentry>