summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJaromil <jaromil@dyne.org>2008-12-14 16:10:44 (GMT)
committer Jaromil <jaromil@dyne.org>2008-12-14 16:10:44 (GMT)
commitff9d58cbc1413f89077b3867f7a3b077d315ae24 (patch)
tree2aa8d0af044b4052176736a9a239580fcf1d3d1b
parent79fc47b63de9bad9513d4fcd3e3aa5770c388007 (diff)
now documents are encoded honouring UTF-8 chars
also some cleanup was done
-rw-r--r--dynebolic/EN/index.sgml398
-rw-r--r--dynebolic/EN/intro.sgml3
-rw-r--r--dynebolic/Makefile52
-rw-r--r--dynebolic/utils/collateindex.pl (renamed from dynebolic/stylesheets/dsssl-1.79/bin/collateindex.pl)0
-rw-r--r--dynebolic/utils/collateindex.pl.1 (renamed from dynebolic/stylesheets/dsssl-1.79/bin/collateindex.pl.1)0
-rwxr-xr-xdynebolic/utils/collatemanual.sh8
6 files changed, 38 insertions, 423 deletions
diff --git a/dynebolic/EN/index.sgml b/dynebolic/EN/index.sgml
deleted file mode 100644
index a3795e8..0000000
--- a/dynebolic/EN/index.sgml
+++ /dev/null
@@ -1,398 +0,0 @@
-<index>
-
-<!-- This file was produced by collateindex.pl. -->
-<!-- Remove this comment if you edit this file by hand! -->
-<!-- ULINK is abused here.
-
- The URL attribute holds the URL that points from the index entry
- back to the appropriate place in the output produced by the HTML
- stylesheet. (It's much easier to calculate this URL in the first
- pass.)
-
- The Role attribute holds the ID (either real or manufactured) of
- the corresponding INDEXTERM. This is used by the print backends
- to produce page numbers.
-
- The entries below are sorted and collated into the correct order.
- Duplicates may be removed in the HTML backend, but in the print
- backends, it is impossible to suppress duplicate pages or coalesce
- sequences of pages into a range.
--->
-
-<indexentry>
- <primaryie> Audio ,
- <ulink url="c534.htm" role="AEN537">Audio production</ulink>
- </primaryie>
- <secondaryie> Amarok ,
- <ulink url="c534.htm#AEN544" role="AEN556">Play</ulink>
- </secondaryie>
- <secondaryie> Ardour ,
- <ulink url="x594.htm" role="AEN598">Record and edit</ulink>
- </secondaryie>
- <secondaryie> Audacity ,
- <ulink url="x594.htm" role="AEN604">Record and edit</ulink>
- </secondaryie>
- <secondaryie> Formats ,
- <ulink url="c534.htm#AEN544" role="AEN547">Play</ulink>
- </secondaryie>
- <secondaryie> Free Wheeling ,
- <ulink url="x570.htm" role="AEN590">Perform</ulink>
- </secondaryie>
- <secondaryie> Hydrogen ,
- <ulink url="x570.htm" role="AEN574">Perform</ulink>
- </secondaryie>
- <secondaryie> Jack Rack ,
- <ulink url="x570.htm" role="AEN585">Perform</ulink>
- </secondaryie>
- <secondaryie> Jamin ,
- <ulink url="x570.htm" role="AEN580">Perform</ulink>
- </secondaryie>
- <secondaryie> MikMod ,
- <ulink url="c534.htm#AEN544" role="AEN566">Play</ulink>
- </secondaryie>
- <secondaryie> MuSE ,
- <ulink url="x618.htm" role="AEN621">Stream</ulink>
- </secondaryie>
- <secondaryie> Rezound ,
- <ulink url="x594.htm" role="AEN609">Record and edit</ulink>
- </secondaryie>
- <secondaryie> Streaming manual ,
- <ulink url="x618.htm" role="AEN627">Stream</ulink>
- </secondaryie>
- <secondaryie> Time Machine ,
- <ulink url="x594.htm" role="AEN614">Record and edit</ulink>
- </secondaryie>
- <secondaryie> Timidity ,
- <ulink url="c534.htm#AEN544" role="AEN561">Play</ulink>
- </secondaryie>
- <secondaryie> Xmms ,
- <ulink url="c534.htm#AEN544" role="AEN551">Play</ulink>
- </secondaryie>
-</indexentry>
-
-<indexentry>
- <primaryie> Image
- </primaryie>
- <secondaryie> Blender ,
- <ulink url="c632.htm" role="AEN647">Graphical software</ulink>
- </secondaryie>
- <secondaryie> Gimp ,
- <ulink url="c632.htm" role="AEN637">Graphical software</ulink>
- </secondaryie>
- <secondaryie> GQview ,
- <ulink url="c632.htm" role="AEN653">Graphical software</ulink>
- </secondaryie>
- <secondaryie> ImageMagick ,
- <ulink url="c632.htm" role="AEN658">Graphical software</ulink>
- </secondaryie>
- <secondaryie> InkScape ,
- <ulink url="c632.htm" role="AEN642">Graphical software</ulink>
- </secondaryie>
-</indexentry>
-
-<indexentry>
- <primaryie> Network ,
- <ulink url="c704.htm" role="AEN707">Communication software</ulink>
- </primaryie>
- <secondaryie> Email ,
- <ulink url="x752.htm" role="AEN758">Email and encryption</ulink>
- </secondaryie>
- <secondaryie> Links ,
- <ulink url="c704.htm#AEN717" role="AEN727">Surf the web</ulink>
- </secondaryie>
- <secondaryie> Mozilla ,
- <ulink url="c704.htm#AEN717" role="AEN722">Surf the web</ulink>
- </secondaryie>
- <secondaryie> NVU Web page editor ,
- <ulink url="c704.htm#AEN717" role="AEN732">Surf the web</ulink>
- </secondaryie>
- <secondaryie> Samba ,
- <ulink url="c704.htm" role="AEN712">Communication software</ulink>
- </secondaryie>
- <secondaryie> Thunderbird ,
- <ulink url="x752.htm" role="AEN768">Email and encryption</ulink>
- </secondaryie>
- <secondaryie> Tor ,
- <ulink url="c704.htm#AEN717" role="AEN743">Surf the web</ulink>
- </secondaryie>
- <secondaryie> Wget Web spider ,
- <ulink url="c704.htm#AEN717" role="AEN737">Surf the web</ulink>
- </secondaryie>
-</indexentry>
-
-<indexentry>
- <primaryie> Privacy
- </primaryie>
- <secondaryie> Email ,
- <ulink url="x752.htm" role="AEN755">Email and encryption</ulink>
- </secondaryie>
- <secondaryie> Enigmail ,
- <ulink url="x752.htm" role="AEN765">Email and encryption</ulink>
- </secondaryie>
- <secondaryie> Gpa ,
- <ulink url="x752.htm" role="AEN775">Email and encryption</ulink>
- </secondaryie>
- <secondaryie> Tor anonymity proxy ,
- <ulink url="c704.htm#AEN717" role="AEN746">Surf the web</ulink>
- </secondaryie>
-</indexentry>
-
-<indexentry>
- <primaryie> Text ,
- <ulink url="c664.htm" role="AEN667">Text software</ulink>
- </primaryie>
- <secondaryie> AbiWord ,
- <ulink url="c664.htm" role="AEN674">Text software</ulink>
- </secondaryie>
- <secondaryie> AntiWord ,
- <ulink url="c664.htm" role="AEN689">Text software</ulink>
- </secondaryie>
- <secondaryie> Nedit ,
- <ulink url="c664.htm" role="AEN684">Text software</ulink>
- </secondaryie>
- <secondaryie> Open Office ,
- <ulink url="c664.htm" role="AEN700">Text software</ulink>
- </secondaryie>
- <secondaryie> Scribus ,
- <ulink url="c664.htm" role="AEN679">Text software</ulink>
- </secondaryie>
-</indexentry>
-
-<indexentry>
- <primaryie> Video ,
- <ulink url="c403.htm" role="AEN406">Video production</ulink>
- </primaryie>
- <secondaryie> AviDeMux ,
- <ulink url="x487.htm" role="AEN499">Edit</ulink>
- </secondaryie>
- <secondaryie> Cinelerra ,
- <ulink url="x487.htm" role="AEN490">Edit</ulink>
- </secondaryie>
- <secondaryie>Device setup,
- <ulink url="c403.htm#AEN411" role="AEN413">Configure your video devices</ulink>
- </secondaryie>
- <secondaryie> EffecTV ,
- <ulink url="x426.htm" role="AEN442">VeeJay</ulink>
- </secondaryie>
- <secondaryie> FFMpeg ,
- <ulink url="x457.htm" role="AEN465">Play</ulink>
- </secondaryie>
- <secondaryie> FreeJ ,
- <ulink url="x426.htm" role="AEN430">VeeJay</ulink>,
- <ulink url="x509.htm" role="AEN521">Stream</ulink>
- </secondaryie>
- <secondaryie> HasciiCam ,
- <ulink url="x509.htm" role="AEN529">Stream</ulink>
- </secondaryie>
- <secondaryie> Kino ,
- <ulink url="x472.htm" role="AEN479">Record</ulink>
- </secondaryie>
- <secondaryie> Mencoder ,
- <ulink url="x472.htm" role="AEN474">Record</ulink>
- </secondaryie>
- <secondaryie> Mpeg4IP ,
- <ulink url="x509.htm" role="AEN516">Stream</ulink>
- </secondaryie>
- <secondaryie> Mplayer ,
- <ulink url="x457.htm" role="AEN462">Play</ulink>
- </secondaryie>
- <secondaryie> Pure Data ,
- <ulink url="x426.htm" role="AEN451">VeeJay</ulink>
- </secondaryie>
- <secondaryie> Transcode ,
- <ulink url="x487.htm" role="AEN505">Edit</ulink>
- </secondaryie>
- <secondaryie> Xaos ,
- <ulink url="x426.htm" role="AEN446">VeeJay</ulink>
- </secondaryie>
- <secondaryie> XawTV ,
- <ulink url="x472.htm" role="AEN483">Record</ulink>
- </secondaryie>
- <secondaryie> Xine ,
- <ulink url="x457.htm" role="AEN459">Play</ulink>
- </secondaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>afrolinux,
- <ulink url="x63.htm" role="AEN67">This is Rasta software</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>Architecture,
- <ulink url="c1106.htm" role="AEN1111">Development tools</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>boot from harddisk,
- <ulink url="c222.htm#AEN226" role="AEN228">Boot from harddisk</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>boot from network,
- <ulink url="x262.htm" role="AEN264">Boot from network</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>cd,
- <ulink url="c780.htm#AEN788" role="AEN848">Text commands</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>cfdisk,
- <ulink url="c222.htm#AEN226" role="AEN237">Boot from harddisk</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>CLI,
- <ulink url="c780.htm" role="AEN782">Command line console</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>Customize,
- <ulink url="c1106.htm" role="AEN1122">Development tools</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>docking,
- <ulink url="x185.htm" role="AEN187">Install on harddisk? Dock!</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>filesystem organization,
- <ulink url="x138.htm" role="AEN157">Access your data volumes</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>grub,
- <ulink url="c222.htm#AEN226" role="AEN246">Boot from harddisk</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>GUI,
- <ulink url="c780.htm" role="AEN784">Command line console</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>license
- </primaryie>
- <secondaryie>copyright,
- <ulink url="x106.htm" role="AEN108">License and disclaimer</ulink>
- </secondaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>lilo,
- <ulink url="c222.htm#AEN226" role="AEN255">Boot from harddisk</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>ls,
- <ulink url="c780.htm#AEN788" role="AEN833">Text commands</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>man,
- <ulink url="c780.htm#AEN788" role="AEN813">Text commands</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>manuals,
- <ulink url="c26.htm#AEN45" role="AEN47">How to use this manual</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>mke3fs,
- <ulink url="c222.htm#AEN226" role="AEN239">Boot from harddisk</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>modules,
- <ulink url="x201.htm" role="AEN203">Extra software modules</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>nesting,
- <ulink url="x161.htm" role="AEN163">Nest your home and settings</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>NTFS,
- <ulink url="c116.htm" role="AEN136">Discover the system</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>partitioning,
- <ulink url="c222.htm#AEN226" role="AEN235">Boot from harddisk</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>Programming,
- <ulink url="c1106.htm" role="AEN1115">Development tools</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>pure:dyne,
- <ulink url="x201.htm" role="AEN215">Extra software modules</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>rastasoft,
- <ulink url="x63.htm" role="AEN65">This is Rasta software</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>SDK,
- <ulink url="c1106.htm#AEN1124" role="AEN1130">Customize your dyne liveCD</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>streamtime,
- <ulink url="x82.htm" role="AEN85">Streamtime</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>usb pendrive,
- <ulink url="x138.htm" role="AEN146">Access your data volumes</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>Volumes,
- <ulink url="c116.htm" role="AEN134">Discover the system</ulink>
- </primaryie>
-</indexentry>
-
-<indexentry>
- <primaryie>Xfce,
- <ulink url="c116.htm#AEN118" role="AEN121">Your desktop environment</ulink>
- </primaryie>
-</indexentry>
-
-</index>
diff --git a/dynebolic/EN/intro.sgml b/dynebolic/EN/intro.sgml
index b16f7c9..56da736 100644
--- a/dynebolic/EN/intro.sgml
+++ b/dynebolic/EN/intro.sgml
@@ -44,7 +44,7 @@ where more online documentation is made available.
To contribute you can <ulink url="http://bugs.dyne.org">report bugs</ulink> and
get in touch with the community of users and developers joining the
the <ulink url="http://lists.dyne.org">discussion mailinglists</ulink> or the
- <emphasis>irc.freenode.net #dyne</emphasis> chat channel.
+ <emphasis>irc.dyne.net #dyne</emphasis> chat channel.
</para>
@@ -62,6 +62,7 @@ how to use, modify and employ dynebolic in various circumstances.
<para>
When in need of in-deep information on how to operate a particular
software, you should consult the included <emphasis>man pages</emphasis>.
+</para>
<para>
The manpage is the name of the manual page describing usage of the
diff --git a/dynebolic/Makefile b/dynebolic/Makefile
index bdcf9b4..3f17a59 100644
--- a/dynebolic/Makefile
+++ b/dynebolic/Makefile
@@ -1,27 +1,24 @@
# simple makefile to automate the generation of manuals
# "$Header: /dynebolic/manual/Makefile,v 1.4 2003/08/17 12:44:06 jaromil Exp $"
+# check which language is set to compile, english is default
+# to choose another language run: make man-language=ES
+man-language ?= EN
+
# list of all files
DEPS = \
-dynebolic-manual.sgml \
-EN/intro.sgml \
-EN/system.sgml \
-EN/video.sgml \
-EN/audio.sgml \
-EN/text.sgml
+$(man-language)/intro.sgml
-DSSSL-print = ../dsssl-stylesheets-1.79/print/docbook.dsl
-DSSSL-pdf = ../dsssl-stylesheets-1.79/pdf/docbook.dsl
-DSSSL-html = ../dsssl-stylesheets-1.79/html/docbook.dsl
+
+DSSSL-print = ../stylesheets/dsssl-1.79/print/docbook.dsl
+DSSSL-pdf = ../stylesheets/dsssl-1.79/pdf/docbook.dsl
+DSSSL-html = ../stylesheets/dsssl-1.79/html/docbook.dsl
# DSSSL-html = /usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl
# DSSSL-print = /usr/share/sgml/docbook/stylesheet/dsssl/modular/print/docbook.ds
# DSSSL-pdf = /usr/share/sgml/docbook/stylesheet/dsssl/modular/print/docbook.dsl
-# check which language is set to compile, english is default
-# to choose another language run: make man-language=ES
-man-language ?= EN
@@ -35,6 +32,7 @@ $(man-language)/dynebolic-manual-$(man-language).sgml:
utils/collatemanual.sh $(man-language)
# jade omissis options: -V nochunks
+# setting the SP_ENCODING=XML is necessary for UTF-8 based typesetting
index : $(man-language)/dynebolic-manual-$(man-language).sgml
collateindex.pl -N -o $(man-language)/index.sgml -t index
@@ -48,26 +46,30 @@ index : $(man-language)/dynebolic-manual-$(man-language).sgml
html : $(DEPS)
rm -rf html/*.htm
utils/formatimages.sh $(man-language) html
- cd $(man-language) && docbook2html -u -d $(DSSSL-html) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2html -u -d $(DSSSL-html) \
-o html dynebolic-manual-$(man-language).sgml
cp -f stylesheets/dyne.css $(man-language)/html
pdf : $(DEPS)
rm -f $(man-language)/dynebolic-manual-$(man-language).pdf
utils/formatimages.sh $(man-language) pdf
- cd $(man-language) && docbook2pdf -d $(DSSSL-pdf) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2pdf -d $(DSSSL-pdf) \
dynebolic-manual-$(man-language).sgml
txt : $(DEPS)
rm -f $(man-language)/dynebolic-manual-$(man-language).txt
- cd $(man-language) && docbook2txt -d $(DSSSL-print) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2txt -d $(DSSSL-print) \
dynebolic-manual-$(man-language).sgml
texi : $(DEPS)
rm -f $(man-language)/dynebolic-manual-$(man-language).txt
- cd $(man-language) && docbook2texi -d $(DSSSL-print) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2texi -d $(DSSSL-print) \
dynebolic-manual-$(man-language).sgml
info : $(DEPS) texi
@@ -77,33 +79,39 @@ info : $(DEPS) texi
book : $(DEPS)
rm -f dynebolic-manual.pdf
- docbook2pdf -d $(DSSSL-print) -D $(man-language) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2pdf -d $(DSSSL-print) \
dynebolic-manual-$(man-language).sgml
postscript : $(DEPS)
rm -f dynebolic-manual.pdf
- docbook2ps -d $(DSSSL-print) -D $(man-language) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2ps -d $(DSSSL-print) \
dynebolic-manual-$(man-language).sgml
rtf : $(DEPS)
rm -f dynebolic-manual.rtf
- docbook2rtf -d $(DSSSL-pdf) -D $(man-language) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2rtf -d $(DSSSL-pdf) \
dynebolic-manual-$(man-language).sgml
tex : $(DEPS)
rm -f dynebolic-manual.tex
- docbook2tex -d $(DSSSL-print) -D $(man-language) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2tex -d $(DSSSL-print) \
dynebolic-manual-$(man-language).sgml
dvi : $(DEPS)
rm -f dynebolic-manual.dvi
- docbook2dvi -d $(DSSSL-print) -D $(man-language) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2dvi -d $(DSSSL-print) \
dynebolic-manual-$(man-language).sgml
man : $(DEPS)
rm -f dynebolic.man
- docbook2man -d $(DSSSL-html) -D $(man-language) \
+ cd $(man-language) && SP_ENCODING=XML \
+ docbook2man -d $(DSSSL-html) \
dynebolic-manual-$(man-language).sgml
diff --git a/dynebolic/stylesheets/dsssl-1.79/bin/collateindex.pl b/dynebolic/utils/collateindex.pl
index e384711..e384711 100644
--- a/dynebolic/stylesheets/dsssl-1.79/bin/collateindex.pl
+++ b/dynebolic/utils/collateindex.pl
diff --git a/dynebolic/stylesheets/dsssl-1.79/bin/collateindex.pl.1 b/dynebolic/utils/collateindex.pl.1
index a1b7020..a1b7020 100644
--- a/dynebolic/stylesheets/dsssl-1.79/bin/collateindex.pl.1
+++ b/dynebolic/utils/collateindex.pl.1
diff --git a/dynebolic/utils/collatemanual.sh b/dynebolic/utils/collatemanual.sh
index ab38fb9..9a9ab13 100755
--- a/dynebolic/utils/collatemanual.sh
+++ b/dynebolic/utils/collatemanual.sh
@@ -27,8 +27,12 @@ devel
#initialise output file
out=$lang/dynebolic-manual-$lang.sgml
rm -f $out
-echo "<!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook V3.1//EN\"" > $out
-echo "[" >> $out
+
+cat <<EOF > $out
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN"
+[
+EOF
+
# collate the chapters