Hmm, wonder where the "generic steps to get output from sgml" came from??? ;)
*hint hint* *wink wink* ;P -Dustin --- Tony Lambregts <[EMAIL PROTECTED]> 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 you > + to create multiple formats of a given document from a > single > + source. Currently sgml is used to create html, pdf and PS > + formats of the Users Guide, Developers Guide, Winelib Users > + Guide Packagers Guide and FAQ. > + </para> > + </note> > + > + <note> > + <title>What do I need?</title> > + <para> > + You need the sgml tools. There are various places where you > + can get them. The most generic way of geting them form > source. > + </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 <ulink > url="http://www.sgmltools.org">http://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; make > install) > + </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 already > + bundled up in package form. Unfortunately, each > + distribution seems to handle its SGML environment > + differently, installing it into different paths, and > + naming 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 install > the > + 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 and > + Adobe 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 already > - bundled up in package form. Unfortunately, each > - distribution seems to handle its SGML environment > - differently, installing it into different paths, and > - naming 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 install > the > - 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 and > - Adobe 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 "[EMAIL PROTECTED]"> > > +<!entity name-tony-lambregts "Tony Lambregts"> > +<!entity email-tony-lambregts "[EMAIL PROTECTED]"> > + > <!entity name-marcus-meissner "Marcus Meissner"> > <!-- <!entity email-marcus-meissner > "[EMAIL PROTECTED]"> --> > <!entity email-marcus-meissner "[EMAIL PROTECTED]"> > __________________________________________________ Do you Yahoo!? U2 on LAUNCH - Exclusive greatest hits videos http://launch.yahoo.com/u2