cvs commit: hints docbook.txt mozilla.txt

timothy at timothy at
Fri Dec 6 05:35:35 PST 2002

timothy     02/12/06 08:35:35

  Modified:    .        docbook.txt mozilla.txt
  Updates by author.
  Revision  Changes    Path
  1.6       +83 -39    hints/docbook.txt
  Index: docbook.txt
  RCS file: /home/cvsroot/hints/docbook.txt,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- docbook.txt	22 Sep 2002 17:05:44 -0000	1.5
  +++ docbook.txt	6 Dec 2002 13:35:35 -0000	1.6
  @@ -27,6 +27,11 @@
   Change Log:
  +	* Added URIs of interest.
  +	* Added OpenSP package.
  +	* Added descriptions for packages.
  +	* Modified some installation instructions.
   	* Added files to be downloaded.
  @@ -68,8 +73,18 @@
   installed. So don't install scrollkeeper right now but come back to check on the
   instructions when scrollkeeper is installed as per the GNOME instructions.
  +Also, you don't need to install all packages to satisfy GNOME. You may skip
  +docbook-utils and docbook-xml-simple-dtd.
   sgml-common (0.6.3):
  +The sgml-common package gathers very basic stuff necessary to work with SGML and
  +XML, such as xml.dcl, a SGML declaration of XML; iso-entities, a list of the
  +basic SGML ISO entities; and install-catalog, a script used to add entries to
  +(or remove entries from) centralized catalogs whose entries are pointers to SGML
  +open catalogs, as defined by OASIS. It also includes sgmlwhich, a small script
  +which prints where the SGML main configuration file is located (provided for
  +compatibility with non-FHS systems).
  @@ -77,55 +92,76 @@
   	./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man
  +	make install
  +	ROOTCATALOG=/etc/xml/catalog
  +	DOCBOOKCATALOG=/etc/xml/docbook
  +	if [ ! -e ${ROOTCATALOG} ]; then xmlcatalog --noout --create ${ROOTCATALOG}; fi
  +	if [ ! -e ${DOCBOOKCATALOG} ]; then xmlcatalog --noout --create ${DOCBOOKCATALOG}; fi
  +	xmlcatalog --sgml --noout --add /etc/sgml/ /usr/share/sgml/sgml-iso-entities-8879.1986/catalog
  +	xmlcatalog --sgml --noout --add /etc/sgml/ /etc/sgml/
  +	xmlcatalog --noout --add "delegatePublic" "-//OASIS//ENTITIES DocBook XML" "file://$DOCBOOKCATALOG" $ROOTCATALOG
  +	xmlcatalog --noout --add "delegatePublic" "-//OASIS//DTD DocBook XML" "file://$ROOTCATALOG" $ROOTCATALOG
  +	xmlcatalog --noout --add "delegatePublic" "ISO 8879:1986" "file://$ROOTCATALOG" $ROOTCATALOG
  +	xmlcatalog --noout --add "delegateSystem" "" "file://$ROOTCATALOG" $ROOTCATALOG
  +	xmlcatalog --noout --add "delegateURI" "" "file://$ROOTCATALOG" $ROOTCATALOG
  +OpenSP (1.5):
  +OpenSP is a library and a set of tools for validating, parsing and manipulating
  +SGML and XML documents. The library is written in C++ and can be used to add
  +SGML/XML parsing facilities to projects.
  +	./configure --prefix=/usr --disable-static --enable-http --enable-default-catalog=/etc/sgml/catalog --enable-default-search-path=/usr/share/sgml --enable-xml-messages
  +	make pkgdatadir=/usr/share/sgml/OpenSP-${VERSION}
   	if [ ! -z ${PREVIOUS} ]
  -		install-catalog --remove /etc/sgml/ /usr/share/sgml/sgml-iso-entities-8879.1986/catalog
  -		install-catalog --remove /etc/sgml/ /etc/sgml/
  +		install-catalog --remove /etc/sgml/OpenSP-${PREVIOUS}.cat /usr/share/sgml/OpenSP-${PREVIOUS}/catalog
  +		install-catalog --remove /etc/sgml/ /etc/sgml/OpenSP-${PREVIOUS}.cat
  -	make install
  -	install-catalog --add /etc/sgml/ /usr/share/sgml/sgml-iso-entities-8879.1986/catalog
  -	install-catalog --add /etc/sgml/ /etc/sgml/
  +	make pkgdatadir=/usr/share/sgml/OpenSP-${VERSION} install
  +	ln -sf onsgmls /usr/bin/nsgmls
  +	ln -sf osgmlnorm /usr/bin/sgmlnorm
  +	ln -sf ospam /usr/bin/spam
  +	ln -sf ospcat /usr/bin/spcat
  +	ln -sf ospent /usr/bin/spent
  +	ln -sf osx /usr/bin/sx
  +	ln -sf osx /usr/bin/sgml2xml
  +	ln -sf /usr/lib/
  +	install-catalog --add /etc/sgml/OpenSP-${VERSION}.cat /usr/share/sgml/OpenSP-${VERSION}/catalog
  +	install-catalog --add /etc/sgml/
  -openjade (1.3.1):
  +openjade (1.3.2):
   	./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-${VERSION}
   	if [ ! -z ${PREVIOUS} ]
   		install-catalog --remove /etc/sgml/openjade-${PREVIOUS}.cat /usr/share/sgml/openjade-${PREVIOUS}/catalog
  -		install-catalog --remove /etc/sgml/openjade-${PREVIOUS}.cat /usr/share/sgml/openjade-${PREVIOUS}/dsssl/catalog
  -		install-catalog --remove /etc/sgml/openjade-${PREVIOUS}.cat /usr/share/sgml/openjade-${PREVIOUS}/unicode/catalog
   		install-catalog --remove /etc/sgml/ /etc/sgml/openjade-${PREVIOUS}.cat
   	make install
  -	ln -sf onsgmls /usr/bin/nsgmls
   	ln -sf openjade /usr/bin/jade
  -	ln -sf osgmlnorm /usr/bin/sgmlnorm
  -	ln -sf ospam /usr/bin/spam
  -	ln -sf ospent /usr/bin/spent
  -	ln -sf osx /usr/bin/sx
  -	ln -sf osx /usr/bin/sgml2xml
  -	install -d /usr/include/OpenSP
  -	install -m644 generic/*.h /usr/include/OpenSP/
  -	install -m644 include/*.h /usr/include/OpenSP/
  -	install -m644 lib/*.h /usr/include/OpenSP/
  -	echo 'SYSTEM "builtins.dsl" "builtins.dsl"' > /usr/share/sgml/openjade-${VERSION}/catalog
  -	cp -af dsssl/ pubtext/ /usr/share/sgml/openjade-${VERSION}
  -	echo "PUBLIC \"-//James Clark//DTD DSSSL Flow Object Tree//EN\" \"fot.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
  -	echo "PUBLIC \"ISO/IEC 10179:1996//DTD DSSSL Architecture//EN\" \"dsssl.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
  -	echo "PUBLIC \"-//James Clark//DTD DSSSL Style Sheet//EN\" \"style-sheet.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
  -	echo "PUBLIC \"-//OpenJade//DTD DSSSL Style Sheet//EN\" \"style-sheet.dtd\"" >> /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
  +	ln -sf /usr/lib/
  +	ln -sf /usr/lib/
  +	ln -sf /usr/lib/
  +	install -m644 dsssl/catalog /usr/share/sgml/openjade-${VERSION}/
  +	install -m644 dsssl/*.dtd dsssl/*.dsl dsssl/*.sgm /usr/share/sgml/openjade-${VERSION}
   	install-catalog --add /etc/sgml/openjade-${VERSION}.cat /usr/share/sgml/openjade-${VERSION}/catalog
  -	install-catalog --add /etc/sgml/openjade-${VERSION}.cat /usr/share/sgml/openjade-${VERSION}/dsssl/catalog
   	install-catalog --add /etc/sgml/ /etc/sgml/openjade-${VERSION}.cat
  -docbook-sgml-dtd (3.1, 4.1, 4.2)
  +docbook-sgml-dtd (3.1, 4.1, 4.2):
  +Docbook SGML DTDs. All versions need to be installed simaltaneously. There are
  +additional version (3.0 and 4.0) which are not covered in this hint.
  @@ -146,6 +182,7 @@
   docbook-dsssl (1.77)
  +Docbook DSSSL stylesheets.
  @@ -162,18 +199,8 @@
   	install-catalog --add /etc/sgml/ /etc/sgml/
  -docbook-utils (0.6.11)
  -	./configure --prefix=/usr --sysconfdir=/etc
  -	make
  -	make install
   docbook-xsl (1.54.1)
  +Docbook XSL stylesheets.
  @@ -192,6 +219,7 @@
   docbook-xml-dtd (4.1.2, 4.2)
  +Docbook XML DTD.
  @@ -243,6 +271,7 @@
   docbook-xml-simple-dtd (
  +Docbook XML DTD Simplified (with fewer elements).
  @@ -257,6 +286,12 @@
   scrollkeeper (0.3.11)
  +ScrollKeeper is a cataloging system for documentation on open systems. It
  +manages documentation metadata (as specified by the Open Source Metadata
  +Framework(OMF)) and provides a simple API to allow help browsers to find, sort,
  +and search the document catalog. It will also be able to communicate with
  +catalog servers on the Net to search for documents which are not on the local
  @@ -269,7 +304,8 @@
   Following the approach mentioned in this hint, you can download and install more
  -catalogs as and when you find them appropriate for your needs.
  +catalogs as and when you find them appropriate for your needs. Additionally,
  +search for docbook at for docbook realted tools and utilities.
   Also check out the man pages for xmlcatalog and install-catalog. They specify
   how to remove catalogs that are no longer needed (e.g. if you install a new
  @@ -279,3 +315,11 @@
   install the prerequsites for GNOME-2. Hence there may be errors; if so please
   let me know.
  +Some sites that may be of interest:
  +Don't forget to send me bug reports and enhancements so that I can keep the hint
  1.13      +73 -14    hints/mozilla.txt
  Index: mozilla.txt
  RCS file: /home/cvsroot/hints/mozilla.txt,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- mozilla.txt	17 Nov 2002 23:16:31 -0000	1.12
  +++ mozilla.txt	6 Dec 2002 13:35:35 -0000	1.13
  @@ -26,6 +26,9 @@
   at LinuxFromScratch.Org.
   Change Log:
  +	* Added fontconfig and Xft2 support for gtk2 builds (unstable).
  +	* Upgrade to mozilla-1.2.
   	* Upgraded to gtk2.
   	* Added triple install (mozilla-1.0.1, mozilla-1.2b, phoenix).
  @@ -115,17 +118,19 @@
   	* Mozilla SpellChecker
  +	* FontConfig
  +		<>
   Which Mozilla version?
  -I use Mozilla-1.2b for regular use. But I also install a copy of Mozilla-1.0.1
  +I use Mozilla-1.2 for regular use. But I also install a copy of Mozilla-1.0.1
   since it is the stable version and hence useful for experimenting with packages
   such as japhar, openoffice, sun-jdk. I also use Phoenix browser for general
  -browsing. I have Mozilla-1.2b and Phoenix-0.4 installed in the system wide
  +browsing. I have Mozilla-1.2 and Phoenix-0.4 installed in the system wide
   prefix /usr and Mozilla-1.0.1 installed in /opt/mozilla.
   The Mozilla instructions below are, for the most part, applicable to both
  -Mozilla-1.0.1 and Mozilla-1.2b. Instructions for Phoenix are in the latter part
  +Mozilla-1.0.1 and Mozilla-1.2. Instructions for Phoenix are in the latter part
   of the hint.
   GLIb & GTK+:
  @@ -135,7 +140,7 @@
  -You may use the latest libIDL (0.8.0), also known as libIDL2. Mozilla-1.2b
  +You may use the latest libIDL (0.8.0), also known as libIDL2. Mozilla-1.2
   automatically utilizes libIDL2. But for Mozilla-1.0.1 you will need to do the
   following so that libIDL2 is properly recognized. This is assuming that you
   don't have Orbit1 or libIDL-0.6.x installed.
  @@ -213,6 +218,46 @@
   	mv enigmail/src $MOZ_SRC/extensions/enigmail
  +Installing FontConfig and Xft:
  +Fontconfig is needed to enable xft support in Mozilla. 1.0.x versions use an
  +internal copy of fontconfig, but it has been removed since the 1.1 series.
  +Fontconfig and Xft are going to be incorporated into X-4.3. Till then they are
  +available as seperate packages. Installing these packages in the standard X
  +prefix (/usr/X11R6) caused me a lot of problems with many GNOME2 packages. Hence
  +I installed these with a seperate prefix and renamed the Xft lib to Xft2. That
  +way the apps that have not yet been upgraded to Xft2 can still continue to link
  +against while apps such as mozilla can link against
  +Download the fontconfig package from the URL mentioned above and install it as
  +follows. Remember to add /opt/xft/lib to /etc/
  +	cd fontconfig
  +	./configure --prefix=/opt/xft
  +	make
  +	make install
  +	ln -sf /opt/xft/pkgconfig/fontconfig.pc /usr/lib/pkgconfig
  +	cd ..
  +	cd Xft
  +	for i in
  +	do
  +		cp $i $i.orig
  +		sed -e "s:\-lXft:\-lXft2:g" $i.orig > $i
  +	done
  +	export CFLAGS="$CFLAGS -L/opt/xft/lib"
  +	export CXXFLAGS="$CFLAGS -L/opt/xft/lib"
  +	export CPPFLAGS="-I/opt/xft/include"
  +	./configure --prefix=/opt/xft
  +	make
  +	make install
  +	mv /opt/xft/lib/ /opt/xft/lib/
  +	ln -sf /opt/xft/pkgconfig/xft.pc /usr/lib/pkgconfig
  +WARNING: Though I got the build to compile, I got runtime errors. I don't know
  +whether it was a problem with Mozilla or incorrect configuration of fontconfig.
  +So use the Xft option at your own risk.
   Compiling Mozilla:
   Apply patches that you think are useful from the site mentioned above. Some of
  @@ -279,11 +324,8 @@
   Disable LDAP Support, recommended if mail is disabled.
   	echo ac_add_options --disable-ldap >> .mozconfig
  -Enable the Xft support.
  +Enable the Xft support (this is unstable).
   	echo ac_add_options --enable-xft >> .mozconfig
  -I had problems with building the xft support in Mozilla-1.2b since it needs
  -fontconfig and Xft2. Since installing those packages caused all kinds of
  -problems with other packages, I have disabled xft support for now.
   Enable the Personal Security Manager to enable SSL connections.
   	echo ac_add_options --enable-crypto >> .mozconfig
  @@ -355,11 +397,24 @@
   and delete or comment out the line.
  -If anyone tells you MS-IE is user friendly, give them this example:)
  +If anyone tells you MS-IE is user friendly, give them this example and explain
  +to them the distinction between corporate friendly and user friendly:)
  +Now configure the package as usual. If there are problems run configure again by
  +removing the offending option.
  +	./configure
  +If you have enabled xft support, mozilla needs Xft2 headers but in the
  +Makefiles, /usr/X11R6/include appears before /opt/fontconfig/include and hence
  +the build picks up Xft headers installed by X (i.e. Xft1) and the build craps
  +out. The easiest fix is to sed in the Xft2 headers to appear before X11 headers.
  +	cd config
  +	cp
  +	sed -e "s:\-I\/usr\/X11R6\/include:\-I\/opt\/xft\/include \
  +		\-I\/usr\/X11R6\/include:g" >
  +	cd ..
  -Now configure and compile the package as usual. If there are problems run
  -configure again by removing the offending option.
  -	./configure &&
  +Now do the usual build stuff.
   This will take a few hours to compile. Watch your favorite Startrek movie.
  @@ -391,7 +446,7 @@
   If you are installing Mozilla-1.0.1, do
   	cp -Lf dist/private/security/*.h dist/public/security/*.h \
  -If you are installing Mozilla-1.2b, do
  +If you are installing Mozilla-1.2, do
   	cp -Lf dist/private/nss/*.h dist/public/nss/*.h \
  @@ -426,6 +481,10 @@
   'locale,install,url,jar:resource:/chrome/easysearch.jar!/locale/en-US/easysearch/' \
   		>> chrome/installed-chrome.txt
  +There are many search engines that you can add to the easysearch toolbar.
  +Download the easysearch plugins tarball from the project's homepage and copy the
  +engines you need to ${MOZ_PREFIX}/lib/mozilla-${VERSION}/searchplugins.
   Do the following to register the components (else the build segfaults if the
   user running mozilla does not have write access to the installation directories.
   Note that the MOZILLA_FIVE_HOME and LD_LIBRARY_PATH are not relevant anymore
  @@ -440,7 +499,7 @@
   Some apps look for netscape for starting the browser (RMS has started a movement
   so that these apps start recognizing the BROWSER env variable). Till then it is
  -better to do a
  +better to do a symlink.
   	ln -sf mozilla netscape
   in the directory where the mozilla startup script is installed (/usr/X11R6/bin).
Unsubscribe: send email to listar at
and put 'unsubscribe hints' in the subject header of the message

More information about the hints mailing list