"/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd">

<article>

  <articleinfo>

    <title>ospent</title>

    <author>

      <firstname>James</firstname>

      <surname>Clark</surname>

    </author>

    <author>

      <firstname>Ian</firstname>

      <surname>Castle</surname>

      <affiliation><address><email>ian.castle@openjade.org</email></address></affiliation>

    </author>

    <copyright>

      <year>2002</year>

      <holder>OpenJade Project</holder>

    </copyright>

  </articleinfo>

  <section>

    <title>Reference</title>

    <refentry>

      <refentryinfo>

        <title>ospent</title>

        <date>November 2002</date>

        <productname>OpenJade</productname>

      </refentryinfo>

      <refmeta>

        <refentrytitle>ospent</refentrytitle>

        <manvolnum>1</manvolnum>

      </refmeta>

      <refnamediv>

        <refname>ospent</refname>

        <refpurpose>Concatenates entities in an SGML/XML document</refpurpose>

      </refnamediv>

      <refsynopsisdiv>

        <cmdsynopsis>

          <command>ospent</command>

          <arg choice="opt"><option>-ChnrRv</option></arg>

          <arg choice="opt"><option>-b<replaceable>bctf</replaceable></option></arg>

          <arg choice="opt"><option>-c<replaceable>sysid</replaceable></option></arg>

          <arg choice="opt"><option>-f<replaceable>file</replaceable></option></arg>

          <arg choice="opt"><option>-D<replaceable>directory</replaceable></option></arg>

          <arg rep="repeat"><replaceable>sysid</replaceable></arg>

        </cmdsynopsis>

      </refsynopsisdiv>

   spent [ -Cnrv ] [ -bbctf ] [ -Ddirectory ] sysid...

-->

      <refsect1>

        <title>Description</title>

   <para><command>ospent</command> (OpenSP print entity) prints the concatenation of the entities

   with system identifiers <cmdsynopsis><arg rep="repeat"><replaceable>sysid</replaceable></arg></cmdsynopsis> on the standard output.</para>

   <para>The following options are available:</para>

   <variablelist>

     <varlistentry>

     <term><option>-b<replaceable>bctf</replaceable></option></term>

     <term><option>--bctf=<replaceable>bctf</replaceable></option></term>

     <listitem>

          <para>Use the BCTF with name <replaceable>bctf</replaceable> for output.</para>

     </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-c<replaceable>sysid</replaceable></option></term>

       <term><option>--catalog=<replaceable>sysid</replaceable></option></term>

       <listitem>

          <para>Map public identifiers and entity names to system identifiers

          using the catalog entry file whose system identifier is 

          <replaceable>sysid</replaceable>.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-C</option></term>

       <term><option>--catalogs</option></term>

       <listitem>

          <para>This has the same effect as in <command>onsgmls(1)</command>.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-D<replaceable>directory</replaceable></option></term>

       <term><option>--directory=<replaceable>directory</replaceable></option></term>

       <listitem>

          <para>Search directory for files specified in system identifiers.

          This has the same effect as in <command>onsgmls(1)</command>.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-f<replaceable>file</replaceable></option></term>

       <term><option>--error-file=<replaceable>file</replaceable></option></term>

       <listitem>

          <para>Redirect error messages to <replaceable>file</replaceable>.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-h</option></term>

       <term><option>--help</option></term>

       <listitem>

          <para>Display a help text and exit.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-n</option></term>

       <term><option>--non-sgml</option></term>

       <listitem>

         <para>The entity is a non-SGML data entity. This option forces the

          octets in the storage objects comprising the entity to be

          copied exactly without any of the conversions that are done for

          text entities. Implies <option>-r</option>.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-r</option></term>

       <term><option>--raw</option></term>

       <listitem>

          <para>Raw output. Don't perform any conversion on RSs and REs when

          printing the entity. The entity would typically have the

          storage manager attribute records=asis.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-R</option></term>

       <term><option>--restricted</option></term>

       <listitem>

          <para>This has the same effect as in <command>onsgmls(1)</command>.</para>

       </listitem>

     </varlistentry>

     <varlistentry>

       <term><option>-v</option></term>

       <term><option>--version</option></term>

       <listitem>

          <para>Print the version number.</para>

       </listitem>

     </varlistentry>

   </variablelist>

   </refsect1>

   <refsect1>

     <title>See Also</title>

     <para><command>onsgmls(1)</command>, <command>ospam(1)</command>,

     <command>onsgmlnorm(1)</command>, <command>osx(1)</command></para>

   </refsect1>

   </refentry>

   </section>

</article>