Introducing DocBook: DocBook Markup

Case Study: Reference Pages

This is the DocBook XML source for a reference page.

<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry>
<refmeta>
<refentrytitle>getpwnam</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>

<refnamediv>
<refname>getpwnam</refname>
<refname>getpwuid</refname>
<refpurpose>get password file entry</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>
#include &lt;pwd.h>
#include &lt;sys/types.h>

struct passwd *getpwnam(const char * name);

struct passwd *getpwuid(uid_t uid);
</synopsis>

</refsynopsisdiv>

<refsect1><title>Description</title>

<para>The <function>getpwnam</function> function returns a pointer to
a structure containing the broken out fields of a line from
<filename>/etc/passwd</filename> for the entry that matches the
user name <parameter>name</parameter>.
</para>

<!--...-->

</refsect1>

<!--...-->

</refentry>

The reference page is also available in HTML and PDF