Hmm, wonder where the "generic steps to get output from sgml" came from??? ;)
*hint hint* *wink wink* ;P
-Dustin --- Tony Lambregts tony_lambregts@telusplanet.net wrote:
Since the last patch looked really screwed up I am resending with .txt extention
Hopfully this makes it easier for others to set up their docbook environment and encourage more people to write documentation it is not complete but at least it is a start.
change log: make the instructions of how to install sgml easier to understand .
files changed: documentation/documentation.sgml documentation/authors.ent
--
Tony Lambregts
Index: documentation.sgml
=================================================================== RCS file: /home/wine/wine/documentation/documentation.sgml,v retrieving revision 1.4 diff -u -r1.4 documentation.sgml --- documentation.sgml 2 Oct 2001 17:48:16 -0000 1.4 +++ documentation.sgml 9 Nov 2002 04:00:59 -0000 @@ -86,6 +86,9 @@ <para> Written by &name-john-sheets; <email>&email-john-sheets;</email> </para>
<para>Modified by &name-tony-lambregts;<email>&email-tony-lambregts;</email> Nov. 2002
</para> <sect2 id="writing-docbook"> <title>Writing Documentation with DocBook</title>@@ -98,7 +101,123 @@ DocBook markup looks very similar to HTML markup, although the names of the markup tags differ. </para>
<sect3>
<title>Getting Started</title><note><title>Why SGML?</title><para>The simple answer to that is that SGML allows youto create multiple formats of a given document from asingle
source. Currently sgml is used to create html, pdf and PSformats of the Users Guide, Developers Guide, Winelib UsersGuide Packagers Guide and FAQ.</para></note><note><title>What do I need?</title><para>You need the sgml tools. There are various places where youcan get them. The most generic way of geting them formsource.
</para></note><note><title>Quick instructions</title><para>These are the generic steps to get output from sgml.</para></note><orderedlist><listItem><para>Go to <ulinkurl="http://www.sgmltools.org%22%3Ehttp://www.sgmltools.org</ulink>
</para></listitem><listItem><para>Download all of the sgmltools packages</para></listitem><listItem><para>Install them all and build them (./configure; make; makeinstall)
</para></listitem><listItem><para>Switch to your toplevel wine directory</para></listitem><listItem><para>Run ./configure (or make distclean && ./configure)</para></listitem><listItem><para>Switch to the documentation directory</para></listitem><listItem><para>run make_winehq</para></listitem><listItem><para>View wine-doc/index.html in your favorite browser</para></listitem></orderedlist></sect3>
<sect3><title>Getting SGML for various distributions</title><para>Most Linux distributions have everything you need alreadybundled up in package form. Unfortunately, eachdistribution seems to handle its SGML environmentdifferently, installing it into different paths, andnaming its packages according to its own whims.</para><sect4><title>SGML on Redhat</title><para>The following packages seems to be sufficient for RedHat 7.1.You
will want to be careful about the order in which you installthe
rpms.<itemizedlist><listitem><para>sgml-common-*.rpm</para></listitem><listitem><para>openjade-*.rpm</para></listitem><listitem><para>perl-SGMLSpm-*.rpm</para></listitem><listitem><para>docbook-dtd*.rpm</para></listitem><listitem><para>docbook-style-dsssl-*.rpm</para></listitem><listitem><para>tetex-*.rpm</para></listitem><listitem><para>jadetex-*.rpm</para></listitem><listitem><para>docbook-utils-*.rpm</para></listitem></itemizedlist>You can also use ghostscript to view the ps format output andAdobe Acrobat 4 to view the pdf file.</para></sect4><sect4><title>SGML on Debian</title><note><title>Fix me</title><para>List package names and install locations...</para></note></sect4><sect4><title>SGML on Other Distributions</title><note><title>Fix me</title><para>List package names and install locations...</para></note></sect4></sect3> <sect3> <title>Terminology</title>@@ -1006,47 +1125,6 @@ </para> </sect3>
<sect3><title>SGML on Redhat</title><para>Most Linux distributions have everything you need alreadybundled up in package form. Unfortunately, eachdistribution seems to handle its SGML environmentdifferently, installing it into different paths, andnaming its packages according to its own whims.</para><para>The following packages seems to be sufficient for RedHat 7.1.You
will want to be careful about the order in which you installthe
rpms.<itemizedlist><listitem><para>sgml-common-*.rpm</para></listitem><listitem><para>openjade-*.rpm</para></listitem><listitem><para>perl-SGMLSpm-*.rpm</para></listitem><listitem><para>docbook-dtd*.rpm</para></listitem><listitem><para>docbook-style-dsssl-*.rpm</para></listitem><listitem><para>tetex-*.rpm</para></listitem><listitem><para>jadetex-*.rpm</para></listitem><listitem><para>docbook-utils-*.rpm</para></listitem></itemizedlist>You can also use ghostscript to view the ps format output andAdobe Acrobat 4 to view the pdf file.</para></sect3><sect3><title>SGML on Debian</title><para>List package names and install locations...</para></sect3><sect3><title>SGML on Other Distributions</title><para>List package names and install locations...</para></sect3> </sect2> <sect2 id="emacs-psgml">Index: authors.ent
RCS file: /home/wine/wine/documentation/authors.ent,v retrieving revision 1.2 diff -u -r1.2 authors.ent --- authors.ent 24 Jul 2002 03:00:02 -0000 1.2 +++ authors.ent 9 Nov 2002 04:01:56 -0000 @@ -43,6 +43,9 @@
<!entity name-alex-korobka "Alex Korobka">
<!entity email-alex-korobka "alex@aikea.ams.sunysb.edu">
+<!entity name-tony-lambregts "Tony Lambregts"> +<!entity email-tony-lambregts "tony_lambregts@telusplanet.net">
<!entity name-marcus-meissner "Marcus Meissner">
<!-- <!entity email-marcus-meissner "msmeissn@cip.informatik.uni-erlangen.de"> -->
<!entity email-marcus-meissner "Marcus.Meissner@caldera.de">
__________________________________________________ Do you Yahoo!? U2 on LAUNCH - Exclusive greatest hits videos http://launch.yahoo.com/u2