resend update to sgml documentation
Dustin Navea
speeddymon at yahoo.com
Sat Nov 9 22:34:43 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