diff --git a/introduction/welcome/changelog.xml b/introduction/welcome/changelog.xml index e896966887..d39ce2b057 100644 --- a/introduction/welcome/changelog.xml +++ b/introduction/welcome/changelog.xml @@ -20,8 +20,10 @@ who wrote what. July 27th, 2004 [randy]: Added FTP download location to OpenSP; changed FTP download location and removed redundant sed command -in DocBook-DTD-3.1 instructions; added UnZip as an optional dependency and -changed sed commands to in-place edits on DocBook-DTD instructions. +in DocBook-DTD-3.1 instructions; added UnZip as a required dependency and +changed sed commands to in-place edits in DocBook-DTD instructions; added +missing tags to OpenJade instructions; added FTP download location and +added UnZip as a required dependency to DocBook XML DTD. July 27th, 2004 [randy]: Added pkgconfig as an optional diff --git a/pst/sgml/openjade.xml b/pst/sgml/openjade.xml index 7c7f1ff416..1b41a04dc7 100644 --- a/pst/sgml/openjade.xml +++ b/pst/sgml/openjade.xml @@ -46,7 +46,8 @@ url="&openjade-download-ftp;"/> Installation of <application>OpenJade</application> -Install OpenJade by running the following commands: +Install OpenJade by running the following +commands: ./configure --prefix=/usr --enable-http --disable-static \ --enable-default-catalog=/etc/sgml/catalog \ @@ -80,10 +81,11 @@ for HTTP. --enable-default-catalog=/etc/sgml/catalog: This switch sets the path to the centralized catalog. -: This switch +--enable-default-search-path: This switch sets the default value of SGML_SEARCH_PATH. ---datadir=/usr/share/sgml/openjade-&openjade-version;: This switch puts data files in +--datadir=/usr/share/sgml/openjade-&openjade-version;: +This switch puts data files in /usr/share/sgml/openjade-&openjade-version; instead of /usr/share. @@ -91,8 +93,8 @@ sets the default value of SGML_SEARCH_PATH. ln -sf libogrove.so /usr/lib/libgrove.so ln -sf libospgrove.so /usr/lib/libspgrove.so ln -sf libostyle.so /usr/lib/libstyle.so -These commands create the Jade equivalents of OpenJade executables and -libraries. +These commands create the Jade equivalents of +OpenJade executables and libraries. @@ -104,6 +106,7 @@ libraries. echo "SYSTEM \"http://www.oasis-open.org/docbook/xml/&DocBook-version;/docbookx.dtd\" \ \"/usr/share/xml/docbook/xml-dtd-&DocBook-version;/docbookx.dtd\"" >> \ /usr/share/sgml/openjade-&openjade-version;/catalog + This configuration is only necessary if you intend to use OpenJade to process the BLFS XML files through @@ -117,15 +120,16 @@ libraries. Contents The OpenJade package contains -openjade. +openjade and the OpenJade +libraries. Description openjade -openjade is a DSSSL engine used for transformations. - +openjade is a DSSSL engine used for +transformations. diff --git a/pst/xml/docbook.xml b/pst/xml/docbook.xml index 71cca4cc03..8275df1af8 100644 --- a/pst/xml/docbook.xml +++ b/pst/xml/docbook.xml @@ -4,7 +4,7 @@ %general-entities; - + @@ -15,12 +15,15 @@ DocBook XML DTD-&DocBook-version; -Introduction to <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application> +Introduction to <application>DocBook <acronym>XML</acronym> +<acronym>DTD</acronym></application> -The DocBook XML DTD-&DocBook-version; package contains document type definitions for -verification of XML data files against the DocBook rule -set. These are useful for structuring books and software documentation -to a standard allowing you to utilize transformations already written for that standard. +The DocBook XML +DTD-&DocBook-version; package contains +document type definitions for verification of XML data +files against the DocBook rule set. These are useful for structuring books +and software documentation to a standard allowing you to utilize +transformations already written for that standard. Package information @@ -31,17 +34,22 @@ to a standard allowing you to utilize transformations already written for that s Estimated build time: &DocBook-time; -<application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application> &DocBook-version; dependencies +<application>DocBook <acronym>XML</acronym> +<acronym>DTD</acronym></application> &DocBook-version; dependencies Required - + and -Installation of <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application> +Installation of <application>DocBook <acronym>XML</acronym> +<acronym>DTD</acronym></application> -Install DocBook XML DTD by running the following commands: + + +Install DocBook XML +DTD by running the following commands: install -d /usr/share/xml/docbook/xml-dtd-&DocBook-version; && cp -af docbook.cat *.dtd ent/ *.mod /usr/share/xml/docbook/xml-dtd-&DocBook-version; && @@ -105,10 +113,12 @@ xmlcatalog --noout --add "delegateURI" \ -Configuring <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application> +Configuring <application>DocBook <acronym>XML</acronym> +<acronym>DTD</acronym></application> Config files -/etc/xml/catalog, /etc/xml/docbook +/etc/xml/catalog, +/etc/xml/docbook Configuration Information @@ -147,21 +157,23 @@ xmlcatalog --noout --add "rewriteURI" \ Contents -The DocBook XML DTD package contains DTD files, -MOD files and ENT files. +The DocBook XML +DTD package contains DTD +files, MOD files and ENT files. Description DTD files -DTD files contain a document type definition which defines the -element types and the attribute lists that can be used in the +DTD files contain a document type definition which +defines the element types and the attribute lists that can be used in the corresponding XML files. MOD files -MOD files contain components of the document type definition that are -sourced into the DTD files. +MOD files contain components of the document type +definition that are sourced into the DTD files. + ENT files ENT files contain lists of named character entities