<?xml version="1.0" encoding="utf-8"?>
<section id="S__db-xref">
  <title>DocBook Cross References</title>
  <remark>This needs documentation</remark>
  <variablelist>
    <title>Modes</title>
    <varlistentry>
      <term>
        <link linkend="M__db_xref_content_mode">
          <function>db.xref.content.mode</function>
        </link>
      </term>
      <listitem>
        <para>FIXME</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <link linkend="M__db_xref_tooltip_mode">
          <function>db.xref.tooltip.mode</function>
        </link>
      </term>
      <listitem>
        <para>FIXME</para>
      </listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <title>Templates</title>
    <varlistentry>
      <term>
        <link linkend="T__db_ulink_tooltip">
          <function>db.ulink.tooltip</function>
        </link>
      </term>
      <listitem>
        <para>Generates the tooltip for an external link</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <link linkend="T__db_xref_content">
          <function>db.xref.content</function>
        </link>
      </term>
      <listitem>
        <para>Generates the content of a cross reference</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <link linkend="T__db_xref_target">
          <function>db.xref.target</function>
        </link>
      </term>
      <listitem>
        <para>Generates the target identifier of a cross reference</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        <link linkend="T__db_xref_tooltip">
          <function>db.xref.tooltip</function>
        </link>
      </term>
      <listitem>
        <para>Generates the tooltip for a cross reference</para>
      </listitem>
    </varlistentry>
  </variablelist>
  <refentry id="M__db_xref_content_mode">
    <indexterm>
      <primary>db.xref.content.mode</primary>
    </indexterm>
    <refnamediv>
      <refname>
        <function>db.xref.content.mode</function>
      </refname>
      <refpurpose>FIXME</refpurpose>
    </refnamediv>
    <refsection>
      <title>Parameters</title>
      <variablelist>
        <varlistentry>
          <term>
            <parameter>xrefstyle</parameter>
          </term>
          <listitem>
            <para>The cross reference style, usually from the <literal>xrefstyle</literal> attribute</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>role</parameter>
          </term>
          <listitem>
            <para>For a role-based <parameter>xrefstyle</parameter>, the role of the cross reference</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </refsection>
    <refsection><title>Description</title>
  <remark>Document this mode</remark>
  </refsection>
  </refentry>
  <refentry id="M__db_xref_tooltip_mode">
    <indexterm>
      <primary>db.xref.tooltip.mode</primary>
    </indexterm>
    <refnamediv>
      <refname>
        <function>db.xref.tooltip.mode</function>
      </refname>
      <refpurpose>FIXME</refpurpose>
    </refnamediv>
    <refsection><title>Description</title>
  <remark>Document this</remark>
  </refsection>
  </refentry>
  <refentry id="T__db_ulink_tooltip">
    <indexterm>
      <primary>db.ulink.tooltip</primary>
    </indexterm>
    <refnamediv>
      <refname>
        <function>db.ulink.tooltip</function>
      </refname>
      <refpurpose>Generates the tooltip for an external link</refpurpose>
    </refnamediv>
    <refsection>
      <title>Parameters</title>
      <variablelist>
        <varlistentry>
          <term>
            <parameter>node</parameter>
          </term>
          <listitem>
            <para>The element to generate a tooltip for</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>url</parameter>
          </term>
          <listitem>
            <para>The URL of the link, usually from the <literal>url</literal> attribute</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </refsection>
    <refsection>
      <title>Description</title>
      <remark>This needs documentation</remark>
    </refsection>
  </refentry>
  <refentry id="T__db_xref_content">
    <indexterm>
      <primary>db.xref.content</primary>
    </indexterm>
    <refnamediv>
      <refname>
        <function>db.xref.content</function>
      </refname>
      <refpurpose>Generates the content of a cross reference</refpurpose>
    </refnamediv>
    <refsection>
      <title>Parameters</title>
      <variablelist>
        <varlistentry>
          <term>
            <parameter>linkend</parameter>
          </term>
          <listitem>
            <para>The id of the linked-to element, usually from the <literal>linkend</literal> attribute</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>target</parameter>
          </term>
          <listitem>
            <para>The linked-to element</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>xrefstyle</parameter>
          </term>
          <listitem>
            <para>The cross reference style, usually from the <literal>xrefstyle</literal> attribute</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>role</parameter>
          </term>
          <listitem>
            <para>For a role-based <parameter>xrefstyle</parameter>, the role of the cross reference</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </refsection>
    <refsection><title>Description</title>
  <remark>The xrefstyle/role stuff needs to be documented</remark>
  </refsection>
  </refentry>
  <refentry id="T__db_xref_target">
    <indexterm>
      <primary>db.xref.target</primary>
    </indexterm>
    <refnamediv>
      <refname>
        <function>db.xref.target</function>
      </refname>
      <refpurpose>Generates the target identifier of a cross reference</refpurpose>
    </refnamediv>
    <refsection>
      <title>Parameters</title>
      <variablelist>
        <varlistentry>
          <term>
            <parameter>linkend</parameter>
          </term>
          <listitem>
            <para>The id of the linked-to element, usually from the <literal>linkend</literal> attribute</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>target</parameter>
          </term>
          <listitem>
            <para>The linked-to element</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>is_chunk</parameter>
          </term>
          <listitem>
            <para>Whether <parameter>target</parameter> is known to be a chunked element</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </refsection>
    <refsection><title>Description</title>
  <remark>Talk about how this works with chunking</remark>
  </refsection>
  </refentry>
  <refentry id="T__db_xref_tooltip">
    <indexterm>
      <primary>db.xref.tooltip</primary>
    </indexterm>
    <refnamediv>
      <refname>
        <function>db.xref.tooltip</function>
      </refname>
      <refpurpose>Generates the tooltip for a cross reference</refpurpose>
    </refnamediv>
    <refsection>
      <title>Parameters</title>
      <variablelist>
        <varlistentry>
          <term>
            <parameter>linkend</parameter>
          </term>
          <listitem>
            <para>The id of the linked-to element, usually from the <literal>linkend</literal> attribute</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <parameter>target</parameter>
          </term>
          <listitem>
            <para>The linked-to element</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </refsection>
    <refsection><title>Description</title>
  <remark>Document this</remark>
  </refsection>
  </refentry>
</section>
