resend update to sgml documentation

Dustin Navea speeddymon at yahoo.com
Sat Nov 9 22:34:39 CST 2002


Hmm, wonder where the "generic steps to get output from sgml" came from??? 
;)

*hint hint* *wink wink* ;P

-Dustin
--- Tony Lambregts <tony_lambregts at 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 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 "alex at aikea.ams.sunysb.edu">
>  
> +<!entity name-tony-lambregts "Tony Lambregts">
> +<!entity email-tony-lambregts "tony_lambregts at telusplanet.net">
> +
>  <!entity name-marcus-meissner "Marcus Meissner">
>  <!-- <!entity email-marcus-meissner
> "msmeissn at cip.informatik.uni-erlangen.de"> -->
>  <!entity email-marcus-meissner "Marcus.Meissner at caldera.de">
> 


__________________________________________________
Do you Yahoo!?
U2 on LAUNCH - Exclusive greatest hits videos
http://launch.yahoo.com/u2



More information about the wine-devel mailing list