<?xml version="1.0" encoding="UTF-8"?>
<topic version="5.2" xml:id="install_files"
       xmlns="http://docbook.org/ns/docbook">
  <info>
    <title>Contents of the installation directory</title>
  </info>

  <variablelist>
    <varlistentry>
      <term><filename>bin/</filename></term>

      <term><filename>bin/assembly</filename></term>

      <term><filename>bin/assembly.bat</filename></term>

      <listitem>
        <para>Contains the <command>assembly</command> command-line utility.
        Use shell script <filename>assembly</filename> on Linux and on the
        Mac. Use <filename>assembly.bat</filename> on Windows.</para>

        <note>
          <title>JAXP limits</title>

          <para>This directory also contains file
          <filename>jaxp.properties</filename> which is referenced by the
          <filename>assembly</filename> scripts. As of Java™ version 24, the
          standard Java XML processing limits (<link
          xlink:href="https://docs.oracle.com/en/java/javase/24/docs/api/java.xml/module-summary.html#IN_ISFPtable"
          xmlns:xlink="http://www.w3.org/1999/xlink">JAXP limits</link>) are
          very restrictive and no longer allow to load large XML documents.
          Therefore this file is needed to increase Java XML processing
          limits.</para>
        </note>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term><filename>doc/</filename></term>

      <term><filename>doc/index.html</filename></term>

      <listitem>
        <para>Contains the documentation of <xi:include href="intro.xml"
        xpointer="dbasm" xmlns:xi="http://www.w3.org/2001/XInclude"/>.</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term><filename>docsrc/</filename></term>

      <term><filename>docsrc/manual.xml</filename></term>

      <listitem>
        <para>Contains the DocBook v5.2 source of the documentation of
        <xi:include href="intro.xml" xpointer="dbasm"
        xmlns:xi="http://www.w3.org/2001/XInclude"/>. File
        <filename>docsrc/manual.xml</filename> contains an assembly. You may
        want to use this sample DocBook v5.2 assembly to experiment with the
        <command>assembly</command> command-line utility.</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term><filename>legal/</filename></term>

      <term><filename>legal.txt</filename></term>

      <listitem>
        <para>Contains legal information about <xi:include href="intro.xml"
        xpointer="dbasm" xmlns:xi="http://www.w3.org/2001/XInclude"/> and
        about third-party components used in <xi:include href="intro.xml"
        xpointer="dbasm" xmlns:xi="http://www.w3.org/2001/XInclude"/>.</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term><filename>lib/<replaceable>*</replaceable>.jar</filename></term>

      <listitem>
        <para>All the <trademark class="trade">Java</trademark> class
        libraries needed to run <xi:include href="intro.xml" xpointer="dbasm"
        xmlns:xi="http://www.w3.org/2001/XInclude"/>:</para>

        <itemizedlist>
          <listitem>
            <para><filename>assembly.jar</filename> contain the code of
            <xi:include href="intro.xml" xpointer="dbasm"
            xmlns:xi="http://www.w3.org/2001/XInclude"/>.</para>
          </listitem>

          <listitem>
            <para><filename>xmlresolver.jar</filename> contains <link
            xlink:href="https://xmlresolver.org/"
            xmlns:xlink="http://www.w3.org/1999/xlink">XMLResolver</link>, an
            enhanced XML resolver with XML Catalog support</para>

            <para>This component is needed only if your assembly loads XML
            documents having a DTD (e.g. transform DITA topics to DocBook
            topics).</para>
          </listitem>
        </itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term><filename>src/</filename></term>

      <term><filename>src/build.xml</filename></term>

      <listitem>
        <para>Contains the <trademark>Java</trademark> source code of
        <xi:include href="intro.xml" xpointer="dbasm"
        xmlns:xi="http://www.w3.org/2001/XInclude"/>.
        <filename>src/build.xml</filename> is an <link
        xlink:href="https://ant.apache.org/"
        xmlns:xlink="http://www.w3.org/1999/xlink">ant</link> build file which
        allows to rebuild <filename>lib/assembly.jar</filename>.</para>
      </listitem>
    </varlistentry>
  </variablelist>
</topic>
