Re: resend update to sgml documentation

[Dustin Navea]

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

*hint hint* *wink wink* ;P

-Dustin
--- Tony Lambregts  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%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; 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 "[e-mail]">
>
> +<!entity name-tony-lambregts "Tony Lambregts">
> +<!entity email-tony-lambregts "[e-mail]">
> -
>
>  <!entity name-marcus-meissner "Marcus Meissner">
>
>  <!-- <!entity email-marcus-meissner
> "[e-mail]"> -->
>
>  <!entity email-marcus-meissner "[e-mail]">

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

resend update to sgml documentation

[Tony Lambregts]

Dustin Navea wrote:
> Hmm, wonder where the "generic steps to get output from sgml" came from??? 
> ;)
>
> *hint hint* *wink wink* ;P

Dunno...  I think I cut and pasted that from an e-mail from you.

Did you  release that X11...?? LGPL...?? or (TM.)?

resend update to sgml documentation

[Dustin Navea]

--- Tony Lambregts  wrote:
> Dustin Navea wrote:
> > Hmm, wonder where the "generic steps to get output from sgml" came from???
> > ;)
> >
> > *hint hint* *wink wink* ;P
>
> Dunno...  I think I cut and pasted that from an e-mail from you.
>
> Did you  release that X11...?? LGPL...?? or (TM.)?

hmm, i guess it was lgpl, but dont ya think i deserve credit for coming up
with it? ;)

-Dustin

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

resend update to sgml documentation

[Tony Lambregts]

Dustin Navea wrote:
> --- Tony Lambregts  wrote:
> > Dustin Navea wrote:
> > > Hmm, wonder where the "generic steps to get output from sgml" came from???
> > >
> > > ;)
> > >
> > > *hint hint* *wink wink* ;P
> >
> > Dunno...  I think I cut and pasted that from an e-mail from you.
> >
> > Did you  release that X11...?? LGPL...?? or (TM.)?
>
> hmm, i guess it was lgpl, but dont ya think i deserve credit for coming up
> with it? ;)

I'll include you as one of the authors in my next patch if you want. Seriously this leads me to this question. Is there a change log for the documentation? I found CHANGELOG.OLD but the last entry in that is from 98... and, from what I can see, most of it is for changes to wine itself not the documentation.

Some sections have no original author included and I know that most of the documents are not the same as the original author wrote.

resend update to sgml documentation

[Vincent Béron]

Le dim 10/11/2002 à 11:12, Tony Lambregts a écrit :
> I'll include you as one of the authors in my next patch if you want. Seriously this leads

me to this question. Is there a change log for the documentation? I found CHANGELOG.OLD but
the last entry in that is from 98... and, from what I can see, most of it is for changes to
wine itself not the documentation.

ChangeLog.OLD is the "older" changelog, and has been replaced by a new
one, ChangeLog (see last (actually, first) comment of ChangeLog).

Alexandre keeps track in ChangeLog of everything he commits, including
documentation updates. grep (or perl) is your friend if you want to
extract only the documentation changelog.

Vincent

resend update to sgml documentation

[Duane Clark]

Tony Lambregts wrote:
> I'll include you as one of the authors in my next patch if you want.
> Seriously this leads me to this question. Is there a change log for
> the documentation? I found CHANGELOG.OLD but the last entry in that
> is from 98... and, from what I can see, most of it is for changes to
> wine itself not the documentation.

Just in case you were not aware of it, for a quite rundown of the dates 
and comments used when commiting to CVS:
cvs log documentation/documentation.sgml

resend update to sgml documentation

[Dustin Navea]

--- Tony Lambregts  wrote:
> Dustin Navea wrote:
> > --- Tony Lambregts  wrote:
> > > Dustin Navea wrote:
> > > > Hmm, wonder where the "generic steps to get output from sgml" came
>
> from???
> > > > ;)
> > > >
> > > > *hint hint* *wink wink* ;P
> > >
> > > Dunno...  I think I cut and pasted that from an e-mail from you.
> > >
> > > Did you  release that X11...?? LGPL...?? or (TM.)?
> >
> > hmm, i guess it was lgpl, but dont ya think i deserve credit for coming up
> > with it? ;)
>
> I'll include you as one of the authors in my next patch if you want.
> Seriously this leads me to this question. Is there a change log for the
> documentation? I found CHANGELOG.OLD but the last entry in that is from
> 98... and, from what I can see, most of it is for changes to wine itself
> not the documentation.
>
> Some sections have no original author included and I know that most of the
> documents are not the same as the original author wrote.

I think the changelog is just a note in the ChangeLog file saying oh and
Dustin Navea submitted some updates to the wine doc...

-Dustin

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