DocBook

Word processors, spreadsheets, presentations, translation, etc.
Post Reply
Message
Author
User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

DocBook

#1 Post by Sit Heel Speak »

***EDITED Dec. 08 2010: Read all the below if you want to know the recipe by which it was built; if you just want to download it, the Version 3.1 squashfile of DocBook, the whole ball o' wax, *and* a .PET package made under Quirky, is at this post, below.***
puppian, 15 Oct 2005 wrote:Actually I don't know what's "SGML document type definition" and what docBook does...
It is now more than five years later and still, frankly, neither do I.

However, I need to compile docbook because it is a dependency of (...a dependency of a dependency of...) the Sakura terminal emulator (if a truly *complete* Sakura build is done), which I need for my clfs-pup. And so, I plan to spend this entire lovely day enduring the sore haunches to compile and package and post the thing.

***edited: well, actually, it took about 100 Weimaraner-hours to finish this "modest" project :lol: ***

Compiled under http://distro.ibiblio.org/pub/linux/dis ... modems.iso

...but I don't think there is anything distro-specific in docbook ***edited: well, actually, when you include OpenSP and OpenJade it matters which kernel, glibc, and gcc you compile under; but, since here I'm compiling under k2.6.21.7, gcc 4.2.2, and glibc 2.6.1, this *should* work in all newer Puppies...***

Stay tuned...
.
Last edited by Sit Heel Speak on Wed 09 Feb 2011, 08:08, edited 6 times in total.

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 1 -- sgml-common-0.6.3

#2 Post by Sit Heel Speak »

sgml-common-0.6.3
http://www.linuxfromscratch.org/blfs/vi ... ommon.html

downloaded:
http://gd.tuwien.ac.at/hci/kde/devel/do ... -0.6.3.tgz
http://www.linuxfromscratch.org/patches ... ge-1.patch

The compiling was done with the changes to /etc/profile described here, to set compiler and linker flags.

Code: Select all

patch -Np1 -i ../sgml-common-0.6.3-manpage-1.patch
autoreconf -f -i
./configure $PUPPYCOMPILE
make
(for my Clipper packaging script, took a "before" snapshot, as explained here)

Code: Select all

new2dir make install
(From new2dir I chose to go directly to dir2pet, it created both an exe and a doc .pet)

Make pinstall.sh and puninstall.sh incorporating

Code: Select all

install-catalog --add /etc/sgml/sgml-ent.cat /usr/share/sgml/sgml-iso-entities-8879.1986/catalog
install-catalog --add /etc/sgml/sgml-docbook.cat /etc/sgml/sgml-ent.cat
and

Code: Select all

install-catalog --remove /etc/sgml/sgml-ent.cat /usr/share/sgml/sgml-iso-entities-8879.1986/catalog
install-catalog --remove /etc/sgml/sgml-docbook.cat /etc/sgml/sgml-ent.cat
(for my Clipper packaging script, took an "after" snapshot)

(created the package using my Clipper packaging script, manually separating-out the /usr/doc and /usr/man subdirectories into a _DOC pet which looks identical to the one produced by new2dir)

(the exe pet's however are not identical, since the one produced by my Clipper script emplaces the files installed by the install-catalog commands)

..hmm, got to emplace a spare copy of install-catalog so the puninstall will work correctly...OK, done, I think...
Attachments
makesfs.gz
The makesfs script, before separating-out the doc and man stuff
(803 Bytes) Downloaded 663 times
sgml-common-0.6.3.pet.gz
sgml-common-0.6.3.pet
(30.41 KiB) Downloaded 643 times
sgml-common_DOC-0.6.3.pet.gz
sgml-common_DOC-0.6.3.pet
(11.53 KiB) Downloaded 656 times
Last edited by Sit Heel Speak on Sat 04 Dec 2010, 20:24, edited 1 time in total.

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 2 -- DocBook SGML DTD-3.1

#3 Post by Sit Heel Speak »

***note: install this and the next one in order, i.e. don't install 4.5 and then 3.1. If you must have both, and already have 4.5 installed but not 3.1, first uninstall all the docbook .pet's after sgml-common from Puppy Package Manager, and then reinstall all the docbook .pet's in order***

DocBook SGML DTD-3.1
http://www.linuxfromscratch.org/blfs/vi ... dtd-3.html

Requires sgml-common-0.6.3 (above) to be mounted (in Puppy Package Manager)

downloaded:
http://www.docbook.org/sgml/3.1/docbk31.zip

It doesn't look like this is really a compiling task, merely an unzip-and-install task, therefore packaging it as a .pet is a job for ye olde Clipper script...

(take "before" snapshot, and then...)

Code: Select all

sed -i -e '/ISO 8879/d' -e 's|DTDDECL "-//OASIS//DTD DocBook V3.1//EN"|SGMLDECL|g' docbook.cat
install -v -d -m755 /usr/share/sgml/docbook/sgml-dtd-3.1
chown -R root:root .
install -v docbook.cat /usr/share/sgml/docbook/sgml-dtd-3.1/catalog
cp -v -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-3.1
install-catalog --add /etc/sgml/sgml-docbook-dtd-3.1.cat /usr/share/sgml/docbook/sgml-dtd-3.1/catalog
install-catalog --add /etc/sgml/sgml-docbook-dtd-3.1.cat /etc/sgml/sgml-docbook.cat
The above seems to go OK:
http://i54.tinypic.com/1j7yc0.png

(take "after" snapshot...run script...)

The BLFS page on DocBook SGML DTD-3.1 gives instructions for modifying /usr/share/sgml/docbook/sgml-dtd-3.1/catalog so that it will use only the most current 3.x version of DocBook SGML DTD.

I have no idea what the significance of this is, but here are both versions, one with the modification to /usr/share/sgml/docbook/sgml-dtd-3.1/catalog and one without:
Attachments
DocBook_SGML_DTD-not-with-only-most-current-3.1.pet
DocBook SGML DTD-3.1 .pet package which does not use only the most current 3.x version of DocBook SGML DTD
(47.59 KiB) Downloaded 653 times
DocBook_SGML_DTD-with-only-most-current-3.1.pet
DocBook SGML DTD-3.1 .pet package which uses only the most current 3.x version of DocBook SGML DTD
(47.7 KiB) Downloaded 659 times
Last edited by Sit Heel Speak on Sun 05 Dec 2010, 02:37, edited 1 time in total.

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 3 -- DocBook SGML DTD-4.5

#4 Post by Sit Heel Speak »

DocBook SGML DTD-4.5
http://www.linuxfromscratch.org/blfs/vi ... l-dtd.html

Requires sgml-common-0.6.3 (above) to be mounted (in Puppy Package Manager)

downloaded:
http://www.docbook.org/sgml/4.5/docbook-4.5.zip

Again, this is not really a compiling task, merely an unzip-and-install task, therefore packaging it as a .pet is a job for the Clipper script...

(take "before" snapshot, and then...)

Code: Select all

sed -i -e '/ISO 8879/d' -e '/gml/d' docbook.cat
install -v -d /usr/share/sgml/docbook/sgml-dtd-4.5
chown -R root:root .
install -v docbook.cat /usr/share/sgml/docbook/sgml-dtd-4.5/catalog
cp -v -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-4.5
install-catalog --add /etc/sgml/sgml-docbook-dtd-4.5.cat /usr/share/sgml/docbook/sgml-dtd-4.5/catalog
install-catalog --add /etc/sgml/sgml-docbook-dtd-4.5.cat /etc/sgml/sgml-docbook.cat
The above seems to go OK (and, hehe, this time I had parcellite installed...):

Code: Select all

# install -v -d /usr/share/sgml/docbook/sgml-dtd-4.5
install: creating directory `/usr/share/sgml/docbook/sgml-dtd-4.5'
# chown -R root:root .
# install -v docbook.cat /usr/share/sgml/docbook/sgml-dtd-4.5/catalog
`docbook.cat' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/catalog'
# cp -v -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-4.5
`calstblx.dtd' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/calstblx.dtd'
`docbook.dtd' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/docbook.dtd'
`docbookx.dtd' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/docbookx.dtd'
`soextblx.dtd' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/soextblx.dtd'
`dbcentx.mod' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/dbcentx.mod'
`dbgenent.mod' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/dbgenent.mod'
`dbhierx.mod' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/dbhierx.mod'
`dbnotnx.mod' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/dbnotnx.mod'
`dbpoolx.mod' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/dbpoolx.mod'
`htmltblx.mod' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/htmltblx.mod'
`docbook.dcl' -> `/usr/share/sgml/docbook/sgml-dtd-4.5/docbook.dcl'
# install-catalog --add /etc/sgml/sgml-docbook-dtd-4.5.cat /usr/share/sgml/docbook/sgml-dtd-4.5/catalog
install-catalog: addition of /usr/share/sgml/docbook/sgml-dtd-4.5/catalog in /etc/sgml/sgml-docbook-dtd-4.5.cat
install-catalog: addition of /etc/sgml/sgml-docbook-dtd-4.5.cat in /etc/sgml/catalog
# install-catalog --add /etc/sgml/sgml-docbook-dtd-4.5.cat /etc/sgml/sgml-docbook.cat
install-catalog: addition of /etc/sgml/sgml-docbook.cat in /etc/sgml/sgml-docbook-dtd-4.5.cat
#
(take "after" snapshot...run script...)

As with version 3.1 (above post), the BLFS page on DocBook SGML DTD-4.5 gives instructions for modifying /usr/share/sgml/docbook/sgml-dtd-4.5/catalog so that it will use only the most current 4.x version of DocBook SGML DTD.

I have no idea what the significance of this is, but here are both versions, one with the modification to /usr/share/sgml/docbook/sgml-dtd-4.5/catalog and one without:
Attachments
DocBook_SGML_DTD-with-only-most-current-4.5.pet
DocBook SGML DTD-4.5 .pet package which uses only the most current 4.x version of DocBook SGML DTD
(60.63 KiB) Downloaded 636 times
DocBook_SGML_DTD-not-with-only-most-current-4.5.pet
DocBook SGML DTD-4.5 .pet package which does not use only the most current 4.x version of DocBook SGML DTD
(60.6 KiB) Downloaded 644 times

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 4 -- OpenSP-1.5.2 er I mean 1.5.1...

#5 Post by Sit Heel Speak »

OpenSP-1.5.2
http://www.linuxfromscratch.org/blfs/vi ... pensp.html

Requires sgml-common-0.6.3 (above) to be mounted

downloaded:
http://downloads.sourceforge.net/openja ... 5.2.tar.gz

The compiling was done with the changes to /etc/profile described here, to set compiler and linker flags.

Code: Select all

sed -i 's:32,:253,:' lib/Syntax.cxx
sed -i 's:LITLEN          240 :LITLEN          8092:' unicode/{gensyntax.pl,unicode.syn}
./configure $PUPPYCOMPILE --disable-static --disable-doc-build --enable-default-catalog=/etc/sgml/catalog --enable-http --enable-default-search-path=/usr/share/sgml
make pkgdatadir=/usr/share/sgml/OpenSP-1.5.2
make check
The BLFS page says that "As many as eight of the 22 tests may fail. Do not be alarmed."

Hmm...

Code: Select all

====================
9 of 23 tests failed
====================
make[3]: *** [check-TESTS] Error 1
make[3]: Leaving directory `/mnt/sdb2/sources/input-OpenSP-1.5.2/OpenSP-1.5.2/tests'
make[2]: *** [check-am] Error 2
make[2]: Leaving directory `/mnt/sdb2/sources/input-OpenSP-1.5.2/OpenSP-1.5.2/tests'
make[1]: *** [check-recursive] Error 1
make[1]: Leaving directory `/mnt/sdb2/sources/input-OpenSP-1.5.2/OpenSP-1.5.2'
make: *** [check] Error 2
#
OK, I guess at 9 failures it is permitted to be alarmed.

Looking at the OpenJade/OpenSP homepage
http://openjade.sourceforge.net/download.html
I notice that "The latest stable release of OpenSP is 1.5.1."

Methinks the Beyond Linux From Scratch boffins may be a wee overambitious.

Trying OpenSP-1.5.1 according to http://www.linuxfromscratch.org/blfs/vi ... pensp.html:

Code: Select all

patch -Np1 -i ../OpenSP-1.5.1-LITLEN-1.patch
patch -Np1 -i ../OpenSP-1.5.1-gcc34-1.patch
./configure $PUPPYCOMPILE --disable-static --enable-http --enable-default-catalog=/etc/sgml/catalog --enable-default-search-path=/usr/share/sgml
make pkgdatadir=/usr/share/sgml/OpenSP-1.5.1
make check
Aw, nuts:

Code: Select all

In file included from ArcEngine.cxx:20:
../include/InternalInputSource.h:37: error: extra qualification 'OpenSP::InternalInputSource::' on member 'asInternalInputSource'
make[1]: *** [ArcEngine.lo] Error 1
make[1]: Leaving directory `/mnt/sdb2/sources/input-OpenSP-1.5.1/OpenSP-1.5.1/lib'
make: *** [check-recursive] Error 1
#
Let's try recompiling OpenSP-1.5.1 but using the header include/InternalInputSource.h from 1.5.2:

Code: Select all

====================
8 of 22 tests failed
====================
make[2]: *** [check-TESTS] Error 1
make[2]: Leaving directory `/mnt/sdb2/sources/input-OpenSP-1.5.1/OpenSP-1.5.1/tests'
make[1]: *** [check-am] Error 2
make[1]: Leaving directory `/mnt/sdb2/sources/input-OpenSP-1.5.1/OpenSP-1.5.1/tests'
make: *** [check-recursive] Error 1
#
Ah, success! At least, it says we can live with only eight errors...

(take the "before" snapshot)

Continuing:

Code: Select all

new2dir make pkgdatadir=/usr/share/sgml/OpenSP-1.5.1 install
From new2dir I did dir2pet directly, it created an exe, dev, doc, and nls .pet package.

Code: Select all

ln -v -sf onsgmls /usr/bin/nsgmls
ln -v -sf osgmlnorm /usr/bin/sgmlnorm
ln -v -sf ospam /usr/bin/spam
ln -v -sf ospcat /usr/bin/spcat
ln -v -sf ospent /usr/bin/spent
ln -v -sf osx /usr/bin/sx
ln -v -sf osx /usr/bin/sgml2xml
ln -v -sf libosp.so /usr/lib/libsp.so
(take the "after" snapshot, apply the Clipper script)

The unified sourcedir produced by the Clipper script was then manually divided (i.e. drag'n'drop'ped using Rox-Filer) into doc, dev, and nls sourcedir's by visual comparison with the output .pet's of new2dir, except:

1. new2dir placed a duplicate of symlink /usr/lib/libosp.so in the dev .pet, but I'm making just the single copy of it in the exe .pet (where its target, libosp.so.4.0.0, resides), i.e. no duplicate in the dev .pet. If libosp.so *should* reside in the DEV, hopefully someone will so advise...

2. The symlinks are present in this exe .pet produced by the Clipper script, which are not in the new2dir-version exe .pet due to their being created after new2dir was run.
Attachments
OpenSP_DEV-1.5.1.pet
OpenSP_DEV-1.5.1
(74.75 KiB) Downloaded 640 times
OpenSP_NLS-1.5.1.pet
OpenSP_NLS-1.5.1
(99.18 KiB) Downloaded 621 times
Last edited by Sit Heel Speak on Mon 06 Dec 2010, 07:19, edited 4 times in total.

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 5 -- OpenJade-1.3.2

#6 Post by Sit Heel Speak »

OpenJade-1.3.2
http://www.linuxfromscratch.org/blfs/vi ... njade.html

Requires sgml-common-0.6.3 and OpenSP-1.5.1 (above) to be mounted.

downloaded:
http://downloads.sourceforge.net/openja ... 3.2.tar.gz

The compiling was done with the changes to /etc/profile described above. The $PUPPYCOMPILE parameter is not used here, because its '--datadir=' setting is in conflict with the one specified by the BLFS recipe for OpenJade, so instead I am specifying $PUPPYCOMPILE's other parameters literally:

Code: Select all

./configure --prefix=/usr --enable-http --disable-static --enable-default-catalog=/etc/sgml/catalog --enable-default-search-path=/usr/share/sgml --datadir=/usr/share/sgml/openjade-1.3.2 --bindir=/usr/bin --sbindir=/usr/sbin --libdir=/usr/lib --includedir=/usr/include --infodir=/usr/info --mandir=/usr/man --sysconfdir=/etc --localstatedir=/var --build=i486-pc-linux-gnu
make
There is no 'make check'.

(take the "before" snapshot)

Code: Select all

new2dir make install
new2dir, directly into dir2pet, creates an exe and a dev .pet.

Code: Select all

make install-man
ln -v -sf openjade /usr/bin/jade
ln -v -sf libogrove.so /usr/lib/libgrove.so
ln -v -sf libospgrove.so /usr/lib/libspgrove.so
ln -v -sf libostyle.so /usr/lib/libstyle.so
install -v -m644 dsssl/catalog /usr/share/sgml/openjade-1.3.2/
I believe that there is a typographical error in the BLFS instructions, should be a forward slash after 'openjade-1.3.2'...probably doesn't really matter, but...

Code: Select all

install -v -m644 dsssl/*.{dtd,dsl,sgm} /usr/share/sgml/openjade-1.3.2/
install-catalog --add /etc/sgml/openjade-1.3.2.cat /usr/share/sgml/openjade-1.3.2/catalog
install-catalog --add /etc/sgml/sgml-docbook.cat /etc/sgml/openjade-1.3.2.cat
echo "SYSTEM \"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd\" \"/usr/share/xml/docbook/xml-dtd-4.5/docbookx.dtd\"" >> /usr/share/sgml/openjade-1.3.2/catalog
(take the "after" snapshot, apply the Clipper script)

(use drag'n'drop from Rox-Filer to separate the unified sourcedir into an exe, a dev, and a doc sourcedir, apply dir2pet)

...and here they are:
Attachments
OpenJade_DEV-1.3.2.pet
OpenJade_DEV-1.3.2.pet
(904 Bytes) Downloaded 629 times
OpenJade_DOC-1.3.2.pet
OpenJade_DOC-1.3.2.pet
(6.01 KiB) Downloaded 655 times

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 6 -- DocBook DSSSL Stylesheets-1.79

#7 Post by Sit Heel Speak »

DocBook DSSSL Stylesheets-1.79
http://www.linuxfromscratch.org/blfs/vi ... dsssl.html

Requires all of the above to be mounted, for the tests to be run.

downloaded:
http://downloads.sourceforge.net/docboo ... 79.tar.bz2
http://downloads.sourceforge.net/docboo ... 79.tar.bz2

This is just an unzip-and-install, no compiling:

(take the "before" snapshot)

Code: Select all

install -v -m755 bin/collateindex.pl /usr/bin
install -v -m644 bin/collateindex.pl.1 /usr/share/man/man1
install -v -d -m755 /usr/share/sgml/docbook/dsssl-stylesheets-1.79
cp -v -R * /usr/share/sgml/docbook/dsssl-stylesheets-1.79
install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat /usr/share/sgml/docbook/dsssl-stylesheets-1.79/catalog
install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat /usr/share/sgml/docbook/dsssl-stylesheets-1.79/common/catalog
install-catalog --add /etc/sgml/sgml-docbook.cat /etc/sgml/dsssl-docbook-stylesheets.cat
(take the "after" snapshot, apply the Clipper script)

The Clipper script contained two errors, it was missing the "." at the end of "cp " lines twice. This produced two error messages at the prompt from which it was run. Hmm, I must look into this problem. I attach the corrected makesfs bash script.

The tests start like this:

Code: Select all

# cd /usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata
# pwd
/usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata
# openjade -t rtf -d jtest.dsl jtest.sgm
# ls jtest.rtf
jtest.rtf
# onsgmls -sv test.sgm
onsgmls:I: "OpenSP" version "1.5.1"
onsgmls:test.sgm:1:61:W: cannot generate system identifier for public text "-//Davenport//DTD DocBook V3.0//EN"
onsgmls:test.sgm:1:61:E: reference to entity "CHAPTER" for which no system identifier could be generated
onsgmls:test.sgm:1:0: entity was defined here
#
Inspection of
/usr/share/sgml/docbook/sgml-dtd-3.1/docbook.dtd
shows that there is no "//Davenport//DTD DocBook V3.0//EN" identifier in it. If /usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata/test.sgm is edited to contain a valid identifier, for example

Code: Select all

<!doctype chapter public "-//OASIS//DTD DocBook V3.1//EN">
<chapter><title>Test Chapter</title>
<para>
This is a test document.
</para>
</chapter>
then the test succeeds:

Code: Select all

# onsgmls -sv test.sgm
onsgmls:I: "OpenSP" version "1.5.1"
#
The final two tests also succeed:

Code: Select all

openjade -t rtf -d /usr/share/sgml/docbook/dsssl-stylesheets-1.79/print/docbook.dsl test.sgm
openjade -t sgml -d /usr/share/sgml/docbook/dsssl-stylesheets-1.79/html/docbook.dsl test.sgm
Screen capture, showing all tests succeeding:
http://i56.tinypic.com/2i8bz1s.png
Attachments
makesfs_DocBook-dsssl.gz
makesfs from the Clipper script, edited to correct two missing &quot;.&quot; instances
(7.39 KiB) Downloaded 621 times
Last edited by Sit Heel Speak on Mon 06 Dec 2010, 06:26, edited 3 times in total.

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 7 -- DocBook-utils-0.6.14

#8 Post by Sit Heel Speak »

DocBook-utils-0.6.14
http://www.linuxfromscratch.org/blfs/vi ... utils.html

downloaded:
http://sources-redhat.mirrors.redwire.n ... .14.tar.gz

Requires these to be mounted (all are above in this thread):
DocBook SGML DTD-3.1
OpenJade-1.3.2
DocBook DSSSL Stylesheets-1.79

The compiling was done with the changes to /etc/profile described in the link given in the first post of this thread, above, using this sequence:

Code: Select all

sed -i 's:/html::' doc/HTML/Makefile.in
./configure $PUPPYCOMPILE
make
(there is no 'make check')

(take the "before" snapshot)

Code: Select all

new2dir make install
From new2dir I went directly into dir2pet, it created an exe and a doc .pet.

Code: Select all

for doctype in html ps dvi man pdf rtf tex texi txt
do
    ln -s docbook2$doctype /usr/bin/db2$doctype
done
(take the "after" snapshot, apply the Clipper script, run dir2pet)

...and, here they are:
Attachments
DocBook-utils-0.6.14.pet
DocBook-utils-0.6.14
(23.37 KiB) Downloaded 637 times
DocBook-utils_DOC-0.6.14.pet
DocBook-utils_DOC-0.6.14
(29.02 KiB) Downloaded 637 times

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 8 -- libxml2-2.7.8

#9 Post by Sit Heel Speak »

Before we can install the next component in the DocBook collection, DocBook XML DTD-4.5, we must first update libxml2 from the version 2.6.30 which is included in Puppy 4.31, to at least version 2.7.7, which DocBook XML DTD-4.5 requires. The current version as of this writing is 2.7.8.

libxml2-2.7.8
http://www.linuxfromscratch.org/blfs/vi ... bxml2.html

downloaded:
http://xmlsoft.org/sources/libxml2-2.7.8.tar.gz
http://www.w3.org/XML/Test/xmlts20080827.tar.gz
Note: I tried unpacking xmlts20080827.tar.gz into the libxml2 build directory, but it has no effect on 'make check' that I can see. Perhaps someone can tell me where to unpack it and how the test cases in it are run.

The compiling was done with the changes to /etc/profile described in the link given in the first post of this thread, above, using this sequence:

Code: Select all

./configure $PUPPYCOMPILE
make
make check
make check concludes with

Code: Select all

## Catalog and Threads regression tests
Total 2819 tests, 10 errors, 0 leaks
make: *** [runtests] Error 1
#
The BLFS instructions say that 'make check' will tell you how many of these errors were expected, but in fact it does not. However, looking through the 'make check' output, I see that the errors are all having to do with 'ebcdic' documents. Since ebcdic is a now-obsolete, ancient IBM encoding, I do not foresee that this will cause problems. A trial compile of libxml2-2.7.7 produces the identical "2819 tests, 10 errors, 0 leaks" message, so we will go ahead and stick with libxml2-2.7.8.

(take the "before" snapshot)

Code: Select all

new2dir make install
From new2dir I went directly into dir2pet, it creates an exe, a dev, and a doc .pet.

(take the "after" snapshot, apply the Clipper script)

The Clipper script generated one error message, the line

Code: Select all

cp "/usr/share/doc/libxml2-2.7.8/html/tree2.c"
should have space+dot (" .") on the end. There must be an error in mk_sfs5.prg, I must look into this. After editing to add the missing space+dot, and after clearing out /mnt/sdb1/sourcedir, the Clipper script was re-run, then the doc and dev components separated-out using Rox-Filer drag'n'drop to match what new2dir produces --except, in the dev, I kept /usr/bin/xml-config in the regular exe .pet, and did not emplace the libxml2.so symlink in the dev .pet's /usr/lib, as new2dir does; also, I'm redistributing /usr/lib/python2.5/site-packages. Hopefully, someone will advise if I am mistaken.

Here they are. The _DEV .pet is over 2 MB, so the forum cannot accept it as an attachment. I have uploaded it to myfreefilehosting.com, here it is:

File name: libxml2_DEV-2.7.8.pet
File size: 2.2MB
Description tags: libxml2_DEV-2.7.8.pet packaged December 06 2010 by Sit Heel Speak

Download link:
http://myfreefilehosting.com/f/d6819b70f3_2.2MB
md5sum:
# md5sum libxml2_DEV-2.7.8.pet
1c0629ea5cc3804af6bb6f3724936ea3 libxml2_DEV-2.7.8.pet

NOTE 1: libxml2 uses python, and so in Puppy Linux you must have the devx installed (which supplies python) before installing these libxml2 .pet's.

NOTE 2: These .pet packages emplace files in subdirectory /usr/lib/python2.5 so, if you have a newer version of python, then before you install these .pet's you must create a symlink to your python subdirectory, for example:

Code: Select all

cd /usr/lib
ln -s python2.6 python2.5
Last edited by Sit Heel Speak on Mon 06 Dec 2010, 20:04, edited 1 time in total.

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 9 -- DocBook XML DTD-4.5

#10 Post by Sit Heel Speak »

DocBook XML DTD-4.5
http://www.linuxfromscratch.org/blfs/vi ... cBook.html

downloaded:
http://www.docbook.org/xml/4.5/docbook-xml-4.5.zip

This is just an unzip-and-install.

(take the "before" snapshot)

Install DocBook XML DTD:

Code: Select all

install -v -d -m755 /usr/share/xml/docbook/xml-dtd-4.5
install -v -d -m755 /etc/xml
chown -R root:root .
cp -v -af docbook.cat *.dtd ent/ *.mod /usr/share/xml/docbook/xml-dtd-4.5
Create and populate the /etc/xml/docbook catalog file:

Code: Select all

if [ ! -e /etc/xml/docbook ]; then
    xmlcatalog --noout --create /etc/xml/docbook
fi
xmlcatalog --noout --add "public" "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//DTD DocBook XML CALS Table Model V4.5//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/calstblx.dtd" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//DTD XML Exchange Table Model 19990315//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/soextblx.dtd" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//ELEMENTS DocBook XML Information Pool V4.5//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/dbpoolx.mod" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//ELEMENTS DocBook XML Document Hierarchy V4.5//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/dbhierx.mod" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//ELEMENTS DocBook XML HTML Tables V4.5//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/htmltblx.mod" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//ENTITIES DocBook XML Notations V4.5//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/dbnotnx.mod" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//ENTITIES DocBook XML Character Entities V4.5//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/dbcentx.mod" /etc/xml/docbook
xmlcatalog --noout --add "public" "-//OASIS//ENTITIES DocBook XML Additional General Entities V4.5//EN" "file:///usr/share/xml/docbook/xml-dtd-4.5/dbgenent.mod" /etc/xml/docbook
xmlcatalog --noout --add "rewriteSystem" "http://www.oasis-open.org/docbook/xml/4.5" "file:///usr/share/xml/docbook/xml-dtd-4.5" /etc/xml/docbook
xmlcatalog --noout --add "rewriteURI" "http://www.oasis-open.org/docbook/xml/4.5" "file:///usr/share/xml/docbook/xml-dtd-4.5" /etc/xml/docbook
Create and populate the /etc/xml/catalog catalog file:

Code: Select all

if [ ! -e /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi
xmlcatalog --noout --add "delegatePublic" "-//OASIS//ENTITIES DocBook XML" "file:///etc/xml/docbook" /etc/xml/catalog
xmlcatalog --noout --add "delegatePublic" "-//OASIS//DTD DocBook XML" "file:///etc/xml/docbook" /etc/xml/catalog
xmlcatalog --noout --add "delegateSystem" "http://www.oasis-open.org/docbook/" "file:///etc/xml/docbook" /etc/xml/catalog
xmlcatalog --noout --add "delegateURI" "http://www.oasis-open.org/docbook/" "file:///etc/xml/docbook" /etc/xml/catalog
For when any DocBook XML DTD version 4.x is requested in the System Identifier, add additional statements to the docbook and catalog files:

Code: Select all

for DTDVERSION in 4.1.2 4.2 4.3 4.4
do
  xmlcatalog --noout --add "public" "-//OASIS//DTD DocBook XML V$DTDVERSION//EN" "http://www.oasis-open.org/docbook/xml/$DTDVERSION/docbookx.dtd" /etc/xml/docbook
  xmlcatalog --noout --add "rewriteSystem" "http://www.oasis-open.org/docbook/xml/$DTDVERSION" "file:///usr/share/xml/docbook/xml-dtd-4.5" /etc/xml/docbook
  xmlcatalog --noout --add "rewriteURI" "http://www.oasis-open.org/docbook/xml/$DTDVERSION" "file:///usr/share/xml/docbook/xml-dtd-4.5" /etc/xml/docbook
  xmlcatalog --noout --add "delegateSystem" "http://www.oasis-open.org/docbook/xml/$DTDVERSION/" "file:///etc/xml/docbook" /etc/xml/catalog
  xmlcatalog --noout --add "delegateURI" "http://www.oasis-open.org/docbook/xml/$DTDVERSION/" "file:///etc/xml/docbook" /etc/xml/catalog
done
(take the "after" snapshot, run the Clipper script, run dir2pet)

Here it is:
Attachments
DocBook_XML_DTD-4.5.pet
DocBook XML DTD-4.5
(75.45 KiB) Downloaded 632 times

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 10 -- DocBook XSL Stylesheets-1.76.1

#11 Post by Sit Heel Speak »

DocBook XSL Stylesheets-1.76.1
http://www.linuxfromscratch.org/blfs/vi ... k-xsl.html

downloaded:
http://downloads.sourceforge.net/docboo ... .1.tar.bz2
http://downloads.sourceforge.net/docboo ... .1.tar.bz2

This is just an unzip-and-install.

(take the "before" snapshot)

Installation of DocBook XSL Stylesheets:

Code: Select all

tar -xf ../docbook-xsl-doc-1.76.1.tar.bz2 --strip-components=1

install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-1.76.1

cp -v -R VERSION common eclipse epub extensions fo highlighting html htmlhelp images javahelp lib manpages params profiling roundtrip slides template tests tools webhelp website xhtml xhtml-1_1 /usr/share/xml/docbook/xsl-stylesheets-1.76.1

install -v -m644 -D README /usr/share/doc/docbook-xsl-1.76.1/README.XSL

install -v -m755    RELEASE-NOTES* NEWS* /usr/share/doc/docbook-xsl-1.76.1

cp -v -R doc/* /usr/share/doc/docbook-xsl-1.76.1
Append to the XML catalog file:

Code: Select all

if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi
if [ ! -f /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi

xmlcatalog --noout --add "rewriteSystem" "http://docbook.sourceforge.net/release/xsl/1.76.1" "/usr/share/xml/docbook/xsl-stylesheets-1.76.1" /etc/xml/catalog

xmlcatalog --noout --add "rewriteURI" "http://docbook.sourceforge.net/release/xsl/1.76.1" "/usr/share/xml/docbook/xsl-stylesheets-1.76.1" /etc/xml/catalog

xmlcatalog --noout --add "rewriteSystem" "http://docbook.sourceforge.net/release/xsl/current" "/usr/share/xml/docbook/xsl-stylesheets-1.76.1" /etc/xml/catalog

xmlcatalog --noout --add "rewriteURI" "http://docbook.sourceforge.net/release/xsl/current" "/usr/share/xml/docbook/xsl-stylesheets-1.76.1" /etc/xml/catalog
If, in the future, you need to install other versions of the XSL stylesheets (for example, for a project which references a specific version, such as BLFS-6.0, which required the 1.67.2 version), then see the instructions near the bottom of http://www.linuxfromscratch.org/blfs/vi ... k-xsl.html.

(take the "after" snapshot, run the Clipper script, run dir2pet)

Note: the Clipper script had several problems with this very large build; several "cp " lines were missing the ending " ." and there were three very long lines:

Code: Select all

cp "/usr/share/xml/docbook/xsl-stylesheets-1.76.1/webhelp/template/common/jquery/theme-redmond/images/ui-bg_gloss-wave_55_5c9ccc_500x100.png
cp "/usr/share/xml/docbook/xsl-stylesheets-1.76.1/webhelp/template/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_f5f8f9_1x100.png"
cp "/usr/share/xml/docbook/xsl-stylesheets-1.76.1/webhelp/template/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_fcfdfd_1x100.png"
which are simply too long for the Clipper script to properly handle. These were edited to look like this:

Code: Select all

cp "/usr/share/xml/docbook/xsl-stylesheets-1.76.1/webhelp/template/common/jquery/theme-redmond/images/ui-bg_gloss-wave_55_5c9ccc_500x100.png" .
cp "/usr/share/xml/docbook/xsl-stylesheets-1.76.1/webhelp/template/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_f5f8f9_1x100.png" .
cp "/usr/share/xml/docbook/xsl-stylesheets-1.76.1/webhelp/template/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_fcfdfd_1x100.png" .
Here they are:

File name: DocBook_XSL_Stylesheets-1.76.1.pet
File size: 3.36MB
Description tags: DocBook_XSL_Stylesheets-1.76.1.pet by Sit Heel Speak
http://myfreefilehosting.com/f/49d170f5de_3.36MB
# md5sum DocBook_XSL_Stylesheets-1.76.1.pet
e8a99c14660a5833df02243fad12ffc9 DocBook_XSL_Stylesheets-1.76.1.pet

File name: DocBook_XSL_Stylesheets_DOC-1.76.1.pet
File size: 2.34MB
Description tags: DocBook_XSL_Stylesheets_DOC-1.76.1.pet by Sit Heel Speak
http://myfreefilehosting.com/f/e3239af857_2.34MB
# md5sum DocBook_XSL_Stylesheets_DOC-1.76.1.pet
31c8b687afc2863004db699c1f9d146c DocBook_XSL_Stylesheets_DOC-1.76.1.pet

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 11 -- libxslt-1.1.26

#12 Post by Sit Heel Speak »

libxslt-1.1.26
http://www.linuxfromscratch.org/blfs/vi ... bxslt.html

downloaded:
http://xmlsoft.org/sources/libxslt-1.1.26.tar.gz

The compiling was done with the changes to /etc/profile described in the link given in the first post of this thread, above, using this sequence:

Code: Select all

./configure $PUPPYCOMPILE
make
make check
There were several "Validation failed: no DTD found !" errors, my guess is that these test cases need special entries in /etc/xml/docbook. The 'make check' did finish OK.

(take the "before" snapshot)

Code: Select all

new2dir make install
new2dir, directly into dir2pet, produced an exe, a dev, and a doc .pet.

(take the "after" snapshot, run the Clipper script, by Rox drag'n'drop separate-out the dev and doc components, run dir2pet)

These .pet's differ slightly from the ones produced by new2dir:
--I am leaving /usr/bin/xslt-config in the exe, not putting it in the dev.
--I am not keeping copies of libexslt.so and libxslt.so in the /usr/lib of the dev. Also I am keeping xsltConf.sh in /usr/lib of the exe, not the dev.
--I am keeping libxsltmod.a and libxsltmod.la in the /usr/lib/python2.5/site-packages subdirectory of the exe, not in the dev. I am not sure about this decision at all, but it seems like it is playing it safest to keep all of /usr/lib/python2.5 in the exe .pet --I simply don't know python well enough to make the judgment as to whether .a and .la files belong in the regular .exe --my thinking is, after all, it's the Puppy devx that has something to do with supplying python, not the libxslt "devx" i.e. the dev .pet...

NOTE 1: libxslt uses python, and so in Puppy Linux you must have the devx installed (which supplies python) before installing these libxslt .pet's.

NOTE 2: These .pet packages emplace files in subdirectory /usr/lib/python2.5 so, if you have a newer version of python, then before you install these .pet's you must create a symlink to your python subdirectory, for example:

Code: Select all

cd /usr/lib 
ln -s python2.6 python2.5
The .pets:

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 12 -- xmlto-0.0.23

#13 Post by Sit Heel Speak »

xmlto-0.0.23
http://www.linuxfromscratch.org/blfs/vi ... xmlto.html

downloaded:
https://fedorahosted.org/releases/x/m/x ... 23.tar.bz2

The compiling was done with the changes to /etc/profile described in the link given in the first post of this thread, above, using this sequence:

Code: Select all

./configure $PUPPYCOMPILE
make
make check
(take the "before" snapshot)

Code: Select all

new2dir make install
new2dir, directly into dir2pet, creates an exe and a doc .pet.

(take the "after" snapshot, apply the Clipper script, dir2pet...)

And here they are:
Attachments
xmlto-0.0.23.pet
xmlto-0.0.23.pet
(17.51 KiB) Downloaded 655 times
xmlto_DOC-0.0.23.pet
xmlto_DOC-0.0.23.pet
(4.63 KiB) Downloaded 629 times

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 13 -- all rolled into one

#14 Post by Sit Heel Speak »

Now to use a fresh install of Puppy 4.31 and the Clipper script to make a consolidated version of all the DocBook .pet's...
Last edited by Sit Heel Speak on Wed 08 Dec 2010, 09:27, edited 1 time in total.

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

docbook 14 -- DocBook with all SGML DTD's, version 3.1 sfs

#15 Post by Sit Heel Speak »

(deleted by poster, October 29, 2011)
Last edited by Sit Heel Speak on Sat 29 Oct 2011, 21:36, edited 6 times in total.

amigo
Posts: 2629
Joined: Mon 02 Apr 2007, 06:52

#16 Post by amigo »

Wow, lots of trouble there to generate some docs you probably don't want. I'd try editing the Makefile.am/.in in the topdir to remove the 'docs' subdir from the build of whatever you were originally trying to compile...

User avatar
Sit Heel Speak
Posts: 2595
Joined: Fri 31 Mar 2006, 03:22
Location: downwind

Because it's there

#17 Post by Sit Heel Speak »

amigo wrote:Wow, lots of trouble there to generate some docs you probably don't want. I'd try editing the Makefile.am/.in in the topdir to remove the 'docs' subdir from the build of whatever you were originally trying to compile...
:lol:

I admit, once I saw that it was unavailable for Puppy except as a .deb or .rpm or .txz of uncertain provenance and quality, it became a "because it's there" thing.

I guess you could say that I admire local hero Ed Viesturs (it's pronounced "vee-sters").

"Can you understand him?"
http://www.youtube.com/v/QmvmykGbhE0&autoplay=1?rel=0
____________________________________________
last-minute gift idea:
Logo Travelling Mug $7.95:
http://www.whittakermountaineering.com/cnav/73/cooking

16-oz. capacity; high handle clearance surmounts powerbricks, mice, keyboards:
http://i54.tinypic.com/a40bpz.jpg

Post Reply