<?xml version="1.0" encoding="utf-8"?>
<section id="S__db-common"><title>DocBook Common</title>
  <para>This stylesheet module provides utility templates for DocBook that are
  independant of the target format.</para>
  <variablelist><title>Templates</title><varlistentry><term><link linkend="T__db_copyright"><function>db.copyright</function></link></term><listitem><para>Outputs copyright information</para></listitem></varlistentry><varlistentry><term><link linkend="T__db_linenumbering"><function>db.linenumbering</function></link></term><listitem><para>Numbers each line in a verbatim environment</para></listitem></varlistentry><varlistentry><term><link linkend="T__db_linenumbering_start"><function>db.linenumbering.start</function></link></term><listitem><para>Determines the starting line number for a verbatim element</para></listitem></varlistentry><varlistentry><term><link linkend="T__db_orderedlist_start"><function>db.orderedlist.start</function></link></term><listitem><para>Determines the number to use for the first <literal>listitem</literal> in an <literal>orderedlist</literal></para></listitem></varlistentry><varlistentry><term><link linkend="T__db_personname"><function>db.personname</function></link></term><listitem><para>Outputs the name of a person</para></listitem></varlistentry><varlistentry><term><link linkend="T__db_personname_list"><function>db.personname.list</function></link></term><listitem><para>Outputs a list of people's names</para></listitem></varlistentry></variablelist><refentry id="T__db_copyright"><indexterm><primary>db.copyright</primary></indexterm><refnamediv><refname><function>db.copyright</function></refname><refpurpose>Outputs copyright information</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The <literal>copyright</literal> element to format</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template outputs copyright information from a <literal>copyright</literal> elements.
  It assembles the <literal>year</literal> and <literal>holder</literal> elements into a simple copyright
  notice, beginning with the copyright symbol "©".</para>
  </refsection></refentry><refentry id="T__db_linenumbering"><indexterm><primary>db.linenumbering</primary></indexterm><refnamediv><refname><function>db.linenumbering</function></refname><refpurpose>Numbers each line in a verbatim environment</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The verbatim element to create the line numbering for</para></listitem></varlistentry><varlistentry><term><parameter>number</parameter></term><listitem><para>The starting line number</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template outputs a string with line numbers for each line in a verbatim
  elements.  Each line number is on its own line, allowing the output string to
  be placed to the side of the verbatim output.</para>
  </refsection></refentry><refentry id="T__db_linenumbering_start"><indexterm><primary>db.linenumbering.start</primary></indexterm><refnamediv><refname><function>db.linenumbering.start</function></refname><refpurpose>Determines the starting line number for a verbatim element</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The verbatim element to determine the starting line number for</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template determines the starting line number for a verbatim element using
  the <literal>continuation</literal> attribute.  The template finds the first preceding element
  of the same name, counts its lines, and handles any <literal>startinglinenumber</literal> or
  <literal>continuation</literal> element it finds on that element.</para>
  </refsection></refentry><refentry id="T__db_orderedlist_start"><indexterm><primary>db.orderedlist.start</primary></indexterm><refnamediv><refname><function>db.orderedlist.start</function></refname><refpurpose>Determines the number to use for the first <literal>listitem</literal> in an <literal>orderedlist</literal></refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The <literal>orderedlist</literal> element to use</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template determines the starting number for an <literal>orderedlist</literal> element using
  the <literal>continuation</literal> attribute.  Thi template finds the first preceding <literal>orderedlist</literal>
  element and counts its list items.  If that element also uses the <literal>continuation</literal>,
  this template calls itself recursively to add that element's starting line number
  to its list item count.</para>
  </refsection></refentry><refentry id="T__db_personname"><indexterm><primary>db.personname</primary></indexterm><refnamediv><refname><function>db.personname</function></refname><refpurpose>Outputs the name of a person</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The element containing tags such as <literal>firstname</literal> and <literal>surname</literal></para></listitem></varlistentry><varlistentry><term><parameter>lang</parameter></term><listitem><para>The language rules to use to construct the name</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template outputs the name of a person as modelled by the <literal>personname</literal>
  element.  The <literal>personname</literal> element allows authors to mark up components of
  a person's name, such as the person's first name and surname.  This template
  assembles those into a string.</para>
  </refsection></refentry><refentry id="T__db_personname_list"><indexterm><primary>db.personname.list</primary></indexterm><refnamediv><refname><function>db.personname.list</function></refname><refpurpose>Outputs a list of people's names</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>nodes</parameter></term><listitem><para>The elements containing tags such as <literal>firstname</literal> and <literal>surname</literal></para></listitem></varlistentry><varlistentry><term><parameter>lang</parameter></term><listitem><para>The language rules to use to construct the list of names</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template outputs a list of names of people as modelled by the <literal>personname</literal>
  element.  The <literal>personname</literal> element allows authors to mark up components of a
  person's name, such as the person's first name and surname.  This template makes
  a list formatted according to the locale set in <parameter>lang</parameter> and calls the template
  <function><link linkend="T__db_personname">db.personname</link></function> for each element in <parameter>nodes</parameter>.</para>
  </refsection></refentry></section>
