- Timestamp:
- 05/16/2005 04:10:44 PM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 04677b5
- Parents:
- 43ee4a1
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
pst/sgml/opensp.xml
r43ee4a1 re7323adb 1 <?xml version="1.0" encoding="ISO-8859-1"?> 1 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" 2 3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ … … 13 14 14 15 <sect1 id="opensp" xreflabel="OpenSP-&opensp-version;"> 15 <sect1info> 16 <othername>$LastChangedBy$</othername> 17 <date>$Date$</date> 18 </sect1info> 19 <?dbhtml filename="opensp.html"?> 20 <title>OpenSP-&opensp-version;</title> 21 <indexterm zone="opensp"> 22 <primary sortas="a-OpenSP">OpenSP</primary></indexterm> 23 24 <sect2> 25 <title>Introduction to <application>OpenSP</application></title> 26 27 <para>The <application>OpenSP</application> package contains a 28 <application>C++</application> library for using 29 <acronym>SGML</acronym>/<acronym>XML</acronym> files. 30 This is useful for validating, parsing and manipulating 31 <acronym>SGML</acronym> and <acronym>XML</acronym> 32 documents.</para> 33 34 <sect3><title>Package information</title> 35 <itemizedlist spacing='compact'> 36 <listitem><para>Download (HTTP): <ulink 37 url="&opensp-download-http;"/></para></listitem> 38 <listitem><para>Download (FTP): <ulink 39 url="&opensp-download-ftp;"/></para></listitem> 40 <listitem><para>Download MD5 sum: &opensp-md5sum;</para></listitem> 41 <listitem><para>Download size: &opensp-size;</para></listitem> 42 <listitem><para>Estimated disk space required: 43 &opensp-buildsize;</para></listitem> 44 <listitem><para>Estimated build time: 45 &opensp-time;</para></listitem></itemizedlist> 46 </sect3> 47 48 <sect3><title>Additional downloads</title> 49 <itemizedlist spacing='compact'> 50 <listitem><para>Required Patch (removes some annoying messages that can appear 51 while running <command>openjade</command>): <ulink 52 url="&patch-root;/OpenSP-&opensp-version;-LITLEN-1.patch"/></para></listitem> 53 <listitem><para>Required Patch: <ulink 54 url="&patch-root;/OpenSP-&opensp-version;-gcc34-1.patch"/></para></listitem> 55 </itemizedlist></sect3> 56 57 <sect3><title><application>OpenSP</application> dependencies</title> 58 <sect4><title>Required</title> 59 <para><xref linkend="sgml-common"/></para> 60 </sect4> 61 </sect3> 62 63 </sect2> 64 65 <sect2> 66 <title>Installation of <application>OpenSP</application></title> 67 68 <para>Install <application>OpenSP</application> by running the following 69 commands:</para> 70 71 <screen><userinput><command>patch -Np1 -i ../OpenSP-&opensp-version;-LITLEN-1.patch && 16 <?dbhtml filename="opensp.html"?> 17 18 <sect1info> 19 <othername>$LastChangedBy$</othername> 20 <date>$Date$</date> 21 </sect1info> 22 23 <title>OpenSP-&opensp-version;</title> 24 25 <indexterm zone="opensp"> 26 <primary sortas="a-OpenSP">OpenSP</primary> 27 </indexterm> 28 29 <sect2 role="package"> 30 <title>Introduction to OpenSP</title> 31 32 <para>The <application>OpenSP</application> package contains a 33 <application>C++</application> library for using SGML/XML files. 34 This is useful for validating, parsing and manipulating SGML and XML 35 documents.</para> 36 37 <bridgehead renderas="sect3">Package Information</bridgehead> 38 <itemizedlist spacing="compact"> 39 <listitem> 40 <para>Download (HTTP): <ulink url="&opensp-download-http;"/></para> 41 </listitem> 42 <listitem> 43 <para>Download (FTP): <ulink url="&opensp-download-ftp;"/></para> 44 </listitem> 45 <listitem> 46 <para>Download MD5 sum: &opensp-md5sum;</para> 47 </listitem> 48 <listitem> 49 <para>Download size: &opensp-size;</para> 50 </listitem> 51 <listitem> 52 <para>Estimated disk space required: &opensp-buildsize;</para> 53 </listitem> 54 <listitem> 55 <para>Estimated build time: &opensp-time;</para> 56 </listitem> 57 </itemizedlist> 58 59 <bridgehead renderas="sect3">Additional Downloads</bridgehead> 60 <itemizedlist spacing='compact'> 61 <listitem> 62 <para>Required Patch (removes some annoying messages that can appear 63 while running <command>openjade</command>): <ulink 64 url="&patch-root;/OpenSP-&opensp-version;-LITLEN-1.patch"/></para> 65 </listitem> 66 <listitem> 67 <para>Required Patch: <ulink 68 url="&patch-root;/OpenSP-&opensp-version;-gcc34-1.patch"/></para> 69 </listitem> 70 </itemizedlist> 71 72 <bridgehead renderas="sect3">OpenSP Dependencies</bridgehead> 73 74 <bridgehead renderas="sect4">Required</bridgehead> 75 <para><xref linkend="sgml-common"/></para> 76 77 </sect2> 78 79 <sect2 role="installation"> 80 <title>Installation of OpenSP</title> 81 82 <para>Install <application>OpenSP</application> by running the following 83 commands:</para> 84 85 <screen><userinput>patch -Np1 -i ../OpenSP-&opensp-version;-LITLEN-1.patch && 72 86 patch -Np1 -i ../OpenSP-&opensp-version;-gcc34-1.patch && 73 87 ./configure --prefix=/usr --disable-static --enable-http \ 74 88 --enable-default-catalog=/etc/sgml/catalog \ 75 89 --enable-default-search-path=/usr/share/sgml && 76 make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version;</ command></userinput></screen>77 78 <para>Now, as the rootuser:</para>79 80 <screen ><userinput role='root'><command>make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; install &&81 ln - sf onsgmls /usr/bin/nsgmls &&82 ln - sf osgmlnorm /usr/bin/sgmlnorm &&83 ln - sf ospam /usr/bin/spam &&84 ln - sf ospcat /usr/bin/spcat &&85 ln - sf ospent /usr/bin/spent &&86 ln - sf osx /usr/bin/sx &&87 ln - sf osx /usr/bin/sgml2xml &&88 ln - sf libosp.so /usr/lib/libsp.so</command></userinput></screen>89 90 <!-- 90 make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version;</userinput></screen> 91 92 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 93 94 <screen role="root"><userinput>make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; install && 95 ln -v -sf onsgmls /usr/bin/nsgmls && 96 ln -v -sf osgmlnorm /usr/bin/sgmlnorm && 97 ln -v -sf ospam /usr/bin/spam && 98 ln -v -sf ospcat /usr/bin/spcat && 99 ln -v -sf ospent /usr/bin/spent && 100 ln -v -sf osx /usr/bin/sx && 101 ln -v -sf osx /usr/bin/sgml2xml && 102 ln -v -sf libosp.so /usr/lib/libsp.so</userinput></screen> 103 104 <!-- 91 105 install-catalog -add /etc/sgml/OpenSP-&opensp-version;.cat \ 92 106 /usr/share/sgml/OpenSP-&opensp-version;/catalog && … … 102 116 --> 103 117 104 </sect2> 105 106 <sect2> 107 <title>Command explanations</title> 108 109 <para><option>--disable-static</option>: This switch prevents 110 the building of the static library.</para> 111 112 <para><option>--enable-http</option>: This switch adds support 113 for <acronym>HTTP</acronym>.</para> 114 115 <para><parameter>--enable-default-catalog=/etc/sgml/catalog</parameter>: This 116 switch sets the path to the centralized catalog.</para> 117 118 <para><parameter>--enable-default-search-path</parameter>: This switch 119 sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para> 120 121 <para><option>--enable-xml-messages</option>: This switch adds 122 support for <acronym>XML</acronym> Formatted Messages.</para> 123 124 <para><command>make 125 pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version;</command>: This sets the 126 pkgdatadir variable in the <filename>Makefile</filename> from 127 <filename class="directory">/usr/share/OpenSP</filename> to 128 <filename class="directory">/usr/share/sgml/OpenSP-&opensp-version;</filename>. 129 </para> 130 131 <para><command>ln -sf ...</command>: These commands create the 132 <application>SP</application> equivalents of 133 <application>OpenSP</application> executables and libraries.</para> 134 135 </sect2> 136 137 <sect2> 138 <title>Contents</title> 139 140 <segmentedlist> 141 <segtitle>Installed Programs</segtitle> 142 <segtitle>Installed Library</segtitle> 143 <segtitle>Installed Directories</segtitle> 144 145 <seglistitem> 146 <seg>onsgmls, osgmlnorm, ospam, ospcat, ospent, osx and the 147 <application>SP</application> equivalent symlinks: nsgmls, sgml2xml, sgmlnorm, 148 spam, spcat, spent and sx</seg> 149 <seg>libosp.so and the <application>SP</application> equivalent symlink: 150 libsp.so</seg> 151 <seg>/usr/include/OpenSP, /usr/share/doc/OpenSP and 152 /usr/share/sgml/OpenSP-&opensp-version;</seg> 153 </seglistitem> 154 </segmentedlist> 155 156 <variablelist> 157 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 158 <?dbfo list-presentation="list"?> 159 160 <varlistentry id="onsgmls"> 161 <term><command>onsgmls</command></term> 162 <listitem><para>is used to process <acronym>SGML</acronym> files.</para> 163 <indexterm zone="opensp onsgmls"> 164 <primary sortas="b-onsgmls">onsgmls</primary> 165 </indexterm></listitem> 166 </varlistentry> 167 168 <varlistentry id="osgmlnorm"> 169 <term><command>osgmlnorm</command></term> 170 <listitem><para>prints on the standard output a normalized document instance 171 for the SGML document contained in the concatenation of the entities with 172 system identifiers .nf and .fi.</para> 173 <indexterm zone="opensp osgmlnorm"> 174 <primary sortas="b-osgmlnorm">osgmlnorm</primary> 175 </indexterm></listitem> 176 </varlistentry> 177 178 <varlistentry id="ospam"> 179 <term><command>ospam</command></term> 180 <listitem><para>is a markup stream editor.</para> 181 <indexterm zone="opensp ospam"> 182 <primary sortas="b-ospam">ospam</primary> 183 </indexterm></listitem> 184 </varlistentry> 185 186 <varlistentry id="ospcat"> 187 <term><command>ospcat</command></term> 188 <listitem><para>prints effective system identifiers found in the 189 catalogs.</para> 190 <indexterm zone="opensp ospcat"> 191 <primary sortas="b-ospcat">ospcat</primary> 192 </indexterm></listitem> 193 </varlistentry> 194 195 <varlistentry id="ospent"> 196 <term><command>ospent</command></term> 197 <listitem><para>provides access to <application>OpenSP</application>'s 198 entity manager.</para> 199 <indexterm zone="opensp ospent"> 200 <primary sortas="b-ospent">ospent</primary> 201 </indexterm></listitem> 202 </varlistentry> 203 204 <varlistentry id="osx"> 205 <term><command>osx</command></term> 206 <listitem><para>is an <acronym>SGML</acronym> normalizer or used to convert 207 <acronym>SGML</acronym> files to <acronym>XML</acronym> files.</para> 208 <indexterm zone="opensp osx"> 209 <primary sortas="b-osx">osx</primary> 210 </indexterm></listitem> 211 </varlistentry> 212 213 <varlistentry id="nsgmls"> 214 <term><command>nsgmls</command></term> 215 <listitem><para>is a symlink to <command>onsgmls</command>.</para> 216 <indexterm zone="opensp nsgmls"> 217 <primary sortas="g-nsgmls">nsgmls</primary> 218 </indexterm></listitem> 219 </varlistentry> 220 221 <varlistentry id="sgml2xml"> 222 <term><command>sgml2xml</command></term> 223 <listitem><para>is a symlink to <command>osx</command>.</para> 224 <indexterm zone="opensp sgml2xml"> 225 <primary sortas="g-sgml2xml">sgml2xml</primary> 226 </indexterm></listitem> 227 </varlistentry> 228 229 <varlistentry id="sgmlnorm"> 230 <term><command>sgmlnorm</command></term> 231 <listitem><para>is a symlink to <command>osgmlnorm</command>.</para> 232 <indexterm zone="opensp sgmlnorm"> 233 <primary sortas="g-sgmlnorm">sgmlnorm</primary> 234 </indexterm></listitem> 235 </varlistentry> 236 237 <varlistentry id="spam"> 238 <term><command>spam</command></term> 239 <listitem><para>is a symlink to <command>ospam</command>.</para> 240 <indexterm zone="opensp spam"> 241 <primary sortas="g-spam">spam</primary> 242 </indexterm></listitem> 243 </varlistentry> 244 245 <varlistentry id="spcat"> 246 <term><command>spcat</command></term> 247 <listitem><para>is a symlink to <command>ospcat</command>.</para> 248 <indexterm zone="opensp spcat"> 249 <primary sortas="g-spcat">spcat</primary> 250 </indexterm></listitem> 251 </varlistentry> 252 253 <varlistentry id="spent"> 254 <term><command>spent</command></term> 255 <listitem><para>is a symlink to <command>ospent</command>.</para> 256 <indexterm zone="opensp spent"> 257 <primary sortas="g-spent">spent</primary> 258 </indexterm></listitem> 259 </varlistentry> 260 261 <varlistentry id="sx"> 262 <term><command>sx</command></term> 263 <listitem><para>is a symlink to <command>osx</command>.</para> 264 <indexterm zone="opensp sx"> 265 <primary sortas="g-sx">sx</primary> 266 </indexterm></listitem> 267 </varlistentry> 268 269 <varlistentry id="libosp"> 270 <term><filename class='libraryfile'>libosp.so</filename></term> 271 <listitem><para>contains functions required by the 272 <application>OpenSP</application> programs to parse, validate and 273 manipulate SGML and XML files.</para> 274 <indexterm zone="opensp libosp"> 275 <primary sortas="c-libosp">libosp.so</primary> 276 </indexterm></listitem> 277 </varlistentry> 278 279 <varlistentry id="libsp"> 280 <term><filename class='libraryfile'>libsp.so</filename></term> 281 <listitem><para>is a symlink to 282 <filename class='libraryfile'>libosp.so</filename>.</para> 283 <indexterm zone="opensp libsp"> 284 <primary sortas="g-libsp">libsp.so</primary> 285 </indexterm></listitem> 286 </varlistentry> 287 </variablelist> 288 289 </sect2> 118 </sect2> 119 120 <sect2 role="commands"> 121 <title>Command Explanations</title> 122 123 <para><parameter>--disable-static</parameter>: This switch prevents 124 the building of the static library.</para> 125 126 <para><parameter>--enable-http</parameter>: This switch adds support 127 for HTTP.</para> 128 129 <para><parameter>--enable-default-catalog=/etc/sgml/catalog</parameter>: 130 This switch sets the path to the centralized catalog.</para> 131 132 <para><parameter>--enable-default-search-path</parameter>: This switch 133 sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para> 134 135 <para><option>--enable-xml-messages</option>: This switch adds 136 support for XML Formatted Messages.</para> 137 138 <para><command>make 139 pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version;</command>: This sets the 140 pkgdatadir variable in the <filename>Makefile</filename> from 141 <filename class="directory">/usr/share/OpenSP</filename> to <filename 142 class="directory">/usr/share/sgml/OpenSP-&opensp-version;</filename>.</para> 143 144 <para><command>ln -v -sf ...</command>: These commands create the 145 <application>SP</application> equivalents of 146 <application>OpenSP</application> executables and libraries.</para> 147 148 </sect2> 149 150 <sect2 role="content"> 151 <title>Contents</title> 152 153 <segmentedlist> 154 <segtitle>Installed Programs</segtitle> 155 <segtitle>Installed Library</segtitle> 156 <segtitle>Installed Directories</segtitle> 157 158 <seglistitem> 159 <seg>onsgmls, osgmlnorm, ospam, ospcat, ospent, osx, and the 160 <application>SP</application> equivalent symlinks: nsgmls, sgml2xml, 161 sgmlnorm, spam, spcat, spent, and sx</seg> 162 <seg>libosp.so and the <application>SP</application> equivalent symlink: 163 libsp.so</seg> 164 <seg>/usr/include/OpenSP, /usr/share/doc/OpenSP, and 165 /usr/share/sgml/OpenSP-&opensp-version;</seg> 166 </seglistitem> 167 </segmentedlist> 168 169 <variablelist> 170 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 171 <?dbfo list-presentation="list"?> 172 <?dbhtml list-presentation="table"?> 173 174 <varlistentry id="onsgmls"> 175 <term><command>onsgmls</command></term> 176 <listitem> 177 <para>is used to process SGML files.</para> 178 <indexterm zone="opensp onsgmls"> 179 <primary sortas="b-onsgmls">onsgmls</primary> 180 </indexterm> 181 </listitem> 182 </varlistentry> 183 184 <varlistentry id="osgmlnorm"> 185 <term><command>osgmlnorm</command></term> 186 <listitem> 187 <para>prints on the standard output a normalized document instance 188 for the SGML document contained in the concatenation of the entities 189 with system identifiers .nf and .fi.</para> 190 <indexterm zone="opensp osgmlnorm"> 191 <primary sortas="b-osgmlnorm">osgmlnorm</primary> 192 </indexterm> 193 </listitem> 194 </varlistentry> 195 196 <varlistentry id="ospam"> 197 <term><command>ospam</command></term> 198 <listitem> 199 <para>is a markup stream editor.</para> 200 <indexterm zone="opensp ospam"> 201 <primary sortas="b-ospam">ospam</primary> 202 </indexterm> 203 </listitem> 204 </varlistentry> 205 206 <varlistentry id="ospcat"> 207 <term><command>ospcat</command></term> 208 <listitem> 209 <para>prints effective system identifiers found in the catalogs.</para> 210 <indexterm zone="opensp ospcat"> 211 <primary sortas="b-ospcat">ospcat</primary> 212 </indexterm> 213 </listitem> 214 </varlistentry> 215 216 <varlistentry id="ospent"> 217 <term><command>ospent</command></term> 218 <listitem> 219 <para>provides access to <application>OpenSP</application>'s 220 entity manager.</para> 221 <indexterm zone="opensp ospent"> 222 <primary sortas="b-ospent">ospent</primary> 223 </indexterm> 224 </listitem> 225 </varlistentry> 226 227 <varlistentry id="osx"> 228 <term><command>osx</command></term> 229 <listitem> 230 <para>is an SGML normalizer or used to convert 231 SGML files to XML files.</para> 232 <indexterm zone="opensp osx"> 233 <primary sortas="b-osx">osx</primary> 234 </indexterm> 235 </listitem> 236 </varlistentry> 237 238 <varlistentry id="nsgmls"> 239 <term><command>nsgmls</command></term> 240 <listitem> 241 <para>is a symlink to <command>onsgmls</command>.</para> 242 <indexterm zone="opensp nsgmls"> 243 <primary sortas="g-nsgmls">nsgmls</primary> 244 </indexterm> 245 </listitem> 246 </varlistentry> 247 248 <varlistentry id="sgml2xml"> 249 <term><command>sgml2xml</command></term> 250 <listitem> 251 <para>is a symlink to <command>osx</command>.</para> 252 <indexterm zone="opensp sgml2xml"> 253 <primary sortas="g-sgml2xml">sgml2xml</primary> 254 </indexterm> 255 </listitem> 256 </varlistentry> 257 258 <varlistentry id="sgmlnorm"> 259 <term><command>sgmlnorm</command></term> 260 <listitem> 261 <para>is a symlink to <command>osgmlnorm</command>.</para> 262 <indexterm zone="opensp sgmlnorm"> 263 <primary sortas="g-sgmlnorm">sgmlnorm</primary> 264 </indexterm> 265 </listitem> 266 </varlistentry> 267 268 <varlistentry id="spam"> 269 <term><command>spam</command></term> 270 <listitem> 271 <para>is a symlink to <command>ospam</command>.</para> 272 <indexterm zone="opensp spam"> 273 <primary sortas="g-spam">spam</primary> 274 </indexterm> 275 </listitem> 276 </varlistentry> 277 278 <varlistentry id="spcat"> 279 <term><command>spcat</command></term> 280 <listitem> 281 <para>is a symlink to <command>ospcat</command>.</para> 282 <indexterm zone="opensp spcat"> 283 <primary sortas="g-spcat">spcat</primary> 284 </indexterm> 285 </listitem> 286 </varlistentry> 287 288 <varlistentry id="spent"> 289 <term><command>spent</command></term> 290 <listitem> 291 <para>is a symlink to <command>ospent</command>.</para> 292 <indexterm zone="opensp spent"> 293 <primary sortas="g-spent">spent</primary> 294 </indexterm> 295 </listitem> 296 </varlistentry> 297 298 <varlistentry id="sx"> 299 <term><command>sx</command></term> 300 <listitem> 301 <para>is a symlink to <command>osx</command>.</para> 302 <indexterm zone="opensp sx"> 303 <primary sortas="g-sx">sx</primary> 304 </indexterm> 305 </listitem> 306 </varlistentry> 307 308 <varlistentry id="libosp"> 309 <term><filename class='libraryfile'>libosp.so</filename></term> 310 <listitem> 311 <para>contains functions required by the 312 <application>OpenSP</application> programs to parse, validate and 313 manipulate SGML and XML files.</para> 314 <indexterm zone="opensp libosp"> 315 <primary sortas="c-libosp">libosp.so</primary> 316 </indexterm> 317 </listitem> 318 </varlistentry> 319 320 <varlistentry id="libsp"> 321 <term><filename class='libraryfile'>libsp.so</filename></term> 322 <listitem> 323 <para>is a symlink to 324 <filename class='libraryfile'>libosp.so</filename>.</para> 325 <indexterm zone="opensp libsp"> 326 <primary sortas="g-libsp">libsp.so</primary> 327 </indexterm> 328 </listitem> 329 </varlistentry> 330 331 </variablelist> 332 333 </sect2> 290 334 291 335 </sect1> 292
Note:
See TracChangeset
for help on using the changeset viewer.