reference.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
<!-- This file can be edited downstream. -->
<!DOCTYPE topic
[
  <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
    %entities;
]>
<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
<!-- point back to this document with a similar comment added to your legacy doc piece -->
<!-- refer to README.md for file and id naming conventions -->
<!-- metadata is dealt with on the assembly level -->
<topic xml:id="reference-example"
 role="reference" xml:lang="en"
 xmlns="http://docbook.org/ns/docbook" version="5.2"
 xmlns:its="http://www.w3.org/2005/11/its"
 xmlns:xi="http://www.w3.org/2001/XInclude"
 xmlns:xlink="http://www.w3.org/1999/xlink"
 xmlns:trans="http://docbook.org/ns/transclusion">
  <info>
   <title>Reference</title><!-- can be changed via merge in the assembly -->
    <!--add author's email address-->
    <meta name="maintainer" content="" its:translate="no"/>
    <abstract><!-- can be changed via merge in the assembly -->
      <para>
       Introductory text
      </para>
    </abstract>
  </info>
  <section xml:id="reference-example-section">
    <title>Section title</title>
    <para>
      A paragraph of text.
    </para>
    <variablelist>
      <title>A title</title>
      <varlistentry>
        <term><command>a-command --with-options</command></term>
        <listitem>
          <para>
            A paragraph of text.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><command>another-command --with-options</command></term>
        <listitem>
          <para>
            Another paragraph of text.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    <table>
      <title>A table title</title>
      <tgroup cols="2">
        <colspec colwidth="50*"/>
        <colspec colwidth="50*"/>
        <tbody>
          <row>
            <entry>an entry</entry>
            <entry>another entry</entry>
          </row>
          <row>
            <entry>an entry</entry>
            <entry>another entry</entry>
          </row>
          <row>
            <entry>an entry</entry>
            <entry>another entry</entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </section>
</topic>