From kirillov@math.sunysb.edu  Sun Feb  4 18:06:39 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from localhost.localdomain (076-041.dialup.sunysb.edu [129.49.76.41])
	by mail.gnome.org (Postfix) with ESMTP id B4BE02BC7E
	for <gnome-doc-list@gnome.org>; Sun,  4 Feb 2001 18:06:38 -0500 (EST)
Received: by localhost.localdomain (Postfix, from userid 501)
	id 0CEF73E53A; Sun,  4 Feb 2001 18:05:02 -0500 (EST)
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: indexing
Message-Id: <20010204230502.0CEF73E53A@localhost.localdomain>
Date: Sun,  4 Feb 2001 18:05:02 -0500 (EST)
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all:
one feature almost all our docs are sorely missing (with the exception
of the users guide for 1.2) is an index. I think we need to do something
about it. 

Ideal solution would be: 

 a. we put tags like 

   <indexterm><primary>Applets</primary>
              <secondary>adding to panel</secondary> 
   </indexterm>
   in our documents (in this case - in the panel manual when
   discussing adding applets to panel). 

 b. during db2html conversion, gnome-db2html would process this and
 create an index for the document, or 

 c. even better, index for documents for all core components
 (panel, applets, nautilus,  control center,...), or  even all  gnome
 docs is created from these tags at installation time, so we have a
 common index. 

Unfortunately, this is unrealistic. At the moment, gnome-db2html does
not automatically produce an index. Neither, btw, does jade. However,
I strongly feel that we need an index *now* - make it a hack if we
must. 

 Suggestions: 

 1. Create an index for each doc manually, i.e. in your doc, add
    a section like this

<index><title>Index</title>
<indexdiv><title>A</title>
<indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see <xref linkend="appletadd">
           </secondaryie>
   </primaryie>   

etc. Here "appletadd" is the id of sect1 discussing this topic.
Obviously, the problem is that you must manually update the index
whenever the document structure changes.

or: 

  2. Create a common index for all core docs as a separate document;
instead of <xref>, use something like 
 <indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see Panel manual, section <ulink type="gnome-help"
url="help:panel?appletadd">Adding objects to panel</ulink> 
           </secondaryie>
   </primaryie>   
  

Obviously, 2 would be better for the user (it is better to have one
common index than 10 individual ones) but *much* harder to maintain. On the
other hand, sections of our documents do not change all too
often. I think either way it is something we can do before 1.4; my
estimate is it would take 2-3 days (for one person) to write such an
index. Yes, it is a hack, but it will do for now. I'd vote for 2. 

Comments? Volunteers?

Sasha






From michael.smith@openwave.com  Mon Feb  5 05:01:38 2001
Return-Path: <michael.smith@openwave.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from oe-mp1.bizmailsrvcs.net (oe-mp1pub.managedmail.com [206.46.164.22])
	by mail.gnome.org (Postfix) with ESMTP id 86F812BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:01:37 -0500 (EST)
Received: from oe-ismta1.bizmailsrvcs.net ([206.46.164.26])
          by oe-mp1.bizmailsrvcs.net (InterMail vM.5.01.01.01 201-252-104)
          with ESMTP
          id <20010205095619.CZSW24251.oe-mp1.bizmailsrvcs.net@oe-ismta1.bizmailsrvcs.net>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:56:19 -0600
Received: from SMITH1.openwave.com ([63.24.97.132])
          by oe-ismta1.bizmailsrvcs.net
          (InterMail vM.5.01.01.01 201-252-104) with ESMTP
          id <20010205095452.YJUR1854.oe-ismta1.bizmailsrvcs.net@SMITH1.openwave.com>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:54:52 -0600
To: gnome-doc-list@gnome.org
Subject: July open-source conference
From: Michael Smith <smith@xml-doc.org>
Date: 05 Feb 2001 02:01:27 -0800
Message-ID: <uae81phxk.fsf@openwave.com>
Lines: 29
User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello all,

I'm writing to a few different lists to ask whether anyone might be
planning to attend the O'Reilly open-source conference (San Diego CA)
in July.

I've been in contact with some of the folks at O'Reilly, trying to
drum up support for a "DocBook" or "open-source document authoring"
day. I think a discussion/tutorial from someone involved with the GNOME
doc project would be valuable to others. Has anyone thought about maybe
submitting a proposal for a tutorial/presentation?

The deadline for submissions of proposals is February 9th (this
Friday). If anyone else from the GNOME doc project could submit a
proposal of some kind, I think it would great. If nobody wants to
commit to a whole tutorial, I'd certainly be willing to coordinate
integration of GNOME expertise into a larger tutorial of some kind.

Please let me know what you think, or just go ahead and submit a
proposal for the conference's XML track:

  http://conferences.oreilly.com/oscon2001/call-xml.html

Or at the very least, if you plan on attending, e-mail
oscon2001-xml-proposals@oreilly.com expressing interest in seeing some
DocBook/document-authoring tutorials/presentations take place.

  --Mike Smith






From laszlo.kovacs@Sun.COM  Mon Feb  5 05:10:37 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 6DE652BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:10:36 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id CAA21828
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 02:10:34 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id KAA19302
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 10:10:33 GMT
Message-ID: <3A7E7C19.78432618@Sun.COM>
Date: Mon, 05 Feb 2001 10:10:33 +0000
From: laszlo kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> 
> Hi all:
> one feature almost all our docs are sorely missing (with the exception
> of the users guide for 1.2) is an index. I think we need to do something
> about it.
> 
> Ideal solution would be:
> 
>  a. we put tags like
> 
>    <indexterm><primary>Applets</primary>
>               <secondary>adding to panel</secondary>
>    </indexterm>
>    in our documents (in this case - in the panel manual when
>    discussing adding applets to panel).
> 
>  b. during db2html conversion, gnome-db2html would process this and
>  create an index for the document, or
> 
>  c. even better, index for documents for all core components
>  (panel, applets, nautilus,  control center,...), or  even all  gnome
>  docs is created from these tags at installation time, so we have a
>  common index.
> 
> Unfortunately, this is unrealistic. At the moment, gnome-db2html does
> not automatically produce an index. Neither, btw, does jade. However,
> I strongly feel that we need an index *now* - make it a hack if we
> must.

I wonder how much people know about the Scrollkeeper project (not very
informative web site is scrollkeeper.sourceforge.net). This project is
about metadata based document categorizing and storing the result in xml
file(s) exported to help browsers. There are pretty high chances that
the Help sidebar in Nautilus for Gnome 1.4 will use Scrollkeeper. We
aimed to add indexing functionality in Scrollkeeper after Gnome 1.4.
This contains index extraction (in case the index info is added to the
docs as detailed above), exporting this to help browsers and integrate
this with Nautilus. Going further implementation of search through index
and other parts of the documentation and metadata is also considered.
Both Scrollkeeper and its integration with Nautilus are run by the same
people.

> 
>  Suggestions:
> 
>  1. Create an index for each doc manually, i.e. in your doc, add
>     a section like this
> 
> <index><title>Index</title>
> <indexdiv><title>A</title>
> <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see <xref linkend="appletadd">
>            </secondaryie>
>    </primaryie>
> 
> etc. Here "appletadd" is the id of sect1 discussing this topic.
> Obviously, the problem is that you must manually update the index
> whenever the document structure changes.
> 
> or:
> 
>   2. Create a common index for all core docs as a separate document;
> instead of <xref>, use something like
>  <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see Panel manual, section <ulink type="gnome-help"
> url="help:panel?appletadd">Adding objects to panel</ulink>
>            </secondaryie>
>    </primaryie>
> 
> 
> Obviously, 2 would be better for the user (it is better to have one
> common index than 10 individual ones) but *much* harder to maintain. On the
> other hand, sections of our documents do not change all too
> often. I think either way it is something we can do before 1.4; my
> estimate is it would take 2-3 days (for one person) to write such an
> index. Yes, it is a hack, but it will do for now. I'd vote for 2.

1. would prolly suit the way how Scrollkeeper is intended to work
better, but I am sure it could also serve the other approach. One
question though, what's the point to add the index info to docs before
Gnome 1.4 if there is no index display and search implemented? Or am I
missing something?

Laszlo


From kirillov@peconic.math.sunysb.edu  Mon Feb  5 11:28:30 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 5D0FE2CA94
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 11:28:30 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id LAA00445;
	Mon, 5 Feb 2001 11:28:28 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id LAA30055;
	Mon, 5 Feb 2001 11:28:28 -0500
Date: Mon, 5 Feb 2001 11:28:28 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: laszlo kovacs <laszlo.kovacs@sun.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
Message-ID: <20010205112828.A30010@math.sunysb.edu>
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <3A7E7C19.78432618@Sun.COM>; from laszlo.kovacs@sun.com on Mon, Feb 05, 2001 at 10:10:33AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, Feb 05, 2001 at 10:10:33AM +0000, laszlo kovacs wrote:
[snip]
> One
> question though, what's the point to add the index info to docs before
> Gnome 1.4 if there is no index display and search implemented? Or am I
> missing something?
> 
> Laszlo

If we add an index to a doc manually, as in suggestion 1, then it will
be useful even without special "index display" - it will just show as
one of the sections of your document (usually the last one). If you
are trying to find info about some topic, you just look at this
section, find (manually) the topic you need, and click on the provided
link. Much as with printed books.

Of course, having a special index display with help option would be
better. Do you have any estimates how soon it will be implemented in
Nautilus? "after Gnome 1.4" is rather vague...

Best,
Sasha


From laszlo.kovacs@Sun.COM  Mon Feb  5 12:26:45 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id B667D2E27C
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:26:44 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id JAA10958;
	Mon, 5 Feb 2001 09:26:42 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id RAA23772;
	Mon, 5 Feb 2001 17:26:41 GMT
Message-ID: <3A7EE251.5B3BEA08@Sun.COM>
Date: Mon, 05 Feb 2001 17:26:41 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM> <20010205112828.A30010@math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> If we add an index to a doc manually, as in suggestion 1, then it will
> be useful even without special "index display" - it will just show as
> one of the sections of your document (usually the last one). If you
> are trying to find info about some topic, you just look at this
> section, find (manually) the topic you need, and click on the provided
> link. Much as with printed books.
Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
 
> Of course, having a special index display with help option would be
> better. Do you have any estimates how soon it will be implemented in
> Nautilus? "after Gnome 1.4" is rather vague...
All I know right now is that hopefully for the next major Gnome release
after 1.4. Work has not been started yet. But this is very important for
Sun. Just like the Search functionality. I always assumed this will be
done as part of the joint Scrollkeeper/Scrollkeeper-Nautilus Integration
project. I did most of the coding of Scrollkeeper with design mostly
discussed with Dan Mueth and other people. Same on the Scrollkeeper
side, there is an intention that as soon as Gnome 1.4 is released myself
or another Sun engineer will be fully responsible for hyperbola, the
Nautilus component that implements the help sidebar and will implement
the GUI for the Index display and Search also (at least this is how I
see it).

Laszlo


From jfleck@inkstain.net  Mon Feb  5 12:36:32 2001
Return-Path: <jfleck@inkstain.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from jello.inkstain.net (shell.inkstain.net [206.29.130.69])
	by mail.gnome.org (Postfix) with ESMTP id 4A5402D9AF
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:36:32 -0500 (EST)
Received: from jello (mail [206.29.130.67])
	by jello.inkstain.net (8.9.3/8.9.3) with SMTP id JAA22114;
	Mon, 5 Feb 2001 09:27:09 -0800 (PST)
Date: Mon, 5 Feb 2001 09:27:09 -0800 (PST)
From: <jfleck@inkstain.net>
X-Sender: jfleck@jello
To: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <3A7EE251.5B3BEA08@Sun.COM>
Message-ID: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Mon, 5 Feb 2001, Laszlo Kovacs wrote:

> > If we add an index to a doc manually, as in suggestion 1, then it will
> > be useful even without special "index display" - it will just show as
> > one of the sections of your document (usually the last one). If you
> > are trying to find info about some topic, you just look at this
> > section, find (manually) the topic you need, and click on the provided
> > link. Much as with printed books.
> Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
>  

It does not now. I'm looking into what would be required to add the
necessary support.

Cheers,

John



From dan@eazel.com  Mon Feb  5 17:25:13 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.localdomain (unknown [64.37.237.47])
	by mail.gnome.org (Postfix) with ESMTP id EFB912D34F
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 17:25:12 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.localdomain (8.11.0/8.11.0) with ESMTP id f160KqX04045;
	Mon, 5 Feb 2001 16:21:42 -0800
X-Authentication-Warning: foodle.localdomain: dan owned process doing -bs
Date: Mon, 5 Feb 2001 16:20:52 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
X-Sender: dan@foodle.localdomain
To: jfleck@inkstain.net
Cc: Laszlo Kovacs <laszlo.kovacs@Sun.COM>,
	Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
Message-ID: <Pine.LNX.4.21.0102051612330.13847-100000@foodle.localdomain>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, 5 Feb 2001 jfleck@inkstain.net wrote:

> On Mon, 5 Feb 2001, Laszlo Kovacs wrote:
> 
> > > If we add an index to a doc manually, as in suggestion 1, then it will
> > > be useful even without special "index display" - it will just show as
> > > one of the sections of your document (usually the last one). If you
> > > are trying to find info about some topic, you just look at this
> > > section, find (manually) the topic you need, and click on the provided
> > > link. Much as with printed books.
> > Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
> >  
> 
> It does not now. I'm looking into what would be required to add the
> necessary support.

Thanks John. This is something we would eventually like to have in
gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
providing a search feature that searches the index of many documents at
once.

If we really want to have a central index, we might imagine faking
together one (as Sasha suggested), but make it a single document which
acts like an index to the other documents which are core to GNOME.  We
could call it "The GNOME Index" and then put links like:
  cd player -> gtcd
  CPU: monitoring load -> multiload applet
       identifying -> Nautilus hardware view
  Themes: changing -> Control center: Appearance

or whatever.  This is really what the user wants. Of course this would be
a lot of work to do well, especially to do a good job.  It would fit
nicely into gnome-user-docs.

Dan




From Patrick.Costello@ireland.sun.com  Tue Feb  6 02:20:18 2001
Return-Path: <Patrick.Costello@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 9DEA02E3BE
	for <gnome-doc-list@gnome.org>; Tue,  6 Feb 2001 02:20:17 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id XAA00496;
	Mon, 5 Feb 2001 23:20:14 -0800 (PST)
Received: from dbl-ray-3 (dbl-ray-3 [129.156.237.102])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with SMTP id HAA28877;
	Tue, 6 Feb 2001 07:20:14 GMT
Message-Id: <200102060720.HAA28877@ireserver.Ireland.Sun.COM>
Date: Tue, 6 Feb 2001 07:20:14 +0000 (GMT)
From: Pat Costello <Patrick.Costello@ireland.sun.com>
Reply-To: Pat Costello <Patrick.Costello@ireland.sun.com>
Subject: Re: indexing
To: jfleck@inkstain.net, dan@eazel.com
Cc: laszlo.kovacs@Sun.COM, kirillov@math.sunysb.edu,
	gnome-doc-list@gnome.org
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mU6vkHqmlSX8KsPxXlLPhQ==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

All, 

A central index covering Gnome core functions, applications and applets would be 
very handy, especially given the multiplexed nature of the Gnome desktop. At 
first, though, I would suggest a top-level approach to the index so that only 
the main topic headers are flagged, for example the only entry for an applet 
would be the applet header rather than applet actions. In other words, we need 
only put the entry "screen-shooter" into the index and not "screenshots, see 
screen-shooter". This might reduce the amount of work. 

Pat

> 
> On Mon, 5 Feb 2001 Dan Mueth wrote:
 
> Thanks John. This is something we would eventually like to have in
> gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
> providing a search feature that searches the index of many documents at
> once.
> 
> If we really want to have a central index, we might imagine faking
> together one (as Sasha suggested), but make it a single document which
> acts like an index to the other documents which are core to GNOME.  We
> could call it "The GNOME Index" and then put links like:
>   cd player -> gtcd
>   CPU: monitoring load -> multiload applet
>        identifying -> Nautilus hardware view
>   Themes: changing -> Control center: Appearance
> 
> or whatever.  This is really what the user wants. Of course this would be
> a lot of work to do well, especially to do a good job.  It would fit
> nicely into gnome-user-docs.
> 
> Dan
> 
> 
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list



From sarithazan@hotmail.com  Thu Feb  8 06:59:02 2001
Return-Path: <sarithazan@hotmail.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from hotmail.com (oe44.law11.hotmail.com [64.4.16.16])
	by mail.gnome.org (Postfix) with ESMTP id ACAC92BD24
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 06:59:01 -0500 (EST)
Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC;
	 Thu, 8 Feb 2001 03:59:00 -0800
X-Originating-IP: [212.117.152.146]
From: "Sara Hazan" <sarithazan@hotmail.com>
To: <gnome-doc-list@gnome.org>
Subject: problem with configure
Date: Thu, 8 Feb 2001 13:58:11 +0200
MIME-Version: 1.0
Content-Type: multipart/alternative;	boundary="----=_NextPart_000_0005_01C091D7.2C65A930"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.00.2014.211
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2014.211
Message-ID: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
X-OriginalArrivalTime: 08 Feb 2001 11:59:00.0765 (UTC) FILETIME=[863694D0:01C091C6]
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Hi,

After run ./configure I get the follow :

checking for glib-config... no
checking for GLIB - version >=3D 1.2.0... no
*** The glib-config script installed by GLIB could not be found
*** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
*** your path, or set the GLIB_CONFIG environment variable to the
*** full path to glib-config.
configure: error: Test for GLIB failed.  MC requires GLIB.


Please tell me what to do.

Thanks.

Sarit


------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/html;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Diso-8859-1" =
http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2314.1000" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Hi,</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>After run ./configure I get the follow=20
:</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>checking for glib-config... =
no<BR>checking for GLIB=20
- version &gt;=3D 1.2.0... no<BR>*** The glib-config script installed by =
GLIB=20
could not be found<BR>*** If GLIB was installed in PREFIX, make sure =
PREFIX/bin=20
is in<BR>*** your path, or set the GLIB_CONFIG environment variable to=20
the<BR>*** full path to glib-config.<BR>configure: error: Test for GLIB=20
failed.&nbsp; MC requires GLIB.<BR></FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Please tell me what to do.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Thanks.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Sarit</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>&nbsp;</DIV></FONT></BODY></HTML>

------=_NextPart_000_0005_01C091D7.2C65A930--


From laszlo.kovacs@Sun.COM  Thu Feb  8 07:02:04 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 75BD12E7A9
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 07:02:04 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id EAA28398;
	Thu, 8 Feb 2001 04:02:03 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id MAA23602;
	Thu, 8 Feb 2001 12:02:02 GMT
Message-ID: <3A828ABA.96B484AB@Sun.COM>
Date: Thu, 08 Feb 2001 12:02:02 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Sara Hazan <sarithazan@hotmail.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: problem with configure
References: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> Sara Hazan wrote:
> 
> Hi,
> 
> After run ./configure I get the follow :
> 
> checking for glib-config... no
> checking for GLIB - version >= 1.2.0... no
> *** The glib-config script installed by GLIB could not be found
> *** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
> *** your path, or set the GLIB_CONFIG environment variable to the
> *** full path to glib-config.
> configure: error: Test for GLIB failed.  MC requires GLIB.
> 
> Please tell me what to do.
> 
> Thanks.
> 
> Sarit
> 

Two ways:

1. put glib-config in your PATH.
2. Set GLIB_CONFIG to point to where your glib-config is.

Laszlo


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Thu Feb  8 16:56:07 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id F0BE82BB19
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 16:56:06 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14Qz2s-0000mx-00
	for <gnome-doc-list@gnome.org>; Thu, 08 Feb 2001 15:56:06 -0600
Date: Thu, 8 Feb 2001 15:56:06 -0600
From: Eric Baudais <baudais@okstate.edu>
To: GNOME Documentation Project <gnome-doc-list@gnome.org>
Subject: Doc Writers Needed.
Message-ID: <20010208155605.A3008@bubba>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Yes, this is a call out for help.  There are currently 3 gnome-games that 
need docs.  They are:

gnometris
gnotravex
gnotski

If anyone wants to write docs for these apps contact me and/or put you name 
in the doctable under the game.

Eric Baudais


From gleblanc@cu-portland.edu  Sat Feb 10 18:27:21 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 54B8D2D04B
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 18:27:21 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1ANRKt11506
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 15:27:20 -0800
Message-Id: <200102102327.f1ANRKt11506@mail3.aracnet.com>
Subject: [khitam sobh <tami@ca.inter.net>] user guide
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org
Content-Type: multipart/mixed; boundary="=-5p0cBznQ7LiDjmQ3yxfp"
X-Mailer: Evolution (0.8 - Preview Release)
Date: 10 Feb 2001 15:26:04 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Type: text/plain

Oh, it beats me, somebody from the list must know.  :)  Please CC
webmaster@gnome.org on any reply you make.  Thanks,

    Greg

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Disposition: inline
Content-Description: Forwarded message - user guide
Content-Type: message/rfc822

Received: from sweeper.cu-portland.edu (SWEEPER [207.149.56.136]) by 
	email.cu-portland.edu with SMTP (Microsoft Exchange Internet Mail Service 
	Version 5.5.2650.21) id CF9WLFPJ; Sat, 10 Feb 2001 15:05:45 -0800
Received: from mail.gnome.org (unverified) by sweeper.cu-portland.edu 
	(Content Technologies SMTPRS 4.1.5) with ESMTP id 
	<Tcf9538428351a54b8096@sweeper.cu-portland.edu> for 
	<GLeblanc@cu-portland.edu>; Sat, 10 Feb 2001 15:05:39 -0800
Received: from mail.gnome.org (localhost.localdomain [127.0.0.1]) by 
	mail.gnome.org (Postfix) with ESMTP id 343392E22E; Sat, 10 Feb 2001 
	18:05:35 -0500 (EST)
Received: from smtp.total.net (rossine.total.net [154.11.89.167]) by 
	mail.gnome.org (Postfix) with SMTP id B8D9F2D04B for <webmaster@gnome.org>; 
	Sat, 10 Feb 2001 18:03:26 -0500 (EST)
Received: (qmail 941 invoked from network); 10 Feb 2001 23:03:24 -0000
Received: from unknown (HELO tamica) (154.20.8.101) by smtp.total.net with 
	SMTP; 10 Feb 2001 23:03:24 -0000
Delivered-To: gnome-webmaster-list@gnome.org
Message-ID: <000a01c093b5$c35eafa0$6508149a@inter.net>
From: "khitam sobh" <tami@ca.inter.net>
To: <webmaster@gnome.org>
Subject: user guide
Date: Sat, 10 Feb 2001 18:04:02 -0500
MIME-Version: 1.0
Content-Type: multipart/alternative; 
	boundary="----=_NextPart_000_0007_01C0938B.D99483A0"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-webmaster-list-admin@gnome.org
Errors-To: gnome-webmaster-list-admin@gnome.org
X-BeenThere: gnome-webmaster-list@gnome.org
X-Loop: gnome-webmaster-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
Reply-To: webmaster@gnome.org
List-Id: Webmaster mail <gnome-webmaster-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Do you have the gnome user guide in french?
If it is available on the net, where can I get it, thanks.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/html; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>

<META content=3D"MSHTML 5.50.4611.1300" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Do you have the gnome user guide in=20
french?</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>If it is available on the net, where can I=
 get it,=20
thanks.</FONT></DIV></BODY></HTML>

------=_NextPart_000_0007_01C0938B.D99483A0--


--=-5p0cBznQ7LiDjmQ3yxfp--



From Ian@shelob.f9.co.uk  Sun Feb 11 12:57:14 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id A8D5A2D9B7
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 12:57:13 -0500 (EST)
Received: (qmail 11399 invoked from network); 11 Feb 2001 17:57:08 -0000
Received: from unknown (HELO shelob) (212.159.32.178)
  by warrior with SMTP; 11 Feb 2001 17:57:08 -0000
Message-ID: <000401c09454$1ab4e3c0$b2209fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "Eric Baudais" <baudais@okstate.edu>
Cc: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 17:57:29 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"Eric Baudais" <baudais@okstate.edu> wrote:
> On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > How
> > would it be if I did could have something finished by the end
> > of this weekend?  I think I can manage that.
> 
> That would be great!

As promised, I have something finished.
It is not perfect, but it is not bad either.
Please download sgml and pngs from
http://www.shelob.plus.com/freecell/
and let me know what you think.

Regards,
Ian




From hobbit@aloss.ukuu.org.uk  Sun Feb 11 14:41:10 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 214E02BB36
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 14:41:09 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1BJgCA02828;
	Sun, 11 Feb 2001 19:42:12 GMT
Date: Sun, 11 Feb 2001 19:42:12 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: Ian@shelob.f9.co.uk
Subject: Re: Freecell Documentation
Message-ID: <20010211194212.B1727@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>,
	Ian@shelob.f9.co.uk
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 05:57:29PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

Dunno if Ian's on the list, so cc'd for now.

> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Looks great to me. Only quibble: fifty-two instead of fifty two (!)
Would it also be possible to explain that you can right-click on a
card in order to see what it is, if it's obscured by cards on top of
it? 

Oh, I suppose it may be worth noting that you click on cards and then
on destinations. I realise this is standard for Windows Freecell, but
it's different from the behaviour of how you move cards in Aisleriot.
I know Zana was thinking of explicitly describing how to move cards
around in aisleriot, so it makes sense to add how you move 'em for
Freecell, since the two are different and people trying one may try
to use the same method for the other.

Telsa


From Ian@shelob.f9.co.uk  Sun Feb 11 15:44:38 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id 907D82BAB4
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 15:44:37 -0500 (EST)
Received: (qmail 2862 invoked from network); 11 Feb 2001 20:44:33 -0000
Received: from unknown (HELO shelob) (212.159.41.48)
  by warrior with SMTP; 11 Feb 2001 20:44:33 -0000
Message-ID: <007d01c0946b$7e79d8e0$30299fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 20:26:14 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa <hobbit@aloss.ukuu.org.uk> wrote
> On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

> Dunno if Ian's on the list, so cc'd for now.

Actually, I am.  Mostly I lurk.

> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.

> Only quibble: fifty-two instead of fifty two (!)

I believe the latter form to be correct.
Jihad! Jihad! Jihad! :-)

> Would it also be possible to explain that you can right-click on a
> card in order to see what it is, if it's obscured by cards on top of
> it?

Yes it would, although not very soon unfortunately.  I feel all
documented out this evening, and I *really* am busy over the
next fortnight.  (I *may* be inclined to tweak a few things next
weekend, but I may instead prefer to do some gardening.)
How long do we have before 1.4 is due?

> I suppose it may be worth noting that you click on cards and then
> on destinations.

Actually, I did mention that.  In the usage section between
figures 2 and 3, I think.  Possibly the screenshots take up more
room than they are worth and just obscure the text?

Thanks for your comments,
Ian





From gleblanc@cu-portland.edu  Sun Feb 11 17:57:19 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 84D192D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 17:57:18 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1BMvGt26067;
	Sun, 11 Feb 2001 14:57:16 -0800
Message-Id: <200102112257.f1BMvGt26067@mail3.aracnet.com>
Subject: Re: Freecell Documentation
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: jrb@redhat.com, itp@ximian.com, zana@webwynk.net,
	cwryu@adam.kaist.ac.kr
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>
References: <20010208150546.A2912@bubba> 
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>  
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 11 Feb 2001 14:55:59 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> "Eric Baudais" <baudais@okstate.edu> wrote:
> > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > How
> > > would it be if I did could have something finished by the end
> > > of this weekend?  I think I can manage that.
> > 
> > That would be great!
> 
> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Just because I enjoy making trouble...  I don't think that a separate
freecell game will exist in the next major release of gnome-games.
Freecell has been implemented as part of the aisleriot suite, and that
version has a few less bugs (and the bugs it does have can be fixed for
all aisleriot games) than the separate C coded freecell game.  This
isn't a sure thing as far as I know, but it's worth being aware of.
Anybody have a good reason -not- to do this?

    Greg



From jrb@redhat.com  Sun Feb 11 18:22:06 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 9AC622D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:22:06 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1BNMl313635;
	Sun, 11 Feb 2001 18:22:47 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, itp@ximian.com,
	zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba>
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
	<200102112257.f1BMvGt26067@mail3.aracnet.com>
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 11 Feb 2001 18:22:47 -0500
In-Reply-To: Gregory Leblanc's message of "11 Feb 2001 14:55:59 -0800"
Message-ID: <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 29
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Gregory Leblanc <gleblanc@cu-portland.edu> writes:

> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

Kill it!!! Kill it!!!!

*squawk*
-Jonathan


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Sun Feb 11 18:25:28 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id 2A9B72E22A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:25:28 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14S5s1-0003uI-00; Sun, 11 Feb 2001 17:25:29 -0600
Date: Sun, 11 Feb 2001 17:25:29 -0600
From: Eric Baudais <baudais@okstate.edu>
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, jrb@redhat.com,
	itp@ximian.com, zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
Message-ID: <20010211172529.A15008@bubba>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <200102112257.f1BMvGt26067@mail3.aracnet.com>; from gleblanc@cu-portland.edu on Sun, Feb 11, 2001 at 02:55:59PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 02:55:59PM -0800, Gregory Leblanc wrote:
> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

I think that we still need docs for Freecell for this release of Gnome.  
Whether Freecell will continue with Gnome is still to be determined, but 
that doesn't reduce the need for these docs any less.

Eric Baudais


From chris@wilddev.net  Mon Feb 12 02:53:22 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 630A32C887
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 02:53:21 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id AAA26386
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 00:02:54 -0800
Message-Id: <200102120802.AAA26386@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 11 Feb 2001 23:53:47 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All
I'm going to attempt to update the GUG. I had a quick look at what was
there in CVS and it appeared like theres a lot of work. If anyone has
objects/comments let me know. 
I spoke with Sasha and Telsa about it and got their ideas for it. I
think the approach I will take will be to integrate exisitng docs into
it and create an index from the info that is there. This will update it
without unnecessarily duplicating the work of others.

Chris (Wilddev)



From hobbit@aloss.ukuu.org.uk  Mon Feb 12 04:21:38 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id E27952E4A3
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:21:37 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1C9Mev06046
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 09:22:40 GMT
Date: Mon, 12 Feb 2001 09:22:39 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
Message-ID: <20010212092239.A5996@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <007d01c0946b$7e79d8e0$30299fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 08:26:14PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> Telsa <hobbit@aloss.ukuu.org.uk> wrote
> 
> > Only quibble: fifty-two instead of fifty two (!)
> 
> I believe the latter form to be correct.
> Jihad! Jihad! Jihad! :-)

Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
 
> > Would it also be possible to explain that you can right-click on a
> > card in order to see what it is, if it's obscured by cards on top of
> > it?
> 
> Yes it would, although not very soon unfortunately. 

Fair enough.

> How long do we have before 1.4 is due?

According to 
http://mail.gnome.org/archives/gnome-1.4-list/2001-January/msg00027.html
the final hard freeze including docs and translations is on 18th March.
Freeze for everything except docs and translations is the 8th March.
I'll bet that gets superseded now I have mentioned it for posterity.
(There is also a releng (release engineering) module in CVS which has a
bunch of stuff in it, but it does not have these dates.)

> > I suppose it may be worth noting that you click on cards and then
> > on destinations.
> 
> Actually, I did mention that.  In the usage section between

Ahem. So you did. My apologies :) 

Telsa


From rjp@mail.tele.dk  Mon Feb 12 04:51:48 2001
Return-Path: <rjp@mail.tele.dk>
Delivered-To: gnome-doc-list@gnome.org
Received: from cicero2.cybercity.dk (cicero2.cybercity.dk [212.242.40.53])
	by mail.gnome.org (Postfix) with ESMTP id F179D2DC88
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:51:47 -0500 (EST)
Received: from usr00.cybercity.dk (usr00.cybercity.dk [212.242.40.34])
	by cicero2.cybercity.dk (Postfix) with ESMTP
	id EAC85FFFA6; Mon, 12 Feb 2001 10:51:45 +0100 (CET)
Received: from mail.tele.dk (IDENT:rjp@port21.cvx1-hb.ppp.cybercity.dk [212.242.232.22])
	by usr00.cybercity.dk (8.9.3/8.9.3) with ESMTP id KAA13626;
	Mon, 12 Feb 2001 10:51:42 +0100 (CET)
	(envelope-from rjp@mail.tele.dk)
Message-ID: <3A87C105.C79184CC@mail.tele.dk>
Date: Mon, 12 Feb 2001 11:55:01 +0100
From: "Rebecca J. Walter" <rjp@mail.tele.dk>
X-Mailer: Mozilla 4.75 [en] (X11; U; Linux 2.2.16-22 i586)
X-Accept-Language: en, da
MIME-Version: 1.0
To: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob> <20010212092239.A5996@aloss.ukuu.org.uk>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa Gwynne wrote:
> 
> On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> > Telsa <hobbit@aloss.ukuu.org.uk> wrote
> >
> > > Only quibble: fifty-two instead of fifty two (!)
> >
> > I believe the latter form to be correct.
> > Jihad! Jihad! Jihad! :-)
> 
> Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
> 
telsa is correct.


From jfleck@swcp.com  Mon Feb 12 09:01:58 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 064D92E53D
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 09:01:58 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id HAA02052
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 07:00:34 -0700
Date: Mon, 12 Feb 2001 07:00:34 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: GNOME Users Guide
Message-ID: <20010212070034.B1770@inkstain.net>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <200102120802.AAA26386@hub.wilddev.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102120802.AAA26386@hub.wilddev.net>; from Chris Lyttle on Sun, Feb 11, 2001 at 11:53:47PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Chris -
This is great. Thanks.

I'll be happy to assemble the chapter(s) for you on the packages I'm
dealing with - gnome-utils, ggv, and ghex. Let me know when and where
and in what form you'd like things.

John

On Sun, Feb 11, 2001 at 11:53:47PM -0800, Chris Lyttle wrote:
> Hi All
> I'm going to attempt to update the GUG. I had a quick look at what was
> there in CVS and it appeared like theres a lot of work. If anyone has
> objects/comments let me know. 
> I spoke with Sasha and Telsa about it and got their ideas for it. I
> think the approach I will take will be to integrate exisitng docs into
> it and create an index from the info that is there. This will update it
> without unnecessarily duplicating the work of others.
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From federico@ximian.com  Mon Feb 12 10:26:26 2001
Return-Path: <federico@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from guanabana.helixcode.com (unknown [212.209.126.33])
	by mail.gnome.org (Postfix) with ESMTP id 0434C2CDE5
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 10:26:26 -0500 (EST)
Received: (from federico@localhost)
	by guanabana.helixcode.com (8.9.3/8.9.3) id JAA30011;
	Mon, 12 Feb 2001 09:36:26 -0600
Date: Mon, 12 Feb 2001 09:36:26 -0600
Message-Id: <200102121536.JAA30011@guanabana.helixcode.com>
X-Authentication-Warning: guanabana.helixcode.com: federico set sender to federico@ximian.com using -f
From: Federico Mena Quintero <federico@ximian.com>
X-Homer: You're everywhere.  You're omnivorous.
To: jrb@redhat.com
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, zana@webwynk.net
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com> <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

jrb@redhat.com writes:

> Kill it!!! Kill it!!!!

There is only one solitaire, and Aisleriot is its name.

  Federico


From emese@sunserv.itp.hu  Tue Feb 13 06:25:56 2001
Return-Path: <emese@sunserv.itp.hu>
Delivered-To: gnome-doc-list@gnome.org
Received: from gamax.hu (ns.gamax.hu [195.184.11.170])
	by mail.gnome.org (Postfix) with ESMTP id EA26B2E60E
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 06:25:48 -0500 (EST)
Received: by gateway.gamax.hu id <116161>; Tue, 13 Feb 2001 12:29:54 +0100
From: Emese Kovacs <emese@gnome.hu>
To: gnome-doc-list@gnome.org
Subject: Docs updated for GKB in gnome-applets HEAD
Message-Id: <01Feb13.122954cet.116161@gateway.gamax.hu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.4i
Date: Tue, 13 Feb 2001 12:29:50 +0100
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All,

As GKB has been rewritten, we have updated its manual (described new features, 
taken new screenshots). I would like to have it reviewed for gnome-1.4 
compatibility and spelling + other problems.

GKB can be checked out from the gnome CVS, it is located in 
gnome-applets/gkb-new

Thanks,

Emese Kovacs
<emese@gnome.hu>



From jacob@ximian.com  Tue Feb 13 18:01:33 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (ulysses.ximian.com [63.140.225.198])
	by mail.gnome.org (Postfix) with ESMTP
	id 6F8C32CCF8; Tue, 13 Feb 2001 18:01:32 -0500 (EST)
Received: from ulysses ([127.0.0.1])
	by ulysses with smtp (Exim 3.22 #1 (Debian))
	id 14SoLI-0000Bj-00; Tue, 13 Feb 2001 17:54:40 -0500
To: gnome-1.4-list@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
Subject: GNOME 1.4 Weekly Update
From: jacob berkman <jacob@ximian.com>
Date: 13 Feb 2001 17:54:39 -0500
Message-ID: <87zofq8a8g.fsf@ximian.com>
Lines: 51
User-Agent: Gnus/5.0807 (Gnus v5.8.7) XEmacs/21.1 (GTK)
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello fans of The GNOME Project,

This is the first installment of a weekly update on the progress of
the GNOME 1.4 "not yet named" release.  Work on this release is
progressing rapidly, with the first beta release currently scheduled
for this Saturday (February 17).

For package maintainers:

    Maintainers of packages that will be included in this beta *must*
    provide tarballs by the end of Thursday.  Please mail
    gnome-1.4-release-team@gnome.org with information on where to find
    the tarball.

    Anybody who is packaging GNOME packages with documentation in it
    should install scrollkeeper 0.0.5 or later:
    http://sourceforge.net/project/showfiles.php?group_id=3D11543

    Dan will write up instructions on using ScrollKeeper soon.=A0 Keep
    an eye on the news on the GDP web page for an announcement of
    these instructions: http://developer.gnome.org/projects/gdp/

    GNOME 1.4 will use Nautilus' gnome-db2html2 converter to display
    SGML documents.=A0 Please make sure that the SGML documents are
    being installed in addition to the HTML.=A0 Also make sure that the
    SGML is compliant with the 1.4 guidelines:
    http://developer.gnome.org/projects/gdp/changes/

    Also, don't forget to mail gnome-i18n@gnome.org a couple of days
    (which is right now, actually) before making your final tarball
    for the beta.

For i18n and doc people:

    A list of the branches for the different modules being released is
    available in the releng module of GNOME cvs, or from lxr:
    http://cvs.gnome.org/lxr/source/releng/gnome-1.4-branches

    Don't worry if everything isn't done by the first beta :)

For testers:

    The GNOME 1.4 beta process will include a list of tests for many
    of the applications.  This will be made available later this week,
    and more information about this will be made at that time.

That's all for now; more information about the release will be
available later this week.

Thanks,
The GNOME 1.4 Release Team  <gnome-1.4-release-team@gnome.org>



From alan@devserv.devel.redhat.com  Tue Feb 13 18:15:12 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id C39912CCF8; Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1DNFBx01803;
	Tue, 13 Feb 2001 18:15:11 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
In-Reply-To: <87zofq8a8g.fsf@ximian.com> from "jacob berkman" at Feb 13, 2001 05:54:39 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

>     provide tarballs by the end of Thursday.  Please mail
>     gnome-1.4-release-team@gnome.org with information on where to find
>     the tarball.
> 
>     Anybody who is packaging GNOME packages with documentation in it
>     should install scrollkeeper 0.0.5 or later:
>     http://sourceforge.net/project/showfiles.php?group_id=11543

By thursday ? Given 2 days notice. Umm



From mjs@eazel.com  Tue Feb 13 19:18:43 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 66E262BAB4; Tue, 13 Feb 2001 19:18:41 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id QAA01825;
	Tue, 13 Feb 2001 16:16:57 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 13 Feb 2001 16:16:57 -0800
In-Reply-To: Alan Cox's message of "Tue, 13 Feb 2001 18:15:11 -0500 (EST)"
Message-ID: <lqk86u6ruu.fsf@pythagoras.eazel.com>
Lines: 30
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> >     provide tarballs by the end of Thursday.  Please mail
> >     gnome-1.4-release-team@gnome.org with information on where to find
> >     the tarball.
> > 
> >     Anybody who is packaging GNOME packages with documentation in it
> >     should install scrollkeeper 0.0.5 or later:
> >     http://sourceforge.net/project/showfiles.php?group_id=11543
> 
> By thursday ? Given 2 days notice. Umm
> 

This has got to be about the 10th time over the past N weeks that this
deadline has been posted. The most recent before this was on Sunday
when I sent a reminder to many of these same lists to start getting
packages ready. We have posted the full schedule of all the
planned betas and package deadlines many times.

And we have also been personally emailing maintainers of packages in
the main release and reminding them on IRC.

I hope this deadline comes as less of a surprise to most people than
it apparently did to Alan.

And if you miss it, hey, there's always beta 2.

 - Maciej




From chris@wilddev.net  Wed Feb 14 00:40:20 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 12AE52BC15
	for <gnome-doc-list@gnome.org>; Wed, 14 Feb 2001 00:40:20 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id VAA02001;
	Tue, 13 Feb 2001 21:49:32 -0800
Message-Id: <200102140549.VAA02001@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: ian@eazel.com
Cc: gnome-doc-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 13 Feb 2001 21:40:40 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi
I just chatted to muet about the scripts you are writing to automate
taking UG docs from cvs and merging it into chapters for the UG GOOD
JOB!
I'll be attempting to do some work on putting the other bits of it
together this weekend, please let me know when you will have something
ready to test/break so I can try it out and we can feed to each other
the changes being made to it.

Thx
Chris (Wilddev)



From alan@devserv.devel.redhat.com  Wed Feb 14 07:32:03 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id 9255F2BA99; Wed, 14 Feb 2001 07:32:02 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1ECW2515224;
	Wed, 14 Feb 2001 07:32:02 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Wed, 14 Feb 2001 07:32:01 -0500 (EST)
Cc: alan@redhat.com (Alan Cox), gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
In-Reply-To: <lqk86u6ruu.fsf@pythagoras.eazel.com> from "Maciej Stachowiak" at Feb 13, 2001 04:16:57 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> This has got to be about the 10th time over the past N weeks that this
> deadline has been posted. The most recent before this was on Sunday

Im not objecting to the tarballing deadline its the suprise go and instal
0.0.5 of scrollkeeper bit

Alan



From dan@eazel.com  Wed Feb 14 20:58:23 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 29DEB2D368; Wed, 14 Feb 2001 20:58:22 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F1wJd14908;
	Wed, 14 Feb 2001 17:58:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 17:58:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
In-Reply-To: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Message-ID: <Pine.LNX.4.21.0102141747590.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 14 Feb 2001, Alan Cox wrote:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit

Sorry about this.  I wrote this note quickly, hoping to get the full
instructions on the web before the newsletter went out and replace this
text, but didn't get it done in time.
 
You only need to have scrollkeeper installed if the GDP elves have come
along and put OMF files in your package.  Right now, this means
gnome-core, gnome-utils, and soon gnome-applets, gnome-media, and
gnome-user-docs.  If you aren't packaging these few modules, you don't
need to worry about scrollkeeper.

Dan





From Lorna.Whelan@ireland.sun.com  Thu Feb 15 05:20:28 2001
Return-Path: <Lorna.Whelan@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP
	id 78A3D2BE58; Thu, 15 Feb 2001 05:20:27 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id CAA26927;
	Thu, 15 Feb 2001 02:20:25 -0800 (PST)
Received: from dbl-ray-2 (dbl-ray-2 [129.156.237.101])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with SMTP id KAA01118;
	Thu, 15 Feb 2001 10:20:23 GMT
Message-Id: <200102151020.KAA01118@ireserver.Ireland.Sun.COM>
Date: Thu, 15 Feb 2001 10:20:23 +0000 (GMT)
From: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Reply-To: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Subject: Localisation Style Guides
To: gnome-i18n@gnome.org, gnome-doc-list@gnome.org
Cc: lorna.whelan@ireland.sun.com, Aoife.Dunne@ireland.sun.com,
	michael.twomey@ireland.sun.com
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mdUVyT/+Qy+6Uia13lTD4w==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

The localisation Style Guides for the following languages
are ready:


Language		Formats available
--------		-----------------

English			.ps .pdf .mif and FrameMaker
French			.ps .pdf .mif and FrameMaker
German			.ps .pdf .mif and FrameMaker
Spanish			.ps .pdf .mif and FrameMaker
Italian			.ps .pdf .mif and FrameMaker
Swedish			.ps .pdf .mif and FrameMaker
Japanese		software: .html   doc: .ps .pdf and FrameMaker
Korean			.pdf
Simplified Chinese	.pdf
Traditional Chinese	.pdf


The following still needs to be done with the style guides:

- convert or rewrite them into docbook format
- rewrite them to make them more Gnome-friendly - all
  references to Sun need to be changed


I have created a tarball of all the style guides and the size is roughly
6Mb, however, I need someone to take the files and place them under the
Gnome CVS tree and also on an appropriate place on the Gnome web site.
Could someone volunteer to do this?


Regards,
Lorna




 ____________________________________________________

 Lorna Whelan			Tel.:+353-1-8199-029
 European Localisation Centre   Fax: +353-1-8199-261
 Sun Ireland		        
 ____________________________________________________



From dhelder@umich.edu  Tue Feb 13 14:07:43 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id E4D0C2DC27; Tue, 13 Feb 2001 14:07:42 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id OAA02437;
	Tue, 13 Feb 2001 14:07:36 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Tue, 13 Feb 2001 14:07:36 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102131401410.28452-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net



From dusk@ravendusk.org  Tue Feb 13 16:39:04 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 309B72BB40
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 16:39:04 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-6.pconline.com [207.191.143.38])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id PAA29344
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:38:59 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Sn6g-0006mu-00
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:35:30 -0600
Date: Tue, 13 Feb 2001 15:35:30 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Updating API docs
Message-ID: <20010213153530.D431@ravendusk.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,

I'm trying to figure out the best way to move inline API comments into
the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
tool to do it automatically, but after some rooting around, it appears
to only parse through the header files.  Is this correct, or have I
missed something?

Do we have to cut & paste the comments manually from the *.c files
into the *.sgml files?

Thanks,
John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From mjs@eazel.com  Wed Feb 14 18:23:52 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 5876C2D1C4; Wed, 14 Feb 2001 18:23:50 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id PAA06633;
	Wed, 14 Feb 2001 15:22:01 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 14 Feb 2001 15:22:01 -0800
In-Reply-To: Alan Cox's message of "Wed, 14 Feb 2001 07:32:01 -0500 (EST)"
Message-ID: <lqhf1wonom.fsf@pythagoras.eazel.com>
Lines: 15
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit
> 

OK, I agree the scrollkeeper thing should have been communicated
better. However, if you can't get it for beta 1, beta 2 is coming up,
and beta 1 does not have to be perfect (that's why it is a beta).

 - Maciej



From dan@eazel.com  Thu Feb 15 00:47:41 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id AFA942C8A2
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 00:47:40 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F5l3903604;
	Wed, 14 Feb 2001 21:47:03 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 21:47:03 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Chris Lyttle <chris@wilddev.net>
Cc: ian@eazel.com, gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <200102140549.VAA02001@hub.wilddev.net>
Message-ID: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I thought I'd add a bit more info here, in case people are curious what we
have in mind...

The problem with how we have done the GNOME User Guide in the past was
that we did it all by hand.  This meant that not only was it hard to
create, it was very hard to keep up to date and very hard for each of the
translation teams to reproduce.  It was basically impossible for
translators to keep up, since it was so much work.

The new proposed solution is to create some scripts which grab docs from
CVS and merge them together to produce a product similar to what we had in
the past, but to automate much of the work.  Once it is set up, doing it
for another locale or updating it is as simple as running the script.  It
is more up-front work, but should not be too bad for somebody who is good
at scripting.

Ian is working on the script, so if he doesn't run out of time or run into
too many problems, we should have something to work with in not too
long.  Chris is working on this with Ian.  Thanks to both of you.

Dan


On 13 Feb 2001, Chris Lyttle wrote:

> Hi
> I just chatted to muet about the scripts you are writing to automate
> taking UG docs from cvs and merging it into chapters for the UG GOOD
> JOB!
> I'll be attempting to do some work on putting the other bits of it
> together this weekend, please let me know when you will have something
> ready to test/break so I can try it out and we can feed to each other
> the changes being made to it.
> 
> Thx
> Chris (Wilddev)



From dhelder@umich.edu  Thu Feb 15 09:39:12 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id 4E7B52BA99; Thu, 15 Feb 2001 09:39:12 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id JAA29621;
	Thu, 15 Feb 2001 09:39:07 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Thu, 15 Feb 2001 09:39:07 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102150935430.29454-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Strange, I sent this Tuesday and I haven't seen it yet so I'm resending
it.  Sorry if you get this twice.]

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net




From kirillov@peconic.math.sunysb.edu  Thu Feb 15 17:52:38 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 202F92E0A5
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 17:22:07 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id RAA12452;
	Thu, 15 Feb 2001 17:22:00 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id RAA11551;
	Thu, 15 Feb 2001 17:21:59 -0500
Date: Thu, 15 Feb 2001 17:21:59 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
Message-ID: <20010215172159.A11517@math.sunysb.edu>
References: <200102140549.VAA02001@hub.wilddev.net> <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>; from dan@eazel.com on Wed, Feb 14, 2001 at 09:47:03PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

For now, having scripts putting different manulas together is better
than doing it by hand. So I'd be happy if Ian and Chhris make this
happen. 

In the long run, I am not so sure having users guide which is just the
collection of manuals of different components lumped together is a
good idea. Good UG should be more task oriented ("how do I do this in
GNOME") and may omit details or some options which should go
in on-line help (i.e., manuals as we have them now). There was a talk
of writing such a users guide or rather a book for GNOME 2.0 - I think
after 1.4 is out, we should return to this project. 

Sasha
  



On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> 
> I thought I'd add a bit more info here, in case people are curious what we
> have in mind...
> 
> The problem with how we have done the GNOME User Guide in the past was
> that we did it all by hand.  This meant that not only was it hard to
> create, it was very hard to keep up to date and very hard for each of the
> translation teams to reproduce.  It was basically impossible for
> translators to keep up, since it was so much work.
> 
> The new proposed solution is to create some scripts which grab docs from
> CVS and merge them together to produce a product similar to what we had in
> the past, but to automate much of the work.  Once it is set up, doing it
> for another locale or updating it is as simple as running the script.  It
> is more up-front work, but should not be too bad for somebody who is good
> at scripting.
> 
> Ian is working on the script, so if he doesn't run out of time or run into
> too many problems, we should have something to work with in not too
> long.  Chris is working on this with Ian.  Thanks to both of you.
> 
> Dan


From dan@eazel.com  Fri Feb 16 03:09:32 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id BB4DD2E0E5
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:09:08 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G88H514657;
	Fri, 16 Feb 2001 00:08:17 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:08:17 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <20010215172159.A11517@math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


I agree.  This sort of a UG, created by lumping the online help together,
should be retired and replaced by a more carefully crafted document.  
This probably won't happen until GNOME 2.0 (about 12 months from now or
more), although it is possible that we get it out somewhat earlier.  In
the mean time, this UG will satisfy an important need: We can place it
prominantly on the web page, allowing people to learn a lot about GNOME
without even installing Linux or GNOME. It is a also single document which
people can either browse through to learn more about GNOME in general, or
they can use it as a reference document as they do with the online help.

I know at least one person who has printed out the entire GNOME User Guide
and basically read it cover to cover when they started using GNOME and was
generally very happy with having learned GNOME this way.

So, I think in these ways the UG is actually quite valuable in its current
form, even though we tend to deprecate it.  For GNOME 2.0, we probably
want to tailor multiple documents to replace the UG, as Sasha has already
started doing in gnome-user-docs.

Generally, I think we will want to use this task oriented approach more in
our online documents and in the Users Guide.

Dan


On Thu, 15 Feb 2001, Alexander Kirillov wrote:

> For now, having scripts putting different manulas together is better
> than doing it by hand. So I'd be happy if Ian and Chhris make this
> happen. 
> 
> In the long run, I am not so sure having users guide which is just the
> collection of manuals of different components lumped together is a
> good idea. Good UG should be more task oriented ("how do I do this in
> GNOME") and may omit details or some options which should go
> in on-line help (i.e., manuals as we have them now). There was a talk
> of writing such a users guide or rather a book for GNOME 2.0 - I think
> after 1.4 is out, we should return to this project. 
> 
> Sasha
>   
> 
> 
> 
> On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> > 
> > I thought I'd add a bit more info here, in case people are curious what we
> > have in mind...
> > 
> > The problem with how we have done the GNOME User Guide in the past was
> > that we did it all by hand.  This meant that not only was it hard to
> > create, it was very hard to keep up to date and very hard for each of the
> > translation teams to reproduce.  It was basically impossible for
> > translators to keep up, since it was so much work.
> > 
> > The new proposed solution is to create some scripts which grab docs from
> > CVS and merge them together to produce a product similar to what we had in
> > the past, but to automate much of the work.  Once it is set up, doing it
> > for another locale or updating it is as simple as running the script.  It
> > is more up-front work, but should not be too bad for somebody who is good
> > at scripting.
> > 
> > Ian is working on the script, so if he doesn't run out of time or run into
> > too many problems, we should have something to work with in not too
> > long.  Chris is working on this with Ian.  Thanks to both of you.
> > 
> > Dan
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 



From dan@eazel.com  Fri Feb 16 03:33:05 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3CF0A2BB41
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:33:05 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G8X4j14907
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 00:33:04 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:33:04 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: gnome-user-docs and gnome-devel-docs
Message-ID: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

I had two new GNOME modules created in CVS today: gnome-user-docs and
gnome-devel-docs

They are both empty.  My plans are to create and ship just two GNOME
packages which are strictly documentation.  So, we can slowly move over
any good documentation into these modules from their current locations.

There are some packages which will die in the process:
	gnome-users-guide
	gnome-user-faq
	gdp-handbook

Some examples of what these modules will contain:

gnome-user-docs:
	Glossary
	Introduction to GNOME
	Introduction to Linux
	GNOME Users Guide
	GNOME User FAQ
        GNOME Quick Reference
	Joining the GNOME Project
	...

gnome-devel-docs:
	GNOME Developer FAQ
	GDP Handbook
	GTP Handbook
	(any white papers which are up to date)
	(any tutorials which are up to date)
	(any other developer documents which are good and up to date)
	...

Generally speaking, gnome-user-docs would ship with the main GNOME
release, and gnome-devel-docs would be in the extra apps packages since
most people don't need them.

So, I think we generally want to get someone with CVS root access to move
these pieces into place from their current locations in CVS, approving
this of course with anybody who may have co-authored each text so they
don't think their doc dissappeared. 

This is our chance to start with a fresh module, so lets be careful to
keep things tidy and keep the build system working.  Remember the basic
directory layout:

gnome-xxx-docs/<docname>/<locale>/{stuff}
gnome-xxx-docs/<docname>/<locale>/{stuff}/figures/

Also be sure that anything you put in these modules are up to date,
written in DocBook/SGML, and licensed under the FDL and appropriately
state so in their legalnotice.

Dan





From damon@ximian.com  Fri Feb 16 10:20:37 2001
Return-Path: <damon@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail6.svr.pol.co.uk (mail6.svr.pol.co.uk [195.92.193.212])
	by mail.gnome.org (Postfix) with ESMTP id E9BA62E5BC
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 10:20:36 -0500 (EST)
Received: from modem-204.dragonette.dialup.pol.co.uk ([62.137.2.204] helo=ximian.com)
	by mail6.svr.pol.co.uk with esmtp (Exim 3.13 #0)
	id 14TmgU-0007cQ-00; Fri, 16 Feb 2001 15:20:34 +0000
Message-ID: <3A8C4CED.960B7A36@ximian.com>
Date: Thu, 15 Feb 2001 21:41:01 +0000
From: Damon Chaplin <damon@ximian.com>
X-Mailer: Mozilla 4.72 [en] (X11; U; Linux 2.2.14-5.0 i686)
X-Accept-Language: en
MIME-Version: 1.0
To: "John R. Sheets" <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
References: <20010213153530.D431@ravendusk.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"John R. Sheets" wrote:
> 
> Hi,
> 
> I'm trying to figure out the best way to move inline API comments into
> the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
> tool to do it automatically, but after some rooting around, it appears
> to only parse through the header files.  Is this correct, or have I
> missed something?
> 
> Do we have to cut & paste the comments manually from the *.c files
> into the *.sgml files?

You normally just leave the API comments in the source code.
gtkdoc-mkdb merges it into the final SGML documentation, if you pass
it the --source-dir option.

Damon




From kbreit@mediaone.net  Fri Feb 16 17:15:21 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id BFAE62E743
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:15:20 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA03735;
	Fri, 16 Feb 2001 16:06:09 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Help for 1.4 QA
Date: Fri, 16 Feb 2001 16:05:05 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
Cc: battery841@mediaone.net
MIME-Version: 1.0
Message-Id: <01021616050500.03732@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
  I am curious if anyone here would be interested in finding QA problems in 
1.4 dox with me.  I'm looking for help, so if you're looking for a job, you 
have no excuse now (other than if you hate tedium ;)
Kevin
PS. Make sure I am on cc: as my email is flakey
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 17:37:51 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 666B32E906
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:37:51 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA28799;
	Fri, 16 Feb 2001 16:28:35 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: Dan Mueth <dan@eazel.com>, gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
Date: Fri, 16 Feb 2001 16:27:33 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="US-ASCII"
References: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
In-Reply-To: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Message-Id: <01021616273300.28362@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> I had two new GNOME modules created in CVS today: gnome-user-docs and
> gnome-devel-docs
>
> They are both empty.  My plans are to create and ship just two GNOME
> packages which are strictly documentation.  So, we can slowly move over
> any good documentation into these modules from their current locations.
Where should I drop the QA gnumeric spreadsheet for now?
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 19:02:13 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 87FC22D4BB
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 19:02:12 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id RAA01258
	for gnome-doc-list@gnome.org; Fri, 16 Feb 2001 17:53:01 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Dia dox ready to go?
Date: Fri, 16 Feb 2001 17:51:56 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
MIME-Version: 1.0
Message-Id: <01021617515701.21176@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
   Wow, I'm active on this list today!  I would like someone to go read my 
documentation for Dia and let me know if it's ready for prime time.  I'm not 
saying it's DONE, but is it something we feel safe releasing in 1.4 in its 
current state.  This would be _greatly_ appreciated.
Thanks
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From dusk@ravendusk.org  Sat Feb 17 12:13:47 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id C474F2D713
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 12:13:46 -0500 (EST)
Received: from exodus.ravendusk.org (m18-4-2.pconline.com [207.191.143.50])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id LAA06230
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:13:43 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UAwH-000066-00
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:14:29 -0600
Date: Sat, 17 Feb 2001 11:14:29 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010217111429.B355@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <3A8C4CED.960B7A36@ximian.com>; from damon@ximian.com on Thu, Feb 15, 2001 at 09:41:01PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 15, 2001, Damon Chaplin <damon@ximian.com> wrote:
> 
> "John R. Sheets" wrote:
> > 
> > Do we have to cut & paste the comments manually from the *.c files
> > into the *.sgml files?
> 
> You normally just leave the API comments in the source code.
> gtkdoc-mkdb merges it into the final SGML documentation, if you pass
> it the --source-dir option.

Yep, that was exactly the problem with the Bonobo API docs: the
--source-dir parameter was set incorrectly.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From jrb@redhat.com  Sat Feb 17 21:44:02 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id BBE472BD79
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 21:44:02 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1I2jOq10285;
	Sat, 17 Feb 2001 21:45:24 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: gnome-doc-list@gnome.org
Subject: Keyword to bugzilla
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 17 Feb 2001 21:45:24 -0500
Message-ID: <ybm8zn4675n.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 8
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I added a new DOCS_NEEDED keyword to bugzilla today.  The idea behind
it, is that if a bug requires a change in documentation when fixed, or
the bug involves the documentation somehow, you can put the keyword in
to indicate that docs need to be written.  I don't know how useful this
will be, but it's worth a shot.

Thanks,
-Jonathan 


From zfrey@bright.net  Sat Feb 17 22:21:20 2001
Return-Path: <zfrey@bright.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from invictus.bright.net (invictus.bright.net [205.212.123.12])
	by mail.gnome.org (Postfix) with ESMTP id 6F31E2BB7B
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 22:21:20 -0500 (EST)
Received: from arch-cas3-cs-35.dial.bright.net ([216.201.22.139])
          by invictus.bright.net with ESMTP
          id <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>;
          Sat, 17 Feb 2001 22:21:19 -0500
Subject: Re: Updating API docs
From: Zach Frey <zfrey@bright.net>
To: John "R." Sheets <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
In-Reply-To: <20010217111429.B355@ravendusk.org>
References: <20010213153530.D431@ravendusk.org>
	<3A8C4CED.960B7A36@ximian.com>  <20010217111429.B355@ravendusk.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.17.08.59 - Preview Release)
Date: 17 Feb 2001 22:25:47 +0000
Mime-Version: 1.0
Message-Id: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:

> Yep, that was exactly the problem with the Bonobo API docs: the
> --source-dir parameter was set incorrectly.


Er, oops, that sounds like my mistake.  Sorry about that.

Now that I see what you did, was the problem that it was broken for
srcdir != builddir?  


Thanks,

Zach





From barreiro@arrakis.es  Sun Feb 18 04:45:15 2001
Return-Path: <barreiro@arrakis.es>
Delivered-To: gnome-doc-list@gnome.org
Received: from correo.madritel.es (unknown [213.37.2.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 0B2F52BD32; Sun, 18 Feb 2001 04:45:15 -0500 (EST)
Received: from pc-int-2.arrakis.es ([213.37.13.136]) by correo.madritel.es
          (Netscape Messaging Server 3.5)  with ESMTP id AAA3F81;
          Sun, 18 Feb 2001 10:42:58 +0100
Content-Length: 691
Message-ID: <XFMail.20010218115129.barreiro@arrakis.es>
X-Mailer: XFMail 1.4.4 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <3A2FA437.E663AF05@ireland.sun.com>
Date: Sun, 18 Feb 2001 11:51:29 +0100 (MET)
Reply-To: barreiro@arrakis.es
Organization: linux landia
From: barreiro@arrakis.es
To: Michael Twomey <michael.twomey@ireland.sun.com>
Subject: Re: Update on Localisation Style Guides and Glossaries
Cc: Gnome Doc List <gnome-doc-list@gnome.org>, ,
	Gnome Doc List <gnome-doc-list@gnome.org>,
	"gnome-i18n@gnome.org" <gnome-i18n@gnome.org>,
	Gregory Leblanc <gleblanc@cu-portland.edu>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 07-Dec-2000 Michael Twomey wrote:
> Gregory Leblanc wrote:
>> 
> 
> Hi,
>       I've sent the glossary to Greg so he should have it up in somewhere
> like gnome-i18n/glossary soon.
> 
> Greg, can I mail you the style guides as well? They are a hefty 4MB
> tarball. Or does someone else want to take them?
> 
> thanks Greg,
>       Michael
>
Hi,

I looked for style guides at Gnome-i18n and gnome-docu but not found it.

Could you tell me where get the Spanish copy?

Regards.


Manuel de Vega Barreiro. barreiro@arrakis.es   En un lugar de la red
Madrid. Espaņa. usuario: 62.146                de cuyo nombre no quiero
http://www.croftj.net/~barreiro Linux Landia   acordarme..........



From dan@eazel.com  Sun Feb 18 04:50:22 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id D0AAD2DD1E
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 04:50:21 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1I9oJ731916;
	Sun, 18 Feb 2001 01:50:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Sun, 18 Feb 2001 01:50:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Kevin Breit <battery841@mediaone.net>
Cc: gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
In-Reply-To: <01021616273300.28362@7of9>
Message-ID: <Pine.LNX.4.21.0102180148100.31875-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Fri, 16 Feb 2001, Kevin Breit wrote:

> On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> > I had two new GNOME modules created in CVS today: gnome-user-docs and
> > gnome-devel-docs
> >
> > They are both empty.  My plans are to create and ship just two GNOME
> > packages which are strictly documentation.  So, we can slowly move over
> > any good documentation into these modules from their current locations.
> Where should I drop the QA gnumeric spreadsheet for now?
> Kevin
> 

These are GDP-related documents which we do not plan to ship, so I would
put them in a new directory at: gnome-docu/gdp/qa/

Things in gnome-user-docs and gnome-devel-docs will only be up-to-date
documents which we plan on shipping in these packages.

Dan



From dusk@ravendusk.org  Sun Feb 18 11:18:32 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 39DFF2BD2D
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 11:18:32 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-11.pconline.com [207.191.143.43])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id KAA13568
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:17 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UWY0-0000Cj-00
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:52 -0600
Date: Sun, 18 Feb 2001 10:18:52 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010218101852.B434@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com> <20010217111429.B355@ravendusk.org> <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>; from zfrey@bright.net on Sat, Feb 17, 2001 at 10:25:47PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 17, 2001, Zach Frey <zfrey@bright.net> wrote:
> 
> On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:
> 
> > Yep, that was exactly the problem with the Bonobo API docs: the
> > --source-dir parameter was set incorrectly.
> 
> Er, oops, that sounds like my mistake.  Sorry about that.

Actually, I think it was Michael Meeks, in revision 1.3 of
Makefile.am, amid a flurry of other changes.  (c;

> Now that I see what you did, was the problem that it was broken for
> srcdir != builddir?  

No, it didn't find the source files at all, even with srcdir ==
builddir.  Didn't go far enough towards the root dir.  Should have
been '../..' rather than '..'.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From erik@core.com  Sun Feb 18 15:20:13 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id D27C92BAAF
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 15:19:37 -0500 (EST)
Received: from core.com (tnt17a-242.focal-chi.corecomm.net [208.40.16.242])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1IKLI545961;
	Sun, 18 Feb 2001 20:21:38 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1IKR2708990;
	Sun, 18 Feb 2001 14:27:02 -0600
Date: Sun, 18 Feb 2001 14:27:02 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: Dan Mueth <dan@eazel.com>
Cc: gnome-doc-list@gnome.org
Subject: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010218142702.L12018@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>; from "dan@eazel.com on Fri, Feb 16, 2001 at 12:08:17AM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Is there any interest in having any of the user or developer docs
recorded? I'm thinking audio books, or even inserting <audioobject> and
<audiodata> tags into the docs themselves. 

All I will need is someone with a good voice to volunteer. (I have a small
studio setup near Chicago.)  

Erik
-- 
All music aspires to the condition of muzak.


From kbreit@mediaone.net  Sun Feb 18 17:14:59 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 4A4CC2CE26
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 17:14:58 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA32529
	for gnome-doc-list@gnome.org; Sun, 18 Feb 2001 16:05:48 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Date: Sun, 18 Feb 2001 15:16:58 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="us-ascii"
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net>
In-Reply-To: <20010218142702.L12018@megsinet.net>
MIME-Version: 1.0
Message-Id: <01021815165800.10931@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> Is there any interest in having any of the user or developer docs
> recorded? I'm thinking audio books, or even inserting <audioobject> and
> <audiodata> tags into the docs themselves.
>
> All I will need is someone with a good voice to volunteer. (I have a small
> studio setup near Chicago.)
That'd be interesting.  It would be best to have it in mp3 format.  If you 
wanted, and we got this rolling soon enough, I could do some voice stuff 
since I live in the Chicago burbs.
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From hobbit@aloss.ukuu.org.uk  Mon Feb 19 17:51:32 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 1959C2BE06
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 17:51:30 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1JMqGW32596
	for gnome-doc-list@gnome.org; Mon, 19 Feb 2001 22:52:16 GMT
Date: Mon, 19 Feb 2001 22:52:16 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010219225216.B32130@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Various people on this list at times have expressed interest in gtkdoc.
I have been trying to find info on it. I can't find much. What I have
is here, because I keep missing people on IRC. And it gets into the
archives here. And I don't know any more than this, so please don't
email me Hard Questions!

Apparently the major problem is that it's a complete sod to install.
If you can't find a nice rpm/deb of it, you're in for pain. Gnome
apparently has its own little something-doc which is a script by
Michael Zucchi and is in CVS. That is what the kernel folks used
as a basis for 'kernel-doc', which is just a script in perl. The
only feature that it is missing which gtkdoc has is something to 
do with classes.

kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
in /linux/scripts. 

On the matter of "how to use the thing once it's installed", it's
the same for kernel-doc and gtk-doc, and so here are the instructions
for kernel-doc on the basis that it might be a quick-start for
gtk-doc: 

----- Forwarded message from Alan Cox <alan@lxorguk.ukuu.org.uk> -----

To: hobbit@aloss.ukuu.org.uk
Subject: Kernel-doc^2
From: Alan Cox <alan@lxorguk.ukuu.org.uk>
Date: Mon, 19 Feb 2001 18:03:42 +0000

Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
so the section on that is relevant and included..


How to add extractable documentation to your source files
---------------------------------------------------------

The format of the block comment is like this:

/**
 * function_name(:)? (- short description)?
(* @parameterx: (description of parameter x)?)*
(* a blank line)?
 * (Description:)? (Description of function)?
 * (section header: (section description)? )*
(*)?*/

The short function description cannot be multiline, but the other
descriptions can be.

All descriptive text is further processed, scanning for the following special
patterns, which are highlighted appropriately.

'funcname()' - function
'$ENVVAR' - environment variable
'&struct_name' - name of a structure (up to two words including 'struct')
'@parameter' - name of a parameter
'%CONST' - name of a constant.

Take a look around the source tree for examples.


Tim.
*/ <twaugh@redhat.com>

----- End forwarded message -----


From otaylor@redhat.com  Mon Feb 19 22:33:06 2001
Return-Path: <otaylor@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from fresnel.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 73CD42CC78
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 22:33:06 -0500 (EST)
Received: by fresnel.labs.redhat.com (Postfix, from userid 2181)
	id CDFB8241BC6; Mon, 19 Feb 2001 22:33:05 -0500 (EST)
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
References: <20010219225216.B32130@aloss.ukuu.org.uk>
From: Owen Taylor <otaylor@redhat.com>
Date: 19 Feb 2001 22:33:05 -0500
In-Reply-To: Telsa Gwynne's message of "Mon, 19 Feb 2001 22:52:16 +0000"
Message-ID: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Lines: 129
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Actually, gtk-doc goes a lot beyond simply parsing the 
function doc comments. (And in fact, it didn't originally
do that at all!)

Among other things, it:

 - Knows about the GTK+ object system - object heirarchies,
   signals, properties, etc.

 - Parses header files to find out about typedefs,
   
 - Integrates documentation from template files with
   the parsed header files.

   (This one of the distinguishing characteristics of gtk-doc - 
   it doesn't try to put all documentation inline - just
   the parts that make sense.)

There is a fair bit of information the doc/ directory
of gtk-doc/. Trevor Curtis is apparently also doing some
work on doing GDP-style documentation, though I don't
know how far he's gotten with that.


As far as installation, gtk-doc is wonderously easy to install.  There
is a RPM of it in the RH rawhide tree, though it's a bit out of date,
but it's also just a simple:

 ./configure ; make install

out of CVS. The thing about gtk-doc is:

 - It's a tool for GTK+/GNOME programmers to do docs for other
   programmers, so the docs for gtk-doc assume a lot of 
   knowledge about programming.

 - It's a real pain to set it up to document a library. I mean, a
   major pain.  Hard. Involves creating a number of files with magic
   contents, and then knowing more about make than you ever wanted to
   know.

   I've gone out on a limb and made the statement that the reference
   doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
   are just about perfect. They are also meant to be easy to modify
   without having to change the scary parts.  So, they may be worth
   copying.

   But I wish I knew how we could make it easier to set up.

   More documentation helps, but it there are just too many files to
   juggle, and it shouldn't take 200 lines of Makefile boilerplate.

Once it's been set up. It's not bad to use - you just
either edit the pseudo-sgml files in the tmpl/ directory or
you edit the inline function headers. But the set up is
the killer.

(Perhaps we need to create a gtkdocize script, like libtoolize
and gettextize.)

Regards,
                                        Owen


Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:

> Various people on this list at times have expressed interest in gtkdoc.
> I have been trying to find info on it. I can't find much. What I have
> is here, because I keep missing people on IRC. And it gets into the
> archives here. And I don't know any more than this, so please don't
> email me Hard Questions!
 
> Apparently the major problem is that it's a complete sod to install.
> If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> apparently has its own little something-doc which is a script by
> Michael Zucchi and is in CVS. That is what the kernel folks used
> as a basis for 'kernel-doc', which is just a script in perl. The
> only feature that it is missing which gtkdoc has is something to 
> do with classes.
> 
> kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> in /linux/scripts. 
> 
> On the matter of "how to use the thing once it's installed", it's
> the same for kernel-doc and gtk-doc, and so here are the instructions
> for kernel-doc on the basis that it might be a quick-start for
> gtk-doc: 
> 
> From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> Subject: Kernel-doc^2
> To: hobbit@aloss.ukuu.org.uk
> Date: Mon, 19 Feb 2001 18:03:42 +0000
> 
> 
> Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
> so the section on that is relevant and included..
> 
> 
> How to add extractable documentation to your source files
> ---------------------------------------------------------
> 
> The format of the block comment is like this:
> 
> /**
>  * function_name(:)? (- short description)?
> (* @parameterx: (description of parameter x)?)*
> (* a blank line)?
>  * (Description:)? (Description of function)?
>  * (section header: (section description)? )*
> (*)?*/
> 
> The short function description cannot be multiline, but the other
> descriptions can be.
> 
> All descriptive text is further processed, scanning for the following special
> patterns, which are highlighted appropriately.
> 
> 'funcname()' - function
> '$ENVVAR' - environment variable
> '&struct_name' - name of a structure (up to two words including 'struct')
> '@parameter' - name of a parameter
> '%CONST' - name of a constant.
> 
> Take a look around the source tree for examples.
> 
> 
> Tim.
> */ <twaugh@redhat.com>


From rob@funky-penguin.co.uk  Tue Feb 20 06:57:39 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id E5EB72BA99
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 06:57:38 -0500 (EST)
Received: from [213.123.15.171] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14VBQH-00050M-00
	for gnome-doc-list@gnome.org; Tue, 20 Feb 2001 11:57:37 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14VBTG-0001Uu-00
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 12:00:42 +0000
Date: Tue, 20 Feb 2001 12:00:41 +0000
To: gnome-doc-list@gnome.org
Subject: Intent to package Gnotravex, Gnometris, gnobotsII
Message-ID: <20010220120041.A5755@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I regularly play these three so will volunteer to do them. And i'll get an
initial draft of one of these up by this evening.

I'll modify the doctable as soon as soon as i find out my username and
password.

rob
-- 
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet


From trevor.curtis@home.com  Tue Feb 20 13:08:11 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id D10E92BA85
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 13:08:10 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010220180742.EWJZ12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 10:07:42 -0800
Date: Tue, 20 Feb 2001 13:09:35 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010220130935.A1152@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
X-Operating-System: Linux frink.thesimpsons.ca 2.4.1
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hey all,

I joined the gdp a few weeks ago.  When Dan Mueth and I originally
spoke, we had agreed that I was to continue the gtk-doc
manual.  The problem however, was that I had little experience with
things such as cvs, autoconf, automake, and the like.  So I've
temporarily put the gtk-doc manual on hold, whilst I learn the above
by doing other smaller projects.

All this to say that this lack of documentation for gtk-doc is an
issue that is trying to be addressed.  Unfortunately, until I learn
more about the subject, and the other bits of knowledge that I must
aquire to complete this job, it may be some time before I'm able to
complete the manual.

If anyone has ideas or just wants to look at was is already there, it
is available in cvs.  

regards,

On Mon, Feb 19, 2001 at 10:33:05PM -0500, Owen Taylor wrote:
> To: gnome-doc-list@gnome.org
> Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
> From: Owen Taylor <otaylor@redhat.com>
> Date: 19 Feb 2001 22:33:05 -0500
> 
> 
> Actually, gtk-doc goes a lot beyond simply parsing the 
> function doc comments. (And in fact, it didn't originally
> do that at all!)
> 
> Among other things, it:
> 
>  - Knows about the GTK+ object system - object heirarchies,
>    signals, properties, etc.
> 
>  - Parses header files to find out about typedefs,
>    
>  - Integrates documentation from template files with
>    the parsed header files.
> 
>    (This one of the distinguishing characteristics of gtk-doc - 
>    it doesn't try to put all documentation inline - just
>    the parts that make sense.)
> 
> There is a fair bit of information the doc/ directory
> of gtk-doc/. Trevor Curtis is apparently also doing some
> work on doing GDP-style documentation, though I don't
> know how far he's gotten with that.
> 
> 
> As far as installation, gtk-doc is wonderously easy to install.  There
> is a RPM of it in the RH rawhide tree, though it's a bit out of date,
> but it's also just a simple:
> 
>  ./configure ; make install
> 
> out of CVS. The thing about gtk-doc is:
> 
>  - It's a tool for GTK+/GNOME programmers to do docs for other
>    programmers, so the docs for gtk-doc assume a lot of 
>    knowledge about programming.
> 
>  - It's a real pain to set it up to document a library. I mean, a
>    major pain.  Hard. Involves creating a number of files with magic
>    contents, and then knowing more about make than you ever wanted to
>    know.
> 
>    I've gone out on a limb and made the statement that the reference
>    doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
>    are just about perfect. They are also meant to be easy to modify
>    without having to change the scary parts.  So, they may be worth
>    copying.
> 
>    But I wish I knew how we could make it easier to set up.
> 
>    More documentation helps, but it there are just too many files to
>    juggle, and it shouldn't take 200 lines of Makefile boilerplate.
> 
> Once it's been set up. It's not bad to use - you just
> either edit the pseudo-sgml files in the tmpl/ directory or
> you edit the inline function headers. But the set up is
> the killer.
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)
> 
> Regards,
>                                         Owen
> 
> 
> Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:
> 
> > Various people on this list at times have expressed interest in gtkdoc.
> > I have been trying to find info on it. I can't find much. What I have
> > is here, because I keep missing people on IRC. And it gets into the
> > archives here. And I don't know any more than this, so please don't
> > email me Hard Questions!
>  
> > Apparently the major problem is that it's a complete sod to install.
> > If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> > apparently has its own little something-doc which is a script by
> > Michael Zucchi and is in CVS. That is what the kernel folks used
> > as a basis for 'kernel-doc', which is just a script in perl. The
> > only feature that it is missing which gtkdoc has is something to 
> > do with classes.
> > 
> > kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> > in /linux/scripts. 
> > 
> > On the matter of "how to use the thing once it's installed", it's
> > the same for kernel-doc and gtk-doc, and so here are the instructions
> > for kernel-doc on the basis that it might be a quick-start for
> > gtk-doc: 
> > 
> > From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> > Subject: Kernel-do


From glynn.foster@Sun.COM  Wed Feb 21 11:58:29 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id D02252E0B0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 11:58:28 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id IAA11518
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 08:58:27 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id QAA09744
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 16:58:23 GMT
Message-ID: <3A93F3E0.C56F6F45@Sun.COM>
Date: Wed, 21 Feb 2001 16:59:12 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Session capplet documentation
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Heya,
Just recently I was working on a multisession hack for gnome-session
which is pretty much finished and in for the GNOME1.4 release. The 
hack involved changing the capplet code and, as a result, the structure 
of the 'Startup Programs' gui.
I was checking through the documentation for the control-center and 
realised that some of it needs to be rewritten for 1.4 [different 
screenshots, added functionality]
I think I identified it to the following cvs module -

		desktop-docs/gnomecc.sgml

I would be quite happy to document some of the changes but being a 
mere insignificant software developer I thought I'd ask first and
find out the proccess for this.

			Thanks,
				Glynn ;)


-- 
Glynn Foster				Email: glynn.foster@ireland.sun.com
Desktop Apps & MiddleWare		Tel:   +353 - 1 - 8199782
Sun Microsystems Ireland Ltd.           Generation dot-COM        i||c Gman


From dusk@ravendusk.org  Wed Feb 21 13:29:00 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id B14222E211
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 13:28:59 -0500 (EST)
Received: from exodus.ravendusk.org (m18-6-16.pconline.com [207.191.143.96])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id MAA25803
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:28:56 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Ve1A-0000Mo-00
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:29:36 -0600
Date: Wed, 21 Feb 2001 12:29:36 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010221122936.D475@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 19, 2001, Owen Taylor <otaylor@redhat.com> wrote:
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)

Oooh, I like the sound of that.  Wonder how much of the setup is
automatable...?

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From kirillov@math.sunysb.edu  Wed Feb 21 14:11:08 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 812AD2E0F0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:08 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id OAA01184
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:07 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id OAA05760;
	Wed, 21 Feb 2001 14:11:07 -0500
Date: Wed, 21 Feb 2001 14:11:07 -0500
Message-Id: <200102211911.OAA05760@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,
I am currently maintaining the documentation for control-center
(btw, it is located at
control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Probably the easiest way would be if you just send me the patch to the
existing file, and I'll check it into CVS. Or you can send me the list
of changes and I'll modify the doc myself - whatever you prefer.

Is this new functionality in gnome-14.beta1? If so, I can take the
screenshots myself (I plan to install beta1 later today).

Best,
Sasha

On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> Heya,
> Just recently I was working on a multisession hack for gnome-session
> which is pretty much finished and in for the GNOME1.4 release. The 
> hack involved changing the capplet code and, as a result, the structure 
> of the 'Startup Programs' gui.
> I was checking through the documentation for the control-center and 
> realised that some of it needs to be rewritten for 1.4 [different 
> screenshots, added functionality]
> I think I identified it to the following cvs module -
> 
>               desktop-docs/gnomecc.sgml
> 
> I would be quite happy to document some of the changes but being a 
> mere insignificant software developer I thought I'd ask first and
> find out the proccess for this.
> 
>                       Thanks,
>                               Glynn ;)
> 


From glynn.foster@Sun.COM  Wed Feb 21 14:29:42 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id D693F2BB47
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:29:41 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id LAA02853;
	Wed, 21 Feb 2001 11:29:39 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id TAA01032;
	Wed, 21 Feb 2001 19:29:27 GMT
Message-ID: <3A941749.21CC4F81@Sun.COM>
Date: Wed, 21 Feb 2001 19:30:17 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
References: <200102211911.OAA05760@copiague.math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Apologies if you are receiving this more than once...must have 
screwed up sending it the first time :/ ]


Heya Sasha,

> Hi,
> I am currently maintaining the documentation for control-center
> (btw, it is located at
> control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Yeah, that was pointed out to me this afternoon...for some reason
the documentation hasn't been transferred over to HEAD yet.

> Probably the easiest way would be if you just send me the patch to the
> existing file, and I'll check it into CVS. Or you can send me the list
> of changes and I'll modify the doc myself - whatever you prefer.

I'm easy about this...What might be the best solution, is for me to send
over a patch to the existing file and you can edit it as you see fit.
I'm no documentation wizard ;)

> Is this new functionality in gnome-14.beta1? If so, I can take the
> screenshots myself (I plan to install beta1 later today).

Yes this is new functionality in beta1.
I've taken screenshots already :) but you can take your own if you wish...
The ones I've taken are at
http://www.geocities.com/gmansundude/gccsessopt.png
http://www.geocities.com/gmansundude/gccstartup.png

[but I'm actually not sure of the quality - just looking at them a minute
ago].

I'll get the patches done pretty soon.
                
                Many thanks,
                        Glynn ;)

> 
> Best,
> Sasha
> 
> On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> > Heya,
> > Just recently I was working on a multisession hack for gnome-session
> > which is pretty much finished and in for the GNOME1.4 release. The
> > hack involved changing the capplet code and, as a result, the structure
> > of the 'Startup Programs' gui.
> > I was checking through the documentation for the control-center and
> > realised that some of it needs to be rewritten for 1.4 [different
> > screenshots, added functionality]
> > I think I identified it to the following cvs module -
> >
> >               desktop-docs/gnomecc.sgml
> >
> > I would be quite happy to document some of the changes but being a
> > mere insignificant software developer I thought I'd ask first and
> > find out the proccess for this.
> >
> >                       Thanks,
> >                               Glynn ;)
> >


From kirillov@math.sunysb.edu  Wed Feb 21 15:57:20 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id E5F202BB41
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:19 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id PAA02713
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:18 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id PAA13250;
	Wed, 21 Feb 2001 15:57:18 -0500
Date: Wed, 21 Feb 2001 15:57:18 -0500
Message-Id: <200102212057.PAA13250@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: scrollkeeper and gnome 1.4
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi guys:

I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
surprise, no OMF files were installed at all: /usr/share/omf contains
scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
wrong with the packages - could you (or someone else) look into this? 

Sasha


From dan@eazel.com  Thu Feb 22 06:34:00 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id EDD532BA83
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:33:59 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBXJ822189;
	Thu, 22 Feb 2001 03:33:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:33:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
Subject: Re: scrollkeeper and gnome 1.4
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 21 Feb 2001, Alexander Kirillov wrote:

> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 

This doesn't entirely surprise me.  We were working on getting this done
right around the package deadline for GNOME 1.4 beta1, so I suspect the
packages were submitted before we added the OMF metadata.  I have spoken
with Jacob, who does a lot of the packaging work at Ximian, about how the
OMF and ScrollKeeper integration works, so he knows how to make things
work.  I even gave him my spec file for gnome-core (which I originally
took from him and then modified).  So, my guess is we just missed the
deadline for when they took their beta1 snapshot.  I expect things to work
for beta2, although it is a good idea to double-check this.

Jacob - could you comment?

Dan



From dan@eazel.com  Thu Feb 22 06:49:01 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 32B6D2E032
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:49:00 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBmxQ22325
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 03:48:59 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:48:59 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: Finished docs
Message-ID: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everybody,

Since we are approaching the GNOME 1.4 release, I have decided to start
producing a weekly list of documents which are completely Done(TM) to send
to the translators for translation.  

By Done, I mean:

0) It is decent. ie. It is worth translating.  Basically this means it is
not obsolete or mostly filled with FIXME's.

1) It is finished, as far as GNOME 1.4 is concerned.  ie. It may not be
perfect or even complete, but it will not experience any more changes
before GNOME 1.4 except for major bug fixes. (eg. it states something
which is false or doesn't render properly in Nautilus)

2) It follows the 1.4 doc
guidelines: http://developer.gnome.org/projects/gdp/changes/

3) It has gone through a simple test in Nautilus to make sure each page
renders properly.

4) The screenshots are finished, or at least won't change much

5) Hopefully it actually builds and installs fine with the package it
belongs too.

#0 through #2 are crucial.  If possible, satisfy #3 through #5 too.  If
you need help testing it in Nautilus, email this list or ask around on
#docs to find somebody with a working Nautilus.

Please email me with a list of documents which you feel are Done(TM) each
Thursday, and I'll compile the list and send it to gnome-i18n-list each
Friday so that the translators can have a fun-filled weekend of
translations each week :)

Dan



From glynn.foster@Sun.COM  Thu Feb 22 08:44:34 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 2B13E2CC04
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:44:34 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id FAA00862;
	Thu, 22 Feb 2001 05:44:29 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id NAA12515;
	Thu, 22 Feb 2001 13:44:24 GMT
Message-ID: <3A9517EB.FB6CCA0A@Sun.COM>
Date: Thu, 22 Feb 2001 13:45:15 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: kirillov@math.sunysb.edu, gnome-doc-list@gnome.org
Subject: Session capplet doc diff
Content-Type: multipart/mixed;
 boundary="------------1CCC036EA35DA3B43F0F89A4"
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Hi Sasha,
Here is the diff for control-center/docs/C/gnomecc.sgml Hope this is okay..
I'm cc'ing gnome-doc-list in case anyone has any feedback...
I've included the extra figures [from the links on my previous email] but
if you want to take better screenshots, feel free.

			Glynn :)
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii;
 name="sessiondoc.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="sessiondoc.diff"

Index: gnomecc.sgml
===================================================================
RCS file: /cvs/gnome/control-center/doc/C/Attic/gnomecc.sgml,v
retrieving revision 1.1.2.5
diff -u -r1.1.2.5 gnomecc.sgml
--- gnomecc.sgml	2001/02/12 17:00:25	1.1.2.5
+++ gnomecc.sgml	2001/02/22 13:39:38
@@ -884,8 +884,8 @@
       <title>Session</title>
     <para>
       The Session Group provides you methods of controlling various items that
-      occur with the startup of your GNOME Session. These include startup
-      programs and startup hints.
+      occur with the startup of your GNOME Session. These include session options,
+      startup programs and startup hints.
     </para>
     <sect2 id="startup-hints">
       <title>Startup Hints</title>
@@ -927,40 +927,36 @@
       </figure>
     </sect2>
     <sect2 id="startup-progs">
-      <title>Startup Programs</title>
+      <title>Session Options & Startup Programs</title>
       <para>
-	Startup Programs capplet allows you control what applications
-	are started at login. By default, GNOME
-	starts some default programs, such as File Manager (necessary
-	for functioning of the desktop), Panel and all applets in it,
-	and some other supporting programs. But it can do more than
-	that. 
+        The Session Options & Startup Programs capplet allows you to
+        control your session. GNOME has the concept of session 
+        management. In simple terms, it means that you can save your
+        <quote>session</quote> (that is, information about currently
+        working applications, their status and position on the screen)
+        at any stage, and at your next login the same applications will
+        reappear on your screen in the same positions, allowing you to 
+        continue your work. Note, however, this only works for GNOME 
+        compliant applications. By default, GNOME starts some default
+        programs, such as File Manager (necessary for functioning of
+        the desktop), Panel and all applets in it, and some other 
+        supporting programs. But it can do much more than that.
       </para>
       <para> 
-	First, GNOME has the concept of session management. In simple
-	terms, it means that you can save your <quote>session</quote>
-	(that is, information about currently working applications,
-	their status and position on screen) at logout and at your next
-	login the same applications will reappear on your screen in
-	the same positions, allowing you to continue your
-	work. Note, however, that this  only works for GNOME
-	applications. 
-      </para>
-      <para> 
 	GNOME also provides another way of starting applications at
-	login. You can explicitly specify one or more  commands to
+	login. You can explicitly specify one or more commands to
 	run, and GNOME will execute them at login. This works for all
-	kinds of applications, whether GNOME compatible or not.  
+	kinds of applications, whether GNOME compliant or not.  
       </para>
       <para> 
-	Startup Programs capplet allows you to configure all of these
-	options, as described below. 
+	Session Options & Startup Programs capplet allows you to configure 
+	all of these options, as described below. 
       </para>
       <figure>
-	<title>Startup Programs Capplet</title>
+	<title>Session Options Capplet</title>
 	<screenshot>
-	  <screeninfo>Startup Programs Capplet</screeninfo>
-	  <graphic format="png" fileref="./figs/gccstartup" srccredit="dcm">
+	  <screeninfo>Session Options Capplet</screeninfo>
+	  <graphic format="png" fileref="./figs/gccsessopt" srccredit="gman">
 	  </graphic>
 	</screenshot>
       </figure>
@@ -979,13 +975,13 @@
 	    <guilabel>Prompt on logout</guilabel> &mdash; If this
 	    option is enabled, a confirmation dialog will appear at
 	    logout. Among other things, this dialog asks you if you
-	    want to save the current session. If you answer
-	    <guilabel>Yes</guilabel>, the current session will be
-	    saved and will be restored at your next login. If you
+	    want to save the current session if you have set the 
+            checkbox for <guilabel> Automatically save session</guilabel>.
+            If you answer <guilabel>Yes</guilabel>, the current session 
+	    will be saved and will be restored at your next login. If you
 	    answer <guilabel>No</guilabel>, the previous saved session
 	    will be used.  
 	  </para> 
-
 	</listitem>
 
 	<listitem>
@@ -1003,6 +999,42 @@
 	    </menuchoice> from the <guimenu>Main Menu</guimenu>. 
 	  </para>
 	</listitem>
+        
+        <listitem>
+          <para>
+            <guilabel>Choose Current Session</guilabel> &mdash;
+             In this section, you can explicitly specify which session
+             to save to, but a save won't occur until you specifically
+             do so. Here, you can also create new sessions, edit and 
+             delete existing sessions. 
+          </para>
+          <para> 
+            To add a new session, press the <guibutton>Add</guibutton> 
+            button and enter in a new session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To edit an existing session name, highlight the session
+            name you wish to edit, press the <guibutton>Edit</guibutton> button
+            and edit the existing session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To delete an existing session name, highlight the session
+            name you wish to delete, press the <guibutton>Delete</guibutton>
+            button.
+          </para>
+        </listitem>  
+        </itemizedlist>
+        <figure>
+ 	  <title>Startup Programs Capplet</title>
+	  <screenshot>
+	    <screeninfo>Startup Programs Capplet</screeninfo>
+	    <graphic format="png" fileref="./figs/gccstartup" srccredit="gman">
+	    </graphic>
+	  </screenshot>
+        </figure>
+      <itemizedlist mark="opencircle">
 	<listitem>
 	  <para>
 	    <guilabel>Non-session managed startup programs</guilabel> &mdash; 
@@ -1406,4 +1438,4 @@
  </sect1>
 
 
-  </article>
\ No newline at end of file
+  </article>

--------------1CCC036EA35DA3B43F0F89A4--



From jfleck@swcp.com  Thu Feb 22 08:50:41 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 879032D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:50:40 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00779
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:49:16 -0700
Date: Thu, 22 Feb 2001 06:49:16 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: scrollkeeper and gnome 1.4
Message-ID: <20010222064916.A770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <200102212057.PAA13250@copiague.math.sunysb.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>; from Alexander Kirillov on Wed, Feb 21, 2001 at 03:57:18PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 03:57:18PM -0500, Alexander Kirillov wrote:
> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 
> 

I know the omf installation was not in place in the gnome-utils
package in time for the first beta. It's done in cvs now.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jfleck@swcp.com  Thu Feb 22 08:58:49 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id B13B32D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:58:48 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00797
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:57:24 -0700
Date: Thu, 22 Feb 2001 06:57:24 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Finished docs
Message-ID: <20010222065724.B770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>; from Dan Mueth on Thu, Feb 22, 2001 at 03:48:59AM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Thu, Feb 22, 2001 at 03:48:59AM -0800, Dan Mueth wrote:
> 
> Since we are approaching the GNOME 1.4 release, I have decided to start
> producing a weekly list of documents which are completely Done(TM) to send
> to the translators for translation.  
> 

Could you include with the list the name and email of the relevant
package coordinators? We need to make sure we know when translations
go in, so we can add in the appropriate omf files and add them to the
build system.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jacob@ximian.com  Thu Feb 22 12:43:25 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (unknown [208.4.24.67])
	by mail.gnome.org (Postfix) with ESMTP id C55182DB91
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 12:43:25 -0500 (EST)
Received: from jacob by ulysses with local (Exim 3.22 #1 (Debian))
	id 14Vzee-0000N7-00; Thu, 22 Feb 2001 12:35:48 -0500
Subject: Re: scrollkeeper and gnome 1.4
From: jacob berkman <jacob@ximian.com>
To: Dan Mueth <dan@eazel.com>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
In-Reply-To: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 12:35:47 -0500
Mime-Version: 1.0
Message-Id: <E14Vzee-0000N7-00@ulysses>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 22 Feb 2001 03:33:19 -0800, Dan Mueth wrote:
> 
> On Wed, 21 Feb 2001, Alexander Kirillov wrote:
> 
> > 
> > Hi guys:
> > 
> > I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> > surprise, no OMF files were installed at all: /usr/share/omf contains
> > scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> > wrong with the packages - could you (or someone else) look into this? 
> 
> This doesn't entirely surprise me.  We were working on getting this done
> right around the package deadline for GNOME 1.4 beta1, so I suspect the
> packages were submitted before we added the OMF metadata.



> I have spoken with Jacob, who does a lot of the packaging work at Ximian

actually i don't do packaging stuff anymore :)

> work.  I even gave him my spec file for gnome-core (which I originally
> took from him and then modified).  So, my guess is we just missed the
> deadline for when they took their beta1 snapshot.  I expect things to work
> for beta2, although it is a good idea to double-check this.

yeah, the plan is to have it working by beta2.  the scrollkeeper tarball
was no good, and nothing used it, and the distro guys were on a tight
deadline anyway.

jacob
-- 
"The people who made the Macintosh produced a miracle, but that
 doesn't mean their code was wonderful." -- Bob Cringely


From gleblanc@cu-portland.edu  Fri Feb 23 00:28:32 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id 85EAB2E5A8; Fri, 23 Feb 2001 00:27:59 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1N5RxQ09400;
	Thu, 22 Feb 2001 21:27:59 -0800
Message-Id: <200102230527.f1N5RxQ09400@mail2.aracnet.com>
Subject: GDP Release Committee Minutes
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 21:26:22 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 18, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Kenny Graunke
Laszlo Kovacs
John Fleck
Alexander Kirillov (arrived 1:18) (departed 1:53)
Ali Abdin (arrived 1:45)

Absent:
-------


Regrets:
--------


Decisions:
----------

- Meeting time agreed to be at 1:00PM PT (9:00PM UTC) on Sunday for
  GDP Release Committee meetings.

- Gregory Leblanc will serve as secretary at meetings

- User's Manuals for applications should be kept in the
  '<application>/help/<locale>/*' sub-directory in CVS, and figures,
  screen shots, and other graphics should go into
  '<application>/help/<locale>/figures'.

- Maintainers assigned for coordinating documentation in various
  modules for the GNOME 1.4 release.  This involves maintaining an
  idea of what the status of a particular module's documentation is
  in, and being a liaison between the docs writers and the application
  hackers.

  - ggv -- John Fleck
  - gnome-applets -- Telsa Gwynne
  - gnome-core -- Dan Mueth
  - gnome-utils -- John Fleck
  - gnome-games -- Gregory Leblanc
  - nautilus -- Dan Mueth
  - ghex -- John Fleck
  - control-center -- Alexander Kirillov
  - bug-buddy -- Telsa Gwynne
  - dia -- Kevin Breit

- Future GDP Release Committee meetings will be open to all GNOME
  members.  This meeting was held without general publication to
  ensure that we could schedule a time for regular meetings, and to
  ensure that the meeting was as effective per time spent as
  possible.  Kevin Breit will be coordinating the Quality Assurance
  efforts for the GDP durring the GNOME 1.4 timeframe.

Work Done:
----------
Since this is our first meeting, we haven't finished any work since
the last meeting.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth -- put HACKING files into gnome-user-docs and
  gnome-devel-docs, and to inform gnome-hackers about the new modules
  and refer them to the HACKING files for further information.

- TODO: Alexander Kirillov -- gather a list of documentation that is
needs to
  be moved into gnome-user-docs, and to email this to Gregory Leblanc
  <gleblanc@cu-portland.edu>
- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Telsa Gwynne -- create a gnome-user-docs product in bugzilla.
  Alexander Kirillov and Telsa Gwynne would like to work on these
  docs, but has more to do than she can handle already, so this will
  wait for now.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.

- INFORMATION: John and Ali reported on the status of gnome-db2html2.
  gnome-db2html2 is mostly solid, with only a few minor known-bugs
  left.  Indexing support isn't included yet, and there is not enough
  time to get it added before 1.4.  Strings have been marked for
  translation, so navigation should appear in the user's specified
  language.  Ali would like to have the navigation links that are
  generated match the locale of the doc, rather than the locale that
  the user has set, but this isn't written yet.  The status of
  Japanese in gnome-db2html2 is -unknown-.

- TODO: John Fleck and Dan Mueth -- test i18n in gnome-db2html2

- TODO: Dan Mueth -- follow up on the bugs with HTML Help in Nautilus.
  Bugs #4302,* #5945, and#6761 in the Nautilus bug system.

- TODO: Dan Mueth -- have Jacob Berkman patch gnome-libs to make
  nautilus the default help browser.

- TODO: Ask Arik to do the "font stuff" for the help sidebar in
  nautilus.

- TODO: Dan Mueth -- enable ScrollKeeper for the help sidebar in the
  default build of Nautilus, including hourly RPMs.

- TODO: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- TODO: Kevin Breit -- develop test assertions, and document
  this procedure so that it can be applied for GNOME 1.4

- TODO: Kevin Breit -- divide docs into groups for QA volunteers to
  sign up for.

- TODO: Laszlo Kovacs-- repair locale fallback for ScrollKeeper in time
for
  GNOME 1.4.  

- INFORMATION: Scrollkeeper will need to be installed on end user
  machines to make the help sidebar in nautilus work properly.  People
  who build packages including OMF metadata should install
  ScrollKeeper so that the document metadata is included in the
  package.  ScrollKeeper can be obtained from:
  http://sourceforge.net/project/showfiles.php?group_id=11543&release_id=24049

- TODO: All Package Coordinators -- gather a list of docs that have
  been completed recently, and are now "frozen".  Mail this list to
  Dan Mueth on Thursday, and he'll collect it and post it to the
  gnome-i18n mailing list.  This is a weekly -recurring- task.

- TODO: Telsa Gwynne -- talk to the i18n team and get feedback on what
  the GDP can do to make translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)


Agenda Items Left For Next Meeting:
-----------------------------------

- User's Guide to be left until the next meeting.  Please review the
  mail by Dan, and prepare for the test at the next meeting.  :)

- Review the list of unfinished documents.

- Discuss use of Bugzilla for the GDP further.

Agenda:
-------
1) Set time for next meeting
2) Minutes
3) Discuss status of gnome-user-docs
4) Discuss gnome-developer-docs and developer FAQ
5) Discuss GNOME Users Guide
6) Review which packages do not have doc maintainers for the GNOME 1.4
release
7) Discuss status of gnome-db2html2
8) Review status of converting docs to work with Nautilus
9) Review status of OMF/ScrollKeeper
10) Review QA plan
11) Review list of unfinished documents
12) Plan for freezing docs and passing them to translators (Release a
weekly list of docs which are frozen and ready for translations?  Stage
docs so each week we completely review and freeze some docs.)
13) Opening up meetings (I don't want the meetings to seem exclusive,
although it makes scheduling a heck of a lot easier if you have a finite
number of people, and the meetings are a lot more efficient. Let's
discuss
having these be open meetings though after we get a schedule locked
down.)






From rob@funky-penguin.co.uk  Fri Feb 23 05:22:13 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id 245102DD1E
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:22:13 -0500 (EST)
Received: from [213.122.189.46] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14WFMX-0007Bf-00
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 10:22:11 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14WFPh-0001QO-00
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:25:25 +0000
Date: Fri, 23 Feb 2001 10:25:12 +0000
To: gnome-doc-list@gnome.org
Subject: Unable to render sgml to html on Debian
Message-ID: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="gKMricLos+KVdGMg"
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--gKMricLos+KVdGMg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

I did used to have this working a long time ago but i moved boxes and now
when i come back to work on it doesnt seem to work.

I downloaded and installed gnome-doc-tools and everything it depeneded on
(cygnus-stylesheets etc).

When i try to db2html a file i know works i just get the file outputed to
stdout rendered as plain text.

Before lots of errors on almost every tag the following it outputted:

input file was called gnome-stones.005.sgml -- output will be in
gnome-stones.005

working on ../gnome-stones.005.sgml
jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"
jade:../gnome-stones.005.sgml:4:0:E: reference to entity "ARTICLE" for which
no system identifier could be generated
jade:../gnome-stones.005.sgml:1:0: entity was defined here
jade:../gnome-stones.005.sgml:4:0:E: DTD did not contain element declaration
for document type name


I think this could be a DTD error but i'm really not sure what to do now.

Any advice on what to do would be greatly appreciated.

rob
--=20
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet

--gKMricLos+KVdGMg
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.4 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD8DBQE6ljqICw8pKd+B7oMRAle6AJ0dl9TmIjMDMlf0AXJiv0q/D5w2iQCdEtrw
sdC62cmPwhiJb/8gP6TUep4=
=ZPbk
-----END PGP SIGNATURE-----

--gKMricLos+KVdGMg--


From jules@blueberry.jellybean.co.uk  Fri Feb 23 05:43:53 2001
Return-Path: <jules@blueberry.jellybean.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from blueberry.jellybean.co.uk (blueberry.jellybean.co.uk [194.88.75.31])
	by mail.gnome.org (Postfix) with ESMTP id E273E2DD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:43:52 -0500 (EST)
Received: from jules by blueberry.jellybean.co.uk with local (Exim 3.16 #1 (Debian))
	id 14WFhO-0003OP-00; Fri, 23 Feb 2001 10:43:42 +0000
Date: Fri, 23 Feb 2001 10:43:42 +0000
From: Jules Bean <jules@jellybean.co.uk>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223104341.B12325@blueberry.jellybean.co.uk>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
> 
> I downloaded and installed gnome-doc-tools and everything it depeneded on
> (cygnus-stylesheets etc).

Which version of gnome-doc-tools?

I'm about to try using eliot landrum's latest debian packages of
gnome-doc-tools, and if it works, upload it into debian. (I need it to 
build the docs of the balsa package, which I maintain).

Jules


From aliabdin@aucegypt.edu  Fri Feb 23 06:16:27 2001
Return-Path: <aliabdin@aucegypt.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from jerry.aucegypt.edu (jerry.aucegypt.edu [208.159.7.6])
	by mail.gnome.org (Postfix) with ESMTP id 695BB2CE41
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 06:16:27 -0500 (EST)
Received: from localhost.localdomain ([217.52.7.140])
 by auc.AUCEGYPT.EDU (PMDF V5.2-31 #41700)
 with ESMTP id <01K0G8WO5SKG9GVA8P@auc.AUCEGYPT.EDU> for
 gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:19:17 EGYPT
Received: by localhost.localdomain (Postfix, from userid 500)
	id 7DF7756FD; Wed, 21 Feb 2001 23:01:25 +0200 (EET)
Date: Wed, 21 Feb 2001 23:01:25 +0200
From: Ali Abdin <aliabdin@aucegypt.edu>
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
In-reply-to: <01021815165800.10931@7of9>
To: battery841@mediaone.net
Cc: gnome-doc-list@gnome.org
Message-id: <20010221210125.7DF7756FD@localhost.localdomain>
MIME-version: 1.0
X-Mailer: Evolution (0.8 - Preview Release)
Content-type: text/plain
References: <20010215172159.A11517@math.sunysb.edu>
 <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
 <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 18 Feb 2001 15:16:58 -0600, Kevin Breit wrote:
> On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> > Is there any interest in having any of the user or developer docs
> > recorded? I'm thinking audio books, or even inserting <audioobject> and
> > <audiodata> tags into the docs themselves.
> >
> > All I will need is someone with a good voice to volunteer. (I have a small
> > studio setup near Chicago.)
> That'd be interesting.  It would be best to have it in mp3 format.  If you 
> wanted, and we got this rolling soon enough, I could do some voice stuff 
> since I live in the Chicago burbs.


No it wouldn't. It would be best to have it in ogg format!!!! :)

I don't think it is worth doing until we have a nice way of actually
playing these files ;)

Perhaps somebody should talk with Sun about this since they are doing
some GNOME Accessibility work

Regards,
Ali


From kirillov@peconic.math.sunysb.edu  Fri Feb 23 10:51:42 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id DC0DB2E516
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:51:41 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id KAA21411;
	Fri, 23 Feb 2001 10:51:37 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id KAA21208;
	Fri, 23 Feb 2001 10:51:37 -0500
Date: Fri, 23 Feb 2001 10:51:37 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223105137.B21128@math.sunysb.edu>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
[snip] 
> working on ../gnome-stones.005.sgml
> jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
> jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
> public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"

>From these messages, something is wrong with your CATALOG file -
probably DocBook PNG Variant V1.1, instead of referring to DOcBook
V3.1 as it should, refers to itself, or something like this. If you
send me your /usr/lib/sgml/catalog and the dtd file installed by
DocBook PNG Variant V1.1, I might be able to tell you more. 

Sasha


From pablodc@mapfre.com.ar  Fri Feb 23 11:10:02 2001
Return-Path: <pablodc@mapfre.com.ar>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail.mapfre.com.ar (mail.mapfre.com.ar [200.32.86.3])
	by mail.gnome.org (Postfix) with ESMTP id 5A27C2C906
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 11:09:48 -0500 (EST)
Received: by mail.mapfre.intranet.ar with Internet Mail Service (5.5.2448.0)
	id <FKPFQT5Y>; Fri, 23 Feb 2001 13:11:36 -0300
Message-ID: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
From: Pablo del Campo <pablodc@mapfre.com.ar>
To: gnome-doc-list@gnome.org
Subject: Strings Unstranslated in Nautilus (spanish)
Date: Fri, 23 Feb 2001 13:11:30 -0300
Importance: high
X-Priority: 1
MIME-Version: 1.0
X-Mailer: Internet Mail Service (5.5.2448.0)
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everyone:

	My name is Pablo and I working in the Nautilus=B4s spanish
translation.

	I have a couple of troubles with some strings that are translated in
the es.po but Nautilus insist in display them in english, I write this =
mail
for someone that can help me whith this:

Some of the strings are:

* Customer (I don=B4t have this string in the es,po after run =
./update.sh es),
it=B4s in the Help menu.
* All the Strings of the MP3 player are translated in the es.po but
displayed in english when use it in Nautilus.
* The users level that are displayed in the Assistant when first Launch
Nautilus.
* two or three strings in the RPM view (I=B4dont remember exactly what =
they
are right now).

If someone can help whith this write me at pablodc@bigfoot as fast as =
you
can.

Thanks and please forgive my bad english.

    .-.     Pablo Gonzalo del Campo
 .-.   .-.     MAPFRE Aconcagua
(___\ /___)       Sistemas
     |          Programador
     =20


From erik@core.com  Fri Feb 23 13:54:15 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id CAE9A2BD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 13:54:14 -0500 (EST)
Received: from core.com (tnt15b-74.focal-chi.corecomm.net [216.214.210.74])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1NIsjv78655
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 18:54:45 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1NJ2Up14527
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:02:30 -0600
Date: Fri, 23 Feb 2001 13:02:30 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010223130230.B6594@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9> <20010221210125.7DF7756FD@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010221210125.7DF7756FD@localhost.localdomain>; from "aliabdin@aucegypt.edu on Wed, Feb 21, 2001 at 11:01:25PM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 11:01:25PM +0200, Ali Abdin wrote:
> 
> No it wouldn't. It would be best to have it in ogg format!!!! :)

Well, they will be recorded/edited as 24bit 44.1kHz SoundDesignerII format, but
after that I can convert them into anything. :)

> I don't think it is worth doing until we have a nice way of actually
> playing these files ;)

There are plenty of ways to play these files. :) (but none are intergrated
specifically for this.)

My view is why wait? If someone actually uses this between the time the
recording/editing is finished and a hacker get some intergration into I think
would be nautilus, then it will be worth it. I see this as the old chicken and
egg problem...  or is it the carrot in front of the horse? Heh.

I talked to Kevin on irc, what I think we'll do is a proof of concept demo.

> Perhaps somebody should talk with Sun about this since they are doing
> some GNOME Accessibility work

Who at Sun should we get in contact with?

-- 
All music aspires to the condition of muzak.


From dan@eazel.com  Fri Feb 23 23:09:35 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3A9E72BAAF
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 23:09:35 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1O47Ke02058;
	Fri, 23 Feb 2001 20:07:20 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 23 Feb 2001 20:07:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Pablo del Campo <pablodc@mapfre.com.ar>
Cc: gnome-doc-list@gnome.org, nautilus-list@lists.eazel.com
Subject: Re: Strings Unstranslated in Nautilus (spanish)
In-Reply-To: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
Message-ID: <Pine.LNX.4.21.0102231954540.27264-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=ISO-8859-1
Content-Transfer-Encoding: 8BIT
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi Pablo,

Thanks for pointing this out.  I am no hacker, but my unexpert opinion is
that this is un-gettext'd:

components/rpmview/nautilus-rpm-view.c:

gtk_label_set_text
(GTK_LABEL(rpm_view->details->package_installed_message), "This package is
currently installed");

I suspect we have a fair number of places where ungettext'd strings have
slipped in.

Any Nautilus hackers want to volunteer to grep through CVS and fix any
strings which are not gettext-ized?

Dan




On Fri, 23 Feb 2001, Pablo del Campo wrote:

> Hi everyone:
> 
> 	My name is Pablo and I working in the Nautilusīs spanish
> translation.
> 
> 	I have a couple of troubles with some strings that are translated in
> the es.po but Nautilus insist in display them in english, I write this mail
> for someone that can help me whith this:
> 
> Some of the strings are:
> 
> * Customer (I donīt have this string in the es,po after run ./update.sh es),
> itīs in the Help menu.
> * All the Strings of the MP3 player are translated in the es.po but
> displayed in english when use it in Nautilus.
> * The users level that are displayed in the Assistant when first Launch
> Nautilus.
> * two or three strings in the RPM view (Iīdont remember exactly what they
> are right now).
> 
> If someone can help whith this write me at pablodc@bigfoot as fast as you
> can.
> 
> Thanks and please forgive my bad english.
> 
>     .-.     Pablo Gonzalo del Campo
>  .-.   .-.     MAPFRE Aconcagua
> (___\ /___)       Sistemas
>      |          Programador
>       
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 





From hobbit@aloss.ukuu.org.uk  Sun Feb 25 04:27:39 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id EB49C2BACE
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 04:27:38 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1P9V4X12307
	for gnome-doc-list@gnome.org; Sun, 25 Feb 2001 09:31:04 GMT
Date: Sun, 25 Feb 2001 09:31:04 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: bug-buddy docs 1.4 ready? Please check :) 
Message-ID: <20010225093104.B12247@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Okay, the proto-docs for bug-buddy are on the web at
http://www.linux.org.uk/~telsa/GDP/bug-buddy-new.sgml

The text is fine, I think. As in, I don't see too many errors.
I have checked for most of the 1.4-readiness stuff. But I have
got myself intro a terrible muddle: which licence am I supposed 
to be including under what id tag? I think I have it wrong. Please 
give it a quick check and tell me. Then I'll throw them at Jacob 
for CVS. (I haven't put them straight into CVS cos every time I 
touch it something else goes wrong. :))

Telsa


From chris@wilddev.net  Sun Feb 25 05:57:41 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 47E5B2BAFB
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 05:57:40 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id DAA21647;
	Sun, 25 Feb 2001 03:07:13 -0800
Message-ID: <3A98E54F.9000900@wilddev.net>
Date: Sun, 25 Feb 2001 02:58:23 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Cc: ian@eazel.com
Subject: GNOME UG Proposed Framework
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I wish to get comments from people on what they think of this list of 
docs to be included in the UG. The major change in 1.4 is the addition 
of Nautilus. I'm going to pull the current copies of these docs from CVS 
to see what needs to be done to get them together for the UG. If Ian 
gets to busy to do the scripts then I may just attempt to put them 
together manually.

Chris

Intro to GNOME
GNOME Quick Start
Window Managers and GNOME
The Gnome Desktop
Nautilus
Panel
   -Applets
GNOME System Utilities
Menu Editor
GNOME Control Center
Appendix
   -A Linux Primer
   -B GDP Team
   -C GNU FDL



From trevor.curtis@home.com  Mon Feb 26 10:37:37 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id 7899C2BF20
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 10:37:37 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010226153708.SBMY12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 07:37:08 -0800
Date: Mon, 26 Feb 2001 10:39:01 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Gnome Tali doc converted
Message-ID: <20010226103900.A5114@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
X-Operating-System: Linux frink.thesimpsons.ca 2.4.2
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I just finished converting the Gnome Tali game manual from html to
sgml. This is my first attempt at docbooking something so any feedback
would be great; negative or otherwise :)

My biggest problem was decided what should and shouldn't be tagged and
how to or not to tag them. So if there are issues here concerning that
just let me know.

So for those you who wouldn't mind you can find it here:
http://www.scs.carleton.ca/~tcurtis/gtali.sgml

thanks in advance,
-- 
Trevor Curtis
http://members.home.net/jbrabazon
--------------------------------------------------------------
"The only people who have anything to fear from free software,
are those whose products are worth even less."  --David Emery.



From jfleck@swcp.com  Mon Feb 26 11:11:36 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 99DE12DDEE
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 11:11:34 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id JAA03237
	for gnome-doc-list@gnome.org; Mon, 26 Feb 2001 09:10:10 -0700
Date: Mon, 26 Feb 2001 09:10:09 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Gnome Tali doc converted
Message-ID: <20010226091009.A1672@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <20010226103900.A5114@mail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <20010226103900.A5114@mail.com>; from Trevor Curtis on Mon, Feb 26, 2001 at 10:39:01AM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Trevor -

The markup looks fine to me.

The only change needed that I saw was the reference to
bugs.gnome.org. It needs to be changed to bugzilla.gnome.org. We need
to get that changed in the templates. Sorry.

I also tested it in Nautilus, and it passed.

The next step, which would be great if you have the energy, would be
to add screenshots.

Cheers,

John

On Mon, Feb 26, 2001 at 10:39:01AM -0500, Trevor Curtis wrote:
> I just finished converting the Gnome Tali game manual from html to
> sgml. This is my first attempt at docbooking something so any feedback
> would be great; negative or otherwise :)
> 
> My biggest problem was decided what should and shouldn't be tagged and
> how to or not to tag them. So if there are issues here concerning that
> just let me know.
> 
> So for those you who wouldn't mind you can find it here:
> http://www.scs.carleton.ca/~tcurtis/gtali.sgml
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From battery841@mediaone.net  Tue Feb 27 17:24:15 2001
Return-Path: <battery841@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from elmls01.ce.mediaone.net (elmls01.ce.mediaone.net [24.131.128.25])
	by mail.gnome.org (Postfix) with ESMTP id 576F82CA94
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 17:24:15 -0500 (EST)
Received: from 7of9 (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by elmls01.ce.mediaone.net (8.8.7/8.8.7) with SMTP id QAA19245
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 16:24:10 -0600 (CST)
Content-Type: text/plain;
  charset="iso-8859-1"
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Gnibbles dox
Date: Tue, 27 Feb 2001 16:14:56 -0600
X-Mailer: KMail [version 1.2]
MIME-Version: 1.0
Message-Id: <01022716145600.18733@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
	Why aren't the Gnibbles documentation in Gnibbles?  I wrote the dox and they 
should be in CVS.  Any reasons?
Thanks
Kevin


From gleblanc@cu-portland.edu  Tue Feb 27 23:48:33 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id F09D12DECF; Tue, 27 Feb 2001 23:48:32 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1S4mWn15023;
	Tue, 27 Feb 2001 20:48:32 -0800
Message-Id: <200102280448.f1S4mWn15023@mail2.aracnet.com>
Subject: Minutes for the GDP Release Committee meeting Feb 25, 2001
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 27 Feb 2001 20:46:45 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 25, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Laszlo Kovacs
John Fleck
Alexander Kirillov
Chris Lyttle (arrived 1:54)

Absent:
-------
Kenny Graunke
Ali Abdin


Regrets:
--------


Decisions:
----------

- Nautilus will not have the ability to fall back on the
  non-scrollkeeper sidebar.  Scrollkeeper is now required for
  Nautilus.

Work Done:
----------

- DONE: Dan Mueth -- HACKING files created in gnome-user-docs and
  gnome-devel-doc.  

- DONE: Alexander Kirillov -- created a list of documentation to be
  moved into the gnome-user-docs module, and send it to Gregory
  Leblanc <gleblanc@cu-portland.edu>
- DONE: Telsa Gwynne -- created a gnome-user-docs product in
  bugzilla.

- DONE: John Fleck and Dan Mueth -- tested l10n and i18n in
  gnome-db2html2.  It doesn't work, but a detailed bug report has been
  filed, and "it should be easy to fix".

- DONE: Dan Mueth, John Fleck, Mike Fleming-- bugs #4302, #5945, and
  #6761 are fixed and verified.

- DONE: Laszlo Kovacs -- Enabled scrollkeeper in the default builds of
  Nautilus, and in the hourly builds.

- DONE: Kevin Breit -- Divided docs into groups so that QA volunteers
  can sign up.
  http://battery841.myip.org/school/gnome-1.4-category.txt/ps

- DONE: Laszlo Kovacs -- locale fallback in scrollkeeper has been
  fixed.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth Kenny Graunke -- create build system in
  gnome-user-docs and gnome-devel-docs.  Once build system is in place
  inform gnome-hackers about the new modules and refer them to the
  HACKING files for further information.

- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Gregory Leblanc -- find script that puts the FAQ (and possibly
  other gnome-user-docs documents) onto the website, and find the
  maintainer.  Have the script changed to look to gnome-user-docs
  instead of gnome-docu.

- TODO: Telsa Gwynne -- add components and version numbers to the
  gnome-user-docs module in bugzilla.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.  Mail list of packages to gnome-doc-list for
  volunteers.

- IN PROGRESS: Dan Mueth -- Emailed Jacob Berkman about making
  nautilus the default help browser in gnome-libs.

- IN PROGRESS: John Fleck -- check on support for using multiple fonts
  in the Nautilus Help Sidebar.

- TODO: John Fleck, Laszlo Kovacs, Dan Mueth -- work out l10n issues.

- IN PROGRESS: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- IN PROGRESS: Kevin Breit -- develop quality assurance tests, and
  document this procedure so that it can be applied for GNOME
  1.4. See: 
  http://battery841.myip.org/school/checklist.txt
  http://www.gnome.org/~mjs/gnome-test-plans/ and
  gnome-test-plans in CVS for details.

- TODO: John Fleck -- determine status of glossary.[xml sgml] so that
  it can be translated.

- IN PROGRESS: Telsa Gwynne -- talk to the i18n teams about making
  translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)

- TODO: Chris Lyttle -- Work on GNOME Users Guide.  Add a "New in
  GNOME 1.4" section near the beginning of the Guide.  See about the
  feasibility of getting the Users Guide included with Beta 3

- TODO: Kevin Breit -- Polish the existing dia documentation and have
  it included (and linked to the help menu) in the next release.

- TODO: Dan Mueth -- Assist John Fleck in verifing some
  Nautilus/gnome-db2html2 bugs.  

Agenda Items Left For Next Meeting:
-----------------------------------

0) Discuss improving meetings
1) Review which packages need maintainers
2) QA review

Agenda:
-------
0) Review TODO's from last meeting
1) Discuss GNOME User Guide
2) Discuss whether Dia doc is ready for inclusion
3) Discuss improving meetings
4) Review which packages need maintainers
5) QA review
6) Nautilus bug verification





From chris@wilddev.net  Wed Feb 28 02:04:57 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 64AC12BB09
	for <gnome-doc-list@gnome.org>; Wed, 28 Feb 2001 02:04:56 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id XAA30737
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 23:14:49 -0800
Message-ID: <3A9CA358.5080701@wilddev.net>
Date: Tue, 27 Feb 2001 23:06:00 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: GNOME UG vs KDE UG
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all
I was surfing the KDE site looking for ideas and I noticed

http://www.kde.org/documentation/userguide/index.html

This impressed me as it is task based, something we have discussed doing 
for the gdp docs. I am thinking now that I might try to incorporate some 
things into the UG that are more task oriented (in the time available) 
and plan on rewriting the UG as a standalone task based doc for possibly 2.0

Let me know your thoughts

Chris



From kirillov@math.sunysb.edu  Sun Feb  4 18:06:39 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from localhost.localdomain (076-041.dialup.sunysb.edu [129.49.76.41])
	by mail.gnome.org (Postfix) with ESMTP id B4BE02BC7E
	for <gnome-doc-list@gnome.org>; Sun,  4 Feb 2001 18:06:38 -0500 (EST)
Received: by localhost.localdomain (Postfix, from userid 501)
	id 0CEF73E53A; Sun,  4 Feb 2001 18:05:02 -0500 (EST)
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: indexing
Message-Id: <20010204230502.0CEF73E53A@localhost.localdomain>
Date: Sun,  4 Feb 2001 18:05:02 -0500 (EST)
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all:
one feature almost all our docs are sorely missing (with the exception
of the users guide for 1.2) is an index. I think we need to do something
about it. 

Ideal solution would be: 

 a. we put tags like 

   <indexterm><primary>Applets</primary>
              <secondary>adding to panel</secondary> 
   </indexterm>
   in our documents (in this case - in the panel manual when
   discussing adding applets to panel). 

 b. during db2html conversion, gnome-db2html would process this and
 create an index for the document, or 

 c. even better, index for documents for all core components
 (panel, applets, nautilus,  control center,...), or  even all  gnome
 docs is created from these tags at installation time, so we have a
 common index. 

Unfortunately, this is unrealistic. At the moment, gnome-db2html does
not automatically produce an index. Neither, btw, does jade. However,
I strongly feel that we need an index *now* - make it a hack if we
must. 

 Suggestions: 

 1. Create an index for each doc manually, i.e. in your doc, add
    a section like this

<index><title>Index</title>
<indexdiv><title>A</title>
<indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see <xref linkend="appletadd">
           </secondaryie>
   </primaryie>   

etc. Here "appletadd" is the id of sect1 discussing this topic.
Obviously, the problem is that you must manually update the index
whenever the document structure changes.

or: 

  2. Create a common index for all core docs as a separate document;
instead of <xref>, use something like 
 <indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see Panel manual, section <ulink type="gnome-help"
url="help:panel?appletadd">Adding objects to panel</ulink> 
           </secondaryie>
   </primaryie>   
  

Obviously, 2 would be better for the user (it is better to have one
common index than 10 individual ones) but *much* harder to maintain. On the
other hand, sections of our documents do not change all too
often. I think either way it is something we can do before 1.4; my
estimate is it would take 2-3 days (for one person) to write such an
index. Yes, it is a hack, but it will do for now. I'd vote for 2. 

Comments? Volunteers?

Sasha






From michael.smith@openwave.com  Mon Feb  5 05:01:38 2001
Return-Path: <michael.smith@openwave.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from oe-mp1.bizmailsrvcs.net (oe-mp1pub.managedmail.com [206.46.164.22])
	by mail.gnome.org (Postfix) with ESMTP id 86F812BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:01:37 -0500 (EST)
Received: from oe-ismta1.bizmailsrvcs.net ([206.46.164.26])
          by oe-mp1.bizmailsrvcs.net (InterMail vM.5.01.01.01 201-252-104)
          with ESMTP
          id <20010205095619.CZSW24251.oe-mp1.bizmailsrvcs.net@oe-ismta1.bizmailsrvcs.net>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:56:19 -0600
Received: from SMITH1.openwave.com ([63.24.97.132])
          by oe-ismta1.bizmailsrvcs.net
          (InterMail vM.5.01.01.01 201-252-104) with ESMTP
          id <20010205095452.YJUR1854.oe-ismta1.bizmailsrvcs.net@SMITH1.openwave.com>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:54:52 -0600
To: gnome-doc-list@gnome.org
Subject: July open-source conference
From: Michael Smith <smith@xml-doc.org>
Date: 05 Feb 2001 02:01:27 -0800
Message-ID: <uae81phxk.fsf@openwave.com>
Lines: 29
User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello all,

I'm writing to a few different lists to ask whether anyone might be
planning to attend the O'Reilly open-source conference (San Diego CA)
in July.

I've been in contact with some of the folks at O'Reilly, trying to
drum up support for a "DocBook" or "open-source document authoring"
day. I think a discussion/tutorial from someone involved with the GNOME
doc project would be valuable to others. Has anyone thought about maybe
submitting a proposal for a tutorial/presentation?

The deadline for submissions of proposals is February 9th (this
Friday). If anyone else from the GNOME doc project could submit a
proposal of some kind, I think it would great. If nobody wants to
commit to a whole tutorial, I'd certainly be willing to coordinate
integration of GNOME expertise into a larger tutorial of some kind.

Please let me know what you think, or just go ahead and submit a
proposal for the conference's XML track:

  http://conferences.oreilly.com/oscon2001/call-xml.html

Or at the very least, if you plan on attending, e-mail
oscon2001-xml-proposals@oreilly.com expressing interest in seeing some
DocBook/document-authoring tutorials/presentations take place.

  --Mike Smith






From laszlo.kovacs@Sun.COM  Mon Feb  5 05:10:37 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 6DE652BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:10:36 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id CAA21828
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 02:10:34 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id KAA19302
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 10:10:33 GMT
Message-ID: <3A7E7C19.78432618@Sun.COM>
Date: Mon, 05 Feb 2001 10:10:33 +0000
From: laszlo kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> 
> Hi all:
> one feature almost all our docs are sorely missing (with the exception
> of the users guide for 1.2) is an index. I think we need to do something
> about it.
> 
> Ideal solution would be:
> 
>  a. we put tags like
> 
>    <indexterm><primary>Applets</primary>
>               <secondary>adding to panel</secondary>
>    </indexterm>
>    in our documents (in this case - in the panel manual when
>    discussing adding applets to panel).
> 
>  b. during db2html conversion, gnome-db2html would process this and
>  create an index for the document, or
> 
>  c. even better, index for documents for all core components
>  (panel, applets, nautilus,  control center,...), or  even all  gnome
>  docs is created from these tags at installation time, so we have a
>  common index.
> 
> Unfortunately, this is unrealistic. At the moment, gnome-db2html does
> not automatically produce an index. Neither, btw, does jade. However,
> I strongly feel that we need an index *now* - make it a hack if we
> must.

I wonder how much people know about the Scrollkeeper project (not very
informative web site is scrollkeeper.sourceforge.net). This project is
about metadata based document categorizing and storing the result in xml
file(s) exported to help browsers. There are pretty high chances that
the Help sidebar in Nautilus for Gnome 1.4 will use Scrollkeeper. We
aimed to add indexing functionality in Scrollkeeper after Gnome 1.4.
This contains index extraction (in case the index info is added to the
docs as detailed above), exporting this to help browsers and integrate
this with Nautilus. Going further implementation of search through index
and other parts of the documentation and metadata is also considered.
Both Scrollkeeper and its integration with Nautilus are run by the same
people.

> 
>  Suggestions:
> 
>  1. Create an index for each doc manually, i.e. in your doc, add
>     a section like this
> 
> <index><title>Index</title>
> <indexdiv><title>A</title>
> <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see <xref linkend="appletadd">
>            </secondaryie>
>    </primaryie>
> 
> etc. Here "appletadd" is the id of sect1 discussing this topic.
> Obviously, the problem is that you must manually update the index
> whenever the document structure changes.
> 
> or:
> 
>   2. Create a common index for all core docs as a separate document;
> instead of <xref>, use something like
>  <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see Panel manual, section <ulink type="gnome-help"
> url="help:panel?appletadd">Adding objects to panel</ulink>
>            </secondaryie>
>    </primaryie>
> 
> 
> Obviously, 2 would be better for the user (it is better to have one
> common index than 10 individual ones) but *much* harder to maintain. On the
> other hand, sections of our documents do not change all too
> often. I think either way it is something we can do before 1.4; my
> estimate is it would take 2-3 days (for one person) to write such an
> index. Yes, it is a hack, but it will do for now. I'd vote for 2.

1. would prolly suit the way how Scrollkeeper is intended to work
better, but I am sure it could also serve the other approach. One
question though, what's the point to add the index info to docs before
Gnome 1.4 if there is no index display and search implemented? Or am I
missing something?

Laszlo


From kirillov@peconic.math.sunysb.edu  Mon Feb  5 11:28:30 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 5D0FE2CA94
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 11:28:30 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id LAA00445;
	Mon, 5 Feb 2001 11:28:28 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id LAA30055;
	Mon, 5 Feb 2001 11:28:28 -0500
Date: Mon, 5 Feb 2001 11:28:28 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: laszlo kovacs <laszlo.kovacs@sun.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
Message-ID: <20010205112828.A30010@math.sunysb.edu>
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <3A7E7C19.78432618@Sun.COM>; from laszlo.kovacs@sun.com on Mon, Feb 05, 2001 at 10:10:33AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, Feb 05, 2001 at 10:10:33AM +0000, laszlo kovacs wrote:
[snip]
> One
> question though, what's the point to add the index info to docs before
> Gnome 1.4 if there is no index display and search implemented? Or am I
> missing something?
> 
> Laszlo

If we add an index to a doc manually, as in suggestion 1, then it will
be useful even without special "index display" - it will just show as
one of the sections of your document (usually the last one). If you
are trying to find info about some topic, you just look at this
section, find (manually) the topic you need, and click on the provided
link. Much as with printed books.

Of course, having a special index display with help option would be
better. Do you have any estimates how soon it will be implemented in
Nautilus? "after Gnome 1.4" is rather vague...

Best,
Sasha


From laszlo.kovacs@Sun.COM  Mon Feb  5 12:26:45 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id B667D2E27C
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:26:44 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id JAA10958;
	Mon, 5 Feb 2001 09:26:42 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id RAA23772;
	Mon, 5 Feb 2001 17:26:41 GMT
Message-ID: <3A7EE251.5B3BEA08@Sun.COM>
Date: Mon, 05 Feb 2001 17:26:41 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM> <20010205112828.A30010@math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> If we add an index to a doc manually, as in suggestion 1, then it will
> be useful even without special "index display" - it will just show as
> one of the sections of your document (usually the last one). If you
> are trying to find info about some topic, you just look at this
> section, find (manually) the topic you need, and click on the provided
> link. Much as with printed books.
Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
 
> Of course, having a special index display with help option would be
> better. Do you have any estimates how soon it will be implemented in
> Nautilus? "after Gnome 1.4" is rather vague...
All I know right now is that hopefully for the next major Gnome release
after 1.4. Work has not been started yet. But this is very important for
Sun. Just like the Search functionality. I always assumed this will be
done as part of the joint Scrollkeeper/Scrollkeeper-Nautilus Integration
project. I did most of the coding of Scrollkeeper with design mostly
discussed with Dan Mueth and other people. Same on the Scrollkeeper
side, there is an intention that as soon as Gnome 1.4 is released myself
or another Sun engineer will be fully responsible for hyperbola, the
Nautilus component that implements the help sidebar and will implement
the GUI for the Index display and Search also (at least this is how I
see it).

Laszlo


From jfleck@inkstain.net  Mon Feb  5 12:36:32 2001
Return-Path: <jfleck@inkstain.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from jello.inkstain.net (shell.inkstain.net [206.29.130.69])
	by mail.gnome.org (Postfix) with ESMTP id 4A5402D9AF
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:36:32 -0500 (EST)
Received: from jello (mail [206.29.130.67])
	by jello.inkstain.net (8.9.3/8.9.3) with SMTP id JAA22114;
	Mon, 5 Feb 2001 09:27:09 -0800 (PST)
Date: Mon, 5 Feb 2001 09:27:09 -0800 (PST)
From: <jfleck@inkstain.net>
X-Sender: jfleck@jello
To: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <3A7EE251.5B3BEA08@Sun.COM>
Message-ID: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Mon, 5 Feb 2001, Laszlo Kovacs wrote:

> > If we add an index to a doc manually, as in suggestion 1, then it will
> > be useful even without special "index display" - it will just show as
> > one of the sections of your document (usually the last one). If you
> > are trying to find info about some topic, you just look at this
> > section, find (manually) the topic you need, and click on the provided
> > link. Much as with printed books.
> Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
>  

It does not now. I'm looking into what would be required to add the
necessary support.

Cheers,

John



From dan@eazel.com  Mon Feb  5 17:25:13 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.localdomain (unknown [64.37.237.47])
	by mail.gnome.org (Postfix) with ESMTP id EFB912D34F
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 17:25:12 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.localdomain (8.11.0/8.11.0) with ESMTP id f160KqX04045;
	Mon, 5 Feb 2001 16:21:42 -0800
X-Authentication-Warning: foodle.localdomain: dan owned process doing -bs
Date: Mon, 5 Feb 2001 16:20:52 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
X-Sender: dan@foodle.localdomain
To: jfleck@inkstain.net
Cc: Laszlo Kovacs <laszlo.kovacs@Sun.COM>,
	Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
Message-ID: <Pine.LNX.4.21.0102051612330.13847-100000@foodle.localdomain>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, 5 Feb 2001 jfleck@inkstain.net wrote:

> On Mon, 5 Feb 2001, Laszlo Kovacs wrote:
> 
> > > If we add an index to a doc manually, as in suggestion 1, then it will
> > > be useful even without special "index display" - it will just show as
> > > one of the sections of your document (usually the last one). If you
> > > are trying to find info about some topic, you just look at this
> > > section, find (manually) the topic you need, and click on the provided
> > > link. Much as with printed books.
> > Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
> >  
> 
> It does not now. I'm looking into what would be required to add the
> necessary support.

Thanks John. This is something we would eventually like to have in
gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
providing a search feature that searches the index of many documents at
once.

If we really want to have a central index, we might imagine faking
together one (as Sasha suggested), but make it a single document which
acts like an index to the other documents which are core to GNOME.  We
could call it "The GNOME Index" and then put links like:
  cd player -> gtcd
  CPU: monitoring load -> multiload applet
       identifying -> Nautilus hardware view
  Themes: changing -> Control center: Appearance

or whatever.  This is really what the user wants. Of course this would be
a lot of work to do well, especially to do a good job.  It would fit
nicely into gnome-user-docs.

Dan




From Patrick.Costello@ireland.sun.com  Tue Feb  6 02:20:18 2001
Return-Path: <Patrick.Costello@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 9DEA02E3BE
	for <gnome-doc-list@gnome.org>; Tue,  6 Feb 2001 02:20:17 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id XAA00496;
	Mon, 5 Feb 2001 23:20:14 -0800 (PST)
Received: from dbl-ray-3 (dbl-ray-3 [129.156.237.102])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with SMTP id HAA28877;
	Tue, 6 Feb 2001 07:20:14 GMT
Message-Id: <200102060720.HAA28877@ireserver.Ireland.Sun.COM>
Date: Tue, 6 Feb 2001 07:20:14 +0000 (GMT)
From: Pat Costello <Patrick.Costello@ireland.sun.com>
Reply-To: Pat Costello <Patrick.Costello@ireland.sun.com>
Subject: Re: indexing
To: jfleck@inkstain.net, dan@eazel.com
Cc: laszlo.kovacs@Sun.COM, kirillov@math.sunysb.edu,
	gnome-doc-list@gnome.org
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mU6vkHqmlSX8KsPxXlLPhQ==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

All, 

A central index covering Gnome core functions, applications and applets would be 
very handy, especially given the multiplexed nature of the Gnome desktop. At 
first, though, I would suggest a top-level approach to the index so that only 
the main topic headers are flagged, for example the only entry for an applet 
would be the applet header rather than applet actions. In other words, we need 
only put the entry "screen-shooter" into the index and not "screenshots, see 
screen-shooter". This might reduce the amount of work. 

Pat

> 
> On Mon, 5 Feb 2001 Dan Mueth wrote:
 
> Thanks John. This is something we would eventually like to have in
> gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
> providing a search feature that searches the index of many documents at
> once.
> 
> If we really want to have a central index, we might imagine faking
> together one (as Sasha suggested), but make it a single document which
> acts like an index to the other documents which are core to GNOME.  We
> could call it "The GNOME Index" and then put links like:
>   cd player -> gtcd
>   CPU: monitoring load -> multiload applet
>        identifying -> Nautilus hardware view
>   Themes: changing -> Control center: Appearance
> 
> or whatever.  This is really what the user wants. Of course this would be
> a lot of work to do well, especially to do a good job.  It would fit
> nicely into gnome-user-docs.
> 
> Dan
> 
> 
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list



From sarithazan@hotmail.com  Thu Feb  8 06:59:02 2001
Return-Path: <sarithazan@hotmail.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from hotmail.com (oe44.law11.hotmail.com [64.4.16.16])
	by mail.gnome.org (Postfix) with ESMTP id ACAC92BD24
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 06:59:01 -0500 (EST)
Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC;
	 Thu, 8 Feb 2001 03:59:00 -0800
X-Originating-IP: [212.117.152.146]
From: "Sara Hazan" <sarithazan@hotmail.com>
To: <gnome-doc-list@gnome.org>
Subject: problem with configure
Date: Thu, 8 Feb 2001 13:58:11 +0200
MIME-Version: 1.0
Content-Type: multipart/alternative;	boundary="----=_NextPart_000_0005_01C091D7.2C65A930"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.00.2014.211
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2014.211
Message-ID: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
X-OriginalArrivalTime: 08 Feb 2001 11:59:00.0765 (UTC) FILETIME=[863694D0:01C091C6]
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Hi,

After run ./configure I get the follow :

checking for glib-config... no
checking for GLIB - version >=3D 1.2.0... no
*** The glib-config script installed by GLIB could not be found
*** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
*** your path, or set the GLIB_CONFIG environment variable to the
*** full path to glib-config.
configure: error: Test for GLIB failed.  MC requires GLIB.


Please tell me what to do.

Thanks.

Sarit


------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/html;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Diso-8859-1" =
http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2314.1000" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Hi,</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>After run ./configure I get the follow=20
:</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>checking for glib-config... =
no<BR>checking for GLIB=20
- version &gt;=3D 1.2.0... no<BR>*** The glib-config script installed by =
GLIB=20
could not be found<BR>*** If GLIB was installed in PREFIX, make sure =
PREFIX/bin=20
is in<BR>*** your path, or set the GLIB_CONFIG environment variable to=20
the<BR>*** full path to glib-config.<BR>configure: error: Test for GLIB=20
failed.&nbsp; MC requires GLIB.<BR></FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Please tell me what to do.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Thanks.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Sarit</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>&nbsp;</DIV></FONT></BODY></HTML>

------=_NextPart_000_0005_01C091D7.2C65A930--


From laszlo.kovacs@Sun.COM  Thu Feb  8 07:02:04 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 75BD12E7A9
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 07:02:04 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id EAA28398;
	Thu, 8 Feb 2001 04:02:03 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id MAA23602;
	Thu, 8 Feb 2001 12:02:02 GMT
Message-ID: <3A828ABA.96B484AB@Sun.COM>
Date: Thu, 08 Feb 2001 12:02:02 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Sara Hazan <sarithazan@hotmail.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: problem with configure
References: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> Sara Hazan wrote:
> 
> Hi,
> 
> After run ./configure I get the follow :
> 
> checking for glib-config... no
> checking for GLIB - version >= 1.2.0... no
> *** The glib-config script installed by GLIB could not be found
> *** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
> *** your path, or set the GLIB_CONFIG environment variable to the
> *** full path to glib-config.
> configure: error: Test for GLIB failed.  MC requires GLIB.
> 
> Please tell me what to do.
> 
> Thanks.
> 
> Sarit
> 

Two ways:

1. put glib-config in your PATH.
2. Set GLIB_CONFIG to point to where your glib-config is.

Laszlo


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Thu Feb  8 16:56:07 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id F0BE82BB19
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 16:56:06 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14Qz2s-0000mx-00
	for <gnome-doc-list@gnome.org>; Thu, 08 Feb 2001 15:56:06 -0600
Date: Thu, 8 Feb 2001 15:56:06 -0600
From: Eric Baudais <baudais@okstate.edu>
To: GNOME Documentation Project <gnome-doc-list@gnome.org>
Subject: Doc Writers Needed.
Message-ID: <20010208155605.A3008@bubba>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Yes, this is a call out for help.  There are currently 3 gnome-games that 
need docs.  They are:

gnometris
gnotravex
gnotski

If anyone wants to write docs for these apps contact me and/or put you name 
in the doctable under the game.

Eric Baudais


From gleblanc@cu-portland.edu  Sat Feb 10 18:27:21 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 54B8D2D04B
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 18:27:21 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1ANRKt11506
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 15:27:20 -0800
Message-Id: <200102102327.f1ANRKt11506@mail3.aracnet.com>
Subject: [khitam sobh <tami@ca.inter.net>] user guide
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org
Content-Type: multipart/mixed; boundary="=-5p0cBznQ7LiDjmQ3yxfp"
X-Mailer: Evolution (0.8 - Preview Release)
Date: 10 Feb 2001 15:26:04 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Type: text/plain

Oh, it beats me, somebody from the list must know.  :)  Please CC
webmaster@gnome.org on any reply you make.  Thanks,

    Greg

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Disposition: inline
Content-Description: Forwarded message - user guide
Content-Type: message/rfc822

Received: from sweeper.cu-portland.edu (SWEEPER [207.149.56.136]) by 
	email.cu-portland.edu with SMTP (Microsoft Exchange Internet Mail Service 
	Version 5.5.2650.21) id CF9WLFPJ; Sat, 10 Feb 2001 15:05:45 -0800
Received: from mail.gnome.org (unverified) by sweeper.cu-portland.edu 
	(Content Technologies SMTPRS 4.1.5) with ESMTP id 
	<Tcf9538428351a54b8096@sweeper.cu-portland.edu> for 
	<GLeblanc@cu-portland.edu>; Sat, 10 Feb 2001 15:05:39 -0800
Received: from mail.gnome.org (localhost.localdomain [127.0.0.1]) by 
	mail.gnome.org (Postfix) with ESMTP id 343392E22E; Sat, 10 Feb 2001 
	18:05:35 -0500 (EST)
Received: from smtp.total.net (rossine.total.net [154.11.89.167]) by 
	mail.gnome.org (Postfix) with SMTP id B8D9F2D04B for <webmaster@gnome.org>; 
	Sat, 10 Feb 2001 18:03:26 -0500 (EST)
Received: (qmail 941 invoked from network); 10 Feb 2001 23:03:24 -0000
Received: from unknown (HELO tamica) (154.20.8.101) by smtp.total.net with 
	SMTP; 10 Feb 2001 23:03:24 -0000
Delivered-To: gnome-webmaster-list@gnome.org
Message-ID: <000a01c093b5$c35eafa0$6508149a@inter.net>
From: "khitam sobh" <tami@ca.inter.net>
To: <webmaster@gnome.org>
Subject: user guide
Date: Sat, 10 Feb 2001 18:04:02 -0500
MIME-Version: 1.0
Content-Type: multipart/alternative; 
	boundary="----=_NextPart_000_0007_01C0938B.D99483A0"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-webmaster-list-admin@gnome.org
Errors-To: gnome-webmaster-list-admin@gnome.org
X-BeenThere: gnome-webmaster-list@gnome.org
X-Loop: gnome-webmaster-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
Reply-To: webmaster@gnome.org
List-Id: Webmaster mail <gnome-webmaster-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Do you have the gnome user guide in french?
If it is available on the net, where can I get it, thanks.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/html; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>

<META content=3D"MSHTML 5.50.4611.1300" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Do you have the gnome user guide in=20
french?</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>If it is available on the net, where can I=
 get it,=20
thanks.</FONT></DIV></BODY></HTML>

------=_NextPart_000_0007_01C0938B.D99483A0--


--=-5p0cBznQ7LiDjmQ3yxfp--



From Ian@shelob.f9.co.uk  Sun Feb 11 12:57:14 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id A8D5A2D9B7
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 12:57:13 -0500 (EST)
Received: (qmail 11399 invoked from network); 11 Feb 2001 17:57:08 -0000
Received: from unknown (HELO shelob) (212.159.32.178)
  by warrior with SMTP; 11 Feb 2001 17:57:08 -0000
Message-ID: <000401c09454$1ab4e3c0$b2209fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "Eric Baudais" <baudais@okstate.edu>
Cc: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 17:57:29 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"Eric Baudais" <baudais@okstate.edu> wrote:
> On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > How
> > would it be if I did could have something finished by the end
> > of this weekend?  I think I can manage that.
> 
> That would be great!

As promised, I have something finished.
It is not perfect, but it is not bad either.
Please download sgml and pngs from
http://www.shelob.plus.com/freecell/
and let me know what you think.

Regards,
Ian




From hobbit@aloss.ukuu.org.uk  Sun Feb 11 14:41:10 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 214E02BB36
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 14:41:09 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1BJgCA02828;
	Sun, 11 Feb 2001 19:42:12 GMT
Date: Sun, 11 Feb 2001 19:42:12 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: Ian@shelob.f9.co.uk
Subject: Re: Freecell Documentation
Message-ID: <20010211194212.B1727@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>,
	Ian@shelob.f9.co.uk
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 05:57:29PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

Dunno if Ian's on the list, so cc'd for now.

> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Looks great to me. Only quibble: fifty-two instead of fifty two (!)
Would it also be possible to explain that you can right-click on a
card in order to see what it is, if it's obscured by cards on top of
it? 

Oh, I suppose it may be worth noting that you click on cards and then
on destinations. I realise this is standard for Windows Freecell, but
it's different from the behaviour of how you move cards in Aisleriot.
I know Zana was thinking of explicitly describing how to move cards
around in aisleriot, so it makes sense to add how you move 'em for
Freecell, since the two are different and people trying one may try
to use the same method for the other.

Telsa


From Ian@shelob.f9.co.uk  Sun Feb 11 15:44:38 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id 907D82BAB4
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 15:44:37 -0500 (EST)
Received: (qmail 2862 invoked from network); 11 Feb 2001 20:44:33 -0000
Received: from unknown (HELO shelob) (212.159.41.48)
  by warrior with SMTP; 11 Feb 2001 20:44:33 -0000
Message-ID: <007d01c0946b$7e79d8e0$30299fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 20:26:14 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa <hobbit@aloss.ukuu.org.uk> wrote
> On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

> Dunno if Ian's on the list, so cc'd for now.

Actually, I am.  Mostly I lurk.

> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.

> Only quibble: fifty-two instead of fifty two (!)

I believe the latter form to be correct.
Jihad! Jihad! Jihad! :-)

> Would it also be possible to explain that you can right-click on a
> card in order to see what it is, if it's obscured by cards on top of
> it?

Yes it would, although not very soon unfortunately.  I feel all
documented out this evening, and I *really* am busy over the
next fortnight.  (I *may* be inclined to tweak a few things next
weekend, but I may instead prefer to do some gardening.)
How long do we have before 1.4 is due?

> I suppose it may be worth noting that you click on cards and then
> on destinations.

Actually, I did mention that.  In the usage section between
figures 2 and 3, I think.  Possibly the screenshots take up more
room than they are worth and just obscure the text?

Thanks for your comments,
Ian





From gleblanc@cu-portland.edu  Sun Feb 11 17:57:19 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 84D192D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 17:57:18 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1BMvGt26067;
	Sun, 11 Feb 2001 14:57:16 -0800
Message-Id: <200102112257.f1BMvGt26067@mail3.aracnet.com>
Subject: Re: Freecell Documentation
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: jrb@redhat.com, itp@ximian.com, zana@webwynk.net,
	cwryu@adam.kaist.ac.kr
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>
References: <20010208150546.A2912@bubba> 
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>  
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 11 Feb 2001 14:55:59 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> "Eric Baudais" <baudais@okstate.edu> wrote:
> > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > How
> > > would it be if I did could have something finished by the end
> > > of this weekend?  I think I can manage that.
> > 
> > That would be great!
> 
> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Just because I enjoy making trouble...  I don't think that a separate
freecell game will exist in the next major release of gnome-games.
Freecell has been implemented as part of the aisleriot suite, and that
version has a few less bugs (and the bugs it does have can be fixed for
all aisleriot games) than the separate C coded freecell game.  This
isn't a sure thing as far as I know, but it's worth being aware of.
Anybody have a good reason -not- to do this?

    Greg



From jrb@redhat.com  Sun Feb 11 18:22:06 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 9AC622D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:22:06 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1BNMl313635;
	Sun, 11 Feb 2001 18:22:47 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, itp@ximian.com,
	zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba>
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
	<200102112257.f1BMvGt26067@mail3.aracnet.com>
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 11 Feb 2001 18:22:47 -0500
In-Reply-To: Gregory Leblanc's message of "11 Feb 2001 14:55:59 -0800"
Message-ID: <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 29
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Gregory Leblanc <gleblanc@cu-portland.edu> writes:

> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

Kill it!!! Kill it!!!!

*squawk*
-Jonathan


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Sun Feb 11 18:25:28 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id 2A9B72E22A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:25:28 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14S5s1-0003uI-00; Sun, 11 Feb 2001 17:25:29 -0600
Date: Sun, 11 Feb 2001 17:25:29 -0600
From: Eric Baudais <baudais@okstate.edu>
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, jrb@redhat.com,
	itp@ximian.com, zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
Message-ID: <20010211172529.A15008@bubba>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <200102112257.f1BMvGt26067@mail3.aracnet.com>; from gleblanc@cu-portland.edu on Sun, Feb 11, 2001 at 02:55:59PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 02:55:59PM -0800, Gregory Leblanc wrote:
> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

I think that we still need docs for Freecell for this release of Gnome.  
Whether Freecell will continue with Gnome is still to be determined, but 
that doesn't reduce the need for these docs any less.

Eric Baudais


From chris@wilddev.net  Mon Feb 12 02:53:22 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 630A32C887
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 02:53:21 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id AAA26386
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 00:02:54 -0800
Message-Id: <200102120802.AAA26386@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 11 Feb 2001 23:53:47 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All
I'm going to attempt to update the GUG. I had a quick look at what was
there in CVS and it appeared like theres a lot of work. If anyone has
objects/comments let me know. 
I spoke with Sasha and Telsa about it and got their ideas for it. I
think the approach I will take will be to integrate exisitng docs into
it and create an index from the info that is there. This will update it
without unnecessarily duplicating the work of others.

Chris (Wilddev)



From hobbit@aloss.ukuu.org.uk  Mon Feb 12 04:21:38 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id E27952E4A3
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:21:37 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1C9Mev06046
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 09:22:40 GMT
Date: Mon, 12 Feb 2001 09:22:39 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
Message-ID: <20010212092239.A5996@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <007d01c0946b$7e79d8e0$30299fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 08:26:14PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> Telsa <hobbit@aloss.ukuu.org.uk> wrote
> 
> > Only quibble: fifty-two instead of fifty two (!)
> 
> I believe the latter form to be correct.
> Jihad! Jihad! Jihad! :-)

Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
 
> > Would it also be possible to explain that you can right-click on a
> > card in order to see what it is, if it's obscured by cards on top of
> > it?
> 
> Yes it would, although not very soon unfortunately. 

Fair enough.

> How long do we have before 1.4 is due?

According to 
http://mail.gnome.org/archives/gnome-1.4-list/2001-January/msg00027.html
the final hard freeze including docs and translations is on 18th March.
Freeze for everything except docs and translations is the 8th March.
I'll bet that gets superseded now I have mentioned it for posterity.
(There is also a releng (release engineering) module in CVS which has a
bunch of stuff in it, but it does not have these dates.)

> > I suppose it may be worth noting that you click on cards and then
> > on destinations.
> 
> Actually, I did mention that.  In the usage section between

Ahem. So you did. My apologies :) 

Telsa


From rjp@mail.tele.dk  Mon Feb 12 04:51:48 2001
Return-Path: <rjp@mail.tele.dk>
Delivered-To: gnome-doc-list@gnome.org
Received: from cicero2.cybercity.dk (cicero2.cybercity.dk [212.242.40.53])
	by mail.gnome.org (Postfix) with ESMTP id F179D2DC88
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:51:47 -0500 (EST)
Received: from usr00.cybercity.dk (usr00.cybercity.dk [212.242.40.34])
	by cicero2.cybercity.dk (Postfix) with ESMTP
	id EAC85FFFA6; Mon, 12 Feb 2001 10:51:45 +0100 (CET)
Received: from mail.tele.dk (IDENT:rjp@port21.cvx1-hb.ppp.cybercity.dk [212.242.232.22])
	by usr00.cybercity.dk (8.9.3/8.9.3) with ESMTP id KAA13626;
	Mon, 12 Feb 2001 10:51:42 +0100 (CET)
	(envelope-from rjp@mail.tele.dk)
Message-ID: <3A87C105.C79184CC@mail.tele.dk>
Date: Mon, 12 Feb 2001 11:55:01 +0100
From: "Rebecca J. Walter" <rjp@mail.tele.dk>
X-Mailer: Mozilla 4.75 [en] (X11; U; Linux 2.2.16-22 i586)
X-Accept-Language: en, da
MIME-Version: 1.0
To: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob> <20010212092239.A5996@aloss.ukuu.org.uk>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa Gwynne wrote:
> 
> On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> > Telsa <hobbit@aloss.ukuu.org.uk> wrote
> >
> > > Only quibble: fifty-two instead of fifty two (!)
> >
> > I believe the latter form to be correct.
> > Jihad! Jihad! Jihad! :-)
> 
> Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
> 
telsa is correct.


From jfleck@swcp.com  Mon Feb 12 09:01:58 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 064D92E53D
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 09:01:58 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id HAA02052
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 07:00:34 -0700
Date: Mon, 12 Feb 2001 07:00:34 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: GNOME Users Guide
Message-ID: <20010212070034.B1770@inkstain.net>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <200102120802.AAA26386@hub.wilddev.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102120802.AAA26386@hub.wilddev.net>; from Chris Lyttle on Sun, Feb 11, 2001 at 11:53:47PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Chris -
This is great. Thanks.

I'll be happy to assemble the chapter(s) for you on the packages I'm
dealing with - gnome-utils, ggv, and ghex. Let me know when and where
and in what form you'd like things.

John

On Sun, Feb 11, 2001 at 11:53:47PM -0800, Chris Lyttle wrote:
> Hi All
> I'm going to attempt to update the GUG. I had a quick look at what was
> there in CVS and it appeared like theres a lot of work. If anyone has
> objects/comments let me know. 
> I spoke with Sasha and Telsa about it and got their ideas for it. I
> think the approach I will take will be to integrate exisitng docs into
> it and create an index from the info that is there. This will update it
> without unnecessarily duplicating the work of others.
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From federico@ximian.com  Mon Feb 12 10:26:26 2001
Return-Path: <federico@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from guanabana.helixcode.com (unknown [212.209.126.33])
	by mail.gnome.org (Postfix) with ESMTP id 0434C2CDE5
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 10:26:26 -0500 (EST)
Received: (from federico@localhost)
	by guanabana.helixcode.com (8.9.3/8.9.3) id JAA30011;
	Mon, 12 Feb 2001 09:36:26 -0600
Date: Mon, 12 Feb 2001 09:36:26 -0600
Message-Id: <200102121536.JAA30011@guanabana.helixcode.com>
X-Authentication-Warning: guanabana.helixcode.com: federico set sender to federico@ximian.com using -f
From: Federico Mena Quintero <federico@ximian.com>
X-Homer: You're everywhere.  You're omnivorous.
To: jrb@redhat.com
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, zana@webwynk.net
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com> <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

jrb@redhat.com writes:

> Kill it!!! Kill it!!!!

There is only one solitaire, and Aisleriot is its name.

  Federico


From emese@sunserv.itp.hu  Tue Feb 13 06:25:56 2001
Return-Path: <emese@sunserv.itp.hu>
Delivered-To: gnome-doc-list@gnome.org
Received: from gamax.hu (ns.gamax.hu [195.184.11.170])
	by mail.gnome.org (Postfix) with ESMTP id EA26B2E60E
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 06:25:48 -0500 (EST)
Received: by gateway.gamax.hu id <116161>; Tue, 13 Feb 2001 12:29:54 +0100
From: Emese Kovacs <emese@gnome.hu>
To: gnome-doc-list@gnome.org
Subject: Docs updated for GKB in gnome-applets HEAD
Message-Id: <01Feb13.122954cet.116161@gateway.gamax.hu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.4i
Date: Tue, 13 Feb 2001 12:29:50 +0100
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All,

As GKB has been rewritten, we have updated its manual (described new features, 
taken new screenshots). I would like to have it reviewed for gnome-1.4 
compatibility and spelling + other problems.

GKB can be checked out from the gnome CVS, it is located in 
gnome-applets/gkb-new

Thanks,

Emese Kovacs
<emese@gnome.hu>



From jacob@ximian.com  Tue Feb 13 18:01:33 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (ulysses.ximian.com [63.140.225.198])
	by mail.gnome.org (Postfix) with ESMTP
	id 6F8C32CCF8; Tue, 13 Feb 2001 18:01:32 -0500 (EST)
Received: from ulysses ([127.0.0.1])
	by ulysses with smtp (Exim 3.22 #1 (Debian))
	id 14SoLI-0000Bj-00; Tue, 13 Feb 2001 17:54:40 -0500
To: gnome-1.4-list@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
Subject: GNOME 1.4 Weekly Update
From: jacob berkman <jacob@ximian.com>
Date: 13 Feb 2001 17:54:39 -0500
Message-ID: <87zofq8a8g.fsf@ximian.com>
Lines: 51
User-Agent: Gnus/5.0807 (Gnus v5.8.7) XEmacs/21.1 (GTK)
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello fans of The GNOME Project,

This is the first installment of a weekly update on the progress of
the GNOME 1.4 "not yet named" release.  Work on this release is
progressing rapidly, with the first beta release currently scheduled
for this Saturday (February 17).

For package maintainers:

    Maintainers of packages that will be included in this beta *must*
    provide tarballs by the end of Thursday.  Please mail
    gnome-1.4-release-team@gnome.org with information on where to find
    the tarball.

    Anybody who is packaging GNOME packages with documentation in it
    should install scrollkeeper 0.0.5 or later:
    http://sourceforge.net/project/showfiles.php?group_id=3D11543

    Dan will write up instructions on using ScrollKeeper soon.=A0 Keep
    an eye on the news on the GDP web page for an announcement of
    these instructions: http://developer.gnome.org/projects/gdp/

    GNOME 1.4 will use Nautilus' gnome-db2html2 converter to display
    SGML documents.=A0 Please make sure that the SGML documents are
    being installed in addition to the HTML.=A0 Also make sure that the
    SGML is compliant with the 1.4 guidelines:
    http://developer.gnome.org/projects/gdp/changes/

    Also, don't forget to mail gnome-i18n@gnome.org a couple of days
    (which is right now, actually) before making your final tarball
    for the beta.

For i18n and doc people:

    A list of the branches for the different modules being released is
    available in the releng module of GNOME cvs, or from lxr:
    http://cvs.gnome.org/lxr/source/releng/gnome-1.4-branches

    Don't worry if everything isn't done by the first beta :)

For testers:

    The GNOME 1.4 beta process will include a list of tests for many
    of the applications.  This will be made available later this week,
    and more information about this will be made at that time.

That's all for now; more information about the release will be
available later this week.

Thanks,
The GNOME 1.4 Release Team  <gnome-1.4-release-team@gnome.org>



From alan@devserv.devel.redhat.com  Tue Feb 13 18:15:12 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id C39912CCF8; Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1DNFBx01803;
	Tue, 13 Feb 2001 18:15:11 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
In-Reply-To: <87zofq8a8g.fsf@ximian.com> from "jacob berkman" at Feb 13, 2001 05:54:39 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

>     provide tarballs by the end of Thursday.  Please mail
>     gnome-1.4-release-team@gnome.org with information on where to find
>     the tarball.
> 
>     Anybody who is packaging GNOME packages with documentation in it
>     should install scrollkeeper 0.0.5 or later:
>     http://sourceforge.net/project/showfiles.php?group_id=11543

By thursday ? Given 2 days notice. Umm



From mjs@eazel.com  Tue Feb 13 19:18:43 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 66E262BAB4; Tue, 13 Feb 2001 19:18:41 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id QAA01825;
	Tue, 13 Feb 2001 16:16:57 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 13 Feb 2001 16:16:57 -0800
In-Reply-To: Alan Cox's message of "Tue, 13 Feb 2001 18:15:11 -0500 (EST)"
Message-ID: <lqk86u6ruu.fsf@pythagoras.eazel.com>
Lines: 30
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> >     provide tarballs by the end of Thursday.  Please mail
> >     gnome-1.4-release-team@gnome.org with information on where to find
> >     the tarball.
> > 
> >     Anybody who is packaging GNOME packages with documentation in it
> >     should install scrollkeeper 0.0.5 or later:
> >     http://sourceforge.net/project/showfiles.php?group_id=11543
> 
> By thursday ? Given 2 days notice. Umm
> 

This has got to be about the 10th time over the past N weeks that this
deadline has been posted. The most recent before this was on Sunday
when I sent a reminder to many of these same lists to start getting
packages ready. We have posted the full schedule of all the
planned betas and package deadlines many times.

And we have also been personally emailing maintainers of packages in
the main release and reminding them on IRC.

I hope this deadline comes as less of a surprise to most people than
it apparently did to Alan.

And if you miss it, hey, there's always beta 2.

 - Maciej




From chris@wilddev.net  Wed Feb 14 00:40:20 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 12AE52BC15
	for <gnome-doc-list@gnome.org>; Wed, 14 Feb 2001 00:40:20 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id VAA02001;
	Tue, 13 Feb 2001 21:49:32 -0800
Message-Id: <200102140549.VAA02001@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: ian@eazel.com
Cc: gnome-doc-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 13 Feb 2001 21:40:40 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi
I just chatted to muet about the scripts you are writing to automate
taking UG docs from cvs and merging it into chapters for the UG GOOD
JOB!
I'll be attempting to do some work on putting the other bits of it
together this weekend, please let me know when you will have something
ready to test/break so I can try it out and we can feed to each other
the changes being made to it.

Thx
Chris (Wilddev)



From alan@devserv.devel.redhat.com  Wed Feb 14 07:32:03 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id 9255F2BA99; Wed, 14 Feb 2001 07:32:02 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1ECW2515224;
	Wed, 14 Feb 2001 07:32:02 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Wed, 14 Feb 2001 07:32:01 -0500 (EST)
Cc: alan@redhat.com (Alan Cox), gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
In-Reply-To: <lqk86u6ruu.fsf@pythagoras.eazel.com> from "Maciej Stachowiak" at Feb 13, 2001 04:16:57 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> This has got to be about the 10th time over the past N weeks that this
> deadline has been posted. The most recent before this was on Sunday

Im not objecting to the tarballing deadline its the suprise go and instal
0.0.5 of scrollkeeper bit

Alan



From dan@eazel.com  Wed Feb 14 20:58:23 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 29DEB2D368; Wed, 14 Feb 2001 20:58:22 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F1wJd14908;
	Wed, 14 Feb 2001 17:58:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 17:58:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
In-Reply-To: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Message-ID: <Pine.LNX.4.21.0102141747590.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 14 Feb 2001, Alan Cox wrote:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit

Sorry about this.  I wrote this note quickly, hoping to get the full
instructions on the web before the newsletter went out and replace this
text, but didn't get it done in time.
 
You only need to have scrollkeeper installed if the GDP elves have come
along and put OMF files in your package.  Right now, this means
gnome-core, gnome-utils, and soon gnome-applets, gnome-media, and
gnome-user-docs.  If you aren't packaging these few modules, you don't
need to worry about scrollkeeper.

Dan





From Lorna.Whelan@ireland.sun.com  Thu Feb 15 05:20:28 2001
Return-Path: <Lorna.Whelan@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP
	id 78A3D2BE58; Thu, 15 Feb 2001 05:20:27 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id CAA26927;
	Thu, 15 Feb 2001 02:20:25 -0800 (PST)
Received: from dbl-ray-2 (dbl-ray-2 [129.156.237.101])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with SMTP id KAA01118;
	Thu, 15 Feb 2001 10:20:23 GMT
Message-Id: <200102151020.KAA01118@ireserver.Ireland.Sun.COM>
Date: Thu, 15 Feb 2001 10:20:23 +0000 (GMT)
From: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Reply-To: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Subject: Localisation Style Guides
To: gnome-i18n@gnome.org, gnome-doc-list@gnome.org
Cc: lorna.whelan@ireland.sun.com, Aoife.Dunne@ireland.sun.com,
	michael.twomey@ireland.sun.com
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mdUVyT/+Qy+6Uia13lTD4w==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

The localisation Style Guides for the following languages
are ready:


Language		Formats available
--------		-----------------

English			.ps .pdf .mif and FrameMaker
French			.ps .pdf .mif and FrameMaker
German			.ps .pdf .mif and FrameMaker
Spanish			.ps .pdf .mif and FrameMaker
Italian			.ps .pdf .mif and FrameMaker
Swedish			.ps .pdf .mif and FrameMaker
Japanese		software: .html   doc: .ps .pdf and FrameMaker
Korean			.pdf
Simplified Chinese	.pdf
Traditional Chinese	.pdf


The following still needs to be done with the style guides:

- convert or rewrite them into docbook format
- rewrite them to make them more Gnome-friendly - all
  references to Sun need to be changed


I have created a tarball of all the style guides and the size is roughly
6Mb, however, I need someone to take the files and place them under the
Gnome CVS tree and also on an appropriate place on the Gnome web site.
Could someone volunteer to do this?


Regards,
Lorna




 ____________________________________________________

 Lorna Whelan			Tel.:+353-1-8199-029
 European Localisation Centre   Fax: +353-1-8199-261
 Sun Ireland		        
 ____________________________________________________



From dhelder@umich.edu  Tue Feb 13 14:07:43 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id E4D0C2DC27; Tue, 13 Feb 2001 14:07:42 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id OAA02437;
	Tue, 13 Feb 2001 14:07:36 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Tue, 13 Feb 2001 14:07:36 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102131401410.28452-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net



From dusk@ravendusk.org  Tue Feb 13 16:39:04 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 309B72BB40
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 16:39:04 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-6.pconline.com [207.191.143.38])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id PAA29344
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:38:59 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Sn6g-0006mu-00
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:35:30 -0600
Date: Tue, 13 Feb 2001 15:35:30 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Updating API docs
Message-ID: <20010213153530.D431@ravendusk.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,

I'm trying to figure out the best way to move inline API comments into
the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
tool to do it automatically, but after some rooting around, it appears
to only parse through the header files.  Is this correct, or have I
missed something?

Do we have to cut & paste the comments manually from the *.c files
into the *.sgml files?

Thanks,
John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From mjs@eazel.com  Wed Feb 14 18:23:52 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 5876C2D1C4; Wed, 14 Feb 2001 18:23:50 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id PAA06633;
	Wed, 14 Feb 2001 15:22:01 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 14 Feb 2001 15:22:01 -0800
In-Reply-To: Alan Cox's message of "Wed, 14 Feb 2001 07:32:01 -0500 (EST)"
Message-ID: <lqhf1wonom.fsf@pythagoras.eazel.com>
Lines: 15
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit
> 

OK, I agree the scrollkeeper thing should have been communicated
better. However, if you can't get it for beta 1, beta 2 is coming up,
and beta 1 does not have to be perfect (that's why it is a beta).

 - Maciej



From dan@eazel.com  Thu Feb 15 00:47:41 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id AFA942C8A2
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 00:47:40 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F5l3903604;
	Wed, 14 Feb 2001 21:47:03 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 21:47:03 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Chris Lyttle <chris@wilddev.net>
Cc: ian@eazel.com, gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <200102140549.VAA02001@hub.wilddev.net>
Message-ID: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I thought I'd add a bit more info here, in case people are curious what we
have in mind...

The problem with how we have done the GNOME User Guide in the past was
that we did it all by hand.  This meant that not only was it hard to
create, it was very hard to keep up to date and very hard for each of the
translation teams to reproduce.  It was basically impossible for
translators to keep up, since it was so much work.

The new proposed solution is to create some scripts which grab docs from
CVS and merge them together to produce a product similar to what we had in
the past, but to automate much of the work.  Once it is set up, doing it
for another locale or updating it is as simple as running the script.  It
is more up-front work, but should not be too bad for somebody who is good
at scripting.

Ian is working on the script, so if he doesn't run out of time or run into
too many problems, we should have something to work with in not too
long.  Chris is working on this with Ian.  Thanks to both of you.

Dan


On 13 Feb 2001, Chris Lyttle wrote:

> Hi
> I just chatted to muet about the scripts you are writing to automate
> taking UG docs from cvs and merging it into chapters for the UG GOOD
> JOB!
> I'll be attempting to do some work on putting the other bits of it
> together this weekend, please let me know when you will have something
> ready to test/break so I can try it out and we can feed to each other
> the changes being made to it.
> 
> Thx
> Chris (Wilddev)



From dhelder@umich.edu  Thu Feb 15 09:39:12 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id 4E7B52BA99; Thu, 15 Feb 2001 09:39:12 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id JAA29621;
	Thu, 15 Feb 2001 09:39:07 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Thu, 15 Feb 2001 09:39:07 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102150935430.29454-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Strange, I sent this Tuesday and I haven't seen it yet so I'm resending
it.  Sorry if you get this twice.]

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net




From kirillov@peconic.math.sunysb.edu  Thu Feb 15 17:52:38 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 202F92E0A5
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 17:22:07 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id RAA12452;
	Thu, 15 Feb 2001 17:22:00 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id RAA11551;
	Thu, 15 Feb 2001 17:21:59 -0500
Date: Thu, 15 Feb 2001 17:21:59 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
Message-ID: <20010215172159.A11517@math.sunysb.edu>
References: <200102140549.VAA02001@hub.wilddev.net> <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>; from dan@eazel.com on Wed, Feb 14, 2001 at 09:47:03PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

For now, having scripts putting different manulas together is better
than doing it by hand. So I'd be happy if Ian and Chhris make this
happen. 

In the long run, I am not so sure having users guide which is just the
collection of manuals of different components lumped together is a
good idea. Good UG should be more task oriented ("how do I do this in
GNOME") and may omit details or some options which should go
in on-line help (i.e., manuals as we have them now). There was a talk
of writing such a users guide or rather a book for GNOME 2.0 - I think
after 1.4 is out, we should return to this project. 

Sasha
  



On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> 
> I thought I'd add a bit more info here, in case people are curious what we
> have in mind...
> 
> The problem with how we have done the GNOME User Guide in the past was
> that we did it all by hand.  This meant that not only was it hard to
> create, it was very hard to keep up to date and very hard for each of the
> translation teams to reproduce.  It was basically impossible for
> translators to keep up, since it was so much work.
> 
> The new proposed solution is to create some scripts which grab docs from
> CVS and merge them together to produce a product similar to what we had in
> the past, but to automate much of the work.  Once it is set up, doing it
> for another locale or updating it is as simple as running the script.  It
> is more up-front work, but should not be too bad for somebody who is good
> at scripting.
> 
> Ian is working on the script, so if he doesn't run out of time or run into
> too many problems, we should have something to work with in not too
> long.  Chris is working on this with Ian.  Thanks to both of you.
> 
> Dan


From dan@eazel.com  Fri Feb 16 03:09:32 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id BB4DD2E0E5
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:09:08 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G88H514657;
	Fri, 16 Feb 2001 00:08:17 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:08:17 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <20010215172159.A11517@math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


I agree.  This sort of a UG, created by lumping the online help together,
should be retired and replaced by a more carefully crafted document.  
This probably won't happen until GNOME 2.0 (about 12 months from now or
more), although it is possible that we get it out somewhat earlier.  In
the mean time, this UG will satisfy an important need: We can place it
prominantly on the web page, allowing people to learn a lot about GNOME
without even installing Linux or GNOME. It is a also single document which
people can either browse through to learn more about GNOME in general, or
they can use it as a reference document as they do with the online help.

I know at least one person who has printed out the entire GNOME User Guide
and basically read it cover to cover when they started using GNOME and was
generally very happy with having learned GNOME this way.

So, I think in these ways the UG is actually quite valuable in its current
form, even though we tend to deprecate it.  For GNOME 2.0, we probably
want to tailor multiple documents to replace the UG, as Sasha has already
started doing in gnome-user-docs.

Generally, I think we will want to use this task oriented approach more in
our online documents and in the Users Guide.

Dan


On Thu, 15 Feb 2001, Alexander Kirillov wrote:

> For now, having scripts putting different manulas together is better
> than doing it by hand. So I'd be happy if Ian and Chhris make this
> happen. 
> 
> In the long run, I am not so sure having users guide which is just the
> collection of manuals of different components lumped together is a
> good idea. Good UG should be more task oriented ("how do I do this in
> GNOME") and may omit details or some options which should go
> in on-line help (i.e., manuals as we have them now). There was a talk
> of writing such a users guide or rather a book for GNOME 2.0 - I think
> after 1.4 is out, we should return to this project. 
> 
> Sasha
>   
> 
> 
> 
> On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> > 
> > I thought I'd add a bit more info here, in case people are curious what we
> > have in mind...
> > 
> > The problem with how we have done the GNOME User Guide in the past was
> > that we did it all by hand.  This meant that not only was it hard to
> > create, it was very hard to keep up to date and very hard for each of the
> > translation teams to reproduce.  It was basically impossible for
> > translators to keep up, since it was so much work.
> > 
> > The new proposed solution is to create some scripts which grab docs from
> > CVS and merge them together to produce a product similar to what we had in
> > the past, but to automate much of the work.  Once it is set up, doing it
> > for another locale or updating it is as simple as running the script.  It
> > is more up-front work, but should not be too bad for somebody who is good
> > at scripting.
> > 
> > Ian is working on the script, so if he doesn't run out of time or run into
> > too many problems, we should have something to work with in not too
> > long.  Chris is working on this with Ian.  Thanks to both of you.
> > 
> > Dan
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 



From dan@eazel.com  Fri Feb 16 03:33:05 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3CF0A2BB41
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:33:05 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G8X4j14907
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 00:33:04 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:33:04 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: gnome-user-docs and gnome-devel-docs
Message-ID: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

I had two new GNOME modules created in CVS today: gnome-user-docs and
gnome-devel-docs

They are both empty.  My plans are to create and ship just two GNOME
packages which are strictly documentation.  So, we can slowly move over
any good documentation into these modules from their current locations.

There are some packages which will die in the process:
	gnome-users-guide
	gnome-user-faq
	gdp-handbook

Some examples of what these modules will contain:

gnome-user-docs:
	Glossary
	Introduction to GNOME
	Introduction to Linux
	GNOME Users Guide
	GNOME User FAQ
        GNOME Quick Reference
	Joining the GNOME Project
	...

gnome-devel-docs:
	GNOME Developer FAQ
	GDP Handbook
	GTP Handbook
	(any white papers which are up to date)
	(any tutorials which are up to date)
	(any other developer documents which are good and up to date)
	...

Generally speaking, gnome-user-docs would ship with the main GNOME
release, and gnome-devel-docs would be in the extra apps packages since
most people don't need them.

So, I think we generally want to get someone with CVS root access to move
these pieces into place from their current locations in CVS, approving
this of course with anybody who may have co-authored each text so they
don't think their doc dissappeared. 

This is our chance to start with a fresh module, so lets be careful to
keep things tidy and keep the build system working.  Remember the basic
directory layout:

gnome-xxx-docs/<docname>/<locale>/{stuff}
gnome-xxx-docs/<docname>/<locale>/{stuff}/figures/

Also be sure that anything you put in these modules are up to date,
written in DocBook/SGML, and licensed under the FDL and appropriately
state so in their legalnotice.

Dan





From damon@ximian.com  Fri Feb 16 10:20:37 2001
Return-Path: <damon@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail6.svr.pol.co.uk (mail6.svr.pol.co.uk [195.92.193.212])
	by mail.gnome.org (Postfix) with ESMTP id E9BA62E5BC
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 10:20:36 -0500 (EST)
Received: from modem-204.dragonette.dialup.pol.co.uk ([62.137.2.204] helo=ximian.com)
	by mail6.svr.pol.co.uk with esmtp (Exim 3.13 #0)
	id 14TmgU-0007cQ-00; Fri, 16 Feb 2001 15:20:34 +0000
Message-ID: <3A8C4CED.960B7A36@ximian.com>
Date: Thu, 15 Feb 2001 21:41:01 +0000
From: Damon Chaplin <damon@ximian.com>
X-Mailer: Mozilla 4.72 [en] (X11; U; Linux 2.2.14-5.0 i686)
X-Accept-Language: en
MIME-Version: 1.0
To: "John R. Sheets" <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
References: <20010213153530.D431@ravendusk.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"John R. Sheets" wrote:
> 
> Hi,
> 
> I'm trying to figure out the best way to move inline API comments into
> the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
> tool to do it automatically, but after some rooting around, it appears
> to only parse through the header files.  Is this correct, or have I
> missed something?
> 
> Do we have to cut & paste the comments manually from the *.c files
> into the *.sgml files?

You normally just leave the API comments in the source code.
gtkdoc-mkdb merges it into the final SGML documentation, if you pass
it the --source-dir option.

Damon




From kbreit@mediaone.net  Fri Feb 16 17:15:21 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id BFAE62E743
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:15:20 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA03735;
	Fri, 16 Feb 2001 16:06:09 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Help for 1.4 QA
Date: Fri, 16 Feb 2001 16:05:05 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
Cc: battery841@mediaone.net
MIME-Version: 1.0
Message-Id: <01021616050500.03732@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
  I am curious if anyone here would be interested in finding QA problems in 
1.4 dox with me.  I'm looking for help, so if you're looking for a job, you 
have no excuse now (other than if you hate tedium ;)
Kevin
PS. Make sure I am on cc: as my email is flakey
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 17:37:51 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 666B32E906
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:37:51 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA28799;
	Fri, 16 Feb 2001 16:28:35 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: Dan Mueth <dan@eazel.com>, gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
Date: Fri, 16 Feb 2001 16:27:33 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="US-ASCII"
References: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
In-Reply-To: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Message-Id: <01021616273300.28362@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> I had two new GNOME modules created in CVS today: gnome-user-docs and
> gnome-devel-docs
>
> They are both empty.  My plans are to create and ship just two GNOME
> packages which are strictly documentation.  So, we can slowly move over
> any good documentation into these modules from their current locations.
Where should I drop the QA gnumeric spreadsheet for now?
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 19:02:13 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 87FC22D4BB
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 19:02:12 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id RAA01258
	for gnome-doc-list@gnome.org; Fri, 16 Feb 2001 17:53:01 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Dia dox ready to go?
Date: Fri, 16 Feb 2001 17:51:56 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
MIME-Version: 1.0
Message-Id: <01021617515701.21176@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
   Wow, I'm active on this list today!  I would like someone to go read my 
documentation for Dia and let me know if it's ready for prime time.  I'm not 
saying it's DONE, but is it something we feel safe releasing in 1.4 in its 
current state.  This would be _greatly_ appreciated.
Thanks
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From dusk@ravendusk.org  Sat Feb 17 12:13:47 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id C474F2D713
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 12:13:46 -0500 (EST)
Received: from exodus.ravendusk.org (m18-4-2.pconline.com [207.191.143.50])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id LAA06230
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:13:43 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UAwH-000066-00
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:14:29 -0600
Date: Sat, 17 Feb 2001 11:14:29 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010217111429.B355@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <3A8C4CED.960B7A36@ximian.com>; from damon@ximian.com on Thu, Feb 15, 2001 at 09:41:01PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 15, 2001, Damon Chaplin <damon@ximian.com> wrote:
> 
> "John R. Sheets" wrote:
> > 
> > Do we have to cut & paste the comments manually from the *.c files
> > into the *.sgml files?
> 
> You normally just leave the API comments in the source code.
> gtkdoc-mkdb merges it into the final SGML documentation, if you pass
> it the --source-dir option.

Yep, that was exactly the problem with the Bonobo API docs: the
--source-dir parameter was set incorrectly.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From jrb@redhat.com  Sat Feb 17 21:44:02 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id BBE472BD79
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 21:44:02 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1I2jOq10285;
	Sat, 17 Feb 2001 21:45:24 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: gnome-doc-list@gnome.org
Subject: Keyword to bugzilla
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 17 Feb 2001 21:45:24 -0500
Message-ID: <ybm8zn4675n.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 8
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I added a new DOCS_NEEDED keyword to bugzilla today.  The idea behind
it, is that if a bug requires a change in documentation when fixed, or
the bug involves the documentation somehow, you can put the keyword in
to indicate that docs need to be written.  I don't know how useful this
will be, but it's worth a shot.

Thanks,
-Jonathan 


From zfrey@bright.net  Sat Feb 17 22:21:20 2001
Return-Path: <zfrey@bright.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from invictus.bright.net (invictus.bright.net [205.212.123.12])
	by mail.gnome.org (Postfix) with ESMTP id 6F31E2BB7B
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 22:21:20 -0500 (EST)
Received: from arch-cas3-cs-35.dial.bright.net ([216.201.22.139])
          by invictus.bright.net with ESMTP
          id <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>;
          Sat, 17 Feb 2001 22:21:19 -0500
Subject: Re: Updating API docs
From: Zach Frey <zfrey@bright.net>
To: John "R." Sheets <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
In-Reply-To: <20010217111429.B355@ravendusk.org>
References: <20010213153530.D431@ravendusk.org>
	<3A8C4CED.960B7A36@ximian.com>  <20010217111429.B355@ravendusk.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.17.08.59 - Preview Release)
Date: 17 Feb 2001 22:25:47 +0000
Mime-Version: 1.0
Message-Id: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:

> Yep, that was exactly the problem with the Bonobo API docs: the
> --source-dir parameter was set incorrectly.


Er, oops, that sounds like my mistake.  Sorry about that.

Now that I see what you did, was the problem that it was broken for
srcdir != builddir?  


Thanks,

Zach





From barreiro@arrakis.es  Sun Feb 18 04:45:15 2001
Return-Path: <barreiro@arrakis.es>
Delivered-To: gnome-doc-list@gnome.org
Received: from correo.madritel.es (unknown [213.37.2.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 0B2F52BD32; Sun, 18 Feb 2001 04:45:15 -0500 (EST)
Received: from pc-int-2.arrakis.es ([213.37.13.136]) by correo.madritel.es
          (Netscape Messaging Server 3.5)  with ESMTP id AAA3F81;
          Sun, 18 Feb 2001 10:42:58 +0100
Content-Length: 691
Message-ID: <XFMail.20010218115129.barreiro@arrakis.es>
X-Mailer: XFMail 1.4.4 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <3A2FA437.E663AF05@ireland.sun.com>
Date: Sun, 18 Feb 2001 11:51:29 +0100 (MET)
Reply-To: barreiro@arrakis.es
Organization: linux landia
From: barreiro@arrakis.es
To: Michael Twomey <michael.twomey@ireland.sun.com>
Subject: Re: Update on Localisation Style Guides and Glossaries
Cc: Gnome Doc List <gnome-doc-list@gnome.org>, ,
	Gnome Doc List <gnome-doc-list@gnome.org>,
	"gnome-i18n@gnome.org" <gnome-i18n@gnome.org>,
	Gregory Leblanc <gleblanc@cu-portland.edu>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 07-Dec-2000 Michael Twomey wrote:
> Gregory Leblanc wrote:
>> 
> 
> Hi,
>       I've sent the glossary to Greg so he should have it up in somewhere
> like gnome-i18n/glossary soon.
> 
> Greg, can I mail you the style guides as well? They are a hefty 4MB
> tarball. Or does someone else want to take them?
> 
> thanks Greg,
>       Michael
>
Hi,

I looked for style guides at Gnome-i18n and gnome-docu but not found it.

Could you tell me where get the Spanish copy?

Regards.


Manuel de Vega Barreiro. barreiro@arrakis.es   En un lugar de la red
Madrid. Espaņa. usuario: 62.146                de cuyo nombre no quiero
http://www.croftj.net/~barreiro Linux Landia   acordarme..........



From dan@eazel.com  Sun Feb 18 04:50:22 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id D0AAD2DD1E
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 04:50:21 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1I9oJ731916;
	Sun, 18 Feb 2001 01:50:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Sun, 18 Feb 2001 01:50:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Kevin Breit <battery841@mediaone.net>
Cc: gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
In-Reply-To: <01021616273300.28362@7of9>
Message-ID: <Pine.LNX.4.21.0102180148100.31875-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Fri, 16 Feb 2001, Kevin Breit wrote:

> On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> > I had two new GNOME modules created in CVS today: gnome-user-docs and
> > gnome-devel-docs
> >
> > They are both empty.  My plans are to create and ship just two GNOME
> > packages which are strictly documentation.  So, we can slowly move over
> > any good documentation into these modules from their current locations.
> Where should I drop the QA gnumeric spreadsheet for now?
> Kevin
> 

These are GDP-related documents which we do not plan to ship, so I would
put them in a new directory at: gnome-docu/gdp/qa/

Things in gnome-user-docs and gnome-devel-docs will only be up-to-date
documents which we plan on shipping in these packages.

Dan



From dusk@ravendusk.org  Sun Feb 18 11:18:32 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 39DFF2BD2D
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 11:18:32 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-11.pconline.com [207.191.143.43])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id KAA13568
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:17 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UWY0-0000Cj-00
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:52 -0600
Date: Sun, 18 Feb 2001 10:18:52 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010218101852.B434@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com> <20010217111429.B355@ravendusk.org> <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>; from zfrey@bright.net on Sat, Feb 17, 2001 at 10:25:47PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 17, 2001, Zach Frey <zfrey@bright.net> wrote:
> 
> On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:
> 
> > Yep, that was exactly the problem with the Bonobo API docs: the
> > --source-dir parameter was set incorrectly.
> 
> Er, oops, that sounds like my mistake.  Sorry about that.

Actually, I think it was Michael Meeks, in revision 1.3 of
Makefile.am, amid a flurry of other changes.  (c;

> Now that I see what you did, was the problem that it was broken for
> srcdir != builddir?  

No, it didn't find the source files at all, even with srcdir ==
builddir.  Didn't go far enough towards the root dir.  Should have
been '../..' rather than '..'.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From erik@core.com  Sun Feb 18 15:20:13 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id D27C92BAAF
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 15:19:37 -0500 (EST)
Received: from core.com (tnt17a-242.focal-chi.corecomm.net [208.40.16.242])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1IKLI545961;
	Sun, 18 Feb 2001 20:21:38 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1IKR2708990;
	Sun, 18 Feb 2001 14:27:02 -0600
Date: Sun, 18 Feb 2001 14:27:02 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: Dan Mueth <dan@eazel.com>
Cc: gnome-doc-list@gnome.org
Subject: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010218142702.L12018@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>; from "dan@eazel.com on Fri, Feb 16, 2001 at 12:08:17AM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Is there any interest in having any of the user or developer docs
recorded? I'm thinking audio books, or even inserting <audioobject> and
<audiodata> tags into the docs themselves. 

All I will need is someone with a good voice to volunteer. (I have a small
studio setup near Chicago.)  

Erik
-- 
All music aspires to the condition of muzak.


From kbreit@mediaone.net  Sun Feb 18 17:14:59 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 4A4CC2CE26
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 17:14:58 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA32529
	for gnome-doc-list@gnome.org; Sun, 18 Feb 2001 16:05:48 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Date: Sun, 18 Feb 2001 15:16:58 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="us-ascii"
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net>
In-Reply-To: <20010218142702.L12018@megsinet.net>
MIME-Version: 1.0
Message-Id: <01021815165800.10931@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> Is there any interest in having any of the user or developer docs
> recorded? I'm thinking audio books, or even inserting <audioobject> and
> <audiodata> tags into the docs themselves.
>
> All I will need is someone with a good voice to volunteer. (I have a small
> studio setup near Chicago.)
That'd be interesting.  It would be best to have it in mp3 format.  If you 
wanted, and we got this rolling soon enough, I could do some voice stuff 
since I live in the Chicago burbs.
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From hobbit@aloss.ukuu.org.uk  Mon Feb 19 17:51:32 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 1959C2BE06
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 17:51:30 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1JMqGW32596
	for gnome-doc-list@gnome.org; Mon, 19 Feb 2001 22:52:16 GMT
Date: Mon, 19 Feb 2001 22:52:16 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010219225216.B32130@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Various people on this list at times have expressed interest in gtkdoc.
I have been trying to find info on it. I can't find much. What I have
is here, because I keep missing people on IRC. And it gets into the
archives here. And I don't know any more than this, so please don't
email me Hard Questions!

Apparently the major problem is that it's a complete sod to install.
If you can't find a nice rpm/deb of it, you're in for pain. Gnome
apparently has its own little something-doc which is a script by
Michael Zucchi and is in CVS. That is what the kernel folks used
as a basis for 'kernel-doc', which is just a script in perl. The
only feature that it is missing which gtkdoc has is something to 
do with classes.

kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
in /linux/scripts. 

On the matter of "how to use the thing once it's installed", it's
the same for kernel-doc and gtk-doc, and so here are the instructions
for kernel-doc on the basis that it might be a quick-start for
gtk-doc: 

----- Forwarded message from Alan Cox <alan@lxorguk.ukuu.org.uk> -----

To: hobbit@aloss.ukuu.org.uk
Subject: Kernel-doc^2
From: Alan Cox <alan@lxorguk.ukuu.org.uk>
Date: Mon, 19 Feb 2001 18:03:42 +0000

Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
so the section on that is relevant and included..


How to add extractable documentation to your source files
---------------------------------------------------------

The format of the block comment is like this:

/**
 * function_name(:)? (- short description)?
(* @parameterx: (description of parameter x)?)*
(* a blank line)?
 * (Description:)? (Description of function)?
 * (section header: (section description)? )*
(*)?*/

The short function description cannot be multiline, but the other
descriptions can be.

All descriptive text is further processed, scanning for the following special
patterns, which are highlighted appropriately.

'funcname()' - function
'$ENVVAR' - environment variable
'&struct_name' - name of a structure (up to two words including 'struct')
'@parameter' - name of a parameter
'%CONST' - name of a constant.

Take a look around the source tree for examples.


Tim.
*/ <twaugh@redhat.com>

----- End forwarded message -----


From otaylor@redhat.com  Mon Feb 19 22:33:06 2001
Return-Path: <otaylor@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from fresnel.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 73CD42CC78
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 22:33:06 -0500 (EST)
Received: by fresnel.labs.redhat.com (Postfix, from userid 2181)
	id CDFB8241BC6; Mon, 19 Feb 2001 22:33:05 -0500 (EST)
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
References: <20010219225216.B32130@aloss.ukuu.org.uk>
From: Owen Taylor <otaylor@redhat.com>
Date: 19 Feb 2001 22:33:05 -0500
In-Reply-To: Telsa Gwynne's message of "Mon, 19 Feb 2001 22:52:16 +0000"
Message-ID: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Lines: 129
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Actually, gtk-doc goes a lot beyond simply parsing the 
function doc comments. (And in fact, it didn't originally
do that at all!)

Among other things, it:

 - Knows about the GTK+ object system - object heirarchies,
   signals, properties, etc.

 - Parses header files to find out about typedefs,
   
 - Integrates documentation from template files with
   the parsed header files.

   (This one of the distinguishing characteristics of gtk-doc - 
   it doesn't try to put all documentation inline - just
   the parts that make sense.)

There is a fair bit of information the doc/ directory
of gtk-doc/. Trevor Curtis is apparently also doing some
work on doing GDP-style documentation, though I don't
know how far he's gotten with that.


As far as installation, gtk-doc is wonderously easy to install.  There
is a RPM of it in the RH rawhide tree, though it's a bit out of date,
but it's also just a simple:

 ./configure ; make install

out of CVS. The thing about gtk-doc is:

 - It's a tool for GTK+/GNOME programmers to do docs for other
   programmers, so the docs for gtk-doc assume a lot of 
   knowledge about programming.

 - It's a real pain to set it up to document a library. I mean, a
   major pain.  Hard. Involves creating a number of files with magic
   contents, and then knowing more about make than you ever wanted to
   know.

   I've gone out on a limb and made the statement that the reference
   doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
   are just about perfect. They are also meant to be easy to modify
   without having to change the scary parts.  So, they may be worth
   copying.

   But I wish I knew how we could make it easier to set up.

   More documentation helps, but it there are just too many files to
   juggle, and it shouldn't take 200 lines of Makefile boilerplate.

Once it's been set up. It's not bad to use - you just
either edit the pseudo-sgml files in the tmpl/ directory or
you edit the inline function headers. But the set up is
the killer.

(Perhaps we need to create a gtkdocize script, like libtoolize
and gettextize.)

Regards,
                                        Owen


Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:

> Various people on this list at times have expressed interest in gtkdoc.
> I have been trying to find info on it. I can't find much. What I have
> is here, because I keep missing people on IRC. And it gets into the
> archives here. And I don't know any more than this, so please don't
> email me Hard Questions!
 
> Apparently the major problem is that it's a complete sod to install.
> If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> apparently has its own little something-doc which is a script by
> Michael Zucchi and is in CVS. That is what the kernel folks used
> as a basis for 'kernel-doc', which is just a script in perl. The
> only feature that it is missing which gtkdoc has is something to 
> do with classes.
> 
> kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> in /linux/scripts. 
> 
> On the matter of "how to use the thing once it's installed", it's
> the same for kernel-doc and gtk-doc, and so here are the instructions
> for kernel-doc on the basis that it might be a quick-start for
> gtk-doc: 
> 
> From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> Subject: Kernel-doc^2
> To: hobbit@aloss.ukuu.org.uk
> Date: Mon, 19 Feb 2001 18:03:42 +0000
> 
> 
> Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
> so the section on that is relevant and included..
> 
> 
> How to add extractable documentation to your source files
> ---------------------------------------------------------
> 
> The format of the block comment is like this:
> 
> /**
>  * function_name(:)? (- short description)?
> (* @parameterx: (description of parameter x)?)*
> (* a blank line)?
>  * (Description:)? (Description of function)?
>  * (section header: (section description)? )*
> (*)?*/
> 
> The short function description cannot be multiline, but the other
> descriptions can be.
> 
> All descriptive text is further processed, scanning for the following special
> patterns, which are highlighted appropriately.
> 
> 'funcname()' - function
> '$ENVVAR' - environment variable
> '&struct_name' - name of a structure (up to two words including 'struct')
> '@parameter' - name of a parameter
> '%CONST' - name of a constant.
> 
> Take a look around the source tree for examples.
> 
> 
> Tim.
> */ <twaugh@redhat.com>


From rob@funky-penguin.co.uk  Tue Feb 20 06:57:39 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id E5EB72BA99
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 06:57:38 -0500 (EST)
Received: from [213.123.15.171] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14VBQH-00050M-00
	for gnome-doc-list@gnome.org; Tue, 20 Feb 2001 11:57:37 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14VBTG-0001Uu-00
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 12:00:42 +0000
Date: Tue, 20 Feb 2001 12:00:41 +0000
To: gnome-doc-list@gnome.org
Subject: Intent to package Gnotravex, Gnometris, gnobotsII
Message-ID: <20010220120041.A5755@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I regularly play these three so will volunteer to do them. And i'll get an
initial draft of one of these up by this evening.

I'll modify the doctable as soon as soon as i find out my username and
password.

rob
-- 
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet


From trevor.curtis@home.com  Tue Feb 20 13:08:11 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id D10E92BA85
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 13:08:10 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010220180742.EWJZ12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 10:07:42 -0800
Date: Tue, 20 Feb 2001 13:09:35 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010220130935.A1152@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
X-Operating-System: Linux frink.thesimpsons.ca 2.4.1
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hey all,

I joined the gdp a few weeks ago.  When Dan Mueth and I originally
spoke, we had agreed that I was to continue the gtk-doc
manual.  The problem however, was that I had little experience with
things such as cvs, autoconf, automake, and the like.  So I've
temporarily put the gtk-doc manual on hold, whilst I learn the above
by doing other smaller projects.

All this to say that this lack of documentation for gtk-doc is an
issue that is trying to be addressed.  Unfortunately, until I learn
more about the subject, and the other bits of knowledge that I must
aquire to complete this job, it may be some time before I'm able to
complete the manual.

If anyone has ideas or just wants to look at was is already there, it
is available in cvs.  

regards,

On Mon, Feb 19, 2001 at 10:33:05PM -0500, Owen Taylor wrote:
> To: gnome-doc-list@gnome.org
> Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
> From: Owen Taylor <otaylor@redhat.com>
> Date: 19 Feb 2001 22:33:05 -0500
> 
> 
> Actually, gtk-doc goes a lot beyond simply parsing the 
> function doc comments. (And in fact, it didn't originally
> do that at all!)
> 
> Among other things, it:
> 
>  - Knows about the GTK+ object system - object heirarchies,
>    signals, properties, etc.
> 
>  - Parses header files to find out about typedefs,
>    
>  - Integrates documentation from template files with
>    the parsed header files.
> 
>    (This one of the distinguishing characteristics of gtk-doc - 
>    it doesn't try to put all documentation inline - just
>    the parts that make sense.)
> 
> There is a fair bit of information the doc/ directory
> of gtk-doc/. Trevor Curtis is apparently also doing some
> work on doing GDP-style documentation, though I don't
> know how far he's gotten with that.
> 
> 
> As far as installation, gtk-doc is wonderously easy to install.  There
> is a RPM of it in the RH rawhide tree, though it's a bit out of date,
> but it's also just a simple:
> 
>  ./configure ; make install
> 
> out of CVS. The thing about gtk-doc is:
> 
>  - It's a tool for GTK+/GNOME programmers to do docs for other
>    programmers, so the docs for gtk-doc assume a lot of 
>    knowledge about programming.
> 
>  - It's a real pain to set it up to document a library. I mean, a
>    major pain.  Hard. Involves creating a number of files with magic
>    contents, and then knowing more about make than you ever wanted to
>    know.
> 
>    I've gone out on a limb and made the statement that the reference
>    doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
>    are just about perfect. They are also meant to be easy to modify
>    without having to change the scary parts.  So, they may be worth
>    copying.
> 
>    But I wish I knew how we could make it easier to set up.
> 
>    More documentation helps, but it there are just too many files to
>    juggle, and it shouldn't take 200 lines of Makefile boilerplate.
> 
> Once it's been set up. It's not bad to use - you just
> either edit the pseudo-sgml files in the tmpl/ directory or
> you edit the inline function headers. But the set up is
> the killer.
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)
> 
> Regards,
>                                         Owen
> 
> 
> Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:
> 
> > Various people on this list at times have expressed interest in gtkdoc.
> > I have been trying to find info on it. I can't find much. What I have
> > is here, because I keep missing people on IRC. And it gets into the
> > archives here. And I don't know any more than this, so please don't
> > email me Hard Questions!
>  
> > Apparently the major problem is that it's a complete sod to install.
> > If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> > apparently has its own little something-doc which is a script by
> > Michael Zucchi and is in CVS. That is what the kernel folks used
> > as a basis for 'kernel-doc', which is just a script in perl. The
> > only feature that it is missing which gtkdoc has is something to 
> > do with classes.
> > 
> > kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> > in /linux/scripts. 
> > 
> > On the matter of "how to use the thing once it's installed", it's
> > the same for kernel-doc and gtk-doc, and so here are the instructions
> > for kernel-doc on the basis that it might be a quick-start for
> > gtk-doc: 
> > 
> > From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> > Subject: Kernel-do


From glynn.foster@Sun.COM  Wed Feb 21 11:58:29 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id D02252E0B0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 11:58:28 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id IAA11518
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 08:58:27 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id QAA09744
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 16:58:23 GMT
Message-ID: <3A93F3E0.C56F6F45@Sun.COM>
Date: Wed, 21 Feb 2001 16:59:12 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Session capplet documentation
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Heya,
Just recently I was working on a multisession hack for gnome-session
which is pretty much finished and in for the GNOME1.4 release. The 
hack involved changing the capplet code and, as a result, the structure 
of the 'Startup Programs' gui.
I was checking through the documentation for the control-center and 
realised that some of it needs to be rewritten for 1.4 [different 
screenshots, added functionality]
I think I identified it to the following cvs module -

		desktop-docs/gnomecc.sgml

I would be quite happy to document some of the changes but being a 
mere insignificant software developer I thought I'd ask first and
find out the proccess for this.

			Thanks,
				Glynn ;)


-- 
Glynn Foster				Email: glynn.foster@ireland.sun.com
Desktop Apps & MiddleWare		Tel:   +353 - 1 - 8199782
Sun Microsystems Ireland Ltd.           Generation dot-COM        i||c Gman


From dusk@ravendusk.org  Wed Feb 21 13:29:00 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id B14222E211
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 13:28:59 -0500 (EST)
Received: from exodus.ravendusk.org (m18-6-16.pconline.com [207.191.143.96])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id MAA25803
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:28:56 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Ve1A-0000Mo-00
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:29:36 -0600
Date: Wed, 21 Feb 2001 12:29:36 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010221122936.D475@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 19, 2001, Owen Taylor <otaylor@redhat.com> wrote:
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)

Oooh, I like the sound of that.  Wonder how much of the setup is
automatable...?

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From kirillov@math.sunysb.edu  Wed Feb 21 14:11:08 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 812AD2E0F0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:08 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id OAA01184
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:07 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id OAA05760;
	Wed, 21 Feb 2001 14:11:07 -0500
Date: Wed, 21 Feb 2001 14:11:07 -0500
Message-Id: <200102211911.OAA05760@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,
I am currently maintaining the documentation for control-center
(btw, it is located at
control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Probably the easiest way would be if you just send me the patch to the
existing file, and I'll check it into CVS. Or you can send me the list
of changes and I'll modify the doc myself - whatever you prefer.

Is this new functionality in gnome-14.beta1? If so, I can take the
screenshots myself (I plan to install beta1 later today).

Best,
Sasha

On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> Heya,
> Just recently I was working on a multisession hack for gnome-session
> which is pretty much finished and in for the GNOME1.4 release. The 
> hack involved changing the capplet code and, as a result, the structure 
> of the 'Startup Programs' gui.
> I was checking through the documentation for the control-center and 
> realised that some of it needs to be rewritten for 1.4 [different 
> screenshots, added functionality]
> I think I identified it to the following cvs module -
> 
>               desktop-docs/gnomecc.sgml
> 
> I would be quite happy to document some of the changes but being a 
> mere insignificant software developer I thought I'd ask first and
> find out the proccess for this.
> 
>                       Thanks,
>                               Glynn ;)
> 


From glynn.foster@Sun.COM  Wed Feb 21 14:29:42 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id D693F2BB47
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:29:41 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id LAA02853;
	Wed, 21 Feb 2001 11:29:39 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id TAA01032;
	Wed, 21 Feb 2001 19:29:27 GMT
Message-ID: <3A941749.21CC4F81@Sun.COM>
Date: Wed, 21 Feb 2001 19:30:17 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
References: <200102211911.OAA05760@copiague.math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Apologies if you are receiving this more than once...must have 
screwed up sending it the first time :/ ]


Heya Sasha,

> Hi,
> I am currently maintaining the documentation for control-center
> (btw, it is located at
> control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Yeah, that was pointed out to me this afternoon...for some reason
the documentation hasn't been transferred over to HEAD yet.

> Probably the easiest way would be if you just send me the patch to the
> existing file, and I'll check it into CVS. Or you can send me the list
> of changes and I'll modify the doc myself - whatever you prefer.

I'm easy about this...What might be the best solution, is for me to send
over a patch to the existing file and you can edit it as you see fit.
I'm no documentation wizard ;)

> Is this new functionality in gnome-14.beta1? If so, I can take the
> screenshots myself (I plan to install beta1 later today).

Yes this is new functionality in beta1.
I've taken screenshots already :) but you can take your own if you wish...
The ones I've taken are at
http://www.geocities.com/gmansundude/gccsessopt.png
http://www.geocities.com/gmansundude/gccstartup.png

[but I'm actually not sure of the quality - just looking at them a minute
ago].

I'll get the patches done pretty soon.
                
                Many thanks,
                        Glynn ;)

> 
> Best,
> Sasha
> 
> On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> > Heya,
> > Just recently I was working on a multisession hack for gnome-session
> > which is pretty much finished and in for the GNOME1.4 release. The
> > hack involved changing the capplet code and, as a result, the structure
> > of the 'Startup Programs' gui.
> > I was checking through the documentation for the control-center and
> > realised that some of it needs to be rewritten for 1.4 [different
> > screenshots, added functionality]
> > I think I identified it to the following cvs module -
> >
> >               desktop-docs/gnomecc.sgml
> >
> > I would be quite happy to document some of the changes but being a
> > mere insignificant software developer I thought I'd ask first and
> > find out the proccess for this.
> >
> >                       Thanks,
> >                               Glynn ;)
> >


From kirillov@math.sunysb.edu  Wed Feb 21 15:57:20 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id E5F202BB41
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:19 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id PAA02713
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:18 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id PAA13250;
	Wed, 21 Feb 2001 15:57:18 -0500
Date: Wed, 21 Feb 2001 15:57:18 -0500
Message-Id: <200102212057.PAA13250@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: scrollkeeper and gnome 1.4
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi guys:

I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
surprise, no OMF files were installed at all: /usr/share/omf contains
scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
wrong with the packages - could you (or someone else) look into this? 

Sasha


From dan@eazel.com  Thu Feb 22 06:34:00 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id EDD532BA83
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:33:59 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBXJ822189;
	Thu, 22 Feb 2001 03:33:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:33:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
Subject: Re: scrollkeeper and gnome 1.4
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 21 Feb 2001, Alexander Kirillov wrote:

> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 

This doesn't entirely surprise me.  We were working on getting this done
right around the package deadline for GNOME 1.4 beta1, so I suspect the
packages were submitted before we added the OMF metadata.  I have spoken
with Jacob, who does a lot of the packaging work at Ximian, about how the
OMF and ScrollKeeper integration works, so he knows how to make things
work.  I even gave him my spec file for gnome-core (which I originally
took from him and then modified).  So, my guess is we just missed the
deadline for when they took their beta1 snapshot.  I expect things to work
for beta2, although it is a good idea to double-check this.

Jacob - could you comment?

Dan



From dan@eazel.com  Thu Feb 22 06:49:01 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 32B6D2E032
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:49:00 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBmxQ22325
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 03:48:59 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:48:59 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: Finished docs
Message-ID: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everybody,

Since we are approaching the GNOME 1.4 release, I have decided to start
producing a weekly list of documents which are completely Done(TM) to send
to the translators for translation.  

By Done, I mean:

0) It is decent. ie. It is worth translating.  Basically this means it is
not obsolete or mostly filled with FIXME's.

1) It is finished, as far as GNOME 1.4 is concerned.  ie. It may not be
perfect or even complete, but it will not experience any more changes
before GNOME 1.4 except for major bug fixes. (eg. it states something
which is false or doesn't render properly in Nautilus)

2) It follows the 1.4 doc
guidelines: http://developer.gnome.org/projects/gdp/changes/

3) It has gone through a simple test in Nautilus to make sure each page
renders properly.

4) The screenshots are finished, or at least won't change much

5) Hopefully it actually builds and installs fine with the package it
belongs too.

#0 through #2 are crucial.  If possible, satisfy #3 through #5 too.  If
you need help testing it in Nautilus, email this list or ask around on
#docs to find somebody with a working Nautilus.

Please email me with a list of documents which you feel are Done(TM) each
Thursday, and I'll compile the list and send it to gnome-i18n-list each
Friday so that the translators can have a fun-filled weekend of
translations each week :)

Dan



From glynn.foster@Sun.COM  Thu Feb 22 08:44:34 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 2B13E2CC04
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:44:34 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id FAA00862;
	Thu, 22 Feb 2001 05:44:29 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id NAA12515;
	Thu, 22 Feb 2001 13:44:24 GMT
Message-ID: <3A9517EB.FB6CCA0A@Sun.COM>
Date: Thu, 22 Feb 2001 13:45:15 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: kirillov@math.sunysb.edu, gnome-doc-list@gnome.org
Subject: Session capplet doc diff
Content-Type: multipart/mixed;
 boundary="------------1CCC036EA35DA3B43F0F89A4"
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Hi Sasha,
Here is the diff for control-center/docs/C/gnomecc.sgml Hope this is okay..
I'm cc'ing gnome-doc-list in case anyone has any feedback...
I've included the extra figures [from the links on my previous email] but
if you want to take better screenshots, feel free.

			Glynn :)
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii;
 name="sessiondoc.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="sessiondoc.diff"

Index: gnomecc.sgml
===================================================================
RCS file: /cvs/gnome/control-center/doc/C/Attic/gnomecc.sgml,v
retrieving revision 1.1.2.5
diff -u -r1.1.2.5 gnomecc.sgml
--- gnomecc.sgml	2001/02/12 17:00:25	1.1.2.5
+++ gnomecc.sgml	2001/02/22 13:39:38
@@ -884,8 +884,8 @@
       <title>Session</title>
     <para>
       The Session Group provides you methods of controlling various items that
-      occur with the startup of your GNOME Session. These include startup
-      programs and startup hints.
+      occur with the startup of your GNOME Session. These include session options,
+      startup programs and startup hints.
     </para>
     <sect2 id="startup-hints">
       <title>Startup Hints</title>
@@ -927,40 +927,36 @@
       </figure>
     </sect2>
     <sect2 id="startup-progs">
-      <title>Startup Programs</title>
+      <title>Session Options & Startup Programs</title>
       <para>
-	Startup Programs capplet allows you control what applications
-	are started at login. By default, GNOME
-	starts some default programs, such as File Manager (necessary
-	for functioning of the desktop), Panel and all applets in it,
-	and some other supporting programs. But it can do more than
-	that. 
+        The Session Options & Startup Programs capplet allows you to
+        control your session. GNOME has the concept of session 
+        management. In simple terms, it means that you can save your
+        <quote>session</quote> (that is, information about currently
+        working applications, their status and position on the screen)
+        at any stage, and at your next login the same applications will
+        reappear on your screen in the same positions, allowing you to 
+        continue your work. Note, however, this only works for GNOME 
+        compliant applications. By default, GNOME starts some default
+        programs, such as File Manager (necessary for functioning of
+        the desktop), Panel and all applets in it, and some other 
+        supporting programs. But it can do much more than that.
       </para>
       <para> 
-	First, GNOME has the concept of session management. In simple
-	terms, it means that you can save your <quote>session</quote>
-	(that is, information about currently working applications,
-	their status and position on screen) at logout and at your next
-	login the same applications will reappear on your screen in
-	the same positions, allowing you to continue your
-	work. Note, however, that this  only works for GNOME
-	applications. 
-      </para>
-      <para> 
 	GNOME also provides another way of starting applications at
-	login. You can explicitly specify one or more  commands to
+	login. You can explicitly specify one or more commands to
 	run, and GNOME will execute them at login. This works for all
-	kinds of applications, whether GNOME compatible or not.  
+	kinds of applications, whether GNOME compliant or not.  
       </para>
       <para> 
-	Startup Programs capplet allows you to configure all of these
-	options, as described below. 
+	Session Options & Startup Programs capplet allows you to configure 
+	all of these options, as described below. 
       </para>
       <figure>
-	<title>Startup Programs Capplet</title>
+	<title>Session Options Capplet</title>
 	<screenshot>
-	  <screeninfo>Startup Programs Capplet</screeninfo>
-	  <graphic format="png" fileref="./figs/gccstartup" srccredit="dcm">
+	  <screeninfo>Session Options Capplet</screeninfo>
+	  <graphic format="png" fileref="./figs/gccsessopt" srccredit="gman">
 	  </graphic>
 	</screenshot>
       </figure>
@@ -979,13 +975,13 @@
 	    <guilabel>Prompt on logout</guilabel> &mdash; If this
 	    option is enabled, a confirmation dialog will appear at
 	    logout. Among other things, this dialog asks you if you
-	    want to save the current session. If you answer
-	    <guilabel>Yes</guilabel>, the current session will be
-	    saved and will be restored at your next login. If you
+	    want to save the current session if you have set the 
+            checkbox for <guilabel> Automatically save session</guilabel>.
+            If you answer <guilabel>Yes</guilabel>, the current session 
+	    will be saved and will be restored at your next login. If you
 	    answer <guilabel>No</guilabel>, the previous saved session
 	    will be used.  
 	  </para> 
-
 	</listitem>
 
 	<listitem>
@@ -1003,6 +999,42 @@
 	    </menuchoice> from the <guimenu>Main Menu</guimenu>. 
 	  </para>
 	</listitem>
+        
+        <listitem>
+          <para>
+            <guilabel>Choose Current Session</guilabel> &mdash;
+             In this section, you can explicitly specify which session
+             to save to, but a save won't occur until you specifically
+             do so. Here, you can also create new sessions, edit and 
+             delete existing sessions. 
+          </para>
+          <para> 
+            To add a new session, press the <guibutton>Add</guibutton> 
+            button and enter in a new session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To edit an existing session name, highlight the session
+            name you wish to edit, press the <guibutton>Edit</guibutton> button
+            and edit the existing session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To delete an existing session name, highlight the session
+            name you wish to delete, press the <guibutton>Delete</guibutton>
+            button.
+          </para>
+        </listitem>  
+        </itemizedlist>
+        <figure>
+ 	  <title>Startup Programs Capplet</title>
+	  <screenshot>
+	    <screeninfo>Startup Programs Capplet</screeninfo>
+	    <graphic format="png" fileref="./figs/gccstartup" srccredit="gman">
+	    </graphic>
+	  </screenshot>
+        </figure>
+      <itemizedlist mark="opencircle">
 	<listitem>
 	  <para>
 	    <guilabel>Non-session managed startup programs</guilabel> &mdash; 
@@ -1406,4 +1438,4 @@
  </sect1>
 
 
-  </article>
\ No newline at end of file
+  </article>

--------------1CCC036EA35DA3B43F0F89A4--



From jfleck@swcp.com  Thu Feb 22 08:50:41 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 879032D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:50:40 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00779
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:49:16 -0700
Date: Thu, 22 Feb 2001 06:49:16 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: scrollkeeper and gnome 1.4
Message-ID: <20010222064916.A770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <200102212057.PAA13250@copiague.math.sunysb.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>; from Alexander Kirillov on Wed, Feb 21, 2001 at 03:57:18PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 03:57:18PM -0500, Alexander Kirillov wrote:
> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 
> 

I know the omf installation was not in place in the gnome-utils
package in time for the first beta. It's done in cvs now.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jfleck@swcp.com  Thu Feb 22 08:58:49 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id B13B32D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:58:48 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00797
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:57:24 -0700
Date: Thu, 22 Feb 2001 06:57:24 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Finished docs
Message-ID: <20010222065724.B770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>; from Dan Mueth on Thu, Feb 22, 2001 at 03:48:59AM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Thu, Feb 22, 2001 at 03:48:59AM -0800, Dan Mueth wrote:
> 
> Since we are approaching the GNOME 1.4 release, I have decided to start
> producing a weekly list of documents which are completely Done(TM) to send
> to the translators for translation.  
> 

Could you include with the list the name and email of the relevant
package coordinators? We need to make sure we know when translations
go in, so we can add in the appropriate omf files and add them to the
build system.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jacob@ximian.com  Thu Feb 22 12:43:25 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (unknown [208.4.24.67])
	by mail.gnome.org (Postfix) with ESMTP id C55182DB91
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 12:43:25 -0500 (EST)
Received: from jacob by ulysses with local (Exim 3.22 #1 (Debian))
	id 14Vzee-0000N7-00; Thu, 22 Feb 2001 12:35:48 -0500
Subject: Re: scrollkeeper and gnome 1.4
From: jacob berkman <jacob@ximian.com>
To: Dan Mueth <dan@eazel.com>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
In-Reply-To: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 12:35:47 -0500
Mime-Version: 1.0
Message-Id: <E14Vzee-0000N7-00@ulysses>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 22 Feb 2001 03:33:19 -0800, Dan Mueth wrote:
> 
> On Wed, 21 Feb 2001, Alexander Kirillov wrote:
> 
> > 
> > Hi guys:
> > 
> > I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> > surprise, no OMF files were installed at all: /usr/share/omf contains
> > scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> > wrong with the packages - could you (or someone else) look into this? 
> 
> This doesn't entirely surprise me.  We were working on getting this done
> right around the package deadline for GNOME 1.4 beta1, so I suspect the
> packages were submitted before we added the OMF metadata.



> I have spoken with Jacob, who does a lot of the packaging work at Ximian

actually i don't do packaging stuff anymore :)

> work.  I even gave him my spec file for gnome-core (which I originally
> took from him and then modified).  So, my guess is we just missed the
> deadline for when they took their beta1 snapshot.  I expect things to work
> for beta2, although it is a good idea to double-check this.

yeah, the plan is to have it working by beta2.  the scrollkeeper tarball
was no good, and nothing used it, and the distro guys were on a tight
deadline anyway.

jacob
-- 
"The people who made the Macintosh produced a miracle, but that
 doesn't mean their code was wonderful." -- Bob Cringely


From gleblanc@cu-portland.edu  Fri Feb 23 00:28:32 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id 85EAB2E5A8; Fri, 23 Feb 2001 00:27:59 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1N5RxQ09400;
	Thu, 22 Feb 2001 21:27:59 -0800
Message-Id: <200102230527.f1N5RxQ09400@mail2.aracnet.com>
Subject: GDP Release Committee Minutes
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 21:26:22 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 18, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Kenny Graunke
Laszlo Kovacs
John Fleck
Alexander Kirillov (arrived 1:18) (departed 1:53)
Ali Abdin (arrived 1:45)

Absent:
-------


Regrets:
--------


Decisions:
----------

- Meeting time agreed to be at 1:00PM PT (9:00PM UTC) on Sunday for
  GDP Release Committee meetings.

- Gregory Leblanc will serve as secretary at meetings

- User's Manuals for applications should be kept in the
  '<application>/help/<locale>/*' sub-directory in CVS, and figures,
  screen shots, and other graphics should go into
  '<application>/help/<locale>/figures'.

- Maintainers assigned for coordinating documentation in various
  modules for the GNOME 1.4 release.  This involves maintaining an
  idea of what the status of a particular module's documentation is
  in, and being a liaison between the docs writers and the application
  hackers.

  - ggv -- John Fleck
  - gnome-applets -- Telsa Gwynne
  - gnome-core -- Dan Mueth
  - gnome-utils -- John Fleck
  - gnome-games -- Gregory Leblanc
  - nautilus -- Dan Mueth
  - ghex -- John Fleck
  - control-center -- Alexander Kirillov
  - bug-buddy -- Telsa Gwynne
  - dia -- Kevin Breit

- Future GDP Release Committee meetings will be open to all GNOME
  members.  This meeting was held without general publication to
  ensure that we could schedule a time for regular meetings, and to
  ensure that the meeting was as effective per time spent as
  possible.  Kevin Breit will be coordinating the Quality Assurance
  efforts for the GDP durring the GNOME 1.4 timeframe.

Work Done:
----------
Since this is our first meeting, we haven't finished any work since
the last meeting.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth -- put HACKING files into gnome-user-docs and
  gnome-devel-docs, and to inform gnome-hackers about the new modules
  and refer them to the HACKING files for further information.

- TODO: Alexander Kirillov -- gather a list of documentation that is
needs to
  be moved into gnome-user-docs, and to email this to Gregory Leblanc
  <gleblanc@cu-portland.edu>
- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Telsa Gwynne -- create a gnome-user-docs product in bugzilla.
  Alexander Kirillov and Telsa Gwynne would like to work on these
  docs, but has more to do than she can handle already, so this will
  wait for now.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.

- INFORMATION: John and Ali reported on the status of gnome-db2html2.
  gnome-db2html2 is mostly solid, with only a few minor known-bugs
  left.  Indexing support isn't included yet, and there is not enough
  time to get it added before 1.4.  Strings have been marked for
  translation, so navigation should appear in the user's specified
  language.  Ali would like to have the navigation links that are
  generated match the locale of the doc, rather than the locale that
  the user has set, but this isn't written yet.  The status of
  Japanese in gnome-db2html2 is -unknown-.

- TODO: John Fleck and Dan Mueth -- test i18n in gnome-db2html2

- TODO: Dan Mueth -- follow up on the bugs with HTML Help in Nautilus.
  Bugs #4302,* #5945, and#6761 in the Nautilus bug system.

- TODO: Dan Mueth -- have Jacob Berkman patch gnome-libs to make
  nautilus the default help browser.

- TODO: Ask Arik to do the "font stuff" for the help sidebar in
  nautilus.

- TODO: Dan Mueth -- enable ScrollKeeper for the help sidebar in the
  default build of Nautilus, including hourly RPMs.

- TODO: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- TODO: Kevin Breit -- develop test assertions, and document
  this procedure so that it can be applied for GNOME 1.4

- TODO: Kevin Breit -- divide docs into groups for QA volunteers to
  sign up for.

- TODO: Laszlo Kovacs-- repair locale fallback for ScrollKeeper in time
for
  GNOME 1.4.  

- INFORMATION: Scrollkeeper will need to be installed on end user
  machines to make the help sidebar in nautilus work properly.  People
  who build packages including OMF metadata should install
  ScrollKeeper so that the document metadata is included in the
  package.  ScrollKeeper can be obtained from:
  http://sourceforge.net/project/showfiles.php?group_id=11543&release_id=24049

- TODO: All Package Coordinators -- gather a list of docs that have
  been completed recently, and are now "frozen".  Mail this list to
  Dan Mueth on Thursday, and he'll collect it and post it to the
  gnome-i18n mailing list.  This is a weekly -recurring- task.

- TODO: Telsa Gwynne -- talk to the i18n team and get feedback on what
  the GDP can do to make translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)


Agenda Items Left For Next Meeting:
-----------------------------------

- User's Guide to be left until the next meeting.  Please review the
  mail by Dan, and prepare for the test at the next meeting.  :)

- Review the list of unfinished documents.

- Discuss use of Bugzilla for the GDP further.

Agenda:
-------
1) Set time for next meeting
2) Minutes
3) Discuss status of gnome-user-docs
4) Discuss gnome-developer-docs and developer FAQ
5) Discuss GNOME Users Guide
6) Review which packages do not have doc maintainers for the GNOME 1.4
release
7) Discuss status of gnome-db2html2
8) Review status of converting docs to work with Nautilus
9) Review status of OMF/ScrollKeeper
10) Review QA plan
11) Review list of unfinished documents
12) Plan for freezing docs and passing them to translators (Release a
weekly list of docs which are frozen and ready for translations?  Stage
docs so each week we completely review and freeze some docs.)
13) Opening up meetings (I don't want the meetings to seem exclusive,
although it makes scheduling a heck of a lot easier if you have a finite
number of people, and the meetings are a lot more efficient. Let's
discuss
having these be open meetings though after we get a schedule locked
down.)






From rob@funky-penguin.co.uk  Fri Feb 23 05:22:13 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id 245102DD1E
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:22:13 -0500 (EST)
Received: from [213.122.189.46] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14WFMX-0007Bf-00
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 10:22:11 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14WFPh-0001QO-00
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:25:25 +0000
Date: Fri, 23 Feb 2001 10:25:12 +0000
To: gnome-doc-list@gnome.org
Subject: Unable to render sgml to html on Debian
Message-ID: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="gKMricLos+KVdGMg"
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--gKMricLos+KVdGMg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

I did used to have this working a long time ago but i moved boxes and now
when i come back to work on it doesnt seem to work.

I downloaded and installed gnome-doc-tools and everything it depeneded on
(cygnus-stylesheets etc).

When i try to db2html a file i know works i just get the file outputed to
stdout rendered as plain text.

Before lots of errors on almost every tag the following it outputted:

input file was called gnome-stones.005.sgml -- output will be in
gnome-stones.005

working on ../gnome-stones.005.sgml
jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"
jade:../gnome-stones.005.sgml:4:0:E: reference to entity "ARTICLE" for which
no system identifier could be generated
jade:../gnome-stones.005.sgml:1:0: entity was defined here
jade:../gnome-stones.005.sgml:4:0:E: DTD did not contain element declaration
for document type name


I think this could be a DTD error but i'm really not sure what to do now.

Any advice on what to do would be greatly appreciated.

rob
--=20
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet

--gKMricLos+KVdGMg
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.4 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD8DBQE6ljqICw8pKd+B7oMRAle6AJ0dl9TmIjMDMlf0AXJiv0q/D5w2iQCdEtrw
sdC62cmPwhiJb/8gP6TUep4=
=ZPbk
-----END PGP SIGNATURE-----

--gKMricLos+KVdGMg--


From jules@blueberry.jellybean.co.uk  Fri Feb 23 05:43:53 2001
Return-Path: <jules@blueberry.jellybean.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from blueberry.jellybean.co.uk (blueberry.jellybean.co.uk [194.88.75.31])
	by mail.gnome.org (Postfix) with ESMTP id E273E2DD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:43:52 -0500 (EST)
Received: from jules by blueberry.jellybean.co.uk with local (Exim 3.16 #1 (Debian))
	id 14WFhO-0003OP-00; Fri, 23 Feb 2001 10:43:42 +0000
Date: Fri, 23 Feb 2001 10:43:42 +0000
From: Jules Bean <jules@jellybean.co.uk>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223104341.B12325@blueberry.jellybean.co.uk>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
> 
> I downloaded and installed gnome-doc-tools and everything it depeneded on
> (cygnus-stylesheets etc).

Which version of gnome-doc-tools?

I'm about to try using eliot landrum's latest debian packages of
gnome-doc-tools, and if it works, upload it into debian. (I need it to 
build the docs of the balsa package, which I maintain).

Jules


From aliabdin@aucegypt.edu  Fri Feb 23 06:16:27 2001
Return-Path: <aliabdin@aucegypt.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from jerry.aucegypt.edu (jerry.aucegypt.edu [208.159.7.6])
	by mail.gnome.org (Postfix) with ESMTP id 695BB2CE41
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 06:16:27 -0500 (EST)
Received: from localhost.localdomain ([217.52.7.140])
 by auc.AUCEGYPT.EDU (PMDF V5.2-31 #41700)
 with ESMTP id <01K0G8WO5SKG9GVA8P@auc.AUCEGYPT.EDU> for
 gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:19:17 EGYPT
Received: by localhost.localdomain (Postfix, from userid 500)
	id 7DF7756FD; Wed, 21 Feb 2001 23:01:25 +0200 (EET)
Date: Wed, 21 Feb 2001 23:01:25 +0200
From: Ali Abdin <aliabdin@aucegypt.edu>
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
In-reply-to: <01021815165800.10931@7of9>
To: battery841@mediaone.net
Cc: gnome-doc-list@gnome.org
Message-id: <20010221210125.7DF7756FD@localhost.localdomain>
MIME-version: 1.0
X-Mailer: Evolution (0.8 - Preview Release)
Content-type: text/plain
References: <20010215172159.A11517@math.sunysb.edu>
 <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
 <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 18 Feb 2001 15:16:58 -0600, Kevin Breit wrote:
> On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> > Is there any interest in having any of the user or developer docs
> > recorded? I'm thinking audio books, or even inserting <audioobject> and
> > <audiodata> tags into the docs themselves.
> >
> > All I will need is someone with a good voice to volunteer. (I have a small
> > studio setup near Chicago.)
> That'd be interesting.  It would be best to have it in mp3 format.  If you 
> wanted, and we got this rolling soon enough, I could do some voice stuff 
> since I live in the Chicago burbs.


No it wouldn't. It would be best to have it in ogg format!!!! :)

I don't think it is worth doing until we have a nice way of actually
playing these files ;)

Perhaps somebody should talk with Sun about this since they are doing
some GNOME Accessibility work

Regards,
Ali


From kirillov@peconic.math.sunysb.edu  Fri Feb 23 10:51:42 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id DC0DB2E516
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:51:41 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id KAA21411;
	Fri, 23 Feb 2001 10:51:37 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id KAA21208;
	Fri, 23 Feb 2001 10:51:37 -0500
Date: Fri, 23 Feb 2001 10:51:37 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223105137.B21128@math.sunysb.edu>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
[snip] 
> working on ../gnome-stones.005.sgml
> jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
> jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
> public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"

>From these messages, something is wrong with your CATALOG file -
probably DocBook PNG Variant V1.1, instead of referring to DOcBook
V3.1 as it should, refers to itself, or something like this. If you
send me your /usr/lib/sgml/catalog and the dtd file installed by
DocBook PNG Variant V1.1, I might be able to tell you more. 

Sasha


From pablodc@mapfre.com.ar  Fri Feb 23 11:10:02 2001
Return-Path: <pablodc@mapfre.com.ar>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail.mapfre.com.ar (mail.mapfre.com.ar [200.32.86.3])
	by mail.gnome.org (Postfix) with ESMTP id 5A27C2C906
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 11:09:48 -0500 (EST)
Received: by mail.mapfre.intranet.ar with Internet Mail Service (5.5.2448.0)
	id <FKPFQT5Y>; Fri, 23 Feb 2001 13:11:36 -0300
Message-ID: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
From: Pablo del Campo <pablodc@mapfre.com.ar>
To: gnome-doc-list@gnome.org
Subject: Strings Unstranslated in Nautilus (spanish)
Date: Fri, 23 Feb 2001 13:11:30 -0300
Importance: high
X-Priority: 1
MIME-Version: 1.0
X-Mailer: Internet Mail Service (5.5.2448.0)
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everyone:

	My name is Pablo and I working in the Nautilus=B4s spanish
translation.

	I have a couple of troubles with some strings that are translated in
the es.po but Nautilus insist in display them in english, I write this =
mail
for someone that can help me whith this:

Some of the strings are:

* Customer (I don=B4t have this string in the es,po after run =
./update.sh es),
it=B4s in the Help menu.
* All the Strings of the MP3 player are translated in the es.po but
displayed in english when use it in Nautilus.
* The users level that are displayed in the Assistant when first Launch
Nautilus.
* two or three strings in the RPM view (I=B4dont remember exactly what =
they
are right now).

If someone can help whith this write me at pablodc@bigfoot as fast as =
you
can.

Thanks and please forgive my bad english.

    .-.     Pablo Gonzalo del Campo
 .-.   .-.     MAPFRE Aconcagua
(___\ /___)       Sistemas
     |          Programador
     =20


From erik@core.com  Fri Feb 23 13:54:15 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id CAE9A2BD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 13:54:14 -0500 (EST)
Received: from core.com (tnt15b-74.focal-chi.corecomm.net [216.214.210.74])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1NIsjv78655
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 18:54:45 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1NJ2Up14527
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:02:30 -0600
Date: Fri, 23 Feb 2001 13:02:30 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010223130230.B6594@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9> <20010221210125.7DF7756FD@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010221210125.7DF7756FD@localhost.localdomain>; from "aliabdin@aucegypt.edu on Wed, Feb 21, 2001 at 11:01:25PM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 11:01:25PM +0200, Ali Abdin wrote:
> 
> No it wouldn't. It would be best to have it in ogg format!!!! :)

Well, they will be recorded/edited as 24bit 44.1kHz SoundDesignerII format, but
after that I can convert them into anything. :)

> I don't think it is worth doing until we have a nice way of actually
> playing these files ;)

There are plenty of ways to play these files. :) (but none are intergrated
specifically for this.)

My view is why wait? If someone actually uses this between the time the
recording/editing is finished and a hacker get some intergration into I think
would be nautilus, then it will be worth it. I see this as the old chicken and
egg problem...  or is it the carrot in front of the horse? Heh.

I talked to Kevin on irc, what I think we'll do is a proof of concept demo.

> Perhaps somebody should talk with Sun about this since they are doing
> some GNOME Accessibility work

Who at Sun should we get in contact with?

-- 
All music aspires to the condition of muzak.


From dan@eazel.com  Fri Feb 23 23:09:35 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3A9E72BAAF
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 23:09:35 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1O47Ke02058;
	Fri, 23 Feb 2001 20:07:20 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 23 Feb 2001 20:07:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Pablo del Campo <pablodc@mapfre.com.ar>
Cc: gnome-doc-list@gnome.org, nautilus-list@lists.eazel.com
Subject: Re: Strings Unstranslated in Nautilus (spanish)
In-Reply-To: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
Message-ID: <Pine.LNX.4.21.0102231954540.27264-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=ISO-8859-1
Content-Transfer-Encoding: 8BIT
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi Pablo,

Thanks for pointing this out.  I am no hacker, but my unexpert opinion is
that this is un-gettext'd:

components/rpmview/nautilus-rpm-view.c:

gtk_label_set_text
(GTK_LABEL(rpm_view->details->package_installed_message), "This package is
currently installed");

I suspect we have a fair number of places where ungettext'd strings have
slipped in.

Any Nautilus hackers want to volunteer to grep through CVS and fix any
strings which are not gettext-ized?

Dan




On Fri, 23 Feb 2001, Pablo del Campo wrote:

> Hi everyone:
> 
> 	My name is Pablo and I working in the Nautilusīs spanish
> translation.
> 
> 	I have a couple of troubles with some strings that are translated in
> the es.po but Nautilus insist in display them in english, I write this mail
> for someone that can help me whith this:
> 
> Some of the strings are:
> 
> * Customer (I donīt have this string in the es,po after run ./update.sh es),
> itīs in the Help menu.
> * All the Strings of the MP3 player are translated in the es.po but
> displayed in english when use it in Nautilus.
> * The users level that are displayed in the Assistant when first Launch
> Nautilus.
> * two or three strings in the RPM view (Iīdont remember exactly what they
> are right now).
> 
> If someone can help whith this write me at pablodc@bigfoot as fast as you
> can.
> 
> Thanks and please forgive my bad english.
> 
>     .-.     Pablo Gonzalo del Campo
>  .-.   .-.     MAPFRE Aconcagua
> (___\ /___)       Sistemas
>      |          Programador
>       
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 





From hobbit@aloss.ukuu.org.uk  Sun Feb 25 04:27:39 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id EB49C2BACE
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 04:27:38 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1P9V4X12307
	for gnome-doc-list@gnome.org; Sun, 25 Feb 2001 09:31:04 GMT
Date: Sun, 25 Feb 2001 09:31:04 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: bug-buddy docs 1.4 ready? Please check :) 
Message-ID: <20010225093104.B12247@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Okay, the proto-docs for bug-buddy are on the web at
http://www.linux.org.uk/~telsa/GDP/bug-buddy-new.sgml

The text is fine, I think. As in, I don't see too many errors.
I have checked for most of the 1.4-readiness stuff. But I have
got myself intro a terrible muddle: which licence am I supposed 
to be including under what id tag? I think I have it wrong. Please 
give it a quick check and tell me. Then I'll throw them at Jacob 
for CVS. (I haven't put them straight into CVS cos every time I 
touch it something else goes wrong. :))

Telsa


From chris@wilddev.net  Sun Feb 25 05:57:41 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 47E5B2BAFB
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 05:57:40 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id DAA21647;
	Sun, 25 Feb 2001 03:07:13 -0800
Message-ID: <3A98E54F.9000900@wilddev.net>
Date: Sun, 25 Feb 2001 02:58:23 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Cc: ian@eazel.com
Subject: GNOME UG Proposed Framework
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I wish to get comments from people on what they think of this list of 
docs to be included in the UG. The major change in 1.4 is the addition 
of Nautilus. I'm going to pull the current copies of these docs from CVS 
to see what needs to be done to get them together for the UG. If Ian 
gets to busy to do the scripts then I may just attempt to put them 
together manually.

Chris

Intro to GNOME
GNOME Quick Start
Window Managers and GNOME
The Gnome Desktop
Nautilus
Panel
   -Applets
GNOME System Utilities
Menu Editor
GNOME Control Center
Appendix
   -A Linux Primer
   -B GDP Team
   -C GNU FDL



From trevor.curtis@home.com  Mon Feb 26 10:37:37 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id 7899C2BF20
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 10:37:37 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010226153708.SBMY12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 07:37:08 -0800
Date: Mon, 26 Feb 2001 10:39:01 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Gnome Tali doc converted
Message-ID: <20010226103900.A5114@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
X-Operating-System: Linux frink.thesimpsons.ca 2.4.2
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I just finished converting the Gnome Tali game manual from html to
sgml. This is my first attempt at docbooking something so any feedback
would be great; negative or otherwise :)

My biggest problem was decided what should and shouldn't be tagged and
how to or not to tag them. So if there are issues here concerning that
just let me know.

So for those you who wouldn't mind you can find it here:
http://www.scs.carleton.ca/~tcurtis/gtali.sgml

thanks in advance,
-- 
Trevor Curtis
http://members.home.net/jbrabazon
--------------------------------------------------------------
"The only people who have anything to fear from free software,
are those whose products are worth even less."  --David Emery.



From jfleck@swcp.com  Mon Feb 26 11:11:36 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 99DE12DDEE
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 11:11:34 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id JAA03237
	for gnome-doc-list@gnome.org; Mon, 26 Feb 2001 09:10:10 -0700
Date: Mon, 26 Feb 2001 09:10:09 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Gnome Tali doc converted
Message-ID: <20010226091009.A1672@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <20010226103900.A5114@mail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <20010226103900.A5114@mail.com>; from Trevor Curtis on Mon, Feb 26, 2001 at 10:39:01AM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Trevor -

The markup looks fine to me.

The only change needed that I saw was the reference to
bugs.gnome.org. It needs to be changed to bugzilla.gnome.org. We need
to get that changed in the templates. Sorry.

I also tested it in Nautilus, and it passed.

The next step, which would be great if you have the energy, would be
to add screenshots.

Cheers,

John

On Mon, Feb 26, 2001 at 10:39:01AM -0500, Trevor Curtis wrote:
> I just finished converting the Gnome Tali game manual from html to
> sgml. This is my first attempt at docbooking something so any feedback
> would be great; negative or otherwise :)
> 
> My biggest problem was decided what should and shouldn't be tagged and
> how to or not to tag them. So if there are issues here concerning that
> just let me know.
> 
> So for those you who wouldn't mind you can find it here:
> http://www.scs.carleton.ca/~tcurtis/gtali.sgml
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From battery841@mediaone.net  Tue Feb 27 17:24:15 2001
Return-Path: <battery841@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from elmls01.ce.mediaone.net (elmls01.ce.mediaone.net [24.131.128.25])
	by mail.gnome.org (Postfix) with ESMTP id 576F82CA94
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 17:24:15 -0500 (EST)
Received: from 7of9 (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by elmls01.ce.mediaone.net (8.8.7/8.8.7) with SMTP id QAA19245
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 16:24:10 -0600 (CST)
Content-Type: text/plain;
  charset="iso-8859-1"
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Gnibbles dox
Date: Tue, 27 Feb 2001 16:14:56 -0600
X-Mailer: KMail [version 1.2]
MIME-Version: 1.0
Message-Id: <01022716145600.18733@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
	Why aren't the Gnibbles documentation in Gnibbles?  I wrote the dox and they 
should be in CVS.  Any reasons?
Thanks
Kevin


From gleblanc@cu-portland.edu  Tue Feb 27 23:48:33 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id F09D12DECF; Tue, 27 Feb 2001 23:48:32 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1S4mWn15023;
	Tue, 27 Feb 2001 20:48:32 -0800
Message-Id: <200102280448.f1S4mWn15023@mail2.aracnet.com>
Subject: Minutes for the GDP Release Committee meeting Feb 25, 2001
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 27 Feb 2001 20:46:45 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 25, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Laszlo Kovacs
John Fleck
Alexander Kirillov
Chris Lyttle (arrived 1:54)

Absent:
-------
Kenny Graunke
Ali Abdin


Regrets:
--------


Decisions:
----------

- Nautilus will not have the ability to fall back on the
  non-scrollkeeper sidebar.  Scrollkeeper is now required for
  Nautilus.

Work Done:
----------

- DONE: Dan Mueth -- HACKING files created in gnome-user-docs and
  gnome-devel-doc.  

- DONE: Alexander Kirillov -- created a list of documentation to be
  moved into the gnome-user-docs module, and send it to Gregory
  Leblanc <gleblanc@cu-portland.edu>
- DONE: Telsa Gwynne -- created a gnome-user-docs product in
  bugzilla.

- DONE: John Fleck and Dan Mueth -- tested l10n and i18n in
  gnome-db2html2.  It doesn't work, but a detailed bug report has been
  filed, and "it should be easy to fix".

- DONE: Dan Mueth, John Fleck, Mike Fleming-- bugs #4302, #5945, and
  #6761 are fixed and verified.

- DONE: Laszlo Kovacs -- Enabled scrollkeeper in the default builds of
  Nautilus, and in the hourly builds.

- DONE: Kevin Breit -- Divided docs into groups so that QA volunteers
  can sign up.
  http://battery841.myip.org/school/gnome-1.4-category.txt/ps

- DONE: Laszlo Kovacs -- locale fallback in scrollkeeper has been
  fixed.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth Kenny Graunke -- create build system in
  gnome-user-docs and gnome-devel-docs.  Once build system is in place
  inform gnome-hackers about the new modules and refer them to the
  HACKING files for further information.

- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Gregory Leblanc -- find script that puts the FAQ (and possibly
  other gnome-user-docs documents) onto the website, and find the
  maintainer.  Have the script changed to look to gnome-user-docs
  instead of gnome-docu.

- TODO: Telsa Gwynne -- add components and version numbers to the
  gnome-user-docs module in bugzilla.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.  Mail list of packages to gnome-doc-list for
  volunteers.

- IN PROGRESS: Dan Mueth -- Emailed Jacob Berkman about making
  nautilus the default help browser in gnome-libs.

- IN PROGRESS: John Fleck -- check on support for using multiple fonts
  in the Nautilus Help Sidebar.

- TODO: John Fleck, Laszlo Kovacs, Dan Mueth -- work out l10n issues.

- IN PROGRESS: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- IN PROGRESS: Kevin Breit -- develop quality assurance tests, and
  document this procedure so that it can be applied for GNOME
  1.4. See: 
  http://battery841.myip.org/school/checklist.txt
  http://www.gnome.org/~mjs/gnome-test-plans/ and
  gnome-test-plans in CVS for details.

- TODO: John Fleck -- determine status of glossary.[xml sgml] so that
  it can be translated.

- IN PROGRESS: Telsa Gwynne -- talk to the i18n teams about making
  translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)

- TODO: Chris Lyttle -- Work on GNOME Users Guide.  Add a "New in
  GNOME 1.4" section near the beginning of the Guide.  See about the
  feasibility of getting the Users Guide included with Beta 3

- TODO: Kevin Breit -- Polish the existing dia documentation and have
  it included (and linked to the help menu) in the next release.

- TODO: Dan Mueth -- Assist John Fleck in verifing some
  Nautilus/gnome-db2html2 bugs.  

Agenda Items Left For Next Meeting:
-----------------------------------

0) Discuss improving meetings
1) Review which packages need maintainers
2) QA review

Agenda:
-------
0) Review TODO's from last meeting
1) Discuss GNOME User Guide
2) Discuss whether Dia doc is ready for inclusion
3) Discuss improving meetings
4) Review which packages need maintainers
5) QA review
6) Nautilus bug verification





From chris@wilddev.net  Wed Feb 28 02:04:57 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 64AC12BB09
	for <gnome-doc-list@gnome.org>; Wed, 28 Feb 2001 02:04:56 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id XAA30737
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 23:14:49 -0800
Message-ID: <3A9CA358.5080701@wilddev.net>
Date: Tue, 27 Feb 2001 23:06:00 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: GNOME UG vs KDE UG
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all
I was surfing the KDE site looking for ideas and I noticed

http://www.kde.org/documentation/userguide/index.html

This impressed me as it is task based, something we have discussed doing 
for the gdp docs. I am thinking now that I might try to incorporate some 
things into the UG that are more task oriented (in the time available) 
and plan on rewriting the UG as a standalone task based doc for possibly 2.0

Let me know your thoughts

Chris



From kirillov@math.sunysb.edu  Sun Feb  4 18:06:39 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from localhost.localdomain (076-041.dialup.sunysb.edu [129.49.76.41])
	by mail.gnome.org (Postfix) with ESMTP id B4BE02BC7E
	for <gnome-doc-list@gnome.org>; Sun,  4 Feb 2001 18:06:38 -0500 (EST)
Received: by localhost.localdomain (Postfix, from userid 501)
	id 0CEF73E53A; Sun,  4 Feb 2001 18:05:02 -0500 (EST)
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: indexing
Message-Id: <20010204230502.0CEF73E53A@localhost.localdomain>
Date: Sun,  4 Feb 2001 18:05:02 -0500 (EST)
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all:
one feature almost all our docs are sorely missing (with the exception
of the users guide for 1.2) is an index. I think we need to do something
about it. 

Ideal solution would be: 

 a. we put tags like 

   <indexterm><primary>Applets</primary>
              <secondary>adding to panel</secondary> 
   </indexterm>
   in our documents (in this case - in the panel manual when
   discussing adding applets to panel). 

 b. during db2html conversion, gnome-db2html would process this and
 create an index for the document, or 

 c. even better, index for documents for all core components
 (panel, applets, nautilus,  control center,...), or  even all  gnome
 docs is created from these tags at installation time, so we have a
 common index. 

Unfortunately, this is unrealistic. At the moment, gnome-db2html does
not automatically produce an index. Neither, btw, does jade. However,
I strongly feel that we need an index *now* - make it a hack if we
must. 

 Suggestions: 

 1. Create an index for each doc manually, i.e. in your doc, add
    a section like this

<index><title>Index</title>
<indexdiv><title>A</title>
<indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see <xref linkend="appletadd">
           </secondaryie>
   </primaryie>   

etc. Here "appletadd" is the id of sect1 discussing this topic.
Obviously, the problem is that you must manually update the index
whenever the document structure changes.

or: 

  2. Create a common index for all core docs as a separate document;
instead of <xref>, use something like 
 <indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see Panel manual, section <ulink type="gnome-help"
url="help:panel?appletadd">Adding objects to panel</ulink> 
           </secondaryie>
   </primaryie>   
  

Obviously, 2 would be better for the user (it is better to have one
common index than 10 individual ones) but *much* harder to maintain. On the
other hand, sections of our documents do not change all too
often. I think either way it is something we can do before 1.4; my
estimate is it would take 2-3 days (for one person) to write such an
index. Yes, it is a hack, but it will do for now. I'd vote for 2. 

Comments? Volunteers?

Sasha






From michael.smith@openwave.com  Mon Feb  5 05:01:38 2001
Return-Path: <michael.smith@openwave.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from oe-mp1.bizmailsrvcs.net (oe-mp1pub.managedmail.com [206.46.164.22])
	by mail.gnome.org (Postfix) with ESMTP id 86F812BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:01:37 -0500 (EST)
Received: from oe-ismta1.bizmailsrvcs.net ([206.46.164.26])
          by oe-mp1.bizmailsrvcs.net (InterMail vM.5.01.01.01 201-252-104)
          with ESMTP
          id <20010205095619.CZSW24251.oe-mp1.bizmailsrvcs.net@oe-ismta1.bizmailsrvcs.net>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:56:19 -0600
Received: from SMITH1.openwave.com ([63.24.97.132])
          by oe-ismta1.bizmailsrvcs.net
          (InterMail vM.5.01.01.01 201-252-104) with ESMTP
          id <20010205095452.YJUR1854.oe-ismta1.bizmailsrvcs.net@SMITH1.openwave.com>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:54:52 -0600
To: gnome-doc-list@gnome.org
Subject: July open-source conference
From: Michael Smith <smith@xml-doc.org>
Date: 05 Feb 2001 02:01:27 -0800
Message-ID: <uae81phxk.fsf@openwave.com>
Lines: 29
User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello all,

I'm writing to a few different lists to ask whether anyone might be
planning to attend the O'Reilly open-source conference (San Diego CA)
in July.

I've been in contact with some of the folks at O'Reilly, trying to
drum up support for a "DocBook" or "open-source document authoring"
day. I think a discussion/tutorial from someone involved with the GNOME
doc project would be valuable to others. Has anyone thought about maybe
submitting a proposal for a tutorial/presentation?

The deadline for submissions of proposals is February 9th (this
Friday). If anyone else from the GNOME doc project could submit a
proposal of some kind, I think it would great. If nobody wants to
commit to a whole tutorial, I'd certainly be willing to coordinate
integration of GNOME expertise into a larger tutorial of some kind.

Please let me know what you think, or just go ahead and submit a
proposal for the conference's XML track:

  http://conferences.oreilly.com/oscon2001/call-xml.html

Or at the very least, if you plan on attending, e-mail
oscon2001-xml-proposals@oreilly.com expressing interest in seeing some
DocBook/document-authoring tutorials/presentations take place.

  --Mike Smith






From laszlo.kovacs@Sun.COM  Mon Feb  5 05:10:37 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 6DE652BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:10:36 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id CAA21828
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 02:10:34 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id KAA19302
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 10:10:33 GMT
Message-ID: <3A7E7C19.78432618@Sun.COM>
Date: Mon, 05 Feb 2001 10:10:33 +0000
From: laszlo kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> 
> Hi all:
> one feature almost all our docs are sorely missing (with the exception
> of the users guide for 1.2) is an index. I think we need to do something
> about it.
> 
> Ideal solution would be:
> 
>  a. we put tags like
> 
>    <indexterm><primary>Applets</primary>
>               <secondary>adding to panel</secondary>
>    </indexterm>
>    in our documents (in this case - in the panel manual when
>    discussing adding applets to panel).
> 
>  b. during db2html conversion, gnome-db2html would process this and
>  create an index for the document, or
> 
>  c. even better, index for documents for all core components
>  (panel, applets, nautilus,  control center,...), or  even all  gnome
>  docs is created from these tags at installation time, so we have a
>  common index.
> 
> Unfortunately, this is unrealistic. At the moment, gnome-db2html does
> not automatically produce an index. Neither, btw, does jade. However,
> I strongly feel that we need an index *now* - make it a hack if we
> must.

I wonder how much people know about the Scrollkeeper project (not very
informative web site is scrollkeeper.sourceforge.net). This project is
about metadata based document categorizing and storing the result in xml
file(s) exported to help browsers. There are pretty high chances that
the Help sidebar in Nautilus for Gnome 1.4 will use Scrollkeeper. We
aimed to add indexing functionality in Scrollkeeper after Gnome 1.4.
This contains index extraction (in case the index info is added to the
docs as detailed above), exporting this to help browsers and integrate
this with Nautilus. Going further implementation of search through index
and other parts of the documentation and metadata is also considered.
Both Scrollkeeper and its integration with Nautilus are run by the same
people.

> 
>  Suggestions:
> 
>  1. Create an index for each doc manually, i.e. in your doc, add
>     a section like this
> 
> <index><title>Index</title>
> <indexdiv><title>A</title>
> <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see <xref linkend="appletadd">
>            </secondaryie>
>    </primaryie>
> 
> etc. Here "appletadd" is the id of sect1 discussing this topic.
> Obviously, the problem is that you must manually update the index
> whenever the document structure changes.
> 
> or:
> 
>   2. Create a common index for all core docs as a separate document;
> instead of <xref>, use something like
>  <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see Panel manual, section <ulink type="gnome-help"
> url="help:panel?appletadd">Adding objects to panel</ulink>
>            </secondaryie>
>    </primaryie>
> 
> 
> Obviously, 2 would be better for the user (it is better to have one
> common index than 10 individual ones) but *much* harder to maintain. On the
> other hand, sections of our documents do not change all too
> often. I think either way it is something we can do before 1.4; my
> estimate is it would take 2-3 days (for one person) to write such an
> index. Yes, it is a hack, but it will do for now. I'd vote for 2.

1. would prolly suit the way how Scrollkeeper is intended to work
better, but I am sure it could also serve the other approach. One
question though, what's the point to add the index info to docs before
Gnome 1.4 if there is no index display and search implemented? Or am I
missing something?

Laszlo


From kirillov@peconic.math.sunysb.edu  Mon Feb  5 11:28:30 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 5D0FE2CA94
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 11:28:30 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id LAA00445;
	Mon, 5 Feb 2001 11:28:28 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id LAA30055;
	Mon, 5 Feb 2001 11:28:28 -0500
Date: Mon, 5 Feb 2001 11:28:28 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: laszlo kovacs <laszlo.kovacs@sun.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
Message-ID: <20010205112828.A30010@math.sunysb.edu>
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <3A7E7C19.78432618@Sun.COM>; from laszlo.kovacs@sun.com on Mon, Feb 05, 2001 at 10:10:33AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, Feb 05, 2001 at 10:10:33AM +0000, laszlo kovacs wrote:
[snip]
> One
> question though, what's the point to add the index info to docs before
> Gnome 1.4 if there is no index display and search implemented? Or am I
> missing something?
> 
> Laszlo

If we add an index to a doc manually, as in suggestion 1, then it will
be useful even without special "index display" - it will just show as
one of the sections of your document (usually the last one). If you
are trying to find info about some topic, you just look at this
section, find (manually) the topic you need, and click on the provided
link. Much as with printed books.

Of course, having a special index display with help option would be
better. Do you have any estimates how soon it will be implemented in
Nautilus? "after Gnome 1.4" is rather vague...

Best,
Sasha


From laszlo.kovacs@Sun.COM  Mon Feb  5 12:26:45 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id B667D2E27C
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:26:44 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id JAA10958;
	Mon, 5 Feb 2001 09:26:42 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id RAA23772;
	Mon, 5 Feb 2001 17:26:41 GMT
Message-ID: <3A7EE251.5B3BEA08@Sun.COM>
Date: Mon, 05 Feb 2001 17:26:41 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM> <20010205112828.A30010@math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> If we add an index to a doc manually, as in suggestion 1, then it will
> be useful even without special "index display" - it will just show as
> one of the sections of your document (usually the last one). If you
> are trying to find info about some topic, you just look at this
> section, find (manually) the topic you need, and click on the provided
> link. Much as with printed books.
Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
 
> Of course, having a special index display with help option would be
> better. Do you have any estimates how soon it will be implemented in
> Nautilus? "after Gnome 1.4" is rather vague...
All I know right now is that hopefully for the next major Gnome release
after 1.4. Work has not been started yet. But this is very important for
Sun. Just like the Search functionality. I always assumed this will be
done as part of the joint Scrollkeeper/Scrollkeeper-Nautilus Integration
project. I did most of the coding of Scrollkeeper with design mostly
discussed with Dan Mueth and other people. Same on the Scrollkeeper
side, there is an intention that as soon as Gnome 1.4 is released myself
or another Sun engineer will be fully responsible for hyperbola, the
Nautilus component that implements the help sidebar and will implement
the GUI for the Index display and Search also (at least this is how I
see it).

Laszlo


From jfleck@inkstain.net  Mon Feb  5 12:36:32 2001
Return-Path: <jfleck@inkstain.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from jello.inkstain.net (shell.inkstain.net [206.29.130.69])
	by mail.gnome.org (Postfix) with ESMTP id 4A5402D9AF
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:36:32 -0500 (EST)
Received: from jello (mail [206.29.130.67])
	by jello.inkstain.net (8.9.3/8.9.3) with SMTP id JAA22114;
	Mon, 5 Feb 2001 09:27:09 -0800 (PST)
Date: Mon, 5 Feb 2001 09:27:09 -0800 (PST)
From: <jfleck@inkstain.net>
X-Sender: jfleck@jello
To: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <3A7EE251.5B3BEA08@Sun.COM>
Message-ID: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Mon, 5 Feb 2001, Laszlo Kovacs wrote:

> > If we add an index to a doc manually, as in suggestion 1, then it will
> > be useful even without special "index display" - it will just show as
> > one of the sections of your document (usually the last one). If you
> > are trying to find info about some topic, you just look at this
> > section, find (manually) the topic you need, and click on the provided
> > link. Much as with printed books.
> Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
>  

It does not now. I'm looking into what would be required to add the
necessary support.

Cheers,

John



From dan@eazel.com  Mon Feb  5 17:25:13 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.localdomain (unknown [64.37.237.47])
	by mail.gnome.org (Postfix) with ESMTP id EFB912D34F
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 17:25:12 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.localdomain (8.11.0/8.11.0) with ESMTP id f160KqX04045;
	Mon, 5 Feb 2001 16:21:42 -0800
X-Authentication-Warning: foodle.localdomain: dan owned process doing -bs
Date: Mon, 5 Feb 2001 16:20:52 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
X-Sender: dan@foodle.localdomain
To: jfleck@inkstain.net
Cc: Laszlo Kovacs <laszlo.kovacs@Sun.COM>,
	Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
Message-ID: <Pine.LNX.4.21.0102051612330.13847-100000@foodle.localdomain>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, 5 Feb 2001 jfleck@inkstain.net wrote:

> On Mon, 5 Feb 2001, Laszlo Kovacs wrote:
> 
> > > If we add an index to a doc manually, as in suggestion 1, then it will
> > > be useful even without special "index display" - it will just show as
> > > one of the sections of your document (usually the last one). If you
> > > are trying to find info about some topic, you just look at this
> > > section, find (manually) the topic you need, and click on the provided
> > > link. Much as with printed books.
> > Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
> >  
> 
> It does not now. I'm looking into what would be required to add the
> necessary support.

Thanks John. This is something we would eventually like to have in
gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
providing a search feature that searches the index of many documents at
once.

If we really want to have a central index, we might imagine faking
together one (as Sasha suggested), but make it a single document which
acts like an index to the other documents which are core to GNOME.  We
could call it "The GNOME Index" and then put links like:
  cd player -> gtcd
  CPU: monitoring load -> multiload applet
       identifying -> Nautilus hardware view
  Themes: changing -> Control center: Appearance

or whatever.  This is really what the user wants. Of course this would be
a lot of work to do well, especially to do a good job.  It would fit
nicely into gnome-user-docs.

Dan




From Patrick.Costello@ireland.sun.com  Tue Feb  6 02:20:18 2001
Return-Path: <Patrick.Costello@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 9DEA02E3BE
	for <gnome-doc-list@gnome.org>; Tue,  6 Feb 2001 02:20:17 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id XAA00496;
	Mon, 5 Feb 2001 23:20:14 -0800 (PST)
Received: from dbl-ray-3 (dbl-ray-3 [129.156.237.102])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with SMTP id HAA28877;
	Tue, 6 Feb 2001 07:20:14 GMT
Message-Id: <200102060720.HAA28877@ireserver.Ireland.Sun.COM>
Date: Tue, 6 Feb 2001 07:20:14 +0000 (GMT)
From: Pat Costello <Patrick.Costello@ireland.sun.com>
Reply-To: Pat Costello <Patrick.Costello@ireland.sun.com>
Subject: Re: indexing
To: jfleck@inkstain.net, dan@eazel.com
Cc: laszlo.kovacs@Sun.COM, kirillov@math.sunysb.edu,
	gnome-doc-list@gnome.org
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mU6vkHqmlSX8KsPxXlLPhQ==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

All, 

A central index covering Gnome core functions, applications and applets would be 
very handy, especially given the multiplexed nature of the Gnome desktop. At 
first, though, I would suggest a top-level approach to the index so that only 
the main topic headers are flagged, for example the only entry for an applet 
would be the applet header rather than applet actions. In other words, we need 
only put the entry "screen-shooter" into the index and not "screenshots, see 
screen-shooter". This might reduce the amount of work. 

Pat

> 
> On Mon, 5 Feb 2001 Dan Mueth wrote:
 
> Thanks John. This is something we would eventually like to have in
> gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
> providing a search feature that searches the index of many documents at
> once.
> 
> If we really want to have a central index, we might imagine faking
> together one (as Sasha suggested), but make it a single document which
> acts like an index to the other documents which are core to GNOME.  We
> could call it "The GNOME Index" and then put links like:
>   cd player -> gtcd
>   CPU: monitoring load -> multiload applet
>        identifying -> Nautilus hardware view
>   Themes: changing -> Control center: Appearance
> 
> or whatever.  This is really what the user wants. Of course this would be
> a lot of work to do well, especially to do a good job.  It would fit
> nicely into gnome-user-docs.
> 
> Dan
> 
> 
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list



From sarithazan@hotmail.com  Thu Feb  8 06:59:02 2001
Return-Path: <sarithazan@hotmail.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from hotmail.com (oe44.law11.hotmail.com [64.4.16.16])
	by mail.gnome.org (Postfix) with ESMTP id ACAC92BD24
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 06:59:01 -0500 (EST)
Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC;
	 Thu, 8 Feb 2001 03:59:00 -0800
X-Originating-IP: [212.117.152.146]
From: "Sara Hazan" <sarithazan@hotmail.com>
To: <gnome-doc-list@gnome.org>
Subject: problem with configure
Date: Thu, 8 Feb 2001 13:58:11 +0200
MIME-Version: 1.0
Content-Type: multipart/alternative;	boundary="----=_NextPart_000_0005_01C091D7.2C65A930"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.00.2014.211
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2014.211
Message-ID: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
X-OriginalArrivalTime: 08 Feb 2001 11:59:00.0765 (UTC) FILETIME=[863694D0:01C091C6]
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Hi,

After run ./configure I get the follow :

checking for glib-config... no
checking for GLIB - version >=3D 1.2.0... no
*** The glib-config script installed by GLIB could not be found
*** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
*** your path, or set the GLIB_CONFIG environment variable to the
*** full path to glib-config.
configure: error: Test for GLIB failed.  MC requires GLIB.


Please tell me what to do.

Thanks.

Sarit


------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/html;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Diso-8859-1" =
http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2314.1000" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Hi,</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>After run ./configure I get the follow=20
:</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>checking for glib-config... =
no<BR>checking for GLIB=20
- version &gt;=3D 1.2.0... no<BR>*** The glib-config script installed by =
GLIB=20
could not be found<BR>*** If GLIB was installed in PREFIX, make sure =
PREFIX/bin=20
is in<BR>*** your path, or set the GLIB_CONFIG environment variable to=20
the<BR>*** full path to glib-config.<BR>configure: error: Test for GLIB=20
failed.&nbsp; MC requires GLIB.<BR></FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Please tell me what to do.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Thanks.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Sarit</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>&nbsp;</DIV></FONT></BODY></HTML>

------=_NextPart_000_0005_01C091D7.2C65A930--


From laszlo.kovacs@Sun.COM  Thu Feb  8 07:02:04 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 75BD12E7A9
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 07:02:04 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id EAA28398;
	Thu, 8 Feb 2001 04:02:03 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id MAA23602;
	Thu, 8 Feb 2001 12:02:02 GMT
Message-ID: <3A828ABA.96B484AB@Sun.COM>
Date: Thu, 08 Feb 2001 12:02:02 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Sara Hazan <sarithazan@hotmail.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: problem with configure
References: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> Sara Hazan wrote:
> 
> Hi,
> 
> After run ./configure I get the follow :
> 
> checking for glib-config... no
> checking for GLIB - version >= 1.2.0... no
> *** The glib-config script installed by GLIB could not be found
> *** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
> *** your path, or set the GLIB_CONFIG environment variable to the
> *** full path to glib-config.
> configure: error: Test for GLIB failed.  MC requires GLIB.
> 
> Please tell me what to do.
> 
> Thanks.
> 
> Sarit
> 

Two ways:

1. put glib-config in your PATH.
2. Set GLIB_CONFIG to point to where your glib-config is.

Laszlo


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Thu Feb  8 16:56:07 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id F0BE82BB19
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 16:56:06 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14Qz2s-0000mx-00
	for <gnome-doc-list@gnome.org>; Thu, 08 Feb 2001 15:56:06 -0600
Date: Thu, 8 Feb 2001 15:56:06 -0600
From: Eric Baudais <baudais@okstate.edu>
To: GNOME Documentation Project <gnome-doc-list@gnome.org>
Subject: Doc Writers Needed.
Message-ID: <20010208155605.A3008@bubba>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Yes, this is a call out for help.  There are currently 3 gnome-games that 
need docs.  They are:

gnometris
gnotravex
gnotski

If anyone wants to write docs for these apps contact me and/or put you name 
in the doctable under the game.

Eric Baudais


From gleblanc@cu-portland.edu  Sat Feb 10 18:27:21 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 54B8D2D04B
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 18:27:21 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1ANRKt11506
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 15:27:20 -0800
Message-Id: <200102102327.f1ANRKt11506@mail3.aracnet.com>
Subject: [khitam sobh <tami@ca.inter.net>] user guide
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org
Content-Type: multipart/mixed; boundary="=-5p0cBznQ7LiDjmQ3yxfp"
X-Mailer: Evolution (0.8 - Preview Release)
Date: 10 Feb 2001 15:26:04 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Type: text/plain

Oh, it beats me, somebody from the list must know.  :)  Please CC
webmaster@gnome.org on any reply you make.  Thanks,

    Greg

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Disposition: inline
Content-Description: Forwarded message - user guide
Content-Type: message/rfc822

Received: from sweeper.cu-portland.edu (SWEEPER [207.149.56.136]) by 
	email.cu-portland.edu with SMTP (Microsoft Exchange Internet Mail Service 
	Version 5.5.2650.21) id CF9WLFPJ; Sat, 10 Feb 2001 15:05:45 -0800
Received: from mail.gnome.org (unverified) by sweeper.cu-portland.edu 
	(Content Technologies SMTPRS 4.1.5) with ESMTP id 
	<Tcf9538428351a54b8096@sweeper.cu-portland.edu> for 
	<GLeblanc@cu-portland.edu>; Sat, 10 Feb 2001 15:05:39 -0800
Received: from mail.gnome.org (localhost.localdomain [127.0.0.1]) by 
	mail.gnome.org (Postfix) with ESMTP id 343392E22E; Sat, 10 Feb 2001 
	18:05:35 -0500 (EST)
Received: from smtp.total.net (rossine.total.net [154.11.89.167]) by 
	mail.gnome.org (Postfix) with SMTP id B8D9F2D04B for <webmaster@gnome.org>; 
	Sat, 10 Feb 2001 18:03:26 -0500 (EST)
Received: (qmail 941 invoked from network); 10 Feb 2001 23:03:24 -0000
Received: from unknown (HELO tamica) (154.20.8.101) by smtp.total.net with 
	SMTP; 10 Feb 2001 23:03:24 -0000
Delivered-To: gnome-webmaster-list@gnome.org
Message-ID: <000a01c093b5$c35eafa0$6508149a@inter.net>
From: "khitam sobh" <tami@ca.inter.net>
To: <webmaster@gnome.org>
Subject: user guide
Date: Sat, 10 Feb 2001 18:04:02 -0500
MIME-Version: 1.0
Content-Type: multipart/alternative; 
	boundary="----=_NextPart_000_0007_01C0938B.D99483A0"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-webmaster-list-admin@gnome.org
Errors-To: gnome-webmaster-list-admin@gnome.org
X-BeenThere: gnome-webmaster-list@gnome.org
X-Loop: gnome-webmaster-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
Reply-To: webmaster@gnome.org
List-Id: Webmaster mail <gnome-webmaster-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Do you have the gnome user guide in french?
If it is available on the net, where can I get it, thanks.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/html; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>

<META content=3D"MSHTML 5.50.4611.1300" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Do you have the gnome user guide in=20
french?</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>If it is available on the net, where can I=
 get it,=20
thanks.</FONT></DIV></BODY></HTML>

------=_NextPart_000_0007_01C0938B.D99483A0--


--=-5p0cBznQ7LiDjmQ3yxfp--



From Ian@shelob.f9.co.uk  Sun Feb 11 12:57:14 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id A8D5A2D9B7
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 12:57:13 -0500 (EST)
Received: (qmail 11399 invoked from network); 11 Feb 2001 17:57:08 -0000
Received: from unknown (HELO shelob) (212.159.32.178)
  by warrior with SMTP; 11 Feb 2001 17:57:08 -0000
Message-ID: <000401c09454$1ab4e3c0$b2209fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "Eric Baudais" <baudais@okstate.edu>
Cc: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 17:57:29 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"Eric Baudais" <baudais@okstate.edu> wrote:
> On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > How
> > would it be if I did could have something finished by the end
> > of this weekend?  I think I can manage that.
> 
> That would be great!

As promised, I have something finished.
It is not perfect, but it is not bad either.
Please download sgml and pngs from
http://www.shelob.plus.com/freecell/
and let me know what you think.

Regards,
Ian




From hobbit@aloss.ukuu.org.uk  Sun Feb 11 14:41:10 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 214E02BB36
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 14:41:09 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1BJgCA02828;
	Sun, 11 Feb 2001 19:42:12 GMT
Date: Sun, 11 Feb 2001 19:42:12 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: Ian@shelob.f9.co.uk
Subject: Re: Freecell Documentation
Message-ID: <20010211194212.B1727@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>,
	Ian@shelob.f9.co.uk
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 05:57:29PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

Dunno if Ian's on the list, so cc'd for now.

> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Looks great to me. Only quibble: fifty-two instead of fifty two (!)
Would it also be possible to explain that you can right-click on a
card in order to see what it is, if it's obscured by cards on top of
it? 

Oh, I suppose it may be worth noting that you click on cards and then
on destinations. I realise this is standard for Windows Freecell, but
it's different from the behaviour of how you move cards in Aisleriot.
I know Zana was thinking of explicitly describing how to move cards
around in aisleriot, so it makes sense to add how you move 'em for
Freecell, since the two are different and people trying one may try
to use the same method for the other.

Telsa


From Ian@shelob.f9.co.uk  Sun Feb 11 15:44:38 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id 907D82BAB4
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 15:44:37 -0500 (EST)
Received: (qmail 2862 invoked from network); 11 Feb 2001 20:44:33 -0000
Received: from unknown (HELO shelob) (212.159.41.48)
  by warrior with SMTP; 11 Feb 2001 20:44:33 -0000
Message-ID: <007d01c0946b$7e79d8e0$30299fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 20:26:14 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa <hobbit@aloss.ukuu.org.uk> wrote
> On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

> Dunno if Ian's on the list, so cc'd for now.

Actually, I am.  Mostly I lurk.

> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.

> Only quibble: fifty-two instead of fifty two (!)

I believe the latter form to be correct.
Jihad! Jihad! Jihad! :-)

> Would it also be possible to explain that you can right-click on a
> card in order to see what it is, if it's obscured by cards on top of
> it?

Yes it would, although not very soon unfortunately.  I feel all
documented out this evening, and I *really* am busy over the
next fortnight.  (I *may* be inclined to tweak a few things next
weekend, but I may instead prefer to do some gardening.)
How long do we have before 1.4 is due?

> I suppose it may be worth noting that you click on cards and then
> on destinations.

Actually, I did mention that.  In the usage section between
figures 2 and 3, I think.  Possibly the screenshots take up more
room than they are worth and just obscure the text?

Thanks for your comments,
Ian





From gleblanc@cu-portland.edu  Sun Feb 11 17:57:19 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 84D192D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 17:57:18 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1BMvGt26067;
	Sun, 11 Feb 2001 14:57:16 -0800
Message-Id: <200102112257.f1BMvGt26067@mail3.aracnet.com>
Subject: Re: Freecell Documentation
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: jrb@redhat.com, itp@ximian.com, zana@webwynk.net,
	cwryu@adam.kaist.ac.kr
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>
References: <20010208150546.A2912@bubba> 
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>  
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 11 Feb 2001 14:55:59 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> "Eric Baudais" <baudais@okstate.edu> wrote:
> > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > How
> > > would it be if I did could have something finished by the end
> > > of this weekend?  I think I can manage that.
> > 
> > That would be great!
> 
> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Just because I enjoy making trouble...  I don't think that a separate
freecell game will exist in the next major release of gnome-games.
Freecell has been implemented as part of the aisleriot suite, and that
version has a few less bugs (and the bugs it does have can be fixed for
all aisleriot games) than the separate C coded freecell game.  This
isn't a sure thing as far as I know, but it's worth being aware of.
Anybody have a good reason -not- to do this?

    Greg



From jrb@redhat.com  Sun Feb 11 18:22:06 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 9AC622D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:22:06 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1BNMl313635;
	Sun, 11 Feb 2001 18:22:47 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, itp@ximian.com,
	zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba>
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
	<200102112257.f1BMvGt26067@mail3.aracnet.com>
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 11 Feb 2001 18:22:47 -0500
In-Reply-To: Gregory Leblanc's message of "11 Feb 2001 14:55:59 -0800"
Message-ID: <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 29
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Gregory Leblanc <gleblanc@cu-portland.edu> writes:

> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

Kill it!!! Kill it!!!!

*squawk*
-Jonathan


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Sun Feb 11 18:25:28 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id 2A9B72E22A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:25:28 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14S5s1-0003uI-00; Sun, 11 Feb 2001 17:25:29 -0600
Date: Sun, 11 Feb 2001 17:25:29 -0600
From: Eric Baudais <baudais@okstate.edu>
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, jrb@redhat.com,
	itp@ximian.com, zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
Message-ID: <20010211172529.A15008@bubba>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <200102112257.f1BMvGt26067@mail3.aracnet.com>; from gleblanc@cu-portland.edu on Sun, Feb 11, 2001 at 02:55:59PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 02:55:59PM -0800, Gregory Leblanc wrote:
> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

I think that we still need docs for Freecell for this release of Gnome.  
Whether Freecell will continue with Gnome is still to be determined, but 
that doesn't reduce the need for these docs any less.

Eric Baudais


From chris@wilddev.net  Mon Feb 12 02:53:22 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 630A32C887
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 02:53:21 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id AAA26386
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 00:02:54 -0800
Message-Id: <200102120802.AAA26386@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 11 Feb 2001 23:53:47 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All
I'm going to attempt to update the GUG. I had a quick look at what was
there in CVS and it appeared like theres a lot of work. If anyone has
objects/comments let me know. 
I spoke with Sasha and Telsa about it and got their ideas for it. I
think the approach I will take will be to integrate exisitng docs into
it and create an index from the info that is there. This will update it
without unnecessarily duplicating the work of others.

Chris (Wilddev)



From hobbit@aloss.ukuu.org.uk  Mon Feb 12 04:21:38 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id E27952E4A3
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:21:37 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1C9Mev06046
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 09:22:40 GMT
Date: Mon, 12 Feb 2001 09:22:39 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
Message-ID: <20010212092239.A5996@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <007d01c0946b$7e79d8e0$30299fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 08:26:14PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> Telsa <hobbit@aloss.ukuu.org.uk> wrote
> 
> > Only quibble: fifty-two instead of fifty two (!)
> 
> I believe the latter form to be correct.
> Jihad! Jihad! Jihad! :-)

Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
 
> > Would it also be possible to explain that you can right-click on a
> > card in order to see what it is, if it's obscured by cards on top of
> > it?
> 
> Yes it would, although not very soon unfortunately. 

Fair enough.

> How long do we have before 1.4 is due?

According to 
http://mail.gnome.org/archives/gnome-1.4-list/2001-January/msg00027.html
the final hard freeze including docs and translations is on 18th March.
Freeze for everything except docs and translations is the 8th March.
I'll bet that gets superseded now I have mentioned it for posterity.
(There is also a releng (release engineering) module in CVS which has a
bunch of stuff in it, but it does not have these dates.)

> > I suppose it may be worth noting that you click on cards and then
> > on destinations.
> 
> Actually, I did mention that.  In the usage section between

Ahem. So you did. My apologies :) 

Telsa


From rjp@mail.tele.dk  Mon Feb 12 04:51:48 2001
Return-Path: <rjp@mail.tele.dk>
Delivered-To: gnome-doc-list@gnome.org
Received: from cicero2.cybercity.dk (cicero2.cybercity.dk [212.242.40.53])
	by mail.gnome.org (Postfix) with ESMTP id F179D2DC88
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:51:47 -0500 (EST)
Received: from usr00.cybercity.dk (usr00.cybercity.dk [212.242.40.34])
	by cicero2.cybercity.dk (Postfix) with ESMTP
	id EAC85FFFA6; Mon, 12 Feb 2001 10:51:45 +0100 (CET)
Received: from mail.tele.dk (IDENT:rjp@port21.cvx1-hb.ppp.cybercity.dk [212.242.232.22])
	by usr00.cybercity.dk (8.9.3/8.9.3) with ESMTP id KAA13626;
	Mon, 12 Feb 2001 10:51:42 +0100 (CET)
	(envelope-from rjp@mail.tele.dk)
Message-ID: <3A87C105.C79184CC@mail.tele.dk>
Date: Mon, 12 Feb 2001 11:55:01 +0100
From: "Rebecca J. Walter" <rjp@mail.tele.dk>
X-Mailer: Mozilla 4.75 [en] (X11; U; Linux 2.2.16-22 i586)
X-Accept-Language: en, da
MIME-Version: 1.0
To: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob> <20010212092239.A5996@aloss.ukuu.org.uk>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa Gwynne wrote:
> 
> On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> > Telsa <hobbit@aloss.ukuu.org.uk> wrote
> >
> > > Only quibble: fifty-two instead of fifty two (!)
> >
> > I believe the latter form to be correct.
> > Jihad! Jihad! Jihad! :-)
> 
> Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
> 
telsa is correct.


From jfleck@swcp.com  Mon Feb 12 09:01:58 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 064D92E53D
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 09:01:58 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id HAA02052
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 07:00:34 -0700
Date: Mon, 12 Feb 2001 07:00:34 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: GNOME Users Guide
Message-ID: <20010212070034.B1770@inkstain.net>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <200102120802.AAA26386@hub.wilddev.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102120802.AAA26386@hub.wilddev.net>; from Chris Lyttle on Sun, Feb 11, 2001 at 11:53:47PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Chris -
This is great. Thanks.

I'll be happy to assemble the chapter(s) for you on the packages I'm
dealing with - gnome-utils, ggv, and ghex. Let me know when and where
and in what form you'd like things.

John

On Sun, Feb 11, 2001 at 11:53:47PM -0800, Chris Lyttle wrote:
> Hi All
> I'm going to attempt to update the GUG. I had a quick look at what was
> there in CVS and it appeared like theres a lot of work. If anyone has
> objects/comments let me know. 
> I spoke with Sasha and Telsa about it and got their ideas for it. I
> think the approach I will take will be to integrate exisitng docs into
> it and create an index from the info that is there. This will update it
> without unnecessarily duplicating the work of others.
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From federico@ximian.com  Mon Feb 12 10:26:26 2001
Return-Path: <federico@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from guanabana.helixcode.com (unknown [212.209.126.33])
	by mail.gnome.org (Postfix) with ESMTP id 0434C2CDE5
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 10:26:26 -0500 (EST)
Received: (from federico@localhost)
	by guanabana.helixcode.com (8.9.3/8.9.3) id JAA30011;
	Mon, 12 Feb 2001 09:36:26 -0600
Date: Mon, 12 Feb 2001 09:36:26 -0600
Message-Id: <200102121536.JAA30011@guanabana.helixcode.com>
X-Authentication-Warning: guanabana.helixcode.com: federico set sender to federico@ximian.com using -f
From: Federico Mena Quintero <federico@ximian.com>
X-Homer: You're everywhere.  You're omnivorous.
To: jrb@redhat.com
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, zana@webwynk.net
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com> <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

jrb@redhat.com writes:

> Kill it!!! Kill it!!!!

There is only one solitaire, and Aisleriot is its name.

  Federico


From emese@sunserv.itp.hu  Tue Feb 13 06:25:56 2001
Return-Path: <emese@sunserv.itp.hu>
Delivered-To: gnome-doc-list@gnome.org
Received: from gamax.hu (ns.gamax.hu [195.184.11.170])
	by mail.gnome.org (Postfix) with ESMTP id EA26B2E60E
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 06:25:48 -0500 (EST)
Received: by gateway.gamax.hu id <116161>; Tue, 13 Feb 2001 12:29:54 +0100
From: Emese Kovacs <emese@gnome.hu>
To: gnome-doc-list@gnome.org
Subject: Docs updated for GKB in gnome-applets HEAD
Message-Id: <01Feb13.122954cet.116161@gateway.gamax.hu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.4i
Date: Tue, 13 Feb 2001 12:29:50 +0100
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All,

As GKB has been rewritten, we have updated its manual (described new features, 
taken new screenshots). I would like to have it reviewed for gnome-1.4 
compatibility and spelling + other problems.

GKB can be checked out from the gnome CVS, it is located in 
gnome-applets/gkb-new

Thanks,

Emese Kovacs
<emese@gnome.hu>



From jacob@ximian.com  Tue Feb 13 18:01:33 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (ulysses.ximian.com [63.140.225.198])
	by mail.gnome.org (Postfix) with ESMTP
	id 6F8C32CCF8; Tue, 13 Feb 2001 18:01:32 -0500 (EST)
Received: from ulysses ([127.0.0.1])
	by ulysses with smtp (Exim 3.22 #1 (Debian))
	id 14SoLI-0000Bj-00; Tue, 13 Feb 2001 17:54:40 -0500
To: gnome-1.4-list@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
Subject: GNOME 1.4 Weekly Update
From: jacob berkman <jacob@ximian.com>
Date: 13 Feb 2001 17:54:39 -0500
Message-ID: <87zofq8a8g.fsf@ximian.com>
Lines: 51
User-Agent: Gnus/5.0807 (Gnus v5.8.7) XEmacs/21.1 (GTK)
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello fans of The GNOME Project,

This is the first installment of a weekly update on the progress of
the GNOME 1.4 "not yet named" release.  Work on this release is
progressing rapidly, with the first beta release currently scheduled
for this Saturday (February 17).

For package maintainers:

    Maintainers of packages that will be included in this beta *must*
    provide tarballs by the end of Thursday.  Please mail
    gnome-1.4-release-team@gnome.org with information on where to find
    the tarball.

    Anybody who is packaging GNOME packages with documentation in it
    should install scrollkeeper 0.0.5 or later:
    http://sourceforge.net/project/showfiles.php?group_id=3D11543

    Dan will write up instructions on using ScrollKeeper soon.=A0 Keep
    an eye on the news on the GDP web page for an announcement of
    these instructions: http://developer.gnome.org/projects/gdp/

    GNOME 1.4 will use Nautilus' gnome-db2html2 converter to display
    SGML documents.=A0 Please make sure that the SGML documents are
    being installed in addition to the HTML.=A0 Also make sure that the
    SGML is compliant with the 1.4 guidelines:
    http://developer.gnome.org/projects/gdp/changes/

    Also, don't forget to mail gnome-i18n@gnome.org a couple of days
    (which is right now, actually) before making your final tarball
    for the beta.

For i18n and doc people:

    A list of the branches for the different modules being released is
    available in the releng module of GNOME cvs, or from lxr:
    http://cvs.gnome.org/lxr/source/releng/gnome-1.4-branches

    Don't worry if everything isn't done by the first beta :)

For testers:

    The GNOME 1.4 beta process will include a list of tests for many
    of the applications.  This will be made available later this week,
    and more information about this will be made at that time.

That's all for now; more information about the release will be
available later this week.

Thanks,
The GNOME 1.4 Release Team  <gnome-1.4-release-team@gnome.org>



From alan@devserv.devel.redhat.com  Tue Feb 13 18:15:12 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id C39912CCF8; Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1DNFBx01803;
	Tue, 13 Feb 2001 18:15:11 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
In-Reply-To: <87zofq8a8g.fsf@ximian.com> from "jacob berkman" at Feb 13, 2001 05:54:39 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

>     provide tarballs by the end of Thursday.  Please mail
>     gnome-1.4-release-team@gnome.org with information on where to find
>     the tarball.
> 
>     Anybody who is packaging GNOME packages with documentation in it
>     should install scrollkeeper 0.0.5 or later:
>     http://sourceforge.net/project/showfiles.php?group_id=11543

By thursday ? Given 2 days notice. Umm



From mjs@eazel.com  Tue Feb 13 19:18:43 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 66E262BAB4; Tue, 13 Feb 2001 19:18:41 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id QAA01825;
	Tue, 13 Feb 2001 16:16:57 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 13 Feb 2001 16:16:57 -0800
In-Reply-To: Alan Cox's message of "Tue, 13 Feb 2001 18:15:11 -0500 (EST)"
Message-ID: <lqk86u6ruu.fsf@pythagoras.eazel.com>
Lines: 30
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> >     provide tarballs by the end of Thursday.  Please mail
> >     gnome-1.4-release-team@gnome.org with information on where to find
> >     the tarball.
> > 
> >     Anybody who is packaging GNOME packages with documentation in it
> >     should install scrollkeeper 0.0.5 or later:
> >     http://sourceforge.net/project/showfiles.php?group_id=11543
> 
> By thursday ? Given 2 days notice. Umm
> 

This has got to be about the 10th time over the past N weeks that this
deadline has been posted. The most recent before this was on Sunday
when I sent a reminder to many of these same lists to start getting
packages ready. We have posted the full schedule of all the
planned betas and package deadlines many times.

And we have also been personally emailing maintainers of packages in
the main release and reminding them on IRC.

I hope this deadline comes as less of a surprise to most people than
it apparently did to Alan.

And if you miss it, hey, there's always beta 2.

 - Maciej




From chris@wilddev.net  Wed Feb 14 00:40:20 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 12AE52BC15
	for <gnome-doc-list@gnome.org>; Wed, 14 Feb 2001 00:40:20 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id VAA02001;
	Tue, 13 Feb 2001 21:49:32 -0800
Message-Id: <200102140549.VAA02001@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: ian@eazel.com
Cc: gnome-doc-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 13 Feb 2001 21:40:40 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi
I just chatted to muet about the scripts you are writing to automate
taking UG docs from cvs and merging it into chapters for the UG GOOD
JOB!
I'll be attempting to do some work on putting the other bits of it
together this weekend, please let me know when you will have something
ready to test/break so I can try it out and we can feed to each other
the changes being made to it.

Thx
Chris (Wilddev)



From alan@devserv.devel.redhat.com  Wed Feb 14 07:32:03 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id 9255F2BA99; Wed, 14 Feb 2001 07:32:02 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1ECW2515224;
	Wed, 14 Feb 2001 07:32:02 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Wed, 14 Feb 2001 07:32:01 -0500 (EST)
Cc: alan@redhat.com (Alan Cox), gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
In-Reply-To: <lqk86u6ruu.fsf@pythagoras.eazel.com> from "Maciej Stachowiak" at Feb 13, 2001 04:16:57 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> This has got to be about the 10th time over the past N weeks that this
> deadline has been posted. The most recent before this was on Sunday

Im not objecting to the tarballing deadline its the suprise go and instal
0.0.5 of scrollkeeper bit

Alan



From dan@eazel.com  Wed Feb 14 20:58:23 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 29DEB2D368; Wed, 14 Feb 2001 20:58:22 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F1wJd14908;
	Wed, 14 Feb 2001 17:58:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 17:58:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
In-Reply-To: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Message-ID: <Pine.LNX.4.21.0102141747590.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 14 Feb 2001, Alan Cox wrote:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit

Sorry about this.  I wrote this note quickly, hoping to get the full
instructions on the web before the newsletter went out and replace this
text, but didn't get it done in time.
 
You only need to have scrollkeeper installed if the GDP elves have come
along and put OMF files in your package.  Right now, this means
gnome-core, gnome-utils, and soon gnome-applets, gnome-media, and
gnome-user-docs.  If you aren't packaging these few modules, you don't
need to worry about scrollkeeper.

Dan





From Lorna.Whelan@ireland.sun.com  Thu Feb 15 05:20:28 2001
Return-Path: <Lorna.Whelan@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP
	id 78A3D2BE58; Thu, 15 Feb 2001 05:20:27 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id CAA26927;
	Thu, 15 Feb 2001 02:20:25 -0800 (PST)
Received: from dbl-ray-2 (dbl-ray-2 [129.156.237.101])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with SMTP id KAA01118;
	Thu, 15 Feb 2001 10:20:23 GMT
Message-Id: <200102151020.KAA01118@ireserver.Ireland.Sun.COM>
Date: Thu, 15 Feb 2001 10:20:23 +0000 (GMT)
From: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Reply-To: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Subject: Localisation Style Guides
To: gnome-i18n@gnome.org, gnome-doc-list@gnome.org
Cc: lorna.whelan@ireland.sun.com, Aoife.Dunne@ireland.sun.com,
	michael.twomey@ireland.sun.com
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mdUVyT/+Qy+6Uia13lTD4w==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

The localisation Style Guides for the following languages
are ready:


Language		Formats available
--------		-----------------

English			.ps .pdf .mif and FrameMaker
French			.ps .pdf .mif and FrameMaker
German			.ps .pdf .mif and FrameMaker
Spanish			.ps .pdf .mif and FrameMaker
Italian			.ps .pdf .mif and FrameMaker
Swedish			.ps .pdf .mif and FrameMaker
Japanese		software: .html   doc: .ps .pdf and FrameMaker
Korean			.pdf
Simplified Chinese	.pdf
Traditional Chinese	.pdf


The following still needs to be done with the style guides:

- convert or rewrite them into docbook format
- rewrite them to make them more Gnome-friendly - all
  references to Sun need to be changed


I have created a tarball of all the style guides and the size is roughly
6Mb, however, I need someone to take the files and place them under the
Gnome CVS tree and also on an appropriate place on the Gnome web site.
Could someone volunteer to do this?


Regards,
Lorna




 ____________________________________________________

 Lorna Whelan			Tel.:+353-1-8199-029
 European Localisation Centre   Fax: +353-1-8199-261
 Sun Ireland		        
 ____________________________________________________



From dhelder@umich.edu  Tue Feb 13 14:07:43 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id E4D0C2DC27; Tue, 13 Feb 2001 14:07:42 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id OAA02437;
	Tue, 13 Feb 2001 14:07:36 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Tue, 13 Feb 2001 14:07:36 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102131401410.28452-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net



From dusk@ravendusk.org  Tue Feb 13 16:39:04 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 309B72BB40
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 16:39:04 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-6.pconline.com [207.191.143.38])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id PAA29344
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:38:59 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Sn6g-0006mu-00
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:35:30 -0600
Date: Tue, 13 Feb 2001 15:35:30 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Updating API docs
Message-ID: <20010213153530.D431@ravendusk.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,

I'm trying to figure out the best way to move inline API comments into
the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
tool to do it automatically, but after some rooting around, it appears
to only parse through the header files.  Is this correct, or have I
missed something?

Do we have to cut & paste the comments manually from the *.c files
into the *.sgml files?

Thanks,
John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From mjs@eazel.com  Wed Feb 14 18:23:52 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 5876C2D1C4; Wed, 14 Feb 2001 18:23:50 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id PAA06633;
	Wed, 14 Feb 2001 15:22:01 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 14 Feb 2001 15:22:01 -0800
In-Reply-To: Alan Cox's message of "Wed, 14 Feb 2001 07:32:01 -0500 (EST)"
Message-ID: <lqhf1wonom.fsf@pythagoras.eazel.com>
Lines: 15
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit
> 

OK, I agree the scrollkeeper thing should have been communicated
better. However, if you can't get it for beta 1, beta 2 is coming up,
and beta 1 does not have to be perfect (that's why it is a beta).

 - Maciej



From dan@eazel.com  Thu Feb 15 00:47:41 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id AFA942C8A2
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 00:47:40 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F5l3903604;
	Wed, 14 Feb 2001 21:47:03 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 21:47:03 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Chris Lyttle <chris@wilddev.net>
Cc: ian@eazel.com, gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <200102140549.VAA02001@hub.wilddev.net>
Message-ID: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I thought I'd add a bit more info here, in case people are curious what we
have in mind...

The problem with how we have done the GNOME User Guide in the past was
that we did it all by hand.  This meant that not only was it hard to
create, it was very hard to keep up to date and very hard for each of the
translation teams to reproduce.  It was basically impossible for
translators to keep up, since it was so much work.

The new proposed solution is to create some scripts which grab docs from
CVS and merge them together to produce a product similar to what we had in
the past, but to automate much of the work.  Once it is set up, doing it
for another locale or updating it is as simple as running the script.  It
is more up-front work, but should not be too bad for somebody who is good
at scripting.

Ian is working on the script, so if he doesn't run out of time or run into
too many problems, we should have something to work with in not too
long.  Chris is working on this with Ian.  Thanks to both of you.

Dan


On 13 Feb 2001, Chris Lyttle wrote:

> Hi
> I just chatted to muet about the scripts you are writing to automate
> taking UG docs from cvs and merging it into chapters for the UG GOOD
> JOB!
> I'll be attempting to do some work on putting the other bits of it
> together this weekend, please let me know when you will have something
> ready to test/break so I can try it out and we can feed to each other
> the changes being made to it.
> 
> Thx
> Chris (Wilddev)



From dhelder@umich.edu  Thu Feb 15 09:39:12 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id 4E7B52BA99; Thu, 15 Feb 2001 09:39:12 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id JAA29621;
	Thu, 15 Feb 2001 09:39:07 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Thu, 15 Feb 2001 09:39:07 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102150935430.29454-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Strange, I sent this Tuesday and I haven't seen it yet so I'm resending
it.  Sorry if you get this twice.]

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net




From kirillov@peconic.math.sunysb.edu  Thu Feb 15 17:52:38 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 202F92E0A5
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 17:22:07 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id RAA12452;
	Thu, 15 Feb 2001 17:22:00 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id RAA11551;
	Thu, 15 Feb 2001 17:21:59 -0500
Date: Thu, 15 Feb 2001 17:21:59 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
Message-ID: <20010215172159.A11517@math.sunysb.edu>
References: <200102140549.VAA02001@hub.wilddev.net> <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>; from dan@eazel.com on Wed, Feb 14, 2001 at 09:47:03PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

For now, having scripts putting different manulas together is better
than doing it by hand. So I'd be happy if Ian and Chhris make this
happen. 

In the long run, I am not so sure having users guide which is just the
collection of manuals of different components lumped together is a
good idea. Good UG should be more task oriented ("how do I do this in
GNOME") and may omit details or some options which should go
in on-line help (i.e., manuals as we have them now). There was a talk
of writing such a users guide or rather a book for GNOME 2.0 - I think
after 1.4 is out, we should return to this project. 

Sasha
  



On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> 
> I thought I'd add a bit more info here, in case people are curious what we
> have in mind...
> 
> The problem with how we have done the GNOME User Guide in the past was
> that we did it all by hand.  This meant that not only was it hard to
> create, it was very hard to keep up to date and very hard for each of the
> translation teams to reproduce.  It was basically impossible for
> translators to keep up, since it was so much work.
> 
> The new proposed solution is to create some scripts which grab docs from
> CVS and merge them together to produce a product similar to what we had in
> the past, but to automate much of the work.  Once it is set up, doing it
> for another locale or updating it is as simple as running the script.  It
> is more up-front work, but should not be too bad for somebody who is good
> at scripting.
> 
> Ian is working on the script, so if he doesn't run out of time or run into
> too many problems, we should have something to work with in not too
> long.  Chris is working on this with Ian.  Thanks to both of you.
> 
> Dan


From dan@eazel.com  Fri Feb 16 03:09:32 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id BB4DD2E0E5
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:09:08 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G88H514657;
	Fri, 16 Feb 2001 00:08:17 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:08:17 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <20010215172159.A11517@math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


I agree.  This sort of a UG, created by lumping the online help together,
should be retired and replaced by a more carefully crafted document.  
This probably won't happen until GNOME 2.0 (about 12 months from now or
more), although it is possible that we get it out somewhat earlier.  In
the mean time, this UG will satisfy an important need: We can place it
prominantly on the web page, allowing people to learn a lot about GNOME
without even installing Linux or GNOME. It is a also single document which
people can either browse through to learn more about GNOME in general, or
they can use it as a reference document as they do with the online help.

I know at least one person who has printed out the entire GNOME User Guide
and basically read it cover to cover when they started using GNOME and was
generally very happy with having learned GNOME this way.

So, I think in these ways the UG is actually quite valuable in its current
form, even though we tend to deprecate it.  For GNOME 2.0, we probably
want to tailor multiple documents to replace the UG, as Sasha has already
started doing in gnome-user-docs.

Generally, I think we will want to use this task oriented approach more in
our online documents and in the Users Guide.

Dan


On Thu, 15 Feb 2001, Alexander Kirillov wrote:

> For now, having scripts putting different manulas together is better
> than doing it by hand. So I'd be happy if Ian and Chhris make this
> happen. 
> 
> In the long run, I am not so sure having users guide which is just the
> collection of manuals of different components lumped together is a
> good idea. Good UG should be more task oriented ("how do I do this in
> GNOME") and may omit details or some options which should go
> in on-line help (i.e., manuals as we have them now). There was a talk
> of writing such a users guide or rather a book for GNOME 2.0 - I think
> after 1.4 is out, we should return to this project. 
> 
> Sasha
>   
> 
> 
> 
> On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> > 
> > I thought I'd add a bit more info here, in case people are curious what we
> > have in mind...
> > 
> > The problem with how we have done the GNOME User Guide in the past was
> > that we did it all by hand.  This meant that not only was it hard to
> > create, it was very hard to keep up to date and very hard for each of the
> > translation teams to reproduce.  It was basically impossible for
> > translators to keep up, since it was so much work.
> > 
> > The new proposed solution is to create some scripts which grab docs from
> > CVS and merge them together to produce a product similar to what we had in
> > the past, but to automate much of the work.  Once it is set up, doing it
> > for another locale or updating it is as simple as running the script.  It
> > is more up-front work, but should not be too bad for somebody who is good
> > at scripting.
> > 
> > Ian is working on the script, so if he doesn't run out of time or run into
> > too many problems, we should have something to work with in not too
> > long.  Chris is working on this with Ian.  Thanks to both of you.
> > 
> > Dan
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 



From dan@eazel.com  Fri Feb 16 03:33:05 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3CF0A2BB41
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:33:05 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G8X4j14907
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 00:33:04 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:33:04 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: gnome-user-docs and gnome-devel-docs
Message-ID: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

I had two new GNOME modules created in CVS today: gnome-user-docs and
gnome-devel-docs

They are both empty.  My plans are to create and ship just two GNOME
packages which are strictly documentation.  So, we can slowly move over
any good documentation into these modules from their current locations.

There are some packages which will die in the process:
	gnome-users-guide
	gnome-user-faq
	gdp-handbook

Some examples of what these modules will contain:

gnome-user-docs:
	Glossary
	Introduction to GNOME
	Introduction to Linux
	GNOME Users Guide
	GNOME User FAQ
        GNOME Quick Reference
	Joining the GNOME Project
	...

gnome-devel-docs:
	GNOME Developer FAQ
	GDP Handbook
	GTP Handbook
	(any white papers which are up to date)
	(any tutorials which are up to date)
	(any other developer documents which are good and up to date)
	...

Generally speaking, gnome-user-docs would ship with the main GNOME
release, and gnome-devel-docs would be in the extra apps packages since
most people don't need them.

So, I think we generally want to get someone with CVS root access to move
these pieces into place from their current locations in CVS, approving
this of course with anybody who may have co-authored each text so they
don't think their doc dissappeared. 

This is our chance to start with a fresh module, so lets be careful to
keep things tidy and keep the build system working.  Remember the basic
directory layout:

gnome-xxx-docs/<docname>/<locale>/{stuff}
gnome-xxx-docs/<docname>/<locale>/{stuff}/figures/

Also be sure that anything you put in these modules are up to date,
written in DocBook/SGML, and licensed under the FDL and appropriately
state so in their legalnotice.

Dan





From damon@ximian.com  Fri Feb 16 10:20:37 2001
Return-Path: <damon@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail6.svr.pol.co.uk (mail6.svr.pol.co.uk [195.92.193.212])
	by mail.gnome.org (Postfix) with ESMTP id E9BA62E5BC
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 10:20:36 -0500 (EST)
Received: from modem-204.dragonette.dialup.pol.co.uk ([62.137.2.204] helo=ximian.com)
	by mail6.svr.pol.co.uk with esmtp (Exim 3.13 #0)
	id 14TmgU-0007cQ-00; Fri, 16 Feb 2001 15:20:34 +0000
Message-ID: <3A8C4CED.960B7A36@ximian.com>
Date: Thu, 15 Feb 2001 21:41:01 +0000
From: Damon Chaplin <damon@ximian.com>
X-Mailer: Mozilla 4.72 [en] (X11; U; Linux 2.2.14-5.0 i686)
X-Accept-Language: en
MIME-Version: 1.0
To: "John R. Sheets" <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
References: <20010213153530.D431@ravendusk.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"John R. Sheets" wrote:
> 
> Hi,
> 
> I'm trying to figure out the best way to move inline API comments into
> the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
> tool to do it automatically, but after some rooting around, it appears
> to only parse through the header files.  Is this correct, or have I
> missed something?
> 
> Do we have to cut & paste the comments manually from the *.c files
> into the *.sgml files?

You normally just leave the API comments in the source code.
gtkdoc-mkdb merges it into the final SGML documentation, if you pass
it the --source-dir option.

Damon




From kbreit@mediaone.net  Fri Feb 16 17:15:21 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id BFAE62E743
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:15:20 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA03735;
	Fri, 16 Feb 2001 16:06:09 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Help for 1.4 QA
Date: Fri, 16 Feb 2001 16:05:05 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
Cc: battery841@mediaone.net
MIME-Version: 1.0
Message-Id: <01021616050500.03732@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
  I am curious if anyone here would be interested in finding QA problems in 
1.4 dox with me.  I'm looking for help, so if you're looking for a job, you 
have no excuse now (other than if you hate tedium ;)
Kevin
PS. Make sure I am on cc: as my email is flakey
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 17:37:51 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 666B32E906
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:37:51 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA28799;
	Fri, 16 Feb 2001 16:28:35 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: Dan Mueth <dan@eazel.com>, gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
Date: Fri, 16 Feb 2001 16:27:33 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="US-ASCII"
References: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
In-Reply-To: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Message-Id: <01021616273300.28362@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> I had two new GNOME modules created in CVS today: gnome-user-docs and
> gnome-devel-docs
>
> They are both empty.  My plans are to create and ship just two GNOME
> packages which are strictly documentation.  So, we can slowly move over
> any good documentation into these modules from their current locations.
Where should I drop the QA gnumeric spreadsheet for now?
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 19:02:13 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 87FC22D4BB
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 19:02:12 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id RAA01258
	for gnome-doc-list@gnome.org; Fri, 16 Feb 2001 17:53:01 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Dia dox ready to go?
Date: Fri, 16 Feb 2001 17:51:56 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
MIME-Version: 1.0
Message-Id: <01021617515701.21176@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
   Wow, I'm active on this list today!  I would like someone to go read my 
documentation for Dia and let me know if it's ready for prime time.  I'm not 
saying it's DONE, but is it something we feel safe releasing in 1.4 in its 
current state.  This would be _greatly_ appreciated.
Thanks
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From dusk@ravendusk.org  Sat Feb 17 12:13:47 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id C474F2D713
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 12:13:46 -0500 (EST)
Received: from exodus.ravendusk.org (m18-4-2.pconline.com [207.191.143.50])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id LAA06230
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:13:43 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UAwH-000066-00
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:14:29 -0600
Date: Sat, 17 Feb 2001 11:14:29 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010217111429.B355@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <3A8C4CED.960B7A36@ximian.com>; from damon@ximian.com on Thu, Feb 15, 2001 at 09:41:01PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 15, 2001, Damon Chaplin <damon@ximian.com> wrote:
> 
> "John R. Sheets" wrote:
> > 
> > Do we have to cut & paste the comments manually from the *.c files
> > into the *.sgml files?
> 
> You normally just leave the API comments in the source code.
> gtkdoc-mkdb merges it into the final SGML documentation, if you pass
> it the --source-dir option.

Yep, that was exactly the problem with the Bonobo API docs: the
--source-dir parameter was set incorrectly.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From jrb@redhat.com  Sat Feb 17 21:44:02 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id BBE472BD79
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 21:44:02 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1I2jOq10285;
	Sat, 17 Feb 2001 21:45:24 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: gnome-doc-list@gnome.org
Subject: Keyword to bugzilla
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 17 Feb 2001 21:45:24 -0500
Message-ID: <ybm8zn4675n.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 8
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I added a new DOCS_NEEDED keyword to bugzilla today.  The idea behind
it, is that if a bug requires a change in documentation when fixed, or
the bug involves the documentation somehow, you can put the keyword in
to indicate that docs need to be written.  I don't know how useful this
will be, but it's worth a shot.

Thanks,
-Jonathan 


From zfrey@bright.net  Sat Feb 17 22:21:20 2001
Return-Path: <zfrey@bright.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from invictus.bright.net (invictus.bright.net [205.212.123.12])
	by mail.gnome.org (Postfix) with ESMTP id 6F31E2BB7B
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 22:21:20 -0500 (EST)
Received: from arch-cas3-cs-35.dial.bright.net ([216.201.22.139])
          by invictus.bright.net with ESMTP
          id <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>;
          Sat, 17 Feb 2001 22:21:19 -0500
Subject: Re: Updating API docs
From: Zach Frey <zfrey@bright.net>
To: John "R." Sheets <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
In-Reply-To: <20010217111429.B355@ravendusk.org>
References: <20010213153530.D431@ravendusk.org>
	<3A8C4CED.960B7A36@ximian.com>  <20010217111429.B355@ravendusk.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.17.08.59 - Preview Release)
Date: 17 Feb 2001 22:25:47 +0000
Mime-Version: 1.0
Message-Id: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:

> Yep, that was exactly the problem with the Bonobo API docs: the
> --source-dir parameter was set incorrectly.


Er, oops, that sounds like my mistake.  Sorry about that.

Now that I see what you did, was the problem that it was broken for
srcdir != builddir?  


Thanks,

Zach





From barreiro@arrakis.es  Sun Feb 18 04:45:15 2001
Return-Path: <barreiro@arrakis.es>
Delivered-To: gnome-doc-list@gnome.org
Received: from correo.madritel.es (unknown [213.37.2.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 0B2F52BD32; Sun, 18 Feb 2001 04:45:15 -0500 (EST)
Received: from pc-int-2.arrakis.es ([213.37.13.136]) by correo.madritel.es
          (Netscape Messaging Server 3.5)  with ESMTP id AAA3F81;
          Sun, 18 Feb 2001 10:42:58 +0100
Content-Length: 691
Message-ID: <XFMail.20010218115129.barreiro@arrakis.es>
X-Mailer: XFMail 1.4.4 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <3A2FA437.E663AF05@ireland.sun.com>
Date: Sun, 18 Feb 2001 11:51:29 +0100 (MET)
Reply-To: barreiro@arrakis.es
Organization: linux landia
From: barreiro@arrakis.es
To: Michael Twomey <michael.twomey@ireland.sun.com>
Subject: Re: Update on Localisation Style Guides and Glossaries
Cc: Gnome Doc List <gnome-doc-list@gnome.org>, ,
	Gnome Doc List <gnome-doc-list@gnome.org>,
	"gnome-i18n@gnome.org" <gnome-i18n@gnome.org>,
	Gregory Leblanc <gleblanc@cu-portland.edu>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 07-Dec-2000 Michael Twomey wrote:
> Gregory Leblanc wrote:
>> 
> 
> Hi,
>       I've sent the glossary to Greg so he should have it up in somewhere
> like gnome-i18n/glossary soon.
> 
> Greg, can I mail you the style guides as well? They are a hefty 4MB
> tarball. Or does someone else want to take them?
> 
> thanks Greg,
>       Michael
>
Hi,

I looked for style guides at Gnome-i18n and gnome-docu but not found it.

Could you tell me where get the Spanish copy?

Regards.


Manuel de Vega Barreiro. barreiro@arrakis.es   En un lugar de la red
Madrid. Espaņa. usuario: 62.146                de cuyo nombre no quiero
http://www.croftj.net/~barreiro Linux Landia   acordarme..........



From dan@eazel.com  Sun Feb 18 04:50:22 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id D0AAD2DD1E
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 04:50:21 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1I9oJ731916;
	Sun, 18 Feb 2001 01:50:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Sun, 18 Feb 2001 01:50:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Kevin Breit <battery841@mediaone.net>
Cc: gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
In-Reply-To: <01021616273300.28362@7of9>
Message-ID: <Pine.LNX.4.21.0102180148100.31875-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Fri, 16 Feb 2001, Kevin Breit wrote:

> On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> > I had two new GNOME modules created in CVS today: gnome-user-docs and
> > gnome-devel-docs
> >
> > They are both empty.  My plans are to create and ship just two GNOME
> > packages which are strictly documentation.  So, we can slowly move over
> > any good documentation into these modules from their current locations.
> Where should I drop the QA gnumeric spreadsheet for now?
> Kevin
> 

These are GDP-related documents which we do not plan to ship, so I would
put them in a new directory at: gnome-docu/gdp/qa/

Things in gnome-user-docs and gnome-devel-docs will only be up-to-date
documents which we plan on shipping in these packages.

Dan



From dusk@ravendusk.org  Sun Feb 18 11:18:32 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 39DFF2BD2D
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 11:18:32 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-11.pconline.com [207.191.143.43])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id KAA13568
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:17 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UWY0-0000Cj-00
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:52 -0600
Date: Sun, 18 Feb 2001 10:18:52 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010218101852.B434@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com> <20010217111429.B355@ravendusk.org> <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>; from zfrey@bright.net on Sat, Feb 17, 2001 at 10:25:47PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 17, 2001, Zach Frey <zfrey@bright.net> wrote:
> 
> On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:
> 
> > Yep, that was exactly the problem with the Bonobo API docs: the
> > --source-dir parameter was set incorrectly.
> 
> Er, oops, that sounds like my mistake.  Sorry about that.

Actually, I think it was Michael Meeks, in revision 1.3 of
Makefile.am, amid a flurry of other changes.  (c;

> Now that I see what you did, was the problem that it was broken for
> srcdir != builddir?  

No, it didn't find the source files at all, even with srcdir ==
builddir.  Didn't go far enough towards the root dir.  Should have
been '../..' rather than '..'.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From erik@core.com  Sun Feb 18 15:20:13 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id D27C92BAAF
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 15:19:37 -0500 (EST)
Received: from core.com (tnt17a-242.focal-chi.corecomm.net [208.40.16.242])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1IKLI545961;
	Sun, 18 Feb 2001 20:21:38 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1IKR2708990;
	Sun, 18 Feb 2001 14:27:02 -0600
Date: Sun, 18 Feb 2001 14:27:02 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: Dan Mueth <dan@eazel.com>
Cc: gnome-doc-list@gnome.org
Subject: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010218142702.L12018@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>; from "dan@eazel.com on Fri, Feb 16, 2001 at 12:08:17AM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Is there any interest in having any of the user or developer docs
recorded? I'm thinking audio books, or even inserting <audioobject> and
<audiodata> tags into the docs themselves. 

All I will need is someone with a good voice to volunteer. (I have a small
studio setup near Chicago.)  

Erik
-- 
All music aspires to the condition of muzak.


From kbreit@mediaone.net  Sun Feb 18 17:14:59 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 4A4CC2CE26
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 17:14:58 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA32529
	for gnome-doc-list@gnome.org; Sun, 18 Feb 2001 16:05:48 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Date: Sun, 18 Feb 2001 15:16:58 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="us-ascii"
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net>
In-Reply-To: <20010218142702.L12018@megsinet.net>
MIME-Version: 1.0
Message-Id: <01021815165800.10931@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> Is there any interest in having any of the user or developer docs
> recorded? I'm thinking audio books, or even inserting <audioobject> and
> <audiodata> tags into the docs themselves.
>
> All I will need is someone with a good voice to volunteer. (I have a small
> studio setup near Chicago.)
That'd be interesting.  It would be best to have it in mp3 format.  If you 
wanted, and we got this rolling soon enough, I could do some voice stuff 
since I live in the Chicago burbs.
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From hobbit@aloss.ukuu.org.uk  Mon Feb 19 17:51:32 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 1959C2BE06
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 17:51:30 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1JMqGW32596
	for gnome-doc-list@gnome.org; Mon, 19 Feb 2001 22:52:16 GMT
Date: Mon, 19 Feb 2001 22:52:16 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010219225216.B32130@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Various people on this list at times have expressed interest in gtkdoc.
I have been trying to find info on it. I can't find much. What I have
is here, because I keep missing people on IRC. And it gets into the
archives here. And I don't know any more than this, so please don't
email me Hard Questions!

Apparently the major problem is that it's a complete sod to install.
If you can't find a nice rpm/deb of it, you're in for pain. Gnome
apparently has its own little something-doc which is a script by
Michael Zucchi and is in CVS. That is what the kernel folks used
as a basis for 'kernel-doc', which is just a script in perl. The
only feature that it is missing which gtkdoc has is something to 
do with classes.

kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
in /linux/scripts. 

On the matter of "how to use the thing once it's installed", it's
the same for kernel-doc and gtk-doc, and so here are the instructions
for kernel-doc on the basis that it might be a quick-start for
gtk-doc: 

----- Forwarded message from Alan Cox <alan@lxorguk.ukuu.org.uk> -----

To: hobbit@aloss.ukuu.org.uk
Subject: Kernel-doc^2
From: Alan Cox <alan@lxorguk.ukuu.org.uk>
Date: Mon, 19 Feb 2001 18:03:42 +0000

Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
so the section on that is relevant and included..


How to add extractable documentation to your source files
---------------------------------------------------------

The format of the block comment is like this:

/**
 * function_name(:)? (- short description)?
(* @parameterx: (description of parameter x)?)*
(* a blank line)?
 * (Description:)? (Description of function)?
 * (section header: (section description)? )*
(*)?*/

The short function description cannot be multiline, but the other
descriptions can be.

All descriptive text is further processed, scanning for the following special
patterns, which are highlighted appropriately.

'funcname()' - function
'$ENVVAR' - environment variable
'&struct_name' - name of a structure (up to two words including 'struct')
'@parameter' - name of a parameter
'%CONST' - name of a constant.

Take a look around the source tree for examples.


Tim.
*/ <twaugh@redhat.com>

----- End forwarded message -----


From otaylor@redhat.com  Mon Feb 19 22:33:06 2001
Return-Path: <otaylor@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from fresnel.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 73CD42CC78
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 22:33:06 -0500 (EST)
Received: by fresnel.labs.redhat.com (Postfix, from userid 2181)
	id CDFB8241BC6; Mon, 19 Feb 2001 22:33:05 -0500 (EST)
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
References: <20010219225216.B32130@aloss.ukuu.org.uk>
From: Owen Taylor <otaylor@redhat.com>
Date: 19 Feb 2001 22:33:05 -0500
In-Reply-To: Telsa Gwynne's message of "Mon, 19 Feb 2001 22:52:16 +0000"
Message-ID: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Lines: 129
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Actually, gtk-doc goes a lot beyond simply parsing the 
function doc comments. (And in fact, it didn't originally
do that at all!)

Among other things, it:

 - Knows about the GTK+ object system - object heirarchies,
   signals, properties, etc.

 - Parses header files to find out about typedefs,
   
 - Integrates documentation from template files with
   the parsed header files.

   (This one of the distinguishing characteristics of gtk-doc - 
   it doesn't try to put all documentation inline - just
   the parts that make sense.)

There is a fair bit of information the doc/ directory
of gtk-doc/. Trevor Curtis is apparently also doing some
work on doing GDP-style documentation, though I don't
know how far he's gotten with that.


As far as installation, gtk-doc is wonderously easy to install.  There
is a RPM of it in the RH rawhide tree, though it's a bit out of date,
but it's also just a simple:

 ./configure ; make install

out of CVS. The thing about gtk-doc is:

 - It's a tool for GTK+/GNOME programmers to do docs for other
   programmers, so the docs for gtk-doc assume a lot of 
   knowledge about programming.

 - It's a real pain to set it up to document a library. I mean, a
   major pain.  Hard. Involves creating a number of files with magic
   contents, and then knowing more about make than you ever wanted to
   know.

   I've gone out on a limb and made the statement that the reference
   doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
   are just about perfect. They are also meant to be easy to modify
   without having to change the scary parts.  So, they may be worth
   copying.

   But I wish I knew how we could make it easier to set up.

   More documentation helps, but it there are just too many files to
   juggle, and it shouldn't take 200 lines of Makefile boilerplate.

Once it's been set up. It's not bad to use - you just
either edit the pseudo-sgml files in the tmpl/ directory or
you edit the inline function headers. But the set up is
the killer.

(Perhaps we need to create a gtkdocize script, like libtoolize
and gettextize.)

Regards,
                                        Owen


Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:

> Various people on this list at times have expressed interest in gtkdoc.
> I have been trying to find info on it. I can't find much. What I have
> is here, because I keep missing people on IRC. And it gets into the
> archives here. And I don't know any more than this, so please don't
> email me Hard Questions!
 
> Apparently the major problem is that it's a complete sod to install.
> If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> apparently has its own little something-doc which is a script by
> Michael Zucchi and is in CVS. That is what the kernel folks used
> as a basis for 'kernel-doc', which is just a script in perl. The
> only feature that it is missing which gtkdoc has is something to 
> do with classes.
> 
> kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> in /linux/scripts. 
> 
> On the matter of "how to use the thing once it's installed", it's
> the same for kernel-doc and gtk-doc, and so here are the instructions
> for kernel-doc on the basis that it might be a quick-start for
> gtk-doc: 
> 
> From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> Subject: Kernel-doc^2
> To: hobbit@aloss.ukuu.org.uk
> Date: Mon, 19 Feb 2001 18:03:42 +0000
> 
> 
> Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
> so the section on that is relevant and included..
> 
> 
> How to add extractable documentation to your source files
> ---------------------------------------------------------
> 
> The format of the block comment is like this:
> 
> /**
>  * function_name(:)? (- short description)?
> (* @parameterx: (description of parameter x)?)*
> (* a blank line)?
>  * (Description:)? (Description of function)?
>  * (section header: (section description)? )*
> (*)?*/
> 
> The short function description cannot be multiline, but the other
> descriptions can be.
> 
> All descriptive text is further processed, scanning for the following special
> patterns, which are highlighted appropriately.
> 
> 'funcname()' - function
> '$ENVVAR' - environment variable
> '&struct_name' - name of a structure (up to two words including 'struct')
> '@parameter' - name of a parameter
> '%CONST' - name of a constant.
> 
> Take a look around the source tree for examples.
> 
> 
> Tim.
> */ <twaugh@redhat.com>


From rob@funky-penguin.co.uk  Tue Feb 20 06:57:39 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id E5EB72BA99
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 06:57:38 -0500 (EST)
Received: from [213.123.15.171] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14VBQH-00050M-00
	for gnome-doc-list@gnome.org; Tue, 20 Feb 2001 11:57:37 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14VBTG-0001Uu-00
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 12:00:42 +0000
Date: Tue, 20 Feb 2001 12:00:41 +0000
To: gnome-doc-list@gnome.org
Subject: Intent to package Gnotravex, Gnometris, gnobotsII
Message-ID: <20010220120041.A5755@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I regularly play these three so will volunteer to do them. And i'll get an
initial draft of one of these up by this evening.

I'll modify the doctable as soon as soon as i find out my username and
password.

rob
-- 
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet


From trevor.curtis@home.com  Tue Feb 20 13:08:11 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id D10E92BA85
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 13:08:10 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010220180742.EWJZ12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 10:07:42 -0800
Date: Tue, 20 Feb 2001 13:09:35 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010220130935.A1152@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
X-Operating-System: Linux frink.thesimpsons.ca 2.4.1
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hey all,

I joined the gdp a few weeks ago.  When Dan Mueth and I originally
spoke, we had agreed that I was to continue the gtk-doc
manual.  The problem however, was that I had little experience with
things such as cvs, autoconf, automake, and the like.  So I've
temporarily put the gtk-doc manual on hold, whilst I learn the above
by doing other smaller projects.

All this to say that this lack of documentation for gtk-doc is an
issue that is trying to be addressed.  Unfortunately, until I learn
more about the subject, and the other bits of knowledge that I must
aquire to complete this job, it may be some time before I'm able to
complete the manual.

If anyone has ideas or just wants to look at was is already there, it
is available in cvs.  

regards,

On Mon, Feb 19, 2001 at 10:33:05PM -0500, Owen Taylor wrote:
> To: gnome-doc-list@gnome.org
> Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
> From: Owen Taylor <otaylor@redhat.com>
> Date: 19 Feb 2001 22:33:05 -0500
> 
> 
> Actually, gtk-doc goes a lot beyond simply parsing the 
> function doc comments. (And in fact, it didn't originally
> do that at all!)
> 
> Among other things, it:
> 
>  - Knows about the GTK+ object system - object heirarchies,
>    signals, properties, etc.
> 
>  - Parses header files to find out about typedefs,
>    
>  - Integrates documentation from template files with
>    the parsed header files.
> 
>    (This one of the distinguishing characteristics of gtk-doc - 
>    it doesn't try to put all documentation inline - just
>    the parts that make sense.)
> 
> There is a fair bit of information the doc/ directory
> of gtk-doc/. Trevor Curtis is apparently also doing some
> work on doing GDP-style documentation, though I don't
> know how far he's gotten with that.
> 
> 
> As far as installation, gtk-doc is wonderously easy to install.  There
> is a RPM of it in the RH rawhide tree, though it's a bit out of date,
> but it's also just a simple:
> 
>  ./configure ; make install
> 
> out of CVS. The thing about gtk-doc is:
> 
>  - It's a tool for GTK+/GNOME programmers to do docs for other
>    programmers, so the docs for gtk-doc assume a lot of 
>    knowledge about programming.
> 
>  - It's a real pain to set it up to document a library. I mean, a
>    major pain.  Hard. Involves creating a number of files with magic
>    contents, and then knowing more about make than you ever wanted to
>    know.
> 
>    I've gone out on a limb and made the statement that the reference
>    doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
>    are just about perfect. They are also meant to be easy to modify
>    without having to change the scary parts.  So, they may be worth
>    copying.
> 
>    But I wish I knew how we could make it easier to set up.
> 
>    More documentation helps, but it there are just too many files to
>    juggle, and it shouldn't take 200 lines of Makefile boilerplate.
> 
> Once it's been set up. It's not bad to use - you just
> either edit the pseudo-sgml files in the tmpl/ directory or
> you edit the inline function headers. But the set up is
> the killer.
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)
> 
> Regards,
>                                         Owen
> 
> 
> Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:
> 
> > Various people on this list at times have expressed interest in gtkdoc.
> > I have been trying to find info on it. I can't find much. What I have
> > is here, because I keep missing people on IRC. And it gets into the
> > archives here. And I don't know any more than this, so please don't
> > email me Hard Questions!
>  
> > Apparently the major problem is that it's a complete sod to install.
> > If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> > apparently has its own little something-doc which is a script by
> > Michael Zucchi and is in CVS. That is what the kernel folks used
> > as a basis for 'kernel-doc', which is just a script in perl. The
> > only feature that it is missing which gtkdoc has is something to 
> > do with classes.
> > 
> > kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> > in /linux/scripts. 
> > 
> > On the matter of "how to use the thing once it's installed", it's
> > the same for kernel-doc and gtk-doc, and so here are the instructions
> > for kernel-doc on the basis that it might be a quick-start for
> > gtk-doc: 
> > 
> > From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> > Subject: Kernel-do


From glynn.foster@Sun.COM  Wed Feb 21 11:58:29 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id D02252E0B0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 11:58:28 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id IAA11518
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 08:58:27 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id QAA09744
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 16:58:23 GMT
Message-ID: <3A93F3E0.C56F6F45@Sun.COM>
Date: Wed, 21 Feb 2001 16:59:12 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Session capplet documentation
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Heya,
Just recently I was working on a multisession hack for gnome-session
which is pretty much finished and in for the GNOME1.4 release. The 
hack involved changing the capplet code and, as a result, the structure 
of the 'Startup Programs' gui.
I was checking through the documentation for the control-center and 
realised that some of it needs to be rewritten for 1.4 [different 
screenshots, added functionality]
I think I identified it to the following cvs module -

		desktop-docs/gnomecc.sgml

I would be quite happy to document some of the changes but being a 
mere insignificant software developer I thought I'd ask first and
find out the proccess for this.

			Thanks,
				Glynn ;)


-- 
Glynn Foster				Email: glynn.foster@ireland.sun.com
Desktop Apps & MiddleWare		Tel:   +353 - 1 - 8199782
Sun Microsystems Ireland Ltd.           Generation dot-COM        i||c Gman


From dusk@ravendusk.org  Wed Feb 21 13:29:00 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id B14222E211
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 13:28:59 -0500 (EST)
Received: from exodus.ravendusk.org (m18-6-16.pconline.com [207.191.143.96])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id MAA25803
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:28:56 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Ve1A-0000Mo-00
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:29:36 -0600
Date: Wed, 21 Feb 2001 12:29:36 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010221122936.D475@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 19, 2001, Owen Taylor <otaylor@redhat.com> wrote:
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)

Oooh, I like the sound of that.  Wonder how much of the setup is
automatable...?

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From kirillov@math.sunysb.edu  Wed Feb 21 14:11:08 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 812AD2E0F0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:08 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id OAA01184
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:07 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id OAA05760;
	Wed, 21 Feb 2001 14:11:07 -0500
Date: Wed, 21 Feb 2001 14:11:07 -0500
Message-Id: <200102211911.OAA05760@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,
I am currently maintaining the documentation for control-center
(btw, it is located at
control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Probably the easiest way would be if you just send me the patch to the
existing file, and I'll check it into CVS. Or you can send me the list
of changes and I'll modify the doc myself - whatever you prefer.

Is this new functionality in gnome-14.beta1? If so, I can take the
screenshots myself (I plan to install beta1 later today).

Best,
Sasha

On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> Heya,
> Just recently I was working on a multisession hack for gnome-session
> which is pretty much finished and in for the GNOME1.4 release. The 
> hack involved changing the capplet code and, as a result, the structure 
> of the 'Startup Programs' gui.
> I was checking through the documentation for the control-center and 
> realised that some of it needs to be rewritten for 1.4 [different 
> screenshots, added functionality]
> I think I identified it to the following cvs module -
> 
>               desktop-docs/gnomecc.sgml
> 
> I would be quite happy to document some of the changes but being a 
> mere insignificant software developer I thought I'd ask first and
> find out the proccess for this.
> 
>                       Thanks,
>                               Glynn ;)
> 


From glynn.foster@Sun.COM  Wed Feb 21 14:29:42 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id D693F2BB47
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:29:41 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id LAA02853;
	Wed, 21 Feb 2001 11:29:39 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id TAA01032;
	Wed, 21 Feb 2001 19:29:27 GMT
Message-ID: <3A941749.21CC4F81@Sun.COM>
Date: Wed, 21 Feb 2001 19:30:17 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
References: <200102211911.OAA05760@copiague.math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Apologies if you are receiving this more than once...must have 
screwed up sending it the first time :/ ]


Heya Sasha,

> Hi,
> I am currently maintaining the documentation for control-center
> (btw, it is located at
> control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Yeah, that was pointed out to me this afternoon...for some reason
the documentation hasn't been transferred over to HEAD yet.

> Probably the easiest way would be if you just send me the patch to the
> existing file, and I'll check it into CVS. Or you can send me the list
> of changes and I'll modify the doc myself - whatever you prefer.

I'm easy about this...What might be the best solution, is for me to send
over a patch to the existing file and you can edit it as you see fit.
I'm no documentation wizard ;)

> Is this new functionality in gnome-14.beta1? If so, I can take the
> screenshots myself (I plan to install beta1 later today).

Yes this is new functionality in beta1.
I've taken screenshots already :) but you can take your own if you wish...
The ones I've taken are at
http://www.geocities.com/gmansundude/gccsessopt.png
http://www.geocities.com/gmansundude/gccstartup.png

[but I'm actually not sure of the quality - just looking at them a minute
ago].

I'll get the patches done pretty soon.
                
                Many thanks,
                        Glynn ;)

> 
> Best,
> Sasha
> 
> On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> > Heya,
> > Just recently I was working on a multisession hack for gnome-session
> > which is pretty much finished and in for the GNOME1.4 release. The
> > hack involved changing the capplet code and, as a result, the structure
> > of the 'Startup Programs' gui.
> > I was checking through the documentation for the control-center and
> > realised that some of it needs to be rewritten for 1.4 [different
> > screenshots, added functionality]
> > I think I identified it to the following cvs module -
> >
> >               desktop-docs/gnomecc.sgml
> >
> > I would be quite happy to document some of the changes but being a
> > mere insignificant software developer I thought I'd ask first and
> > find out the proccess for this.
> >
> >                       Thanks,
> >                               Glynn ;)
> >


From kirillov@math.sunysb.edu  Wed Feb 21 15:57:20 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id E5F202BB41
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:19 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id PAA02713
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:18 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id PAA13250;
	Wed, 21 Feb 2001 15:57:18 -0500
Date: Wed, 21 Feb 2001 15:57:18 -0500
Message-Id: <200102212057.PAA13250@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: scrollkeeper and gnome 1.4
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi guys:

I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
surprise, no OMF files were installed at all: /usr/share/omf contains
scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
wrong with the packages - could you (or someone else) look into this? 

Sasha


From dan@eazel.com  Thu Feb 22 06:34:00 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id EDD532BA83
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:33:59 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBXJ822189;
	Thu, 22 Feb 2001 03:33:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:33:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
Subject: Re: scrollkeeper and gnome 1.4
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 21 Feb 2001, Alexander Kirillov wrote:

> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 

This doesn't entirely surprise me.  We were working on getting this done
right around the package deadline for GNOME 1.4 beta1, so I suspect the
packages were submitted before we added the OMF metadata.  I have spoken
with Jacob, who does a lot of the packaging work at Ximian, about how the
OMF and ScrollKeeper integration works, so he knows how to make things
work.  I even gave him my spec file for gnome-core (which I originally
took from him and then modified).  So, my guess is we just missed the
deadline for when they took their beta1 snapshot.  I expect things to work
for beta2, although it is a good idea to double-check this.

Jacob - could you comment?

Dan



From dan@eazel.com  Thu Feb 22 06:49:01 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 32B6D2E032
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:49:00 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBmxQ22325
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 03:48:59 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:48:59 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: Finished docs
Message-ID: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everybody,

Since we are approaching the GNOME 1.4 release, I have decided to start
producing a weekly list of documents which are completely Done(TM) to send
to the translators for translation.  

By Done, I mean:

0) It is decent. ie. It is worth translating.  Basically this means it is
not obsolete or mostly filled with FIXME's.

1) It is finished, as far as GNOME 1.4 is concerned.  ie. It may not be
perfect or even complete, but it will not experience any more changes
before GNOME 1.4 except for major bug fixes. (eg. it states something
which is false or doesn't render properly in Nautilus)

2) It follows the 1.4 doc
guidelines: http://developer.gnome.org/projects/gdp/changes/

3) It has gone through a simple test in Nautilus to make sure each page
renders properly.

4) The screenshots are finished, or at least won't change much

5) Hopefully it actually builds and installs fine with the package it
belongs too.

#0 through #2 are crucial.  If possible, satisfy #3 through #5 too.  If
you need help testing it in Nautilus, email this list or ask around on
#docs to find somebody with a working Nautilus.

Please email me with a list of documents which you feel are Done(TM) each
Thursday, and I'll compile the list and send it to gnome-i18n-list each
Friday so that the translators can have a fun-filled weekend of
translations each week :)

Dan



From glynn.foster@Sun.COM  Thu Feb 22 08:44:34 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 2B13E2CC04
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:44:34 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id FAA00862;
	Thu, 22 Feb 2001 05:44:29 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id NAA12515;
	Thu, 22 Feb 2001 13:44:24 GMT
Message-ID: <3A9517EB.FB6CCA0A@Sun.COM>
Date: Thu, 22 Feb 2001 13:45:15 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: kirillov@math.sunysb.edu, gnome-doc-list@gnome.org
Subject: Session capplet doc diff
Content-Type: multipart/mixed;
 boundary="------------1CCC036EA35DA3B43F0F89A4"
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Hi Sasha,
Here is the diff for control-center/docs/C/gnomecc.sgml Hope this is okay..
I'm cc'ing gnome-doc-list in case anyone has any feedback...
I've included the extra figures [from the links on my previous email] but
if you want to take better screenshots, feel free.

			Glynn :)
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii;
 name="sessiondoc.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="sessiondoc.diff"

Index: gnomecc.sgml
===================================================================
RCS file: /cvs/gnome/control-center/doc/C/Attic/gnomecc.sgml,v
retrieving revision 1.1.2.5
diff -u -r1.1.2.5 gnomecc.sgml
--- gnomecc.sgml	2001/02/12 17:00:25	1.1.2.5
+++ gnomecc.sgml	2001/02/22 13:39:38
@@ -884,8 +884,8 @@
       <title>Session</title>
     <para>
       The Session Group provides you methods of controlling various items that
-      occur with the startup of your GNOME Session. These include startup
-      programs and startup hints.
+      occur with the startup of your GNOME Session. These include session options,
+      startup programs and startup hints.
     </para>
     <sect2 id="startup-hints">
       <title>Startup Hints</title>
@@ -927,40 +927,36 @@
       </figure>
     </sect2>
     <sect2 id="startup-progs">
-      <title>Startup Programs</title>
+      <title>Session Options & Startup Programs</title>
       <para>
-	Startup Programs capplet allows you control what applications
-	are started at login. By default, GNOME
-	starts some default programs, such as File Manager (necessary
-	for functioning of the desktop), Panel and all applets in it,
-	and some other supporting programs. But it can do more than
-	that. 
+        The Session Options & Startup Programs capplet allows you to
+        control your session. GNOME has the concept of session 
+        management. In simple terms, it means that you can save your
+        <quote>session</quote> (that is, information about currently
+        working applications, their status and position on the screen)
+        at any stage, and at your next login the same applications will
+        reappear on your screen in the same positions, allowing you to 
+        continue your work. Note, however, this only works for GNOME 
+        compliant applications. By default, GNOME starts some default
+        programs, such as File Manager (necessary for functioning of
+        the desktop), Panel and all applets in it, and some other 
+        supporting programs. But it can do much more than that.
       </para>
       <para> 
-	First, GNOME has the concept of session management. In simple
-	terms, it means that you can save your <quote>session</quote>
-	(that is, information about currently working applications,
-	their status and position on screen) at logout and at your next
-	login the same applications will reappear on your screen in
-	the same positions, allowing you to continue your
-	work. Note, however, that this  only works for GNOME
-	applications. 
-      </para>
-      <para> 
 	GNOME also provides another way of starting applications at
-	login. You can explicitly specify one or more  commands to
+	login. You can explicitly specify one or more commands to
 	run, and GNOME will execute them at login. This works for all
-	kinds of applications, whether GNOME compatible or not.  
+	kinds of applications, whether GNOME compliant or not.  
       </para>
       <para> 
-	Startup Programs capplet allows you to configure all of these
-	options, as described below. 
+	Session Options & Startup Programs capplet allows you to configure 
+	all of these options, as described below. 
       </para>
       <figure>
-	<title>Startup Programs Capplet</title>
+	<title>Session Options Capplet</title>
 	<screenshot>
-	  <screeninfo>Startup Programs Capplet</screeninfo>
-	  <graphic format="png" fileref="./figs/gccstartup" srccredit="dcm">
+	  <screeninfo>Session Options Capplet</screeninfo>
+	  <graphic format="png" fileref="./figs/gccsessopt" srccredit="gman">
 	  </graphic>
 	</screenshot>
       </figure>
@@ -979,13 +975,13 @@
 	    <guilabel>Prompt on logout</guilabel> &mdash; If this
 	    option is enabled, a confirmation dialog will appear at
 	    logout. Among other things, this dialog asks you if you
-	    want to save the current session. If you answer
-	    <guilabel>Yes</guilabel>, the current session will be
-	    saved and will be restored at your next login. If you
+	    want to save the current session if you have set the 
+            checkbox for <guilabel> Automatically save session</guilabel>.
+            If you answer <guilabel>Yes</guilabel>, the current session 
+	    will be saved and will be restored at your next login. If you
 	    answer <guilabel>No</guilabel>, the previous saved session
 	    will be used.  
 	  </para> 
-
 	</listitem>
 
 	<listitem>
@@ -1003,6 +999,42 @@
 	    </menuchoice> from the <guimenu>Main Menu</guimenu>. 
 	  </para>
 	</listitem>
+        
+        <listitem>
+          <para>
+            <guilabel>Choose Current Session</guilabel> &mdash;
+             In this section, you can explicitly specify which session
+             to save to, but a save won't occur until you specifically
+             do so. Here, you can also create new sessions, edit and 
+             delete existing sessions. 
+          </para>
+          <para> 
+            To add a new session, press the <guibutton>Add</guibutton> 
+            button and enter in a new session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To edit an existing session name, highlight the session
+            name you wish to edit, press the <guibutton>Edit</guibutton> button
+            and edit the existing session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To delete an existing session name, highlight the session
+            name you wish to delete, press the <guibutton>Delete</guibutton>
+            button.
+          </para>
+        </listitem>  
+        </itemizedlist>
+        <figure>
+ 	  <title>Startup Programs Capplet</title>
+	  <screenshot>
+	    <screeninfo>Startup Programs Capplet</screeninfo>
+	    <graphic format="png" fileref="./figs/gccstartup" srccredit="gman">
+	    </graphic>
+	  </screenshot>
+        </figure>
+      <itemizedlist mark="opencircle">
 	<listitem>
 	  <para>
 	    <guilabel>Non-session managed startup programs</guilabel> &mdash; 
@@ -1406,4 +1438,4 @@
  </sect1>
 
 
-  </article>
\ No newline at end of file
+  </article>

--------------1CCC036EA35DA3B43F0F89A4--



From jfleck@swcp.com  Thu Feb 22 08:50:41 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 879032D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:50:40 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00779
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:49:16 -0700
Date: Thu, 22 Feb 2001 06:49:16 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: scrollkeeper and gnome 1.4
Message-ID: <20010222064916.A770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <200102212057.PAA13250@copiague.math.sunysb.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>; from Alexander Kirillov on Wed, Feb 21, 2001 at 03:57:18PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 03:57:18PM -0500, Alexander Kirillov wrote:
> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 
> 

I know the omf installation was not in place in the gnome-utils
package in time for the first beta. It's done in cvs now.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jfleck@swcp.com  Thu Feb 22 08:58:49 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id B13B32D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:58:48 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00797
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:57:24 -0700
Date: Thu, 22 Feb 2001 06:57:24 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Finished docs
Message-ID: <20010222065724.B770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>; from Dan Mueth on Thu, Feb 22, 2001 at 03:48:59AM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Thu, Feb 22, 2001 at 03:48:59AM -0800, Dan Mueth wrote:
> 
> Since we are approaching the GNOME 1.4 release, I have decided to start
> producing a weekly list of documents which are completely Done(TM) to send
> to the translators for translation.  
> 

Could you include with the list the name and email of the relevant
package coordinators? We need to make sure we know when translations
go in, so we can add in the appropriate omf files and add them to the
build system.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jacob@ximian.com  Thu Feb 22 12:43:25 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (unknown [208.4.24.67])
	by mail.gnome.org (Postfix) with ESMTP id C55182DB91
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 12:43:25 -0500 (EST)
Received: from jacob by ulysses with local (Exim 3.22 #1 (Debian))
	id 14Vzee-0000N7-00; Thu, 22 Feb 2001 12:35:48 -0500
Subject: Re: scrollkeeper and gnome 1.4
From: jacob berkman <jacob@ximian.com>
To: Dan Mueth <dan@eazel.com>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
In-Reply-To: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 12:35:47 -0500
Mime-Version: 1.0
Message-Id: <E14Vzee-0000N7-00@ulysses>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 22 Feb 2001 03:33:19 -0800, Dan Mueth wrote:
> 
> On Wed, 21 Feb 2001, Alexander Kirillov wrote:
> 
> > 
> > Hi guys:
> > 
> > I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> > surprise, no OMF files were installed at all: /usr/share/omf contains
> > scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> > wrong with the packages - could you (or someone else) look into this? 
> 
> This doesn't entirely surprise me.  We were working on getting this done
> right around the package deadline for GNOME 1.4 beta1, so I suspect the
> packages were submitted before we added the OMF metadata.



> I have spoken with Jacob, who does a lot of the packaging work at Ximian

actually i don't do packaging stuff anymore :)

> work.  I even gave him my spec file for gnome-core (which I originally
> took from him and then modified).  So, my guess is we just missed the
> deadline for when they took their beta1 snapshot.  I expect things to work
> for beta2, although it is a good idea to double-check this.

yeah, the plan is to have it working by beta2.  the scrollkeeper tarball
was no good, and nothing used it, and the distro guys were on a tight
deadline anyway.

jacob
-- 
"The people who made the Macintosh produced a miracle, but that
 doesn't mean their code was wonderful." -- Bob Cringely


From gleblanc@cu-portland.edu  Fri Feb 23 00:28:32 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id 85EAB2E5A8; Fri, 23 Feb 2001 00:27:59 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1N5RxQ09400;
	Thu, 22 Feb 2001 21:27:59 -0800
Message-Id: <200102230527.f1N5RxQ09400@mail2.aracnet.com>
Subject: GDP Release Committee Minutes
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 21:26:22 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 18, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Kenny Graunke
Laszlo Kovacs
John Fleck
Alexander Kirillov (arrived 1:18) (departed 1:53)
Ali Abdin (arrived 1:45)

Absent:
-------


Regrets:
--------


Decisions:
----------

- Meeting time agreed to be at 1:00PM PT (9:00PM UTC) on Sunday for
  GDP Release Committee meetings.

- Gregory Leblanc will serve as secretary at meetings

- User's Manuals for applications should be kept in the
  '<application>/help/<locale>/*' sub-directory in CVS, and figures,
  screen shots, and other graphics should go into
  '<application>/help/<locale>/figures'.

- Maintainers assigned for coordinating documentation in various
  modules for the GNOME 1.4 release.  This involves maintaining an
  idea of what the status of a particular module's documentation is
  in, and being a liaison between the docs writers and the application
  hackers.

  - ggv -- John Fleck
  - gnome-applets -- Telsa Gwynne
  - gnome-core -- Dan Mueth
  - gnome-utils -- John Fleck
  - gnome-games -- Gregory Leblanc
  - nautilus -- Dan Mueth
  - ghex -- John Fleck
  - control-center -- Alexander Kirillov
  - bug-buddy -- Telsa Gwynne
  - dia -- Kevin Breit

- Future GDP Release Committee meetings will be open to all GNOME
  members.  This meeting was held without general publication to
  ensure that we could schedule a time for regular meetings, and to
  ensure that the meeting was as effective per time spent as
  possible.  Kevin Breit will be coordinating the Quality Assurance
  efforts for the GDP durring the GNOME 1.4 timeframe.

Work Done:
----------
Since this is our first meeting, we haven't finished any work since
the last meeting.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth -- put HACKING files into gnome-user-docs and
  gnome-devel-docs, and to inform gnome-hackers about the new modules
  and refer them to the HACKING files for further information.

- TODO: Alexander Kirillov -- gather a list of documentation that is
needs to
  be moved into gnome-user-docs, and to email this to Gregory Leblanc
  <gleblanc@cu-portland.edu>
- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Telsa Gwynne -- create a gnome-user-docs product in bugzilla.
  Alexander Kirillov and Telsa Gwynne would like to work on these
  docs, but has more to do than she can handle already, so this will
  wait for now.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.

- INFORMATION: John and Ali reported on the status of gnome-db2html2.
  gnome-db2html2 is mostly solid, with only a few minor known-bugs
  left.  Indexing support isn't included yet, and there is not enough
  time to get it added before 1.4.  Strings have been marked for
  translation, so navigation should appear in the user's specified
  language.  Ali would like to have the navigation links that are
  generated match the locale of the doc, rather than the locale that
  the user has set, but this isn't written yet.  The status of
  Japanese in gnome-db2html2 is -unknown-.

- TODO: John Fleck and Dan Mueth -- test i18n in gnome-db2html2

- TODO: Dan Mueth -- follow up on the bugs with HTML Help in Nautilus.
  Bugs #4302,* #5945, and#6761 in the Nautilus bug system.

- TODO: Dan Mueth -- have Jacob Berkman patch gnome-libs to make
  nautilus the default help browser.

- TODO: Ask Arik to do the "font stuff" for the help sidebar in
  nautilus.

- TODO: Dan Mueth -- enable ScrollKeeper for the help sidebar in the
  default build of Nautilus, including hourly RPMs.

- TODO: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- TODO: Kevin Breit -- develop test assertions, and document
  this procedure so that it can be applied for GNOME 1.4

- TODO: Kevin Breit -- divide docs into groups for QA volunteers to
  sign up for.

- TODO: Laszlo Kovacs-- repair locale fallback for ScrollKeeper in time
for
  GNOME 1.4.  

- INFORMATION: Scrollkeeper will need to be installed on end user
  machines to make the help sidebar in nautilus work properly.  People
  who build packages including OMF metadata should install
  ScrollKeeper so that the document metadata is included in the
  package.  ScrollKeeper can be obtained from:
  http://sourceforge.net/project/showfiles.php?group_id=11543&release_id=24049

- TODO: All Package Coordinators -- gather a list of docs that have
  been completed recently, and are now "frozen".  Mail this list to
  Dan Mueth on Thursday, and he'll collect it and post it to the
  gnome-i18n mailing list.  This is a weekly -recurring- task.

- TODO: Telsa Gwynne -- talk to the i18n team and get feedback on what
  the GDP can do to make translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)


Agenda Items Left For Next Meeting:
-----------------------------------

- User's Guide to be left until the next meeting.  Please review the
  mail by Dan, and prepare for the test at the next meeting.  :)

- Review the list of unfinished documents.

- Discuss use of Bugzilla for the GDP further.

Agenda:
-------
1) Set time for next meeting
2) Minutes
3) Discuss status of gnome-user-docs
4) Discuss gnome-developer-docs and developer FAQ
5) Discuss GNOME Users Guide
6) Review which packages do not have doc maintainers for the GNOME 1.4
release
7) Discuss status of gnome-db2html2
8) Review status of converting docs to work with Nautilus
9) Review status of OMF/ScrollKeeper
10) Review QA plan
11) Review list of unfinished documents
12) Plan for freezing docs and passing them to translators (Release a
weekly list of docs which are frozen and ready for translations?  Stage
docs so each week we completely review and freeze some docs.)
13) Opening up meetings (I don't want the meetings to seem exclusive,
although it makes scheduling a heck of a lot easier if you have a finite
number of people, and the meetings are a lot more efficient. Let's
discuss
having these be open meetings though after we get a schedule locked
down.)






From rob@funky-penguin.co.uk  Fri Feb 23 05:22:13 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id 245102DD1E
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:22:13 -0500 (EST)
Received: from [213.122.189.46] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14WFMX-0007Bf-00
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 10:22:11 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14WFPh-0001QO-00
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:25:25 +0000
Date: Fri, 23 Feb 2001 10:25:12 +0000
To: gnome-doc-list@gnome.org
Subject: Unable to render sgml to html on Debian
Message-ID: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="gKMricLos+KVdGMg"
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--gKMricLos+KVdGMg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

I did used to have this working a long time ago but i moved boxes and now
when i come back to work on it doesnt seem to work.

I downloaded and installed gnome-doc-tools and everything it depeneded on
(cygnus-stylesheets etc).

When i try to db2html a file i know works i just get the file outputed to
stdout rendered as plain text.

Before lots of errors on almost every tag the following it outputted:

input file was called gnome-stones.005.sgml -- output will be in
gnome-stones.005

working on ../gnome-stones.005.sgml
jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"
jade:../gnome-stones.005.sgml:4:0:E: reference to entity "ARTICLE" for which
no system identifier could be generated
jade:../gnome-stones.005.sgml:1:0: entity was defined here
jade:../gnome-stones.005.sgml:4:0:E: DTD did not contain element declaration
for document type name


I think this could be a DTD error but i'm really not sure what to do now.

Any advice on what to do would be greatly appreciated.

rob
--=20
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet

--gKMricLos+KVdGMg
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.4 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD8DBQE6ljqICw8pKd+B7oMRAle6AJ0dl9TmIjMDMlf0AXJiv0q/D5w2iQCdEtrw
sdC62cmPwhiJb/8gP6TUep4=
=ZPbk
-----END PGP SIGNATURE-----

--gKMricLos+KVdGMg--


From jules@blueberry.jellybean.co.uk  Fri Feb 23 05:43:53 2001
Return-Path: <jules@blueberry.jellybean.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from blueberry.jellybean.co.uk (blueberry.jellybean.co.uk [194.88.75.31])
	by mail.gnome.org (Postfix) with ESMTP id E273E2DD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:43:52 -0500 (EST)
Received: from jules by blueberry.jellybean.co.uk with local (Exim 3.16 #1 (Debian))
	id 14WFhO-0003OP-00; Fri, 23 Feb 2001 10:43:42 +0000
Date: Fri, 23 Feb 2001 10:43:42 +0000
From: Jules Bean <jules@jellybean.co.uk>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223104341.B12325@blueberry.jellybean.co.uk>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
> 
> I downloaded and installed gnome-doc-tools and everything it depeneded on
> (cygnus-stylesheets etc).

Which version of gnome-doc-tools?

I'm about to try using eliot landrum's latest debian packages of
gnome-doc-tools, and if it works, upload it into debian. (I need it to 
build the docs of the balsa package, which I maintain).

Jules


From aliabdin@aucegypt.edu  Fri Feb 23 06:16:27 2001
Return-Path: <aliabdin@aucegypt.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from jerry.aucegypt.edu (jerry.aucegypt.edu [208.159.7.6])
	by mail.gnome.org (Postfix) with ESMTP id 695BB2CE41
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 06:16:27 -0500 (EST)
Received: from localhost.localdomain ([217.52.7.140])
 by auc.AUCEGYPT.EDU (PMDF V5.2-31 #41700)
 with ESMTP id <01K0G8WO5SKG9GVA8P@auc.AUCEGYPT.EDU> for
 gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:19:17 EGYPT
Received: by localhost.localdomain (Postfix, from userid 500)
	id 7DF7756FD; Wed, 21 Feb 2001 23:01:25 +0200 (EET)
Date: Wed, 21 Feb 2001 23:01:25 +0200
From: Ali Abdin <aliabdin@aucegypt.edu>
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
In-reply-to: <01021815165800.10931@7of9>
To: battery841@mediaone.net
Cc: gnome-doc-list@gnome.org
Message-id: <20010221210125.7DF7756FD@localhost.localdomain>
MIME-version: 1.0
X-Mailer: Evolution (0.8 - Preview Release)
Content-type: text/plain
References: <20010215172159.A11517@math.sunysb.edu>
 <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
 <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 18 Feb 2001 15:16:58 -0600, Kevin Breit wrote:
> On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> > Is there any interest in having any of the user or developer docs
> > recorded? I'm thinking audio books, or even inserting <audioobject> and
> > <audiodata> tags into the docs themselves.
> >
> > All I will need is someone with a good voice to volunteer. (I have a small
> > studio setup near Chicago.)
> That'd be interesting.  It would be best to have it in mp3 format.  If you 
> wanted, and we got this rolling soon enough, I could do some voice stuff 
> since I live in the Chicago burbs.


No it wouldn't. It would be best to have it in ogg format!!!! :)

I don't think it is worth doing until we have a nice way of actually
playing these files ;)

Perhaps somebody should talk with Sun about this since they are doing
some GNOME Accessibility work

Regards,
Ali


From kirillov@peconic.math.sunysb.edu  Fri Feb 23 10:51:42 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id DC0DB2E516
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:51:41 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id KAA21411;
	Fri, 23 Feb 2001 10:51:37 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id KAA21208;
	Fri, 23 Feb 2001 10:51:37 -0500
Date: Fri, 23 Feb 2001 10:51:37 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223105137.B21128@math.sunysb.edu>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
[snip] 
> working on ../gnome-stones.005.sgml
> jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
> jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
> public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"

>From these messages, something is wrong with your CATALOG file -
probably DocBook PNG Variant V1.1, instead of referring to DOcBook
V3.1 as it should, refers to itself, or something like this. If you
send me your /usr/lib/sgml/catalog and the dtd file installed by
DocBook PNG Variant V1.1, I might be able to tell you more. 

Sasha


From pablodc@mapfre.com.ar  Fri Feb 23 11:10:02 2001
Return-Path: <pablodc@mapfre.com.ar>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail.mapfre.com.ar (mail.mapfre.com.ar [200.32.86.3])
	by mail.gnome.org (Postfix) with ESMTP id 5A27C2C906
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 11:09:48 -0500 (EST)
Received: by mail.mapfre.intranet.ar with Internet Mail Service (5.5.2448.0)
	id <FKPFQT5Y>; Fri, 23 Feb 2001 13:11:36 -0300
Message-ID: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
From: Pablo del Campo <pablodc@mapfre.com.ar>
To: gnome-doc-list@gnome.org
Subject: Strings Unstranslated in Nautilus (spanish)
Date: Fri, 23 Feb 2001 13:11:30 -0300
Importance: high
X-Priority: 1
MIME-Version: 1.0
X-Mailer: Internet Mail Service (5.5.2448.0)
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everyone:

	My name is Pablo and I working in the Nautilus=B4s spanish
translation.

	I have a couple of troubles with some strings that are translated in
the es.po but Nautilus insist in display them in english, I write this =
mail
for someone that can help me whith this:

Some of the strings are:

* Customer (I don=B4t have this string in the es,po after run =
./update.sh es),
it=B4s in the Help menu.
* All the Strings of the MP3 player are translated in the es.po but
displayed in english when use it in Nautilus.
* The users level that are displayed in the Assistant when first Launch
Nautilus.
* two or three strings in the RPM view (I=B4dont remember exactly what =
they
are right now).

If someone can help whith this write me at pablodc@bigfoot as fast as =
you
can.

Thanks and please forgive my bad english.

    .-.     Pablo Gonzalo del Campo
 .-.   .-.     MAPFRE Aconcagua
(___\ /___)       Sistemas
     |          Programador
     =20


From erik@core.com  Fri Feb 23 13:54:15 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id CAE9A2BD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 13:54:14 -0500 (EST)
Received: from core.com (tnt15b-74.focal-chi.corecomm.net [216.214.210.74])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1NIsjv78655
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 18:54:45 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1NJ2Up14527
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:02:30 -0600
Date: Fri, 23 Feb 2001 13:02:30 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010223130230.B6594@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9> <20010221210125.7DF7756FD@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010221210125.7DF7756FD@localhost.localdomain>; from "aliabdin@aucegypt.edu on Wed, Feb 21, 2001 at 11:01:25PM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 11:01:25PM +0200, Ali Abdin wrote:
> 
> No it wouldn't. It would be best to have it in ogg format!!!! :)

Well, they will be recorded/edited as 24bit 44.1kHz SoundDesignerII format, but
after that I can convert them into anything. :)

> I don't think it is worth doing until we have a nice way of actually
> playing these files ;)

There are plenty of ways to play these files. :) (but none are intergrated
specifically for this.)

My view is why wait? If someone actually uses this between the time the
recording/editing is finished and a hacker get some intergration into I think
would be nautilus, then it will be worth it. I see this as the old chicken and
egg problem...  or is it the carrot in front of the horse? Heh.

I talked to Kevin on irc, what I think we'll do is a proof of concept demo.

> Perhaps somebody should talk with Sun about this since they are doing
> some GNOME Accessibility work

Who at Sun should we get in contact with?

-- 
All music aspires to the condition of muzak.


From dan@eazel.com  Fri Feb 23 23:09:35 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3A9E72BAAF
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 23:09:35 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1O47Ke02058;
	Fri, 23 Feb 2001 20:07:20 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 23 Feb 2001 20:07:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Pablo del Campo <pablodc@mapfre.com.ar>
Cc: gnome-doc-list@gnome.org, nautilus-list@lists.eazel.com
Subject: Re: Strings Unstranslated in Nautilus (spanish)
In-Reply-To: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
Message-ID: <Pine.LNX.4.21.0102231954540.27264-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=ISO-8859-1
Content-Transfer-Encoding: 8BIT
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi Pablo,

Thanks for pointing this out.  I am no hacker, but my unexpert opinion is
that this is un-gettext'd:

components/rpmview/nautilus-rpm-view.c:

gtk_label_set_text
(GTK_LABEL(rpm_view->details->package_installed_message), "This package is
currently installed");

I suspect we have a fair number of places where ungettext'd strings have
slipped in.

Any Nautilus hackers want to volunteer to grep through CVS and fix any
strings which are not gettext-ized?

Dan




On Fri, 23 Feb 2001, Pablo del Campo wrote:

> Hi everyone:
> 
> 	My name is Pablo and I working in the Nautilusīs spanish
> translation.
> 
> 	I have a couple of troubles with some strings that are translated in
> the es.po but Nautilus insist in display them in english, I write this mail
> for someone that can help me whith this:
> 
> Some of the strings are:
> 
> * Customer (I donīt have this string in the es,po after run ./update.sh es),
> itīs in the Help menu.
> * All the Strings of the MP3 player are translated in the es.po but
> displayed in english when use it in Nautilus.
> * The users level that are displayed in the Assistant when first Launch
> Nautilus.
> * two or three strings in the RPM view (Iīdont remember exactly what they
> are right now).
> 
> If someone can help whith this write me at pablodc@bigfoot as fast as you
> can.
> 
> Thanks and please forgive my bad english.
> 
>     .-.     Pablo Gonzalo del Campo
>  .-.   .-.     MAPFRE Aconcagua
> (___\ /___)       Sistemas
>      |          Programador
>       
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 





From hobbit@aloss.ukuu.org.uk  Sun Feb 25 04:27:39 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id EB49C2BACE
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 04:27:38 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1P9V4X12307
	for gnome-doc-list@gnome.org; Sun, 25 Feb 2001 09:31:04 GMT
Date: Sun, 25 Feb 2001 09:31:04 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: bug-buddy docs 1.4 ready? Please check :) 
Message-ID: <20010225093104.B12247@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Okay, the proto-docs for bug-buddy are on the web at
http://www.linux.org.uk/~telsa/GDP/bug-buddy-new.sgml

The text is fine, I think. As in, I don't see too many errors.
I have checked for most of the 1.4-readiness stuff. But I have
got myself intro a terrible muddle: which licence am I supposed 
to be including under what id tag? I think I have it wrong. Please 
give it a quick check and tell me. Then I'll throw them at Jacob 
for CVS. (I haven't put them straight into CVS cos every time I 
touch it something else goes wrong. :))

Telsa


From chris@wilddev.net  Sun Feb 25 05:57:41 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 47E5B2BAFB
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 05:57:40 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id DAA21647;
	Sun, 25 Feb 2001 03:07:13 -0800
Message-ID: <3A98E54F.9000900@wilddev.net>
Date: Sun, 25 Feb 2001 02:58:23 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Cc: ian@eazel.com
Subject: GNOME UG Proposed Framework
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I wish to get comments from people on what they think of this list of 
docs to be included in the UG. The major change in 1.4 is the addition 
of Nautilus. I'm going to pull the current copies of these docs from CVS 
to see what needs to be done to get them together for the UG. If Ian 
gets to busy to do the scripts then I may just attempt to put them 
together manually.

Chris

Intro to GNOME
GNOME Quick Start
Window Managers and GNOME
The Gnome Desktop
Nautilus
Panel
   -Applets
GNOME System Utilities
Menu Editor
GNOME Control Center
Appendix
   -A Linux Primer
   -B GDP Team
   -C GNU FDL



From trevor.curtis@home.com  Mon Feb 26 10:37:37 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id 7899C2BF20
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 10:37:37 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010226153708.SBMY12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 07:37:08 -0800
Date: Mon, 26 Feb 2001 10:39:01 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Gnome Tali doc converted
Message-ID: <20010226103900.A5114@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
X-Operating-System: Linux frink.thesimpsons.ca 2.4.2
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I just finished converting the Gnome Tali game manual from html to
sgml. This is my first attempt at docbooking something so any feedback
would be great; negative or otherwise :)

My biggest problem was decided what should and shouldn't be tagged and
how to or not to tag them. So if there are issues here concerning that
just let me know.

So for those you who wouldn't mind you can find it here:
http://www.scs.carleton.ca/~tcurtis/gtali.sgml

thanks in advance,
-- 
Trevor Curtis
http://members.home.net/jbrabazon
--------------------------------------------------------------
"The only people who have anything to fear from free software,
are those whose products are worth even less."  --David Emery.



From jfleck@swcp.com  Mon Feb 26 11:11:36 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 99DE12DDEE
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 11:11:34 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id JAA03237
	for gnome-doc-list@gnome.org; Mon, 26 Feb 2001 09:10:10 -0700
Date: Mon, 26 Feb 2001 09:10:09 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Gnome Tali doc converted
Message-ID: <20010226091009.A1672@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <20010226103900.A5114@mail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <20010226103900.A5114@mail.com>; from Trevor Curtis on Mon, Feb 26, 2001 at 10:39:01AM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Trevor -

The markup looks fine to me.

The only change needed that I saw was the reference to
bugs.gnome.org. It needs to be changed to bugzilla.gnome.org. We need
to get that changed in the templates. Sorry.

I also tested it in Nautilus, and it passed.

The next step, which would be great if you have the energy, would be
to add screenshots.

Cheers,

John

On Mon, Feb 26, 2001 at 10:39:01AM -0500, Trevor Curtis wrote:
> I just finished converting the Gnome Tali game manual from html to
> sgml. This is my first attempt at docbooking something so any feedback
> would be great; negative or otherwise :)
> 
> My biggest problem was decided what should and shouldn't be tagged and
> how to or not to tag them. So if there are issues here concerning that
> just let me know.
> 
> So for those you who wouldn't mind you can find it here:
> http://www.scs.carleton.ca/~tcurtis/gtali.sgml
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From battery841@mediaone.net  Tue Feb 27 17:24:15 2001
Return-Path: <battery841@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from elmls01.ce.mediaone.net (elmls01.ce.mediaone.net [24.131.128.25])
	by mail.gnome.org (Postfix) with ESMTP id 576F82CA94
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 17:24:15 -0500 (EST)
Received: from 7of9 (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by elmls01.ce.mediaone.net (8.8.7/8.8.7) with SMTP id QAA19245
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 16:24:10 -0600 (CST)
Content-Type: text/plain;
  charset="iso-8859-1"
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Gnibbles dox
Date: Tue, 27 Feb 2001 16:14:56 -0600
X-Mailer: KMail [version 1.2]
MIME-Version: 1.0
Message-Id: <01022716145600.18733@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
	Why aren't the Gnibbles documentation in Gnibbles?  I wrote the dox and they 
should be in CVS.  Any reasons?
Thanks
Kevin


From gleblanc@cu-portland.edu  Tue Feb 27 23:48:33 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id F09D12DECF; Tue, 27 Feb 2001 23:48:32 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1S4mWn15023;
	Tue, 27 Feb 2001 20:48:32 -0800
Message-Id: <200102280448.f1S4mWn15023@mail2.aracnet.com>
Subject: Minutes for the GDP Release Committee meeting Feb 25, 2001
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 27 Feb 2001 20:46:45 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 25, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Laszlo Kovacs
John Fleck
Alexander Kirillov
Chris Lyttle (arrived 1:54)

Absent:
-------
Kenny Graunke
Ali Abdin


Regrets:
--------


Decisions:
----------

- Nautilus will not have the ability to fall back on the
  non-scrollkeeper sidebar.  Scrollkeeper is now required for
  Nautilus.

Work Done:
----------

- DONE: Dan Mueth -- HACKING files created in gnome-user-docs and
  gnome-devel-doc.  

- DONE: Alexander Kirillov -- created a list of documentation to be
  moved into the gnome-user-docs module, and send it to Gregory
  Leblanc <gleblanc@cu-portland.edu>
- DONE: Telsa Gwynne -- created a gnome-user-docs product in
  bugzilla.

- DONE: John Fleck and Dan Mueth -- tested l10n and i18n in
  gnome-db2html2.  It doesn't work, but a detailed bug report has been
  filed, and "it should be easy to fix".

- DONE: Dan Mueth, John Fleck, Mike Fleming-- bugs #4302, #5945, and
  #6761 are fixed and verified.

- DONE: Laszlo Kovacs -- Enabled scrollkeeper in the default builds of
  Nautilus, and in the hourly builds.

- DONE: Kevin Breit -- Divided docs into groups so that QA volunteers
  can sign up.
  http://battery841.myip.org/school/gnome-1.4-category.txt/ps

- DONE: Laszlo Kovacs -- locale fallback in scrollkeeper has been
  fixed.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth Kenny Graunke -- create build system in
  gnome-user-docs and gnome-devel-docs.  Once build system is in place
  inform gnome-hackers about the new modules and refer them to the
  HACKING files for further information.

- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Gregory Leblanc -- find script that puts the FAQ (and possibly
  other gnome-user-docs documents) onto the website, and find the
  maintainer.  Have the script changed to look to gnome-user-docs
  instead of gnome-docu.

- TODO: Telsa Gwynne -- add components and version numbers to the
  gnome-user-docs module in bugzilla.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.  Mail list of packages to gnome-doc-list for
  volunteers.

- IN PROGRESS: Dan Mueth -- Emailed Jacob Berkman about making
  nautilus the default help browser in gnome-libs.

- IN PROGRESS: John Fleck -- check on support for using multiple fonts
  in the Nautilus Help Sidebar.

- TODO: John Fleck, Laszlo Kovacs, Dan Mueth -- work out l10n issues.

- IN PROGRESS: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- IN PROGRESS: Kevin Breit -- develop quality assurance tests, and
  document this procedure so that it can be applied for GNOME
  1.4. See: 
  http://battery841.myip.org/school/checklist.txt
  http://www.gnome.org/~mjs/gnome-test-plans/ and
  gnome-test-plans in CVS for details.

- TODO: John Fleck -- determine status of glossary.[xml sgml] so that
  it can be translated.

- IN PROGRESS: Telsa Gwynne -- talk to the i18n teams about making
  translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)

- TODO: Chris Lyttle -- Work on GNOME Users Guide.  Add a "New in
  GNOME 1.4" section near the beginning of the Guide.  See about the
  feasibility of getting the Users Guide included with Beta 3

- TODO: Kevin Breit -- Polish the existing dia documentation and have
  it included (and linked to the help menu) in the next release.

- TODO: Dan Mueth -- Assist John Fleck in verifing some
  Nautilus/gnome-db2html2 bugs.  

Agenda Items Left For Next Meeting:
-----------------------------------

0) Discuss improving meetings
1) Review which packages need maintainers
2) QA review

Agenda:
-------
0) Review TODO's from last meeting
1) Discuss GNOME User Guide
2) Discuss whether Dia doc is ready for inclusion
3) Discuss improving meetings
4) Review which packages need maintainers
5) QA review
6) Nautilus bug verification





From chris@wilddev.net  Wed Feb 28 02:04:57 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 64AC12BB09
	for <gnome-doc-list@gnome.org>; Wed, 28 Feb 2001 02:04:56 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id XAA30737
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 23:14:49 -0800
Message-ID: <3A9CA358.5080701@wilddev.net>
Date: Tue, 27 Feb 2001 23:06:00 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: GNOME UG vs KDE UG
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all
I was surfing the KDE site looking for ideas and I noticed

http://www.kde.org/documentation/userguide/index.html

This impressed me as it is task based, something we have discussed doing 
for the gdp docs. I am thinking now that I might try to incorporate some 
things into the UG that are more task oriented (in the time available) 
and plan on rewriting the UG as a standalone task based doc for possibly 2.0

Let me know your thoughts

Chris



From kirillov@math.sunysb.edu  Sun Feb  4 18:06:39 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from localhost.localdomain (076-041.dialup.sunysb.edu [129.49.76.41])
	by mail.gnome.org (Postfix) with ESMTP id B4BE02BC7E
	for <gnome-doc-list@gnome.org>; Sun,  4 Feb 2001 18:06:38 -0500 (EST)
Received: by localhost.localdomain (Postfix, from userid 501)
	id 0CEF73E53A; Sun,  4 Feb 2001 18:05:02 -0500 (EST)
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: indexing
Message-Id: <20010204230502.0CEF73E53A@localhost.localdomain>
Date: Sun,  4 Feb 2001 18:05:02 -0500 (EST)
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all:
one feature almost all our docs are sorely missing (with the exception
of the users guide for 1.2) is an index. I think we need to do something
about it. 

Ideal solution would be: 

 a. we put tags like 

   <indexterm><primary>Applets</primary>
              <secondary>adding to panel</secondary> 
   </indexterm>
   in our documents (in this case - in the panel manual when
   discussing adding applets to panel). 

 b. during db2html conversion, gnome-db2html would process this and
 create an index for the document, or 

 c. even better, index for documents for all core components
 (panel, applets, nautilus,  control center,...), or  even all  gnome
 docs is created from these tags at installation time, so we have a
 common index. 

Unfortunately, this is unrealistic. At the moment, gnome-db2html does
not automatically produce an index. Neither, btw, does jade. However,
I strongly feel that we need an index *now* - make it a hack if we
must. 

 Suggestions: 

 1. Create an index for each doc manually, i.e. in your doc, add
    a section like this

<index><title>Index</title>
<indexdiv><title>A</title>
<indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see <xref linkend="appletadd">
           </secondaryie>
   </primaryie>   

etc. Here "appletadd" is the id of sect1 discussing this topic.
Obviously, the problem is that you must manually update the index
whenever the document structure changes.

or: 

  2. Create a common index for all core docs as a separate document;
instead of <xref>, use something like 
 <indexentry>
   <primaryie>Applets</primaryie>
           <secondaryie>adding to panel 
              - see Panel manual, section <ulink type="gnome-help"
url="help:panel?appletadd">Adding objects to panel</ulink> 
           </secondaryie>
   </primaryie>   
  

Obviously, 2 would be better for the user (it is better to have one
common index than 10 individual ones) but *much* harder to maintain. On the
other hand, sections of our documents do not change all too
often. I think either way it is something we can do before 1.4; my
estimate is it would take 2-3 days (for one person) to write such an
index. Yes, it is a hack, but it will do for now. I'd vote for 2. 

Comments? Volunteers?

Sasha






From michael.smith@openwave.com  Mon Feb  5 05:01:38 2001
Return-Path: <michael.smith@openwave.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from oe-mp1.bizmailsrvcs.net (oe-mp1pub.managedmail.com [206.46.164.22])
	by mail.gnome.org (Postfix) with ESMTP id 86F812BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:01:37 -0500 (EST)
Received: from oe-ismta1.bizmailsrvcs.net ([206.46.164.26])
          by oe-mp1.bizmailsrvcs.net (InterMail vM.5.01.01.01 201-252-104)
          with ESMTP
          id <20010205095619.CZSW24251.oe-mp1.bizmailsrvcs.net@oe-ismta1.bizmailsrvcs.net>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:56:19 -0600
Received: from SMITH1.openwave.com ([63.24.97.132])
          by oe-ismta1.bizmailsrvcs.net
          (InterMail vM.5.01.01.01 201-252-104) with ESMTP
          id <20010205095452.YJUR1854.oe-ismta1.bizmailsrvcs.net@SMITH1.openwave.com>
          for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 03:54:52 -0600
To: gnome-doc-list@gnome.org
Subject: July open-source conference
From: Michael Smith <smith@xml-doc.org>
Date: 05 Feb 2001 02:01:27 -0800
Message-ID: <uae81phxk.fsf@openwave.com>
Lines: 29
User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello all,

I'm writing to a few different lists to ask whether anyone might be
planning to attend the O'Reilly open-source conference (San Diego CA)
in July.

I've been in contact with some of the folks at O'Reilly, trying to
drum up support for a "DocBook" or "open-source document authoring"
day. I think a discussion/tutorial from someone involved with the GNOME
doc project would be valuable to others. Has anyone thought about maybe
submitting a proposal for a tutorial/presentation?

The deadline for submissions of proposals is February 9th (this
Friday). If anyone else from the GNOME doc project could submit a
proposal of some kind, I think it would great. If nobody wants to
commit to a whole tutorial, I'd certainly be willing to coordinate
integration of GNOME expertise into a larger tutorial of some kind.

Please let me know what you think, or just go ahead and submit a
proposal for the conference's XML track:

  http://conferences.oreilly.com/oscon2001/call-xml.html

Or at the very least, if you plan on attending, e-mail
oscon2001-xml-proposals@oreilly.com expressing interest in seeing some
DocBook/document-authoring tutorials/presentations take place.

  --Mike Smith






From laszlo.kovacs@Sun.COM  Mon Feb  5 05:10:37 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 6DE652BBA9
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 05:10:36 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id CAA21828
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 02:10:34 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id KAA19302
	for <gnome-doc-list@gnome.org>; Mon, 5 Feb 2001 10:10:33 GMT
Message-ID: <3A7E7C19.78432618@Sun.COM>
Date: Mon, 05 Feb 2001 10:10:33 +0000
From: laszlo kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> 
> Hi all:
> one feature almost all our docs are sorely missing (with the exception
> of the users guide for 1.2) is an index. I think we need to do something
> about it.
> 
> Ideal solution would be:
> 
>  a. we put tags like
> 
>    <indexterm><primary>Applets</primary>
>               <secondary>adding to panel</secondary>
>    </indexterm>
>    in our documents (in this case - in the panel manual when
>    discussing adding applets to panel).
> 
>  b. during db2html conversion, gnome-db2html would process this and
>  create an index for the document, or
> 
>  c. even better, index for documents for all core components
>  (panel, applets, nautilus,  control center,...), or  even all  gnome
>  docs is created from these tags at installation time, so we have a
>  common index.
> 
> Unfortunately, this is unrealistic. At the moment, gnome-db2html does
> not automatically produce an index. Neither, btw, does jade. However,
> I strongly feel that we need an index *now* - make it a hack if we
> must.

I wonder how much people know about the Scrollkeeper project (not very
informative web site is scrollkeeper.sourceforge.net). This project is
about metadata based document categorizing and storing the result in xml
file(s) exported to help browsers. There are pretty high chances that
the Help sidebar in Nautilus for Gnome 1.4 will use Scrollkeeper. We
aimed to add indexing functionality in Scrollkeeper after Gnome 1.4.
This contains index extraction (in case the index info is added to the
docs as detailed above), exporting this to help browsers and integrate
this with Nautilus. Going further implementation of search through index
and other parts of the documentation and metadata is also considered.
Both Scrollkeeper and its integration with Nautilus are run by the same
people.

> 
>  Suggestions:
> 
>  1. Create an index for each doc manually, i.e. in your doc, add
>     a section like this
> 
> <index><title>Index</title>
> <indexdiv><title>A</title>
> <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see <xref linkend="appletadd">
>            </secondaryie>
>    </primaryie>
> 
> etc. Here "appletadd" is the id of sect1 discussing this topic.
> Obviously, the problem is that you must manually update the index
> whenever the document structure changes.
> 
> or:
> 
>   2. Create a common index for all core docs as a separate document;
> instead of <xref>, use something like
>  <indexentry>
>    <primaryie>Applets</primaryie>
>            <secondaryie>adding to panel
>               - see Panel manual, section <ulink type="gnome-help"
> url="help:panel?appletadd">Adding objects to panel</ulink>
>            </secondaryie>
>    </primaryie>
> 
> 
> Obviously, 2 would be better for the user (it is better to have one
> common index than 10 individual ones) but *much* harder to maintain. On the
> other hand, sections of our documents do not change all too
> often. I think either way it is something we can do before 1.4; my
> estimate is it would take 2-3 days (for one person) to write such an
> index. Yes, it is a hack, but it will do for now. I'd vote for 2.

1. would prolly suit the way how Scrollkeeper is intended to work
better, but I am sure it could also serve the other approach. One
question though, what's the point to add the index info to docs before
Gnome 1.4 if there is no index display and search implemented? Or am I
missing something?

Laszlo


From kirillov@peconic.math.sunysb.edu  Mon Feb  5 11:28:30 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 5D0FE2CA94
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 11:28:30 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id LAA00445;
	Mon, 5 Feb 2001 11:28:28 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id LAA30055;
	Mon, 5 Feb 2001 11:28:28 -0500
Date: Mon, 5 Feb 2001 11:28:28 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: laszlo kovacs <laszlo.kovacs@sun.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
Message-ID: <20010205112828.A30010@math.sunysb.edu>
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <3A7E7C19.78432618@Sun.COM>; from laszlo.kovacs@sun.com on Mon, Feb 05, 2001 at 10:10:33AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, Feb 05, 2001 at 10:10:33AM +0000, laszlo kovacs wrote:
[snip]
> One
> question though, what's the point to add the index info to docs before
> Gnome 1.4 if there is no index display and search implemented? Or am I
> missing something?
> 
> Laszlo

If we add an index to a doc manually, as in suggestion 1, then it will
be useful even without special "index display" - it will just show as
one of the sections of your document (usually the last one). If you
are trying to find info about some topic, you just look at this
section, find (manually) the topic you need, and click on the provided
link. Much as with printed books.

Of course, having a special index display with help option would be
better. Do you have any estimates how soon it will be implemented in
Nautilus? "after Gnome 1.4" is rather vague...

Best,
Sasha


From laszlo.kovacs@Sun.COM  Mon Feb  5 12:26:45 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id B667D2E27C
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:26:44 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id JAA10958;
	Mon, 5 Feb 2001 09:26:42 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with ESMTP id RAA23772;
	Mon, 5 Feb 2001 17:26:41 GMT
Message-ID: <3A7EE251.5B3BEA08@Sun.COM>
Date: Mon, 05 Feb 2001 17:26:41 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: indexing
References: <20010204230502.0CEF73E53A@localhost.localdomain> <3A7E7C19.78432618@Sun.COM> <20010205112828.A30010@math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> If we add an index to a doc manually, as in suggestion 1, then it will
> be useful even without special "index display" - it will just show as
> one of the sections of your document (usually the last one). If you
> are trying to find info about some topic, you just look at this
> section, find (manually) the topic you need, and click on the provided
> link. Much as with printed books.
Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
 
> Of course, having a special index display with help option would be
> better. Do you have any estimates how soon it will be implemented in
> Nautilus? "after Gnome 1.4" is rather vague...
All I know right now is that hopefully for the next major Gnome release
after 1.4. Work has not been started yet. But this is very important for
Sun. Just like the Search functionality. I always assumed this will be
done as part of the joint Scrollkeeper/Scrollkeeper-Nautilus Integration
project. I did most of the coding of Scrollkeeper with design mostly
discussed with Dan Mueth and other people. Same on the Scrollkeeper
side, there is an intention that as soon as Gnome 1.4 is released myself
or another Sun engineer will be fully responsible for hyperbola, the
Nautilus component that implements the help sidebar and will implement
the GUI for the Index display and Search also (at least this is how I
see it).

Laszlo


From jfleck@inkstain.net  Mon Feb  5 12:36:32 2001
Return-Path: <jfleck@inkstain.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from jello.inkstain.net (shell.inkstain.net [206.29.130.69])
	by mail.gnome.org (Postfix) with ESMTP id 4A5402D9AF
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 12:36:32 -0500 (EST)
Received: from jello (mail [206.29.130.67])
	by jello.inkstain.net (8.9.3/8.9.3) with SMTP id JAA22114;
	Mon, 5 Feb 2001 09:27:09 -0800 (PST)
Date: Mon, 5 Feb 2001 09:27:09 -0800 (PST)
From: <jfleck@inkstain.net>
X-Sender: jfleck@jello
To: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <3A7EE251.5B3BEA08@Sun.COM>
Message-ID: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Mon, 5 Feb 2001, Laszlo Kovacs wrote:

> > If we add an index to a doc manually, as in suggestion 1, then it will
> > be useful even without special "index display" - it will just show as
> > one of the sections of your document (usually the last one). If you
> > are trying to find info about some topic, you just look at this
> > section, find (manually) the topic you need, and click on the provided
> > link. Much as with printed books.
> Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
>  

It does not now. I'm looking into what would be required to add the
necessary support.

Cheers,

John



From dan@eazel.com  Mon Feb  5 17:25:13 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.localdomain (unknown [64.37.237.47])
	by mail.gnome.org (Postfix) with ESMTP id EFB912D34F
	for <gnome-doc-list@gnome.org>; Mon,  5 Feb 2001 17:25:12 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.localdomain (8.11.0/8.11.0) with ESMTP id f160KqX04045;
	Mon, 5 Feb 2001 16:21:42 -0800
X-Authentication-Warning: foodle.localdomain: dan owned process doing -bs
Date: Mon, 5 Feb 2001 16:20:52 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
X-Sender: dan@foodle.localdomain
To: jfleck@inkstain.net
Cc: Laszlo Kovacs <laszlo.kovacs@Sun.COM>,
	Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org
Subject: Re: indexing
In-Reply-To: <Pine.GSO.3.96.1010205092600.22075B-100000@jello>
Message-ID: <Pine.LNX.4.21.0102051612330.13847-100000@foodle.localdomain>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Mon, 5 Feb 2001 jfleck@inkstain.net wrote:

> On Mon, 5 Feb 2001, Laszlo Kovacs wrote:
> 
> > > If we add an index to a doc manually, as in suggestion 1, then it will
> > > be useful even without special "index display" - it will just show as
> > > one of the sections of your document (usually the last one). If you
> > > are trying to find info about some topic, you just look at this
> > > section, find (manually) the topic you need, and click on the provided
> > > link. Much as with printed books.
> > Oh, ok. This sounds good. Is gnome-db2html2 able to handle these tags?
> >  
> 
> It does not now. I'm looking into what would be required to add the
> necessary support.

Thanks John. This is something we would eventually like to have in
gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
providing a search feature that searches the index of many documents at
once.

If we really want to have a central index, we might imagine faking
together one (as Sasha suggested), but make it a single document which
acts like an index to the other documents which are core to GNOME.  We
could call it "The GNOME Index" and then put links like:
  cd player -> gtcd
  CPU: monitoring load -> multiload applet
       identifying -> Nautilus hardware view
  Themes: changing -> Control center: Appearance

or whatever.  This is really what the user wants. Of course this would be
a lot of work to do well, especially to do a good job.  It would fit
nicely into gnome-user-docs.

Dan




From Patrick.Costello@ireland.sun.com  Tue Feb  6 02:20:18 2001
Return-Path: <Patrick.Costello@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 9DEA02E3BE
	for <gnome-doc-list@gnome.org>; Tue,  6 Feb 2001 02:20:17 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id XAA00496;
	Mon, 5 Feb 2001 23:20:14 -0800 (PST)
Received: from dbl-ray-3 (dbl-ray-3 [129.156.237.102])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1) with SMTP id HAA28877;
	Tue, 6 Feb 2001 07:20:14 GMT
Message-Id: <200102060720.HAA28877@ireserver.Ireland.Sun.COM>
Date: Tue, 6 Feb 2001 07:20:14 +0000 (GMT)
From: Pat Costello <Patrick.Costello@ireland.sun.com>
Reply-To: Pat Costello <Patrick.Costello@ireland.sun.com>
Subject: Re: indexing
To: jfleck@inkstain.net, dan@eazel.com
Cc: laszlo.kovacs@Sun.COM, kirillov@math.sunysb.edu,
	gnome-doc-list@gnome.org
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mU6vkHqmlSX8KsPxXlLPhQ==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

All, 

A central index covering Gnome core functions, applications and applets would be 
very handy, especially given the multiplexed nature of the Gnome desktop. At 
first, though, I would suggest a top-level approach to the index so that only 
the main topic headers are flagged, for example the only entry for an applet 
would be the applet header rather than applet actions. In other words, we need 
only put the entry "screen-shooter" into the index and not "screenshots, see 
screen-shooter". This might reduce the amount of work. 

Pat

> 
> On Mon, 5 Feb 2001 Dan Mueth wrote:
 
> Thanks John. This is something we would eventually like to have in
> gnome-db2html2, even if we do use ScrollKeeper to do fancy magic like
> providing a search feature that searches the index of many documents at
> once.
> 
> If we really want to have a central index, we might imagine faking
> together one (as Sasha suggested), but make it a single document which
> acts like an index to the other documents which are core to GNOME.  We
> could call it "The GNOME Index" and then put links like:
>   cd player -> gtcd
>   CPU: monitoring load -> multiload applet
>        identifying -> Nautilus hardware view
>   Themes: changing -> Control center: Appearance
> 
> or whatever.  This is really what the user wants. Of course this would be
> a lot of work to do well, especially to do a good job.  It would fit
> nicely into gnome-user-docs.
> 
> Dan
> 
> 
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list



From sarithazan@hotmail.com  Thu Feb  8 06:59:02 2001
Return-Path: <sarithazan@hotmail.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from hotmail.com (oe44.law11.hotmail.com [64.4.16.16])
	by mail.gnome.org (Postfix) with ESMTP id ACAC92BD24
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 06:59:01 -0500 (EST)
Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC;
	 Thu, 8 Feb 2001 03:59:00 -0800
X-Originating-IP: [212.117.152.146]
From: "Sara Hazan" <sarithazan@hotmail.com>
To: <gnome-doc-list@gnome.org>
Subject: problem with configure
Date: Thu, 8 Feb 2001 13:58:11 +0200
MIME-Version: 1.0
Content-Type: multipart/alternative;	boundary="----=_NextPart_000_0005_01C091D7.2C65A930"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.00.2014.211
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2014.211
Message-ID: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
X-OriginalArrivalTime: 08 Feb 2001 11:59:00.0765 (UTC) FILETIME=[863694D0:01C091C6]
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Hi,

After run ./configure I get the follow :

checking for glib-config... no
checking for GLIB - version >=3D 1.2.0... no
*** The glib-config script installed by GLIB could not be found
*** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
*** your path, or set the GLIB_CONFIG environment variable to the
*** full path to glib-config.
configure: error: Test for GLIB failed.  MC requires GLIB.


Please tell me what to do.

Thanks.

Sarit


------=_NextPart_000_0005_01C091D7.2C65A930
Content-Type: text/html;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Diso-8859-1" =
http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2314.1000" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Hi,</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>After run ./configure I get the follow=20
:</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>checking for glib-config... =
no<BR>checking for GLIB=20
- version &gt;=3D 1.2.0... no<BR>*** The glib-config script installed by =
GLIB=20
could not be found<BR>*** If GLIB was installed in PREFIX, make sure =
PREFIX/bin=20
is in<BR>*** your path, or set the GLIB_CONFIG environment variable to=20
the<BR>*** full path to glib-config.<BR>configure: error: Test for GLIB=20
failed.&nbsp; MC requires GLIB.<BR></FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Please tell me what to do.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Thanks.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Sarit</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>&nbsp;</DIV></FONT></BODY></HTML>

------=_NextPart_000_0005_01C091D7.2C65A930--


From laszlo.kovacs@Sun.COM  Thu Feb  8 07:02:04 2001
Return-Path: <laszlo.kovacs@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id 75BD12E7A9
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 07:02:04 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id EAA28398;
	Thu, 8 Feb 2001 04:02:03 -0800 (PST)
Received: from Sun.COM (trinian [129.156.238.31])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id MAA23602;
	Thu, 8 Feb 2001 12:02:02 GMT
Message-ID: <3A828ABA.96B484AB@Sun.COM>
Date: Thu, 08 Feb 2001 12:02:02 +0000
From: Laszlo Kovacs <laszlo.kovacs@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.7 [en] (X11; I; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Sara Hazan <sarithazan@hotmail.com>
Cc: gnome-doc-list@gnome.org
Subject: Re: problem with configure
References: <OE44SsDPL70s4qdFB3d00003ac5@hotmail.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> Sara Hazan wrote:
> 
> Hi,
> 
> After run ./configure I get the follow :
> 
> checking for glib-config... no
> checking for GLIB - version >= 1.2.0... no
> *** The glib-config script installed by GLIB could not be found
> *** If GLIB was installed in PREFIX, make sure PREFIX/bin is in
> *** your path, or set the GLIB_CONFIG environment variable to the
> *** full path to glib-config.
> configure: error: Test for GLIB failed.  MC requires GLIB.
> 
> Please tell me what to do.
> 
> Thanks.
> 
> Sarit
> 

Two ways:

1. put glib-config in your PATH.
2. Set GLIB_CONFIG to point to where your glib-config is.

Laszlo


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Thu Feb  8 16:56:07 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id F0BE82BB19
	for <gnome-doc-list@gnome.org>; Thu,  8 Feb 2001 16:56:06 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14Qz2s-0000mx-00
	for <gnome-doc-list@gnome.org>; Thu, 08 Feb 2001 15:56:06 -0600
Date: Thu, 8 Feb 2001 15:56:06 -0600
From: Eric Baudais <baudais@okstate.edu>
To: GNOME Documentation Project <gnome-doc-list@gnome.org>
Subject: Doc Writers Needed.
Message-ID: <20010208155605.A3008@bubba>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Yes, this is a call out for help.  There are currently 3 gnome-games that 
need docs.  They are:

gnometris
gnotravex
gnotski

If anyone wants to write docs for these apps contact me and/or put you name 
in the doctable under the game.

Eric Baudais


From gleblanc@cu-portland.edu  Sat Feb 10 18:27:21 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 54B8D2D04B
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 18:27:21 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1ANRKt11506
	for <gnome-doc-list@gnome.org>; Sat, 10 Feb 2001 15:27:20 -0800
Message-Id: <200102102327.f1ANRKt11506@mail3.aracnet.com>
Subject: [khitam sobh <tami@ca.inter.net>] user guide
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org
Content-Type: multipart/mixed; boundary="=-5p0cBznQ7LiDjmQ3yxfp"
X-Mailer: Evolution (0.8 - Preview Release)
Date: 10 Feb 2001 15:26:04 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Type: text/plain

Oh, it beats me, somebody from the list must know.  :)  Please CC
webmaster@gnome.org on any reply you make.  Thanks,

    Greg

--=-5p0cBznQ7LiDjmQ3yxfp
Content-Disposition: inline
Content-Description: Forwarded message - user guide
Content-Type: message/rfc822

Received: from sweeper.cu-portland.edu (SWEEPER [207.149.56.136]) by 
	email.cu-portland.edu with SMTP (Microsoft Exchange Internet Mail Service 
	Version 5.5.2650.21) id CF9WLFPJ; Sat, 10 Feb 2001 15:05:45 -0800
Received: from mail.gnome.org (unverified) by sweeper.cu-portland.edu 
	(Content Technologies SMTPRS 4.1.5) with ESMTP id 
	<Tcf9538428351a54b8096@sweeper.cu-portland.edu> for 
	<GLeblanc@cu-portland.edu>; Sat, 10 Feb 2001 15:05:39 -0800
Received: from mail.gnome.org (localhost.localdomain [127.0.0.1]) by 
	mail.gnome.org (Postfix) with ESMTP id 343392E22E; Sat, 10 Feb 2001 
	18:05:35 -0500 (EST)
Received: from smtp.total.net (rossine.total.net [154.11.89.167]) by 
	mail.gnome.org (Postfix) with SMTP id B8D9F2D04B for <webmaster@gnome.org>; 
	Sat, 10 Feb 2001 18:03:26 -0500 (EST)
Received: (qmail 941 invoked from network); 10 Feb 2001 23:03:24 -0000
Received: from unknown (HELO tamica) (154.20.8.101) by smtp.total.net with 
	SMTP; 10 Feb 2001 23:03:24 -0000
Delivered-To: gnome-webmaster-list@gnome.org
Message-ID: <000a01c093b5$c35eafa0$6508149a@inter.net>
From: "khitam sobh" <tami@ca.inter.net>
To: <webmaster@gnome.org>
Subject: user guide
Date: Sat, 10 Feb 2001 18:04:02 -0500
MIME-Version: 1.0
Content-Type: multipart/alternative; 
	boundary="----=_NextPart_000_0007_01C0938B.D99483A0"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-webmaster-list-admin@gnome.org
Errors-To: gnome-webmaster-list-admin@gnome.org
X-BeenThere: gnome-webmaster-list@gnome.org
X-Loop: gnome-webmaster-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
Reply-To: webmaster@gnome.org
List-Id: Webmaster mail <gnome-webmaster-list.gnome.org>

This is a multi-part message in MIME format.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

Do you have the gnome user guide in french?
If it is available on the net, where can I get it, thanks.

------=_NextPart_000_0007_01C0938B.D99483A0
Content-Type: text/html; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>

<META content=3D"MSHTML 5.50.4611.1300" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>Do you have the gnome user guide in=20
french?</FONT></DIV>
<DIV><FONT face=3DArial size=3D2>If it is available on the net, where can I=
 get it,=20
thanks.</FONT></DIV></BODY></HTML>

------=_NextPart_000_0007_01C0938B.D99483A0--


--=-5p0cBznQ7LiDjmQ3yxfp--



From Ian@shelob.f9.co.uk  Sun Feb 11 12:57:14 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id A8D5A2D9B7
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 12:57:13 -0500 (EST)
Received: (qmail 11399 invoked from network); 11 Feb 2001 17:57:08 -0000
Received: from unknown (HELO shelob) (212.159.32.178)
  by warrior with SMTP; 11 Feb 2001 17:57:08 -0000
Message-ID: <000401c09454$1ab4e3c0$b2209fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "Eric Baudais" <baudais@okstate.edu>
Cc: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 17:57:29 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"Eric Baudais" <baudais@okstate.edu> wrote:
> On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > How
> > would it be if I did could have something finished by the end
> > of this weekend?  I think I can manage that.
> 
> That would be great!

As promised, I have something finished.
It is not perfect, but it is not bad either.
Please download sgml and pngs from
http://www.shelob.plus.com/freecell/
and let me know what you think.

Regards,
Ian




From hobbit@aloss.ukuu.org.uk  Sun Feb 11 14:41:10 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 214E02BB36
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 14:41:09 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1BJgCA02828;
	Sun, 11 Feb 2001 19:42:12 GMT
Date: Sun, 11 Feb 2001 19:42:12 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: Ian@shelob.f9.co.uk
Subject: Re: Freecell Documentation
Message-ID: <20010211194212.B1727@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>,
	Ian@shelob.f9.co.uk
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 05:57:29PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

Dunno if Ian's on the list, so cc'd for now.

> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Looks great to me. Only quibble: fifty-two instead of fifty two (!)
Would it also be possible to explain that you can right-click on a
card in order to see what it is, if it's obscured by cards on top of
it? 

Oh, I suppose it may be worth noting that you click on cards and then
on destinations. I realise this is standard for Windows Freecell, but
it's different from the behaviour of how you move cards in Aisleriot.
I know Zana was thinking of explicitly describing how to move cards
around in aisleriot, so it makes sense to add how you move 'em for
Freecell, since the two are different and people trying one may try
to use the same method for the other.

Telsa


From Ian@shelob.f9.co.uk  Sun Feb 11 15:44:38 2001
Return-Path: <Ian@shelob.f9.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from warrior-outbound.servers.plus.net (unknown [212.159.14.227])
	by mail.gnome.org (Postfix) with SMTP id 907D82BAB4
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 15:44:37 -0500 (EST)
Received: (qmail 2862 invoked from network); 11 Feb 2001 20:44:33 -0000
Received: from unknown (HELO shelob) (212.159.41.48)
  by warrior with SMTP; 11 Feb 2001 20:44:33 -0000
Message-ID: <007d01c0946b$7e79d8e0$30299fd4@shelob>
From: "Ian Miller" <Ian@shelob.f9.co.uk>
To: "gnome-doc-list" <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk>
Subject: Re: Freecell Documentation
Date: Sun, 11 Feb 2001 20:26:14 -0000
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa <hobbit@aloss.ukuu.org.uk> wrote
> On Sun, Feb 11, 2001 at 05:57:29PM -0000 or thereabouts, Ian Miller wrote:

> Dunno if Ian's on the list, so cc'd for now.

Actually, I am.  Mostly I lurk.

> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.

> Only quibble: fifty-two instead of fifty two (!)

I believe the latter form to be correct.
Jihad! Jihad! Jihad! :-)

> Would it also be possible to explain that you can right-click on a
> card in order to see what it is, if it's obscured by cards on top of
> it?

Yes it would, although not very soon unfortunately.  I feel all
documented out this evening, and I *really* am busy over the
next fortnight.  (I *may* be inclined to tweak a few things next
weekend, but I may instead prefer to do some gardening.)
How long do we have before 1.4 is due?

> I suppose it may be worth noting that you click on cards and then
> on destinations.

Actually, I did mention that.  In the usage section between
figures 2 and 3, I think.  Possibly the screenshots take up more
room than they are worth and just obscure the text?

Thanks for your comments,
Ian





From gleblanc@cu-portland.edu  Sun Feb 11 17:57:19 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail3.aracnet.com (mail3.aracnet.com [216.99.193.38])
	by mail.gnome.org (Postfix) with ESMTP id 84D192D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 17:57:18 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail3.aracnet.com (8.11.0/8.11.0) with ESMTP id f1BMvGt26067;
	Sun, 11 Feb 2001 14:57:16 -0800
Message-Id: <200102112257.f1BMvGt26067@mail3.aracnet.com>
Subject: Re: Freecell Documentation
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Cc: jrb@redhat.com, itp@ximian.com, zana@webwynk.net,
	cwryu@adam.kaist.ac.kr
In-Reply-To: <000401c09454$1ab4e3c0$b2209fd4@shelob>
References: <20010208150546.A2912@bubba> 
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>  
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 11 Feb 2001 14:55:59 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> "Eric Baudais" <baudais@okstate.edu> wrote:
> > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > How
> > > would it be if I did could have something finished by the end
> > > of this weekend?  I think I can manage that.
> > 
> > That would be great!
> 
> As promised, I have something finished.
> It is not perfect, but it is not bad either.
> Please download sgml and pngs from
> http://www.shelob.plus.com/freecell/
> and let me know what you think.

Just because I enjoy making trouble...  I don't think that a separate
freecell game will exist in the next major release of gnome-games.
Freecell has been implemented as part of the aisleriot suite, and that
version has a few less bugs (and the bugs it does have can be fixed for
all aisleriot games) than the separate C coded freecell game.  This
isn't a sure thing as far as I know, but it's worth being aware of.
Anybody have a good reason -not- to do this?

    Greg



From jrb@redhat.com  Sun Feb 11 18:22:06 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 9AC622D37A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:22:06 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1BNMl313635;
	Sun, 11 Feb 2001 18:22:47 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, itp@ximian.com,
	zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba>
	<000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba>
	<000401c09454$1ab4e3c0$b2209fd4@shelob>
	<200102112257.f1BMvGt26067@mail3.aracnet.com>
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 11 Feb 2001 18:22:47 -0500
In-Reply-To: Gregory Leblanc's message of "11 Feb 2001 14:55:59 -0800"
Message-ID: <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 29
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Gregory Leblanc <gleblanc@cu-portland.edu> writes:

> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

Kill it!!! Kill it!!!!

*squawk*
-Jonathan


From ebaudais@x8b4e50ae.dhcp.okstate.edu  Sun Feb 11 18:25:28 2001
Return-Path: <ebaudais@x8b4e50ae.dhcp.okstate.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from bubba (x8b4e50ae.dhcp.okstate.edu [139.78.80.174])
	by mail.gnome.org (Postfix) with ESMTP id 2A9B72E22A
	for <gnome-doc-list@gnome.org>; Sun, 11 Feb 2001 18:25:28 -0500 (EST)
Received: from ebaudais by bubba with local (Exim 3.22 #1 (Debian))
	id 14S5s1-0003uI-00; Sun, 11 Feb 2001 17:25:29 -0600
Date: Sun, 11 Feb 2001 17:25:29 -0600
From: Eric Baudais <baudais@okstate.edu>
To: Gregory Leblanc <gleblanc@cu-portland.edu>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, jrb@redhat.com,
	itp@ximian.com, zana@webwynk.net, cwryu@adam.kaist.ac.kr
Subject: Re: Freecell Documentation
Message-ID: <20010211172529.A15008@bubba>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <200102112257.f1BMvGt26067@mail3.aracnet.com>; from gleblanc@cu-portland.edu on Sun, Feb 11, 2001 at 02:55:59PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 02:55:59PM -0800, Gregory Leblanc wrote:
> On 11 Feb 2001 17:57:29 +0000, Ian Miller wrote:
> > "Eric Baudais" <baudais@okstate.edu> wrote:
> > > On Fri, Feb 09, 2001 at 06:34:59PM +0000, Ian Miller wrote:
> > > > How
> > > > would it be if I did could have something finished by the end
> > > > of this weekend?  I think I can manage that.
> > > 
> > > That would be great!
> > 
> > As promised, I have something finished.
> > It is not perfect, but it is not bad either.
> > Please download sgml and pngs from
> > http://www.shelob.plus.com/freecell/
> > and let me know what you think.
> 
> Just because I enjoy making trouble...  I don't think that a separate
> freecell game will exist in the next major release of gnome-games.
> Freecell has been implemented as part of the aisleriot suite, and that
> version has a few less bugs (and the bugs it does have can be fixed for
> all aisleriot games) than the separate C coded freecell game.  This
> isn't a sure thing as far as I know, but it's worth being aware of.
> Anybody have a good reason -not- to do this?

I think that we still need docs for Freecell for this release of Gnome.  
Whether Freecell will continue with Gnome is still to be determined, but 
that doesn't reduce the need for these docs any less.

Eric Baudais


From chris@wilddev.net  Mon Feb 12 02:53:22 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 630A32C887
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 02:53:21 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id AAA26386
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 00:02:54 -0800
Message-Id: <200102120802.AAA26386@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 11 Feb 2001 23:53:47 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All
I'm going to attempt to update the GUG. I had a quick look at what was
there in CVS and it appeared like theres a lot of work. If anyone has
objects/comments let me know. 
I spoke with Sasha and Telsa about it and got their ideas for it. I
think the approach I will take will be to integrate exisitng docs into
it and create an index from the info that is there. This will update it
without unnecessarily duplicating the work of others.

Chris (Wilddev)



From hobbit@aloss.ukuu.org.uk  Mon Feb 12 04:21:38 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id E27952E4A3
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:21:37 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1C9Mev06046
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 09:22:40 GMT
Date: Mon, 12 Feb 2001 09:22:39 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
Message-ID: <20010212092239.A5996@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <007d01c0946b$7e79d8e0$30299fd4@shelob>; from Ian@shelob.f9.co.uk on Sun, Feb 11, 2001 at 08:26:14PM -0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> Telsa <hobbit@aloss.ukuu.org.uk> wrote
> 
> > Only quibble: fifty-two instead of fifty two (!)
> 
> I believe the latter form to be correct.
> Jihad! Jihad! Jihad! :-)

Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
 
> > Would it also be possible to explain that you can right-click on a
> > card in order to see what it is, if it's obscured by cards on top of
> > it?
> 
> Yes it would, although not very soon unfortunately. 

Fair enough.

> How long do we have before 1.4 is due?

According to 
http://mail.gnome.org/archives/gnome-1.4-list/2001-January/msg00027.html
the final hard freeze including docs and translations is on 18th March.
Freeze for everything except docs and translations is the 8th March.
I'll bet that gets superseded now I have mentioned it for posterity.
(There is also a releng (release engineering) module in CVS which has a
bunch of stuff in it, but it does not have these dates.)

> > I suppose it may be worth noting that you click on cards and then
> > on destinations.
> 
> Actually, I did mention that.  In the usage section between

Ahem. So you did. My apologies :) 

Telsa


From rjp@mail.tele.dk  Mon Feb 12 04:51:48 2001
Return-Path: <rjp@mail.tele.dk>
Delivered-To: gnome-doc-list@gnome.org
Received: from cicero2.cybercity.dk (cicero2.cybercity.dk [212.242.40.53])
	by mail.gnome.org (Postfix) with ESMTP id F179D2DC88
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 04:51:47 -0500 (EST)
Received: from usr00.cybercity.dk (usr00.cybercity.dk [212.242.40.34])
	by cicero2.cybercity.dk (Postfix) with ESMTP
	id EAC85FFFA6; Mon, 12 Feb 2001 10:51:45 +0100 (CET)
Received: from mail.tele.dk (IDENT:rjp@port21.cvx1-hb.ppp.cybercity.dk [212.242.232.22])
	by usr00.cybercity.dk (8.9.3/8.9.3) with ESMTP id KAA13626;
	Mon, 12 Feb 2001 10:51:42 +0100 (CET)
	(envelope-from rjp@mail.tele.dk)
Message-ID: <3A87C105.C79184CC@mail.tele.dk>
Date: Mon, 12 Feb 2001 11:55:01 +0100
From: "Rebecca J. Walter" <rjp@mail.tele.dk>
X-Mailer: Mozilla 4.75 [en] (X11; U; Linux 2.2.16-22 i586)
X-Accept-Language: en, da
MIME-Version: 1.0
To: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
Cc: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <20010211194212.B1727@aloss.ukuu.org.uk> <007d01c0946b$7e79d8e0$30299fd4@shelob> <20010212092239.A5996@aloss.ukuu.org.uk>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Telsa Gwynne wrote:
> 
> On Sun, Feb 11, 2001 at 08:26:14PM -0000 or thereabouts, Ian Miller wrote:
> > Telsa <hobbit@aloss.ukuu.org.uk> wrote
> >
> > > Only quibble: fifty-two instead of fifty two (!)
> >
> > I believe the latter form to be correct.
> > Jihad! Jihad! Jihad! :-)
> 
> Argh, I always lose these :) <mutter type="subliminal">fifty-two</mutter>
> 
telsa is correct.


From jfleck@swcp.com  Mon Feb 12 09:01:58 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 064D92E53D
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 09:01:58 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id HAA02052
	for gnome-doc-list@gnome.org; Mon, 12 Feb 2001 07:00:34 -0700
Date: Mon, 12 Feb 2001 07:00:34 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: Re: GNOME Users Guide
Message-ID: <20010212070034.B1770@inkstain.net>
Mail-Followup-To: gnome-doc-list <gnome-doc-list@gnome.org>
References: <200102120802.AAA26386@hub.wilddev.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102120802.AAA26386@hub.wilddev.net>; from Chris Lyttle on Sun, Feb 11, 2001 at 11:53:47PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Chris -
This is great. Thanks.

I'll be happy to assemble the chapter(s) for you on the packages I'm
dealing with - gnome-utils, ggv, and ghex. Let me know when and where
and in what form you'd like things.

John

On Sun, Feb 11, 2001 at 11:53:47PM -0800, Chris Lyttle wrote:
> Hi All
> I'm going to attempt to update the GUG. I had a quick look at what was
> there in CVS and it appeared like theres a lot of work. If anyone has
> objects/comments let me know. 
> I spoke with Sasha and Telsa about it and got their ideas for it. I
> think the approach I will take will be to integrate exisitng docs into
> it and create an index from the info that is there. This will update it
> without unnecessarily duplicating the work of others.
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From federico@ximian.com  Mon Feb 12 10:26:26 2001
Return-Path: <federico@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from guanabana.helixcode.com (unknown [212.209.126.33])
	by mail.gnome.org (Postfix) with ESMTP id 0434C2CDE5
	for <gnome-doc-list@gnome.org>; Mon, 12 Feb 2001 10:26:26 -0500 (EST)
Received: (from federico@localhost)
	by guanabana.helixcode.com (8.9.3/8.9.3) id JAA30011;
	Mon, 12 Feb 2001 09:36:26 -0600
Date: Mon, 12 Feb 2001 09:36:26 -0600
Message-Id: <200102121536.JAA30011@guanabana.helixcode.com>
X-Authentication-Warning: guanabana.helixcode.com: federico set sender to federico@ximian.com using -f
From: Federico Mena Quintero <federico@ximian.com>
X-Homer: You're everywhere.  You're omnivorous.
To: jrb@redhat.com
Cc: gnome-doc-list <gnome-doc-list@gnome.org>, zana@webwynk.net
Subject: Re: Freecell Documentation
References: <20010208150546.A2912@bubba> <000401c092c7$032864e0$5f259fd4@shelob> <20010209124117.B24184@bubba> <000401c09454$1ab4e3c0$b2209fd4@shelob> <200102112257.f1BMvGt26067@mail3.aracnet.com> <ybm4ry0vm7s.fsf@aware-of-vacuity.labs.redhat.com>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

jrb@redhat.com writes:

> Kill it!!! Kill it!!!!

There is only one solitaire, and Aisleriot is its name.

  Federico


From emese@sunserv.itp.hu  Tue Feb 13 06:25:56 2001
Return-Path: <emese@sunserv.itp.hu>
Delivered-To: gnome-doc-list@gnome.org
Received: from gamax.hu (ns.gamax.hu [195.184.11.170])
	by mail.gnome.org (Postfix) with ESMTP id EA26B2E60E
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 06:25:48 -0500 (EST)
Received: by gateway.gamax.hu id <116161>; Tue, 13 Feb 2001 12:29:54 +0100
From: Emese Kovacs <emese@gnome.hu>
To: gnome-doc-list@gnome.org
Subject: Docs updated for GKB in gnome-applets HEAD
Message-Id: <01Feb13.122954cet.116161@gateway.gamax.hu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.4i
Date: Tue, 13 Feb 2001 12:29:50 +0100
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi All,

As GKB has been rewritten, we have updated its manual (described new features, 
taken new screenshots). I would like to have it reviewed for gnome-1.4 
compatibility and spelling + other problems.

GKB can be checked out from the gnome CVS, it is located in 
gnome-applets/gkb-new

Thanks,

Emese Kovacs
<emese@gnome.hu>



From jacob@ximian.com  Tue Feb 13 18:01:33 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (ulysses.ximian.com [63.140.225.198])
	by mail.gnome.org (Postfix) with ESMTP
	id 6F8C32CCF8; Tue, 13 Feb 2001 18:01:32 -0500 (EST)
Received: from ulysses ([127.0.0.1])
	by ulysses with smtp (Exim 3.22 #1 (Debian))
	id 14SoLI-0000Bj-00; Tue, 13 Feb 2001 17:54:40 -0500
To: gnome-1.4-list@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
Subject: GNOME 1.4 Weekly Update
From: jacob berkman <jacob@ximian.com>
Date: 13 Feb 2001 17:54:39 -0500
Message-ID: <87zofq8a8g.fsf@ximian.com>
Lines: 51
User-Agent: Gnus/5.0807 (Gnus v5.8.7) XEmacs/21.1 (GTK)
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hello fans of The GNOME Project,

This is the first installment of a weekly update on the progress of
the GNOME 1.4 "not yet named" release.  Work on this release is
progressing rapidly, with the first beta release currently scheduled
for this Saturday (February 17).

For package maintainers:

    Maintainers of packages that will be included in this beta *must*
    provide tarballs by the end of Thursday.  Please mail
    gnome-1.4-release-team@gnome.org with information on where to find
    the tarball.

    Anybody who is packaging GNOME packages with documentation in it
    should install scrollkeeper 0.0.5 or later:
    http://sourceforge.net/project/showfiles.php?group_id=3D11543

    Dan will write up instructions on using ScrollKeeper soon.=A0 Keep
    an eye on the news on the GDP web page for an announcement of
    these instructions: http://developer.gnome.org/projects/gdp/

    GNOME 1.4 will use Nautilus' gnome-db2html2 converter to display
    SGML documents.=A0 Please make sure that the SGML documents are
    being installed in addition to the HTML.=A0 Also make sure that the
    SGML is compliant with the 1.4 guidelines:
    http://developer.gnome.org/projects/gdp/changes/

    Also, don't forget to mail gnome-i18n@gnome.org a couple of days
    (which is right now, actually) before making your final tarball
    for the beta.

For i18n and doc people:

    A list of the branches for the different modules being released is
    available in the releng module of GNOME cvs, or from lxr:
    http://cvs.gnome.org/lxr/source/releng/gnome-1.4-branches

    Don't worry if everything isn't done by the first beta :)

For testers:

    The GNOME 1.4 beta process will include a list of tests for many
    of the applications.  This will be made available later this week,
    and more information about this will be made at that time.

That's all for now; more information about the release will be
available later this week.

Thanks,
The GNOME 1.4 Release Team  <gnome-1.4-release-team@gnome.org>



From alan@devserv.devel.redhat.com  Tue Feb 13 18:15:12 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id C39912CCF8; Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1DNFBx01803;
	Tue, 13 Feb 2001 18:15:11 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Tue, 13 Feb 2001 18:15:11 -0500 (EST)
Cc: gnome-announce-list@gnome.org, gnome-i18n@gnome.org,
	gnome-doc-list@gnome.org, gnome-hackers@gnome.org
In-Reply-To: <87zofq8a8g.fsf@ximian.com> from "jacob berkman" at Feb 13, 2001 05:54:39 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

>     provide tarballs by the end of Thursday.  Please mail
>     gnome-1.4-release-team@gnome.org with information on where to find
>     the tarball.
> 
>     Anybody who is packaging GNOME packages with documentation in it
>     should install scrollkeeper 0.0.5 or later:
>     http://sourceforge.net/project/showfiles.php?group_id=11543

By thursday ? Given 2 days notice. Umm



From mjs@eazel.com  Tue Feb 13 19:18:43 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 66E262BAB4; Tue, 13 Feb 2001 19:18:41 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id QAA01825;
	Tue, 13 Feb 2001 16:16:57 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Reply-To: gnome-1.4-list@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102132315.f1DNFBx01803@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 13 Feb 2001 16:16:57 -0800
In-Reply-To: Alan Cox's message of "Tue, 13 Feb 2001 18:15:11 -0500 (EST)"
Message-ID: <lqk86u6ruu.fsf@pythagoras.eazel.com>
Lines: 30
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> >     provide tarballs by the end of Thursday.  Please mail
> >     gnome-1.4-release-team@gnome.org with information on where to find
> >     the tarball.
> > 
> >     Anybody who is packaging GNOME packages with documentation in it
> >     should install scrollkeeper 0.0.5 or later:
> >     http://sourceforge.net/project/showfiles.php?group_id=11543
> 
> By thursday ? Given 2 days notice. Umm
> 

This has got to be about the 10th time over the past N weeks that this
deadline has been posted. The most recent before this was on Sunday
when I sent a reminder to many of these same lists to start getting
packages ready. We have posted the full schedule of all the
planned betas and package deadlines many times.

And we have also been personally emailing maintainers of packages in
the main release and reminding them on IRC.

I hope this deadline comes as less of a surprise to most people than
it apparently did to Alan.

And if you miss it, hey, there's always beta 2.

 - Maciej




From chris@wilddev.net  Wed Feb 14 00:40:20 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 12AE52BC15
	for <gnome-doc-list@gnome.org>; Wed, 14 Feb 2001 00:40:20 -0500 (EST)
Received: from meher.wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id VAA02001;
	Tue, 13 Feb 2001 21:49:32 -0800
Message-Id: <200102140549.VAA02001@hub.wilddev.net>
Subject: GNOME Users Guide
From: Chris Lyttle <chris@wilddev.net>
To: ian@eazel.com
Cc: gnome-doc-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.10.08.59 - Preview Release)
Date: 13 Feb 2001 21:40:40 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi
I just chatted to muet about the scripts you are writing to automate
taking UG docs from cvs and merging it into chapters for the UG GOOD
JOB!
I'll be attempting to do some work on putting the other bits of it
together this weekend, please let me know when you will have something
ready to test/break so I can try it out and we can feed to each other
the changes being made to it.

Thx
Chris (Wilddev)



From alan@devserv.devel.redhat.com  Wed Feb 14 07:32:03 2001
Return-Path: <alan@devserv.devel.redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from devserv.devel.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP
	id 9255F2BA99; Wed, 14 Feb 2001 07:32:02 -0500 (EST)
Received: (from alan@localhost)
	by devserv.devel.redhat.com (8.11.0/8.11.0) id f1ECW2515224;
	Wed, 14 Feb 2001 07:32:02 -0500
From: Alan Cox <alan@redhat.com>
Message-Id: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Subject: Re: GNOME 1.4 Weekly Update
To: gnome-1.4-list@gnome.org
Date: Wed, 14 Feb 2001 07:32:01 -0500 (EST)
Cc: alan@redhat.com (Alan Cox), gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
In-Reply-To: <lqk86u6ruu.fsf@pythagoras.eazel.com> from "Maciej Stachowiak" at Feb 13, 2001 04:16:57 PM
X-Mailer: ELM [version 2.5 PL3]
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

> This has got to be about the 10th time over the past N weeks that this
> deadline has been posted. The most recent before this was on Sunday

Im not objecting to the tarballing deadline its the suprise go and instal
0.0.5 of scrollkeeper bit

Alan



From dan@eazel.com  Wed Feb 14 20:58:23 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 29DEB2D368; Wed, 14 Feb 2001 20:58:22 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F1wJd14908;
	Wed, 14 Feb 2001 17:58:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 17:58:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
In-Reply-To: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
Message-ID: <Pine.LNX.4.21.0102141747590.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 14 Feb 2001, Alan Cox wrote:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit

Sorry about this.  I wrote this note quickly, hoping to get the full
instructions on the web before the newsletter went out and replace this
text, but didn't get it done in time.
 
You only need to have scrollkeeper installed if the GDP elves have come
along and put OMF files in your package.  Right now, this means
gnome-core, gnome-utils, and soon gnome-applets, gnome-media, and
gnome-user-docs.  If you aren't packaging these few modules, you don't
need to worry about scrollkeeper.

Dan





From Lorna.Whelan@ireland.sun.com  Thu Feb 15 05:20:28 2001
Return-Path: <Lorna.Whelan@ireland.sun.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP
	id 78A3D2BE58; Thu, 15 Feb 2001 05:20:27 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id CAA26927;
	Thu, 15 Feb 2001 02:20:25 -0800 (PST)
Received: from dbl-ray-2 (dbl-ray-2 [129.156.237.101])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with SMTP id KAA01118;
	Thu, 15 Feb 2001 10:20:23 GMT
Message-Id: <200102151020.KAA01118@ireserver.Ireland.Sun.COM>
Date: Thu, 15 Feb 2001 10:20:23 +0000 (GMT)
From: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Reply-To: Lorna Whelan <Lorna.Whelan@ireland.sun.com>
Subject: Localisation Style Guides
To: gnome-i18n@gnome.org, gnome-doc-list@gnome.org
Cc: lorna.whelan@ireland.sun.com, Aoife.Dunne@ireland.sun.com,
	michael.twomey@ireland.sun.com
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=us-ascii
Content-MD5: mdUVyT/+Qy+6Uia13lTD4w==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.4.2 SunOS 5.8 sun4u sparc 
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

The localisation Style Guides for the following languages
are ready:


Language		Formats available
--------		-----------------

English			.ps .pdf .mif and FrameMaker
French			.ps .pdf .mif and FrameMaker
German			.ps .pdf .mif and FrameMaker
Spanish			.ps .pdf .mif and FrameMaker
Italian			.ps .pdf .mif and FrameMaker
Swedish			.ps .pdf .mif and FrameMaker
Japanese		software: .html   doc: .ps .pdf and FrameMaker
Korean			.pdf
Simplified Chinese	.pdf
Traditional Chinese	.pdf


The following still needs to be done with the style guides:

- convert or rewrite them into docbook format
- rewrite them to make them more Gnome-friendly - all
  references to Sun need to be changed


I have created a tarball of all the style guides and the size is roughly
6Mb, however, I need someone to take the files and place them under the
Gnome CVS tree and also on an appropriate place on the Gnome web site.
Could someone volunteer to do this?


Regards,
Lorna




 ____________________________________________________

 Lorna Whelan			Tel.:+353-1-8199-029
 European Localisation Centre   Fax: +353-1-8199-261
 Sun Ireland		        
 ____________________________________________________



From dhelder@umich.edu  Tue Feb 13 14:07:43 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id E4D0C2DC27; Tue, 13 Feb 2001 14:07:42 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id OAA02437;
	Tue, 13 Feb 2001 14:07:36 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Tue, 13 Feb 2001 14:07:36 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102131401410.28452-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net



From dusk@ravendusk.org  Tue Feb 13 16:39:04 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 309B72BB40
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 16:39:04 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-6.pconline.com [207.191.143.38])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id PAA29344
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:38:59 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Sn6g-0006mu-00
	for <gnome-doc-list@gnome.org>; Tue, 13 Feb 2001 15:35:30 -0600
Date: Tue, 13 Feb 2001 15:35:30 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Updating API docs
Message-ID: <20010213153530.D431@ravendusk.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,

I'm trying to figure out the best way to move inline API comments into
the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
tool to do it automatically, but after some rooting around, it appears
to only parse through the header files.  Is this correct, or have I
missed something?

Do we have to cut & paste the comments manually from the *.c files
into the *.sgml files?

Thanks,
John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From mjs@eazel.com  Wed Feb 14 18:23:52 2001
Return-Path: <mjs@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from pythagoras.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 5876C2D1C4; Wed, 14 Feb 2001 18:23:50 -0500 (EST)
Received: (from mjs@localhost)
	by pythagoras.eazel.com (8.9.3/8.9.3) id PAA06633;
	Wed, 14 Feb 2001 15:22:01 -0800
X-Authentication-Warning: pythagoras.eazel.com: mjs set sender to mjs@eazel.com using -f
To: Alan Cox <alan@redhat.com>
Cc: gnome-1.4-list@gnome.org, gnome-announce-list@gnome.org,
	gnome-i18n@gnome.org, gnome-doc-list@gnome.org,
	gnome-hackers@gnome.org
Subject: Re: GNOME 1.4 Weekly Update
References: <200102141232.f1ECW2515224@devserv.devel.redhat.com>
From: Maciej Stachowiak <mjs@eazel.com>
Date: 14 Feb 2001 15:22:01 -0800
In-Reply-To: Alan Cox's message of "Wed, 14 Feb 2001 07:32:01 -0500 (EST)"
Message-ID: <lqhf1wonom.fsf@pythagoras.eazel.com>
Lines: 15
User-Agent: Gnus/5.0802 (Gnus v5.8.2) Emacs/20.4
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Alan Cox <alan@redhat.com> writes:

> > This has got to be about the 10th time over the past N weeks that this
> > deadline has been posted. The most recent before this was on Sunday
> 
> Im not objecting to the tarballing deadline its the suprise go and instal
> 0.0.5 of scrollkeeper bit
> 

OK, I agree the scrollkeeper thing should have been communicated
better. However, if you can't get it for beta 1, beta 2 is coming up,
and beta 1 does not have to be perfect (that's why it is a beta).

 - Maciej



From dan@eazel.com  Thu Feb 15 00:47:41 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id AFA942C8A2
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 00:47:40 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1F5l3903604;
	Wed, 14 Feb 2001 21:47:03 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Wed, 14 Feb 2001 21:47:03 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Chris Lyttle <chris@wilddev.net>
Cc: ian@eazel.com, gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <200102140549.VAA02001@hub.wilddev.net>
Message-ID: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I thought I'd add a bit more info here, in case people are curious what we
have in mind...

The problem with how we have done the GNOME User Guide in the past was
that we did it all by hand.  This meant that not only was it hard to
create, it was very hard to keep up to date and very hard for each of the
translation teams to reproduce.  It was basically impossible for
translators to keep up, since it was so much work.

The new proposed solution is to create some scripts which grab docs from
CVS and merge them together to produce a product similar to what we had in
the past, but to automate much of the work.  Once it is set up, doing it
for another locale or updating it is as simple as running the script.  It
is more up-front work, but should not be too bad for somebody who is good
at scripting.

Ian is working on the script, so if he doesn't run out of time or run into
too many problems, we should have something to work with in not too
long.  Chris is working on this with Ian.  Thanks to both of you.

Dan


On 13 Feb 2001, Chris Lyttle wrote:

> Hi
> I just chatted to muet about the scripts you are writing to automate
> taking UG docs from cvs and merging it into chapters for the UG GOOD
> JOB!
> I'll be attempting to do some work on putting the other bits of it
> together this weekend, please let me know when you will have something
> ready to test/break so I can try it out and we can feed to each other
> the changes being made to it.
> 
> Thx
> Chris (Wilddev)



From dhelder@umich.edu  Thu Feb 15 09:39:12 2001
Return-Path: <dhelder@umich.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from ask.eecs.umich.edu (ask.eecs.umich.edu [141.213.11.224])
	by mail.gnome.org (Postfix) with ESMTP
	id 4E7B52BA99; Thu, 15 Feb 2001 09:39:12 -0500 (EST)
Received: from localhost (dhelder@localhost)
	by ask.eecs.umich.edu (8.9.3/8.9.3/Debian 8.9.3-21) with ESMTP id JAA29621;
	Thu, 15 Feb 2001 09:39:07 -0500
X-Authentication-Warning: ask.eecs.umich.edu: dhelder owned process doing -bs
Date: Thu, 15 Feb 2001 09:39:07 -0500 (EST)
From: David Helder <dhelder@umich.edu>
X-X-Sender:  <dhelder@ask.eecs.umich.edu>
To: <gtk-app-devel-list@gnome.org>
Cc: <gnome-doc-list@gnome.org>
Subject: meshplayer workshop notes
Message-ID: <Pine.LNX.4.33.0102150935430.29454-100000@ask.eecs.umich.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Strange, I sent this Tuesday and I haven't seen it yet so I'm resending
it.  Sorry if you get this twice.]

I recently taught a workshop at U of M on GTK development using Glade and
libglade.  It was a hands-on workshop - the demo program was an MP3 player
(mpg123 frontend) called meshplayer.  My notes are here:

	http://misc.eecs.umich.edu/workshops/gtk/

There's a link to the demo code in this file.  Basically it's a 10-15
minutes lecture, a 10 minute Glade demo, and the rest of the workshop is
adding features to meshplayer (1 - 1.5 hours).

I thought the GTK/Gnome community might find this useful.  Enjoy.

David


-- 
      __          _    __  David Helder - University of Michigan
  ___/ /__ __  __(_)__/ /  dhelder@umich.edu
 / _  / _ `/ |/ / / _  /   http://www.eecs.umich.edu/~dhelder
 |_,_/|_,_/|___/_/|_,_/    Jungle Monkey: http://www.junglemonkey.net




From kirillov@peconic.math.sunysb.edu  Thu Feb 15 17:52:38 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 202F92E0A5
	for <gnome-doc-list@gnome.org>; Thu, 15 Feb 2001 17:22:07 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id RAA12452;
	Thu, 15 Feb 2001 17:22:00 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id RAA11551;
	Thu, 15 Feb 2001 17:21:59 -0500
Date: Thu, 15 Feb 2001 17:21:59 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
Message-ID: <20010215172159.A11517@math.sunysb.edu>
References: <200102140549.VAA02001@hub.wilddev.net> <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <Pine.LNX.4.21.0102142141550.23609-100000@foodle.eazel.com>; from dan@eazel.com on Wed, Feb 14, 2001 at 09:47:03PM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

For now, having scripts putting different manulas together is better
than doing it by hand. So I'd be happy if Ian and Chhris make this
happen. 

In the long run, I am not so sure having users guide which is just the
collection of manuals of different components lumped together is a
good idea. Good UG should be more task oriented ("how do I do this in
GNOME") and may omit details or some options which should go
in on-line help (i.e., manuals as we have them now). There was a talk
of writing such a users guide or rather a book for GNOME 2.0 - I think
after 1.4 is out, we should return to this project. 

Sasha
  



On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> 
> I thought I'd add a bit more info here, in case people are curious what we
> have in mind...
> 
> The problem with how we have done the GNOME User Guide in the past was
> that we did it all by hand.  This meant that not only was it hard to
> create, it was very hard to keep up to date and very hard for each of the
> translation teams to reproduce.  It was basically impossible for
> translators to keep up, since it was so much work.
> 
> The new proposed solution is to create some scripts which grab docs from
> CVS and merge them together to produce a product similar to what we had in
> the past, but to automate much of the work.  Once it is set up, doing it
> for another locale or updating it is as simple as running the script.  It
> is more up-front work, but should not be too bad for somebody who is good
> at scripting.
> 
> Ian is working on the script, so if he doesn't run out of time or run into
> too many problems, we should have something to work with in not too
> long.  Chris is working on this with Ian.  Thanks to both of you.
> 
> Dan


From dan@eazel.com  Fri Feb 16 03:09:32 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id BB4DD2E0E5
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:09:08 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G88H514657;
	Fri, 16 Feb 2001 00:08:17 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:08:17 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: Chris Lyttle <chris@wilddev.net>, ian@eazel.com,
	gnome-doc-list@gnome.org
Subject: Re: GNOME Users Guide
In-Reply-To: <20010215172159.A11517@math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


I agree.  This sort of a UG, created by lumping the online help together,
should be retired and replaced by a more carefully crafted document.  
This probably won't happen until GNOME 2.0 (about 12 months from now or
more), although it is possible that we get it out somewhat earlier.  In
the mean time, this UG will satisfy an important need: We can place it
prominantly on the web page, allowing people to learn a lot about GNOME
without even installing Linux or GNOME. It is a also single document which
people can either browse through to learn more about GNOME in general, or
they can use it as a reference document as they do with the online help.

I know at least one person who has printed out the entire GNOME User Guide
and basically read it cover to cover when they started using GNOME and was
generally very happy with having learned GNOME this way.

So, I think in these ways the UG is actually quite valuable in its current
form, even though we tend to deprecate it.  For GNOME 2.0, we probably
want to tailor multiple documents to replace the UG, as Sasha has already
started doing in gnome-user-docs.

Generally, I think we will want to use this task oriented approach more in
our online documents and in the Users Guide.

Dan


On Thu, 15 Feb 2001, Alexander Kirillov wrote:

> For now, having scripts putting different manulas together is better
> than doing it by hand. So I'd be happy if Ian and Chhris make this
> happen. 
> 
> In the long run, I am not so sure having users guide which is just the
> collection of manuals of different components lumped together is a
> good idea. Good UG should be more task oriented ("how do I do this in
> GNOME") and may omit details or some options which should go
> in on-line help (i.e., manuals as we have them now). There was a talk
> of writing such a users guide or rather a book for GNOME 2.0 - I think
> after 1.4 is out, we should return to this project. 
> 
> Sasha
>   
> 
> 
> 
> On Wed, Feb 14, 2001 at 09:47:03PM -0800, Dan Mueth wrote:
> > 
> > I thought I'd add a bit more info here, in case people are curious what we
> > have in mind...
> > 
> > The problem with how we have done the GNOME User Guide in the past was
> > that we did it all by hand.  This meant that not only was it hard to
> > create, it was very hard to keep up to date and very hard for each of the
> > translation teams to reproduce.  It was basically impossible for
> > translators to keep up, since it was so much work.
> > 
> > The new proposed solution is to create some scripts which grab docs from
> > CVS and merge them together to produce a product similar to what we had in
> > the past, but to automate much of the work.  Once it is set up, doing it
> > for another locale or updating it is as simple as running the script.  It
> > is more up-front work, but should not be too bad for somebody who is good
> > at scripting.
> > 
> > Ian is working on the script, so if he doesn't run out of time or run into
> > too many problems, we should have something to work with in not too
> > long.  Chris is working on this with Ian.  Thanks to both of you.
> > 
> > Dan
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 



From dan@eazel.com  Fri Feb 16 03:33:05 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3CF0A2BB41
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 03:33:05 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1G8X4j14907
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 00:33:04 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 16 Feb 2001 00:33:04 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: gnome-user-docs and gnome-devel-docs
Message-ID: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi folks,

I had two new GNOME modules created in CVS today: gnome-user-docs and
gnome-devel-docs

They are both empty.  My plans are to create and ship just two GNOME
packages which are strictly documentation.  So, we can slowly move over
any good documentation into these modules from their current locations.

There are some packages which will die in the process:
	gnome-users-guide
	gnome-user-faq
	gdp-handbook

Some examples of what these modules will contain:

gnome-user-docs:
	Glossary
	Introduction to GNOME
	Introduction to Linux
	GNOME Users Guide
	GNOME User FAQ
        GNOME Quick Reference
	Joining the GNOME Project
	...

gnome-devel-docs:
	GNOME Developer FAQ
	GDP Handbook
	GTP Handbook
	(any white papers which are up to date)
	(any tutorials which are up to date)
	(any other developer documents which are good and up to date)
	...

Generally speaking, gnome-user-docs would ship with the main GNOME
release, and gnome-devel-docs would be in the extra apps packages since
most people don't need them.

So, I think we generally want to get someone with CVS root access to move
these pieces into place from their current locations in CVS, approving
this of course with anybody who may have co-authored each text so they
don't think their doc dissappeared. 

This is our chance to start with a fresh module, so lets be careful to
keep things tidy and keep the build system working.  Remember the basic
directory layout:

gnome-xxx-docs/<docname>/<locale>/{stuff}
gnome-xxx-docs/<docname>/<locale>/{stuff}/figures/

Also be sure that anything you put in these modules are up to date,
written in DocBook/SGML, and licensed under the FDL and appropriately
state so in their legalnotice.

Dan





From damon@ximian.com  Fri Feb 16 10:20:37 2001
Return-Path: <damon@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail6.svr.pol.co.uk (mail6.svr.pol.co.uk [195.92.193.212])
	by mail.gnome.org (Postfix) with ESMTP id E9BA62E5BC
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 10:20:36 -0500 (EST)
Received: from modem-204.dragonette.dialup.pol.co.uk ([62.137.2.204] helo=ximian.com)
	by mail6.svr.pol.co.uk with esmtp (Exim 3.13 #0)
	id 14TmgU-0007cQ-00; Fri, 16 Feb 2001 15:20:34 +0000
Message-ID: <3A8C4CED.960B7A36@ximian.com>
Date: Thu, 15 Feb 2001 21:41:01 +0000
From: Damon Chaplin <damon@ximian.com>
X-Mailer: Mozilla 4.72 [en] (X11; U; Linux 2.2.14-5.0 i686)
X-Accept-Language: en
MIME-Version: 1.0
To: "John R. Sheets" <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
References: <20010213153530.D431@ravendusk.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

"John R. Sheets" wrote:
> 
> Hi,
> 
> I'm trying to figure out the best way to move inline API comments into
> the tmpl/*.sgml files.  I had assumed that gtk-doc had some sort of
> tool to do it automatically, but after some rooting around, it appears
> to only parse through the header files.  Is this correct, or have I
> missed something?
> 
> Do we have to cut & paste the comments manually from the *.c files
> into the *.sgml files?

You normally just leave the API comments in the source code.
gtkdoc-mkdb merges it into the final SGML documentation, if you pass
it the --source-dir option.

Damon




From kbreit@mediaone.net  Fri Feb 16 17:15:21 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id BFAE62E743
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:15:20 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA03735;
	Fri, 16 Feb 2001 16:06:09 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Help for 1.4 QA
Date: Fri, 16 Feb 2001 16:05:05 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
Cc: battery841@mediaone.net
MIME-Version: 1.0
Message-Id: <01021616050500.03732@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
  I am curious if anyone here would be interested in finding QA problems in 
1.4 dox with me.  I'm looking for help, so if you're looking for a job, you 
have no excuse now (other than if you hate tedium ;)
Kevin
PS. Make sure I am on cc: as my email is flakey
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 17:37:51 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 666B32E906
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 17:37:51 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA28799;
	Fri, 16 Feb 2001 16:28:35 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: Dan Mueth <dan@eazel.com>, gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
Date: Fri, 16 Feb 2001 16:27:33 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="US-ASCII"
References: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
In-Reply-To: <Pine.LNX.4.21.0102160008200.23325-100000@foodle.eazel.com>
MIME-Version: 1.0
Message-Id: <01021616273300.28362@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> I had two new GNOME modules created in CVS today: gnome-user-docs and
> gnome-devel-docs
>
> They are both empty.  My plans are to create and ship just two GNOME
> packages which are strictly documentation.  So, we can slowly move over
> any good documentation into these modules from their current locations.
Where should I drop the QA gnumeric spreadsheet for now?
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From kbreit@mediaone.net  Fri Feb 16 19:02:13 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 87FC22D4BB
	for <gnome-doc-list@gnome.org>; Fri, 16 Feb 2001 19:02:12 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id RAA01258
	for gnome-doc-list@gnome.org; Fri, 16 Feb 2001 17:53:01 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Dia dox ready to go?
Date: Fri, 16 Feb 2001 17:51:56 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="iso-8859-1"
MIME-Version: 1.0
Message-Id: <01021617515701.21176@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
   Wow, I'm active on this list today!  I would like someone to go read my 
documentation for Dia and let me know if it's ready for prime time.  I'm not 
saying it's DONE, but is it something we feel safe releasing in 1.4 in its 
current state.  This would be _greatly_ appreciated.
Thanks
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From dusk@ravendusk.org  Sat Feb 17 12:13:47 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id C474F2D713
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 12:13:46 -0500 (EST)
Received: from exodus.ravendusk.org (m18-4-2.pconline.com [207.191.143.50])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id LAA06230
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:13:43 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UAwH-000066-00
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 11:14:29 -0600
Date: Sat, 17 Feb 2001 11:14:29 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010217111429.B355@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <3A8C4CED.960B7A36@ximian.com>; from damon@ximian.com on Thu, Feb 15, 2001 at 09:41:01PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 15, 2001, Damon Chaplin <damon@ximian.com> wrote:
> 
> "John R. Sheets" wrote:
> > 
> > Do we have to cut & paste the comments manually from the *.c files
> > into the *.sgml files?
> 
> You normally just leave the API comments in the source code.
> gtkdoc-mkdb merges it into the final SGML documentation, if you pass
> it the --source-dir option.

Yep, that was exactly the problem with the Bonobo API docs: the
--source-dir parameter was set incorrectly.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From jrb@redhat.com  Sat Feb 17 21:44:02 2001
Return-Path: <jrb@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from aware-of-vacuity.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id BBE472BD79
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 21:44:02 -0500 (EST)
Received: (from jrb@localhost)
	by aware-of-vacuity.labs.redhat.com (8.11.0/8.11.0) id f1I2jOq10285;
	Sat, 17 Feb 2001 21:45:24 -0500
X-Authentication-Warning: aware-of-vacuity.labs.redhat.com: jrb set sender to jrb@redhat.com using -f
To: gnome-doc-list@gnome.org
Subject: Keyword to bugzilla
X-URL: <http://people.redhat.com/jrb>
From: jrb@redhat.com
Date: 17 Feb 2001 21:45:24 -0500
Message-ID: <ybm8zn4675n.fsf@aware-of-vacuity.labs.redhat.com>
Lines: 8
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I added a new DOCS_NEEDED keyword to bugzilla today.  The idea behind
it, is that if a bug requires a change in documentation when fixed, or
the bug involves the documentation somehow, you can put the keyword in
to indicate that docs need to be written.  I don't know how useful this
will be, but it's worth a shot.

Thanks,
-Jonathan 


From zfrey@bright.net  Sat Feb 17 22:21:20 2001
Return-Path: <zfrey@bright.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from invictus.bright.net (invictus.bright.net [205.212.123.12])
	by mail.gnome.org (Postfix) with ESMTP id 6F31E2BB7B
	for <gnome-doc-list@gnome.org>; Sat, 17 Feb 2001 22:21:20 -0500 (EST)
Received: from arch-cas3-cs-35.dial.bright.net ([216.201.22.139])
          by invictus.bright.net with ESMTP
          id <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>;
          Sat, 17 Feb 2001 22:21:19 -0500
Subject: Re: Updating API docs
From: Zach Frey <zfrey@bright.net>
To: John "R." Sheets <dusk@ravendusk.org>
Cc: gnome-doc-list@gnome.org
In-Reply-To: <20010217111429.B355@ravendusk.org>
References: <20010213153530.D431@ravendusk.org>
	<3A8C4CED.960B7A36@ximian.com>  <20010217111429.B355@ravendusk.org>
Content-Type: text/plain
X-Mailer: Evolution (0.8/+cvs.2001.02.17.08.59 - Preview Release)
Date: 17 Feb 2001 22:25:47 +0000
Mime-Version: 1.0
Message-Id: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:

> Yep, that was exactly the problem with the Bonobo API docs: the
> --source-dir parameter was set incorrectly.


Er, oops, that sounds like my mistake.  Sorry about that.

Now that I see what you did, was the problem that it was broken for
srcdir != builddir?  


Thanks,

Zach





From barreiro@arrakis.es  Sun Feb 18 04:45:15 2001
Return-Path: <barreiro@arrakis.es>
Delivered-To: gnome-doc-list@gnome.org
Received: from correo.madritel.es (unknown [213.37.2.130])
	by mail.gnome.org (Postfix) with ESMTP
	id 0B2F52BD32; Sun, 18 Feb 2001 04:45:15 -0500 (EST)
Received: from pc-int-2.arrakis.es ([213.37.13.136]) by correo.madritel.es
          (Netscape Messaging Server 3.5)  with ESMTP id AAA3F81;
          Sun, 18 Feb 2001 10:42:58 +0100
Content-Length: 691
Message-ID: <XFMail.20010218115129.barreiro@arrakis.es>
X-Mailer: XFMail 1.4.4 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <3A2FA437.E663AF05@ireland.sun.com>
Date: Sun, 18 Feb 2001 11:51:29 +0100 (MET)
Reply-To: barreiro@arrakis.es
Organization: linux landia
From: barreiro@arrakis.es
To: Michael Twomey <michael.twomey@ireland.sun.com>
Subject: Re: Update on Localisation Style Guides and Glossaries
Cc: Gnome Doc List <gnome-doc-list@gnome.org>, ,
	Gnome Doc List <gnome-doc-list@gnome.org>,
	"gnome-i18n@gnome.org" <gnome-i18n@gnome.org>,
	Gregory Leblanc <gleblanc@cu-portland.edu>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 07-Dec-2000 Michael Twomey wrote:
> Gregory Leblanc wrote:
>> 
> 
> Hi,
>       I've sent the glossary to Greg so he should have it up in somewhere
> like gnome-i18n/glossary soon.
> 
> Greg, can I mail you the style guides as well? They are a hefty 4MB
> tarball. Or does someone else want to take them?
> 
> thanks Greg,
>       Michael
>
Hi,

I looked for style guides at Gnome-i18n and gnome-docu but not found it.

Could you tell me where get the Spanish copy?

Regards.


Manuel de Vega Barreiro. barreiro@arrakis.es   En un lugar de la red
Madrid. Espaņa. usuario: 62.146                de cuyo nombre no quiero
http://www.croftj.net/~barreiro Linux Landia   acordarme..........



From dan@eazel.com  Sun Feb 18 04:50:22 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id D0AAD2DD1E
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 04:50:21 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1I9oJ731916;
	Sun, 18 Feb 2001 01:50:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Sun, 18 Feb 2001 01:50:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Kevin Breit <battery841@mediaone.net>
Cc: gnome-doc-list@gnome.org
Subject: Re: gnome-user-docs and gnome-devel-docs
In-Reply-To: <01021616273300.28362@7of9>
Message-ID: <Pine.LNX.4.21.0102180148100.31875-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>


On Fri, 16 Feb 2001, Kevin Breit wrote:

> On Friday 16 February 2001 02:33 am, NBC said Dan Mueth wrote:
> > I had two new GNOME modules created in CVS today: gnome-user-docs and
> > gnome-devel-docs
> >
> > They are both empty.  My plans are to create and ship just two GNOME
> > packages which are strictly documentation.  So, we can slowly move over
> > any good documentation into these modules from their current locations.
> Where should I drop the QA gnumeric spreadsheet for now?
> Kevin
> 

These are GDP-related documents which we do not plan to ship, so I would
put them in a new directory at: gnome-docu/gdp/qa/

Things in gnome-user-docs and gnome-devel-docs will only be up-to-date
documents which we plan on shipping in these packages.

Dan



From dusk@ravendusk.org  Sun Feb 18 11:18:32 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id 39DFF2BD2D
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 11:18:32 -0500 (EST)
Received: from exodus.ravendusk.org (m18-3-11.pconline.com [207.191.143.43])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id KAA13568
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:17 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14UWY0-0000Cj-00
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 10:18:52 -0600
Date: Sun, 18 Feb 2001 10:18:52 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Updating API docs
Message-ID: <20010218101852.B434@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010213153530.D431@ravendusk.org> <3A8C4CED.960B7A36@ximian.com> <20010217111429.B355@ravendusk.org> <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <20010218032119.MRNL10619.invictus@arch-cas3-cs-35.dial.bright.net>; from zfrey@bright.net on Sat, Feb 17, 2001 at 10:25:47PM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 17, 2001, Zach Frey <zfrey@bright.net> wrote:
> 
> On 17 Feb 2001 11:14:29 -0600, John R. Sheets wrote:
> 
> > Yep, that was exactly the problem with the Bonobo API docs: the
> > --source-dir parameter was set incorrectly.
> 
> Er, oops, that sounds like my mistake.  Sorry about that.

Actually, I think it was Michael Meeks, in revision 1.3 of
Makefile.am, amid a flurry of other changes.  (c;

> Now that I see what you did, was the problem that it was broken for
> srcdir != builddir?  

No, it didn't find the source files at all, even with srcdir ==
builddir.  Didn't go far enough towards the root dir.  Should have
been '../..' rather than '..'.

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From erik@core.com  Sun Feb 18 15:20:13 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id D27C92BAAF
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 15:19:37 -0500 (EST)
Received: from core.com (tnt17a-242.focal-chi.corecomm.net [208.40.16.242])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1IKLI545961;
	Sun, 18 Feb 2001 20:21:38 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1IKR2708990;
	Sun, 18 Feb 2001 14:27:02 -0600
Date: Sun, 18 Feb 2001 14:27:02 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: Dan Mueth <dan@eazel.com>
Cc: gnome-doc-list@gnome.org
Subject: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010218142702.L12018@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>; from "dan@eazel.com on Fri, Feb 16, 2001 at 12:08:17AM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Is there any interest in having any of the user or developer docs
recorded? I'm thinking audio books, or even inserting <audioobject> and
<audiodata> tags into the docs themselves. 

All I will need is someone with a good voice to volunteer. (I have a small
studio setup near Chicago.)  

Erik
-- 
All music aspires to the condition of muzak.


From kbreit@mediaone.net  Sun Feb 18 17:14:59 2001
Return-Path: <kbreit@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from mediaone.net (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by mail.gnome.org (Postfix) with ESMTP id 4A4CC2CE26
	for <gnome-doc-list@gnome.org>; Sun, 18 Feb 2001 17:14:58 -0500 (EST)
Received: from localhost (localhost [[UNIX: localhost]])
	by mediaone.net (8.9.3/8.9.3) id QAA32529
	for gnome-doc-list@gnome.org; Sun, 18 Feb 2001 16:05:48 -0600
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Date: Sun, 18 Feb 2001 15:16:58 -0600
X-Mailer: KMail [version 1.1.99]
Content-Type: text/plain;
  charset="us-ascii"
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net>
In-Reply-To: <20010218142702.L12018@megsinet.net>
MIME-Version: 1.0
Message-Id: <01021815165800.10931@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> Is there any interest in having any of the user or developer docs
> recorded? I'm thinking audio books, or even inserting <audioobject> and
> <audiodata> tags into the docs themselves.
>
> All I will need is someone with a good voice to volunteer. (I have a small
> studio setup near Chicago.)
That'd be interesting.  It would be best to have it in mp3 format.  If you 
wanted, and we got this rolling soon enough, I could do some voice stuff 
since I live in the Chicago burbs.
Kevin
-- 
"Curiously enough, the dolphins had long known of the impending destruction
of the planet Earth and had made many attempts to alert mankind to the danger;
but most of their communications were misinterpreted as amusing attempts to
punch footballs..." - Hitchiker's Guide to the Galaxy


From hobbit@aloss.ukuu.org.uk  Mon Feb 19 17:51:32 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id 1959C2BE06
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 17:51:30 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1JMqGW32596
	for gnome-doc-list@gnome.org; Mon, 19 Feb 2001 22:52:16 GMT
Date: Mon, 19 Feb 2001 22:52:16 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010219225216.B32130@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Various people on this list at times have expressed interest in gtkdoc.
I have been trying to find info on it. I can't find much. What I have
is here, because I keep missing people on IRC. And it gets into the
archives here. And I don't know any more than this, so please don't
email me Hard Questions!

Apparently the major problem is that it's a complete sod to install.
If you can't find a nice rpm/deb of it, you're in for pain. Gnome
apparently has its own little something-doc which is a script by
Michael Zucchi and is in CVS. That is what the kernel folks used
as a basis for 'kernel-doc', which is just a script in perl. The
only feature that it is missing which gtkdoc has is something to 
do with classes.

kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
in /linux/scripts. 

On the matter of "how to use the thing once it's installed", it's
the same for kernel-doc and gtk-doc, and so here are the instructions
for kernel-doc on the basis that it might be a quick-start for
gtk-doc: 

----- Forwarded message from Alan Cox <alan@lxorguk.ukuu.org.uk> -----

To: hobbit@aloss.ukuu.org.uk
Subject: Kernel-doc^2
From: Alan Cox <alan@lxorguk.ukuu.org.uk>
Date: Mon, 19 Feb 2001 18:03:42 +0000

Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
so the section on that is relevant and included..


How to add extractable documentation to your source files
---------------------------------------------------------

The format of the block comment is like this:

/**
 * function_name(:)? (- short description)?
(* @parameterx: (description of parameter x)?)*
(* a blank line)?
 * (Description:)? (Description of function)?
 * (section header: (section description)? )*
(*)?*/

The short function description cannot be multiline, but the other
descriptions can be.

All descriptive text is further processed, scanning for the following special
patterns, which are highlighted appropriately.

'funcname()' - function
'$ENVVAR' - environment variable
'&struct_name' - name of a structure (up to two words including 'struct')
'@parameter' - name of a parameter
'%CONST' - name of a constant.

Take a look around the source tree for examples.


Tim.
*/ <twaugh@redhat.com>

----- End forwarded message -----


From otaylor@redhat.com  Mon Feb 19 22:33:06 2001
Return-Path: <otaylor@redhat.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from fresnel.labs.redhat.com (unknown [199.183.24.200])
	by mail.gnome.org (Postfix) with ESMTP id 73CD42CC78
	for <gnome-doc-list@gnome.org>; Mon, 19 Feb 2001 22:33:06 -0500 (EST)
Received: by fresnel.labs.redhat.com (Postfix, from userid 2181)
	id CDFB8241BC6; Mon, 19 Feb 2001 22:33:05 -0500 (EST)
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
References: <20010219225216.B32130@aloss.ukuu.org.uk>
From: Owen Taylor <otaylor@redhat.com>
Date: 19 Feb 2001 22:33:05 -0500
In-Reply-To: Telsa Gwynne's message of "Mon, 19 Feb 2001 22:52:16 +0000"
Message-ID: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Lines: 129
User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Actually, gtk-doc goes a lot beyond simply parsing the 
function doc comments. (And in fact, it didn't originally
do that at all!)

Among other things, it:

 - Knows about the GTK+ object system - object heirarchies,
   signals, properties, etc.

 - Parses header files to find out about typedefs,
   
 - Integrates documentation from template files with
   the parsed header files.

   (This one of the distinguishing characteristics of gtk-doc - 
   it doesn't try to put all documentation inline - just
   the parts that make sense.)

There is a fair bit of information the doc/ directory
of gtk-doc/. Trevor Curtis is apparently also doing some
work on doing GDP-style documentation, though I don't
know how far he's gotten with that.


As far as installation, gtk-doc is wonderously easy to install.  There
is a RPM of it in the RH rawhide tree, though it's a bit out of date,
but it's also just a simple:

 ./configure ; make install

out of CVS. The thing about gtk-doc is:

 - It's a tool for GTK+/GNOME programmers to do docs for other
   programmers, so the docs for gtk-doc assume a lot of 
   knowledge about programming.

 - It's a real pain to set it up to document a library. I mean, a
   major pain.  Hard. Involves creating a number of files with magic
   contents, and then knowing more about make than you ever wanted to
   know.

   I've gone out on a limb and made the statement that the reference
   doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
   are just about perfect. They are also meant to be easy to modify
   without having to change the scary parts.  So, they may be worth
   copying.

   But I wish I knew how we could make it easier to set up.

   More documentation helps, but it there are just too many files to
   juggle, and it shouldn't take 200 lines of Makefile boilerplate.

Once it's been set up. It's not bad to use - you just
either edit the pseudo-sgml files in the tmpl/ directory or
you edit the inline function headers. But the set up is
the killer.

(Perhaps we need to create a gtkdocize script, like libtoolize
and gettextize.)

Regards,
                                        Owen


Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:

> Various people on this list at times have expressed interest in gtkdoc.
> I have been trying to find info on it. I can't find much. What I have
> is here, because I keep missing people on IRC. And it gets into the
> archives here. And I don't know any more than this, so please don't
> email me Hard Questions!
 
> Apparently the major problem is that it's a complete sod to install.
> If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> apparently has its own little something-doc which is a script by
> Michael Zucchi and is in CVS. That is what the kernel folks used
> as a basis for 'kernel-doc', which is just a script in perl. The
> only feature that it is missing which gtkdoc has is something to 
> do with classes.
> 
> kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> in /linux/scripts. 
> 
> On the matter of "how to use the thing once it's installed", it's
> the same for kernel-doc and gtk-doc, and so here are the instructions
> for kernel-doc on the basis that it might be a quick-start for
> gtk-doc: 
> 
> From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> Subject: Kernel-doc^2
> To: hobbit@aloss.ukuu.org.uk
> Date: Mon, 19 Feb 2001 18:03:42 +0000
> 
> 
> Kernel docs on kernel-doc aka much of gtkdoc. Different tools same markup
> so the section on that is relevant and included..
> 
> 
> How to add extractable documentation to your source files
> ---------------------------------------------------------
> 
> The format of the block comment is like this:
> 
> /**
>  * function_name(:)? (- short description)?
> (* @parameterx: (description of parameter x)?)*
> (* a blank line)?
>  * (Description:)? (Description of function)?
>  * (section header: (section description)? )*
> (*)?*/
> 
> The short function description cannot be multiline, but the other
> descriptions can be.
> 
> All descriptive text is further processed, scanning for the following special
> patterns, which are highlighted appropriately.
> 
> 'funcname()' - function
> '$ENVVAR' - environment variable
> '&struct_name' - name of a structure (up to two words including 'struct')
> '@parameter' - name of a parameter
> '%CONST' - name of a constant.
> 
> Take a look around the source tree for examples.
> 
> 
> Tim.
> */ <twaugh@redhat.com>


From rob@funky-penguin.co.uk  Tue Feb 20 06:57:39 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id E5EB72BA99
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 06:57:38 -0500 (EST)
Received: from [213.123.15.171] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14VBQH-00050M-00
	for gnome-doc-list@gnome.org; Tue, 20 Feb 2001 11:57:37 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14VBTG-0001Uu-00
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 12:00:42 +0000
Date: Tue, 20 Feb 2001 12:00:41 +0000
To: gnome-doc-list@gnome.org
Subject: Intent to package Gnotravex, Gnometris, gnobotsII
Message-ID: <20010220120041.A5755@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I regularly play these three so will volunteer to do them. And i'll get an
initial draft of one of these up by this evening.

I'll modify the doctable as soon as soon as i find out my username and
password.

rob
-- 
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet


From trevor.curtis@home.com  Tue Feb 20 13:08:11 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id D10E92BA85
	for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 13:08:10 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010220180742.EWJZ12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Tue, 20 Feb 2001 10:07:42 -0800
Date: Tue, 20 Feb 2001 13:09:35 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010220130935.A1152@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
X-Operating-System: Linux frink.thesimpsons.ca 2.4.1
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hey all,

I joined the gdp a few weeks ago.  When Dan Mueth and I originally
spoke, we had agreed that I was to continue the gtk-doc
manual.  The problem however, was that I had little experience with
things such as cvs, autoconf, automake, and the like.  So I've
temporarily put the gtk-doc manual on hold, whilst I learn the above
by doing other smaller projects.

All this to say that this lack of documentation for gtk-doc is an
issue that is trying to be addressed.  Unfortunately, until I learn
more about the subject, and the other bits of knowledge that I must
aquire to complete this job, it may be some time before I'm able to
complete the manual.

If anyone has ideas or just wants to look at was is already there, it
is available in cvs.  

regards,

On Mon, Feb 19, 2001 at 10:33:05PM -0500, Owen Taylor wrote:
> To: gnome-doc-list@gnome.org
> Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
> From: Owen Taylor <otaylor@redhat.com>
> Date: 19 Feb 2001 22:33:05 -0500
> 
> 
> Actually, gtk-doc goes a lot beyond simply parsing the 
> function doc comments. (And in fact, it didn't originally
> do that at all!)
> 
> Among other things, it:
> 
>  - Knows about the GTK+ object system - object heirarchies,
>    signals, properties, etc.
> 
>  - Parses header files to find out about typedefs,
>    
>  - Integrates documentation from template files with
>    the parsed header files.
> 
>    (This one of the distinguishing characteristics of gtk-doc - 
>    it doesn't try to put all documentation inline - just
>    the parts that make sense.)
> 
> There is a fair bit of information the doc/ directory
> of gtk-doc/. Trevor Curtis is apparently also doing some
> work on doing GDP-style documentation, though I don't
> know how far he's gotten with that.
> 
> 
> As far as installation, gtk-doc is wonderously easy to install.  There
> is a RPM of it in the RH rawhide tree, though it's a bit out of date,
> but it's also just a simple:
> 
>  ./configure ; make install
> 
> out of CVS. The thing about gtk-doc is:
> 
>  - It's a tool for GTK+/GNOME programmers to do docs for other
>    programmers, so the docs for gtk-doc assume a lot of 
>    knowledge about programming.
> 
>  - It's a real pain to set it up to document a library. I mean, a
>    major pain.  Hard. Involves creating a number of files with magic
>    contents, and then knowing more about make than you ever wanted to
>    know.
> 
>    I've gone out on a limb and made the statement that the reference
>    doc makefiles in the HEAD of GTK+ (docs/reference/gtk/Makefile.am, etc)
>    are just about perfect. They are also meant to be easy to modify
>    without having to change the scary parts.  So, they may be worth
>    copying.
> 
>    But I wish I knew how we could make it easier to set up.
> 
>    More documentation helps, but it there are just too many files to
>    juggle, and it shouldn't take 200 lines of Makefile boilerplate.
> 
> Once it's been set up. It's not bad to use - you just
> either edit the pseudo-sgml files in the tmpl/ directory or
> you edit the inline function headers. But the set up is
> the killer.
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)
> 
> Regards,
>                                         Owen
> 
> 
> Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:
> 
> > Various people on this list at times have expressed interest in gtkdoc.
> > I have been trying to find info on it. I can't find much. What I have
> > is here, because I keep missing people on IRC. And it gets into the
> > archives here. And I don't know any more than this, so please don't
> > email me Hard Questions!
>  
> > Apparently the major problem is that it's a complete sod to install.
> > If you can't find a nice rpm/deb of it, you're in for pain. Gnome
> > apparently has its own little something-doc which is a script by
> > Michael Zucchi and is in CVS. That is what the kernel folks used
> > as a basis for 'kernel-doc', which is just a script in perl. The
> > only feature that it is missing which gtkdoc has is something to 
> > do with classes.
> > 
> > kernel-doc is apparently found in 2.4 (and 2.3 :)) linux kernels
> > in /linux/scripts. 
> > 
> > On the matter of "how to use the thing once it's installed", it's
> > the same for kernel-doc and gtk-doc, and so here are the instructions
> > for kernel-doc on the basis that it might be a quick-start for
> > gtk-doc: 
> > 
> > From: Alan Cox <alan@lxorguk.ukuu.org.uk>
> > Subject: Kernel-do


From glynn.foster@Sun.COM  Wed Feb 21 11:58:29 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from patan.sun.com (patan.Sun.COM [192.18.98.43])
	by mail.gnome.org (Postfix) with ESMTP id D02252E0B0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 11:58:28 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by patan.sun.com (8.9.3+Sun/8.9.3) with ESMTP id IAA11518
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 08:58:27 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id QAA09744
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 16:58:23 GMT
Message-ID: <3A93F3E0.C56F6F45@Sun.COM>
Date: Wed, 21 Feb 2001 16:59:12 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Subject: Session capplet documentation
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Heya,
Just recently I was working on a multisession hack for gnome-session
which is pretty much finished and in for the GNOME1.4 release. The 
hack involved changing the capplet code and, as a result, the structure 
of the 'Startup Programs' gui.
I was checking through the documentation for the control-center and 
realised that some of it needs to be rewritten for 1.4 [different 
screenshots, added functionality]
I think I identified it to the following cvs module -

		desktop-docs/gnomecc.sgml

I would be quite happy to document some of the changes but being a 
mere insignificant software developer I thought I'd ask first and
find out the proccess for this.

			Thanks,
				Glynn ;)


-- 
Glynn Foster				Email: glynn.foster@ireland.sun.com
Desktop Apps & MiddleWare		Tel:   +353 - 1 - 8199782
Sun Microsystems Ireland Ltd.           Generation dot-COM        i||c Gman


From dusk@ravendusk.org  Wed Feb 21 13:29:00 2001
Return-Path: <dusk@ravendusk.org>
Delivered-To: gnome-doc-list@gnome.org
Received: from newton.pconline.com (newton.pconline.com [206.145.48.1])
	by mail.gnome.org (Postfix) with ESMTP id B14222E211
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 13:28:59 -0500 (EST)
Received: from exodus.ravendusk.org (m18-6-16.pconline.com [207.191.143.96])
	by newton.pconline.com (8.8.5/8.8.5) with ESMTP id MAA25803
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:28:56 -0600
Received: from jsheets by exodus.ravendusk.org with local (Exim 3.20 #1 (Debian))
	id 14Ve1A-0000Mo-00
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 12:29:36 -0600
Date: Wed, 21 Feb 2001 12:29:36 -0600
From: "John R. Sheets" <dusk@ravendusk.org>
To: gnome-doc-list@gnome.org
Subject: Re: Fwd: Kernel-doc^2 (gtkdoc)
Message-ID: <20010221122936.D475@ravendusk.org>
Mail-Followup-To: "John R. Sheets" <dusk@ravendusk.org>,
	gnome-doc-list@gnome.org
References: <20010219225216.B32130@aloss.ukuu.org.uk> <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
In-Reply-To: <ybe66i6f2q6.fsf@fresnel.labs.redhat.com>; from otaylor@redhat.com on Mon, Feb 19, 2001 at 10:33:05PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Feb 19, 2001, Owen Taylor <otaylor@redhat.com> wrote:
> 
> (Perhaps we need to create a gtkdocize script, like libtoolize
> and gettextize.)

Oooh, I like the sound of that.  Wonder how much of the setup is
automatable...?

John

-- 
dusk@ravendusk.org                            http://www.gnome.org
jsheets@codeweavers.com                  http://www.worldforge.org
jsheets@users.sourceforge.net     http://openbooks.sourceforge.net
               http://advogato.org/person/jsheets

                   Writing Gnome Applications
          http://www.aw.com/cseng/titles/0-201-65791-0/


From kirillov@math.sunysb.edu  Wed Feb 21 14:11:08 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id 812AD2E0F0
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:08 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id OAA01184
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:11:07 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id OAA05760;
	Wed, 21 Feb 2001 14:11:07 -0500
Date: Wed, 21 Feb 2001 14:11:07 -0500
Message-Id: <200102211911.OAA05760@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi,
I am currently maintaining the documentation for control-center
(btw, it is located at
control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Probably the easiest way would be if you just send me the patch to the
existing file, and I'll check it into CVS. Or you can send me the list
of changes and I'll modify the doc myself - whatever you prefer.

Is this new functionality in gnome-14.beta1? If so, I can take the
screenshots myself (I plan to install beta1 later today).

Best,
Sasha

On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> Heya,
> Just recently I was working on a multisession hack for gnome-session
> which is pretty much finished and in for the GNOME1.4 release. The 
> hack involved changing the capplet code and, as a result, the structure 
> of the 'Startup Programs' gui.
> I was checking through the documentation for the control-center and 
> realised that some of it needs to be rewritten for 1.4 [different 
> screenshots, added functionality]
> I think I identified it to the following cvs module -
> 
>               desktop-docs/gnomecc.sgml
> 
> I would be quite happy to document some of the changes but being a 
> mere insignificant software developer I thought I'd ask first and
> find out the proccess for this.
> 
>                       Thanks,
>                               Glynn ;)
> 


From glynn.foster@Sun.COM  Wed Feb 21 14:29:42 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id D693F2BB47
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 14:29:41 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id LAA02853;
	Wed, 21 Feb 2001 11:29:39 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id TAA01032;
	Wed, 21 Feb 2001 19:29:27 GMT
Message-ID: <3A941749.21CC4F81@Sun.COM>
Date: Wed, 21 Feb 2001 19:30:17 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org
Subject: Re: Session capplet documentation
References: <200102211911.OAA05760@copiague.math.sunysb.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

[Apologies if you are receiving this more than once...must have 
screwed up sending it the first time :/ ]


Heya Sasha,

> Hi,
> I am currently maintaining the documentation for control-center
> (btw, it is located at
> control-center/doc/C/gnomecc.sgml, branch control-center-1-0)

Yeah, that was pointed out to me this afternoon...for some reason
the documentation hasn't been transferred over to HEAD yet.

> Probably the easiest way would be if you just send me the patch to the
> existing file, and I'll check it into CVS. Or you can send me the list
> of changes and I'll modify the doc myself - whatever you prefer.

I'm easy about this...What might be the best solution, is for me to send
over a patch to the existing file and you can edit it as you see fit.
I'm no documentation wizard ;)

> Is this new functionality in gnome-14.beta1? If so, I can take the
> screenshots myself (I plan to install beta1 later today).

Yes this is new functionality in beta1.
I've taken screenshots already :) but you can take your own if you wish...
The ones I've taken are at
http://www.geocities.com/gmansundude/gccsessopt.png
http://www.geocities.com/gmansundude/gccstartup.png

[but I'm actually not sure of the quality - just looking at them a minute
ago].

I'll get the patches done pretty soon.
                
                Many thanks,
                        Glynn ;)

> 
> Best,
> Sasha
> 
> On Wed, Feb 21, 2001 at 04:59:12PM +0000, Glynn Foster wrote:
> > Heya,
> > Just recently I was working on a multisession hack for gnome-session
> > which is pretty much finished and in for the GNOME1.4 release. The
> > hack involved changing the capplet code and, as a result, the structure
> > of the 'Startup Programs' gui.
> > I was checking through the documentation for the control-center and
> > realised that some of it needs to be rewritten for 1.4 [different
> > screenshots, added functionality]
> > I think I identified it to the following cvs module -
> >
> >               desktop-docs/gnomecc.sgml
> >
> > I would be quite happy to document some of the changes but being a
> > mere insignificant software developer I thought I'd ask first and
> > find out the proccess for this.
> >
> >                       Thanks,
> >                               Glynn ;)
> >


From kirillov@math.sunysb.edu  Wed Feb 21 15:57:20 2001
Return-Path: <kirillov@math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id E5F202BB41
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:19 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id PAA02713
	for <gnome-doc-list@gnome.org>; Wed, 21 Feb 2001 15:57:18 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id PAA13250;
	Wed, 21 Feb 2001 15:57:18 -0500
Date: Wed, 21 Feb 2001 15:57:18 -0500
Message-Id: <200102212057.PAA13250@copiague.math.sunysb.edu>
X-Authentication-Warning: copiague.math.sunysb.edu: kirillov set sender to kirillov@math.sunysb.edu using -f
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: gnome-doc-list@gnome.org
Subject: scrollkeeper and gnome 1.4
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi guys:

I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
surprise, no OMF files were installed at all: /usr/share/omf contains
scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
wrong with the packages - could you (or someone else) look into this? 

Sasha


From dan@eazel.com  Thu Feb 22 06:34:00 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id EDD532BA83
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:33:59 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBXJ822189;
	Thu, 22 Feb 2001 03:33:19 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:33:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Alexander Kirillov <kirillov@math.sunysb.edu>
Cc: gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
Subject: Re: scrollkeeper and gnome 1.4
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>
Message-ID: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, 21 Feb 2001, Alexander Kirillov wrote:

> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 

This doesn't entirely surprise me.  We were working on getting this done
right around the package deadline for GNOME 1.4 beta1, so I suspect the
packages were submitted before we added the OMF metadata.  I have spoken
with Jacob, who does a lot of the packaging work at Ximian, about how the
OMF and ScrollKeeper integration works, so he knows how to make things
work.  I even gave him my spec file for gnome-core (which I originally
took from him and then modified).  So, my guess is we just missed the
deadline for when they took their beta1 snapshot.  I expect things to work
for beta2, although it is a good idea to double-check this.

Jacob - could you comment?

Dan



From dan@eazel.com  Thu Feb 22 06:49:01 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 32B6D2E032
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 06:49:00 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1MBmxQ22325
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 03:48:59 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Thu, 22 Feb 2001 03:48:59 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: gnome-doc-list@gnome.org
Subject: Finished docs
Message-ID: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everybody,

Since we are approaching the GNOME 1.4 release, I have decided to start
producing a weekly list of documents which are completely Done(TM) to send
to the translators for translation.  

By Done, I mean:

0) It is decent. ie. It is worth translating.  Basically this means it is
not obsolete or mostly filled with FIXME's.

1) It is finished, as far as GNOME 1.4 is concerned.  ie. It may not be
perfect or even complete, but it will not experience any more changes
before GNOME 1.4 except for major bug fixes. (eg. it states something
which is false or doesn't render properly in Nautilus)

2) It follows the 1.4 doc
guidelines: http://developer.gnome.org/projects/gdp/changes/

3) It has gone through a simple test in Nautilus to make sure each page
renders properly.

4) The screenshots are finished, or at least won't change much

5) Hopefully it actually builds and installs fine with the package it
belongs too.

#0 through #2 are crucial.  If possible, satisfy #3 through #5 too.  If
you need help testing it in Nautilus, email this list or ask around on
#docs to find somebody with a working Nautilus.

Please email me with a list of documents which you feel are Done(TM) each
Thursday, and I'll compile the list and send it to gnome-i18n-list each
Friday so that the translators can have a fun-filled weekend of
translations each week :)

Dan



From glynn.foster@Sun.COM  Thu Feb 22 08:44:34 2001
Return-Path: <glynn.foster@Sun.COM>
Delivered-To: gnome-doc-list@gnome.org
Received: from mercury.Sun.COM (mercury.Sun.COM [192.9.25.1])
	by mail.gnome.org (Postfix) with ESMTP id 2B13E2CC04
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:44:34 -0500 (EST)
Received: from ireserver.Ireland.Sun.COM ([129.156.220.7])
	by mercury.Sun.COM (8.9.3+Sun/8.9.3) with ESMTP id FAA00862;
	Thu, 22 Feb 2001 05:44:29 -0800 (PST)
Received: from Sun.COM (plat [129.156.238.87])
	by ireserver.Ireland.Sun.COM (8.8.8+Sun/8.8.8/ENSMAIL,v2.1p1) with ESMTP id NAA12515;
	Thu, 22 Feb 2001 13:44:24 GMT
Message-ID: <3A9517EB.FB6CCA0A@Sun.COM>
Date: Thu, 22 Feb 2001 13:45:15 +0000
From: Glynn Foster <glynn.foster@Sun.COM>
Organization: Sun Microsystems
X-Mailer: Mozilla 4.75 [en] (X11; U; SunOS 5.8 sun4u)
X-Accept-Language: en
MIME-Version: 1.0
To: kirillov@math.sunysb.edu, gnome-doc-list@gnome.org
Subject: Session capplet doc diff
Content-Type: multipart/mixed;
 boundary="------------1CCC036EA35DA3B43F0F89A4"
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

This is a multi-part message in MIME format.
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Hi Sasha,
Here is the diff for control-center/docs/C/gnomecc.sgml Hope this is okay..
I'm cc'ing gnome-doc-list in case anyone has any feedback...
I've included the extra figures [from the links on my previous email] but
if you want to take better screenshots, feel free.

			Glynn :)
--------------1CCC036EA35DA3B43F0F89A4
Content-Type: text/plain; charset=us-ascii;
 name="sessiondoc.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="sessiondoc.diff"

Index: gnomecc.sgml
===================================================================
RCS file: /cvs/gnome/control-center/doc/C/Attic/gnomecc.sgml,v
retrieving revision 1.1.2.5
diff -u -r1.1.2.5 gnomecc.sgml
--- gnomecc.sgml	2001/02/12 17:00:25	1.1.2.5
+++ gnomecc.sgml	2001/02/22 13:39:38
@@ -884,8 +884,8 @@
       <title>Session</title>
     <para>
       The Session Group provides you methods of controlling various items that
-      occur with the startup of your GNOME Session. These include startup
-      programs and startup hints.
+      occur with the startup of your GNOME Session. These include session options,
+      startup programs and startup hints.
     </para>
     <sect2 id="startup-hints">
       <title>Startup Hints</title>
@@ -927,40 +927,36 @@
       </figure>
     </sect2>
     <sect2 id="startup-progs">
-      <title>Startup Programs</title>
+      <title>Session Options & Startup Programs</title>
       <para>
-	Startup Programs capplet allows you control what applications
-	are started at login. By default, GNOME
-	starts some default programs, such as File Manager (necessary
-	for functioning of the desktop), Panel and all applets in it,
-	and some other supporting programs. But it can do more than
-	that. 
+        The Session Options & Startup Programs capplet allows you to
+        control your session. GNOME has the concept of session 
+        management. In simple terms, it means that you can save your
+        <quote>session</quote> (that is, information about currently
+        working applications, their status and position on the screen)
+        at any stage, and at your next login the same applications will
+        reappear on your screen in the same positions, allowing you to 
+        continue your work. Note, however, this only works for GNOME 
+        compliant applications. By default, GNOME starts some default
+        programs, such as File Manager (necessary for functioning of
+        the desktop), Panel and all applets in it, and some other 
+        supporting programs. But it can do much more than that.
       </para>
       <para> 
-	First, GNOME has the concept of session management. In simple
-	terms, it means that you can save your <quote>session</quote>
-	(that is, information about currently working applications,
-	their status and position on screen) at logout and at your next
-	login the same applications will reappear on your screen in
-	the same positions, allowing you to continue your
-	work. Note, however, that this  only works for GNOME
-	applications. 
-      </para>
-      <para> 
 	GNOME also provides another way of starting applications at
-	login. You can explicitly specify one or more  commands to
+	login. You can explicitly specify one or more commands to
 	run, and GNOME will execute them at login. This works for all
-	kinds of applications, whether GNOME compatible or not.  
+	kinds of applications, whether GNOME compliant or not.  
       </para>
       <para> 
-	Startup Programs capplet allows you to configure all of these
-	options, as described below. 
+	Session Options & Startup Programs capplet allows you to configure 
+	all of these options, as described below. 
       </para>
       <figure>
-	<title>Startup Programs Capplet</title>
+	<title>Session Options Capplet</title>
 	<screenshot>
-	  <screeninfo>Startup Programs Capplet</screeninfo>
-	  <graphic format="png" fileref="./figs/gccstartup" srccredit="dcm">
+	  <screeninfo>Session Options Capplet</screeninfo>
+	  <graphic format="png" fileref="./figs/gccsessopt" srccredit="gman">
 	  </graphic>
 	</screenshot>
       </figure>
@@ -979,13 +975,13 @@
 	    <guilabel>Prompt on logout</guilabel> &mdash; If this
 	    option is enabled, a confirmation dialog will appear at
 	    logout. Among other things, this dialog asks you if you
-	    want to save the current session. If you answer
-	    <guilabel>Yes</guilabel>, the current session will be
-	    saved and will be restored at your next login. If you
+	    want to save the current session if you have set the 
+            checkbox for <guilabel> Automatically save session</guilabel>.
+            If you answer <guilabel>Yes</guilabel>, the current session 
+	    will be saved and will be restored at your next login. If you
 	    answer <guilabel>No</guilabel>, the previous saved session
 	    will be used.  
 	  </para> 
-
 	</listitem>
 
 	<listitem>
@@ -1003,6 +999,42 @@
 	    </menuchoice> from the <guimenu>Main Menu</guimenu>. 
 	  </para>
 	</listitem>
+        
+        <listitem>
+          <para>
+            <guilabel>Choose Current Session</guilabel> &mdash;
+             In this section, you can explicitly specify which session
+             to save to, but a save won't occur until you specifically
+             do so. Here, you can also create new sessions, edit and 
+             delete existing sessions. 
+          </para>
+          <para> 
+            To add a new session, press the <guibutton>Add</guibutton> 
+            button and enter in a new session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To edit an existing session name, highlight the session
+            name you wish to edit, press the <guibutton>Edit</guibutton> button
+            and edit the existing session name. This name must be unique
+            among the other sessions.
+          </para>
+          <para> 
+            To delete an existing session name, highlight the session
+            name you wish to delete, press the <guibutton>Delete</guibutton>
+            button.
+          </para>
+        </listitem>  
+        </itemizedlist>
+        <figure>
+ 	  <title>Startup Programs Capplet</title>
+	  <screenshot>
+	    <screeninfo>Startup Programs Capplet</screeninfo>
+	    <graphic format="png" fileref="./figs/gccstartup" srccredit="gman">
+	    </graphic>
+	  </screenshot>
+        </figure>
+      <itemizedlist mark="opencircle">
 	<listitem>
 	  <para>
 	    <guilabel>Non-session managed startup programs</guilabel> &mdash; 
@@ -1406,4 +1438,4 @@
  </sect1>
 
 
-  </article>
\ No newline at end of file
+  </article>

--------------1CCC036EA35DA3B43F0F89A4--



From jfleck@swcp.com  Thu Feb 22 08:50:41 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 879032D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:50:40 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00779
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:49:16 -0700
Date: Thu, 22 Feb 2001 06:49:16 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: scrollkeeper and gnome 1.4
Message-ID: <20010222064916.A770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <200102212057.PAA13250@copiague.math.sunysb.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <200102212057.PAA13250@copiague.math.sunysb.edu>; from Alexander Kirillov on Wed, Feb 21, 2001 at 03:57:18PM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 03:57:18PM -0500, Alexander Kirillov wrote:
> 
> Hi guys:
> 
> I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> surprise, no OMF files were installed at all: /usr/share/omf contains
> scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> wrong with the packages - could you (or someone else) look into this? 
> 

I know the omf installation was not in place in the gnome-utils
package in time for the first beta. It's done in cvs now.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jfleck@swcp.com  Thu Feb 22 08:58:49 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id B13B32D167
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 08:58:48 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id GAA00797
	for gnome-doc-list@gnome.org; Thu, 22 Feb 2001 06:57:24 -0700
Date: Thu, 22 Feb 2001 06:57:24 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Finished docs
Message-ID: <20010222065724.B770@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <Pine.LNX.4.21.0102220334090.22133-100000@foodle.eazel.com>; from Dan Mueth on Thu, Feb 22, 2001 at 03:48:59AM -0800
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Thu, Feb 22, 2001 at 03:48:59AM -0800, Dan Mueth wrote:
> 
> Since we are approaching the GNOME 1.4 release, I have decided to start
> producing a weekly list of documents which are completely Done(TM) to send
> to the translators for translation.  
> 

Could you include with the list the name and email of the relevant
package coordinators? We need to make sure we know when translations
go in, so we can add in the appropriate omf files and add them to the
build system.

Cheers,
-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From jacob@ximian.com  Thu Feb 22 12:43:25 2001
Return-Path: <jacob@ximian.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from ulysses (unknown [208.4.24.67])
	by mail.gnome.org (Postfix) with ESMTP id C55182DB91
	for <gnome-doc-list@gnome.org>; Thu, 22 Feb 2001 12:43:25 -0500 (EST)
Received: from jacob by ulysses with local (Exim 3.22 #1 (Debian))
	id 14Vzee-0000N7-00; Thu, 22 Feb 2001 12:35:48 -0500
Subject: Re: scrollkeeper and gnome 1.4
From: jacob berkman <jacob@ximian.com>
To: Dan Mueth <dan@eazel.com>
Cc: Alexander Kirillov <kirillov@math.sunysb.edu>,
	gnome-doc-list@gnome.org, Jacob Berkman <jacob@helixcode.com>
In-Reply-To: <Pine.LNX.4.21.0102220329040.22133-100000@foodle.eazel.com>
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 12:35:47 -0500
Mime-Version: 1.0
Message-Id: <E14Vzee-0000N7-00@ulysses>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 22 Feb 2001 03:33:19 -0800, Dan Mueth wrote:
> 
> On Wed, 21 Feb 2001, Alexander Kirillov wrote:
> 
> > 
> > Hi guys:
> > 
> > I just installed gnome-1.4.beta1 (from Ximian rpms for RH6) and to my
> > surprise, no OMF files were installed at all: /usr/share/omf contains
> > scrollkeeper-C.omf and *empty* subdir gnome-user-docs. Dan: something is
> > wrong with the packages - could you (or someone else) look into this? 
> 
> This doesn't entirely surprise me.  We were working on getting this done
> right around the package deadline for GNOME 1.4 beta1, so I suspect the
> packages were submitted before we added the OMF metadata.



> I have spoken with Jacob, who does a lot of the packaging work at Ximian

actually i don't do packaging stuff anymore :)

> work.  I even gave him my spec file for gnome-core (which I originally
> took from him and then modified).  So, my guess is we just missed the
> deadline for when they took their beta1 snapshot.  I expect things to work
> for beta2, although it is a good idea to double-check this.

yeah, the plan is to have it working by beta2.  the scrollkeeper tarball
was no good, and nothing used it, and the distro guys were on a tight
deadline anyway.

jacob
-- 
"The people who made the Macintosh produced a miracle, but that
 doesn't mean their code was wonderful." -- Bob Cringely


From gleblanc@cu-portland.edu  Fri Feb 23 00:28:32 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id 85EAB2E5A8; Fri, 23 Feb 2001 00:27:59 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1N5RxQ09400;
	Thu, 22 Feb 2001 21:27:59 -0800
Message-Id: <200102230527.f1N5RxQ09400@mail2.aracnet.com>
Subject: GDP Release Committee Minutes
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 22 Feb 2001 21:26:22 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 18, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Kenny Graunke
Laszlo Kovacs
John Fleck
Alexander Kirillov (arrived 1:18) (departed 1:53)
Ali Abdin (arrived 1:45)

Absent:
-------


Regrets:
--------


Decisions:
----------

- Meeting time agreed to be at 1:00PM PT (9:00PM UTC) on Sunday for
  GDP Release Committee meetings.

- Gregory Leblanc will serve as secretary at meetings

- User's Manuals for applications should be kept in the
  '<application>/help/<locale>/*' sub-directory in CVS, and figures,
  screen shots, and other graphics should go into
  '<application>/help/<locale>/figures'.

- Maintainers assigned for coordinating documentation in various
  modules for the GNOME 1.4 release.  This involves maintaining an
  idea of what the status of a particular module's documentation is
  in, and being a liaison between the docs writers and the application
  hackers.

  - ggv -- John Fleck
  - gnome-applets -- Telsa Gwynne
  - gnome-core -- Dan Mueth
  - gnome-utils -- John Fleck
  - gnome-games -- Gregory Leblanc
  - nautilus -- Dan Mueth
  - ghex -- John Fleck
  - control-center -- Alexander Kirillov
  - bug-buddy -- Telsa Gwynne
  - dia -- Kevin Breit

- Future GDP Release Committee meetings will be open to all GNOME
  members.  This meeting was held without general publication to
  ensure that we could schedule a time for regular meetings, and to
  ensure that the meeting was as effective per time spent as
  possible.  Kevin Breit will be coordinating the Quality Assurance
  efforts for the GDP durring the GNOME 1.4 timeframe.

Work Done:
----------
Since this is our first meeting, we haven't finished any work since
the last meeting.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth -- put HACKING files into gnome-user-docs and
  gnome-devel-docs, and to inform gnome-hackers about the new modules
  and refer them to the HACKING files for further information.

- TODO: Alexander Kirillov -- gather a list of documentation that is
needs to
  be moved into gnome-user-docs, and to email this to Gregory Leblanc
  <gleblanc@cu-portland.edu>
- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Telsa Gwynne -- create a gnome-user-docs product in bugzilla.
  Alexander Kirillov and Telsa Gwynne would like to work on these
  docs, but has more to do than she can handle already, so this will
  wait for now.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.

- INFORMATION: John and Ali reported on the status of gnome-db2html2.
  gnome-db2html2 is mostly solid, with only a few minor known-bugs
  left.  Indexing support isn't included yet, and there is not enough
  time to get it added before 1.4.  Strings have been marked for
  translation, so navigation should appear in the user's specified
  language.  Ali would like to have the navigation links that are
  generated match the locale of the doc, rather than the locale that
  the user has set, but this isn't written yet.  The status of
  Japanese in gnome-db2html2 is -unknown-.

- TODO: John Fleck and Dan Mueth -- test i18n in gnome-db2html2

- TODO: Dan Mueth -- follow up on the bugs with HTML Help in Nautilus.
  Bugs #4302,* #5945, and#6761 in the Nautilus bug system.

- TODO: Dan Mueth -- have Jacob Berkman patch gnome-libs to make
  nautilus the default help browser.

- TODO: Ask Arik to do the "font stuff" for the help sidebar in
  nautilus.

- TODO: Dan Mueth -- enable ScrollKeeper for the help sidebar in the
  default build of Nautilus, including hourly RPMs.

- TODO: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- TODO: Kevin Breit -- develop test assertions, and document
  this procedure so that it can be applied for GNOME 1.4

- TODO: Kevin Breit -- divide docs into groups for QA volunteers to
  sign up for.

- TODO: Laszlo Kovacs-- repair locale fallback for ScrollKeeper in time
for
  GNOME 1.4.  

- INFORMATION: Scrollkeeper will need to be installed on end user
  machines to make the help sidebar in nautilus work properly.  People
  who build packages including OMF metadata should install
  ScrollKeeper so that the document metadata is included in the
  package.  ScrollKeeper can be obtained from:
  http://sourceforge.net/project/showfiles.php?group_id=11543&release_id=24049

- TODO: All Package Coordinators -- gather a list of docs that have
  been completed recently, and are now "frozen".  Mail this list to
  Dan Mueth on Thursday, and he'll collect it and post it to the
  gnome-i18n mailing list.  This is a weekly -recurring- task.

- TODO: Telsa Gwynne -- talk to the i18n team and get feedback on what
  the GDP can do to make translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)


Agenda Items Left For Next Meeting:
-----------------------------------

- User's Guide to be left until the next meeting.  Please review the
  mail by Dan, and prepare for the test at the next meeting.  :)

- Review the list of unfinished documents.

- Discuss use of Bugzilla for the GDP further.

Agenda:
-------
1) Set time for next meeting
2) Minutes
3) Discuss status of gnome-user-docs
4) Discuss gnome-developer-docs and developer FAQ
5) Discuss GNOME Users Guide
6) Review which packages do not have doc maintainers for the GNOME 1.4
release
7) Discuss status of gnome-db2html2
8) Review status of converting docs to work with Nautilus
9) Review status of OMF/ScrollKeeper
10) Review QA plan
11) Review list of unfinished documents
12) Plan for freezing docs and passing them to translators (Release a
weekly list of docs which are frozen and ready for translations?  Stage
docs so each week we completely review and freeze some docs.)
13) Opening up meetings (I don't want the meetings to seem exclusive,
although it makes scheduling a heck of a lot easier if you have a finite
number of people, and the meetings are a lot more efficient. Let's
discuss
having these be open meetings though after we get a schedule locked
down.)






From rob@funky-penguin.co.uk  Fri Feb 23 05:22:13 2001
Return-Path: <rob@funky-penguin.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from rhenium (rhenium.btinternet.com [194.73.73.93])
	by mail.gnome.org (Postfix) with ESMTP id 245102DD1E
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:22:13 -0500 (EST)
Received: from [213.122.189.46] (helo=zeus.olympus)
	by rhenium with esmtp (Exim 3.03 #83)
	id 14WFMX-0007Bf-00
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 10:22:11 +0000
Received: from rob by zeus.olympus with local (Exim 3.22 #1 (Debian))
	id 14WFPh-0001QO-00
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:25:25 +0000
Date: Fri, 23 Feb 2001 10:25:12 +0000
To: gnome-doc-list@gnome.org
Subject: Unable to render sgml to html on Debian
Message-ID: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="gKMricLos+KVdGMg"
Content-Disposition: inline
User-Agent: Mutt/1.3.12i
From: Rob Bradford <rob@funky-penguin.co.uk>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

--gKMricLos+KVdGMg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

I did used to have this working a long time ago but i moved boxes and now
when i come back to work on it doesnt seem to work.

I downloaded and installed gnome-doc-tools and everything it depeneded on
(cygnus-stylesheets etc).

When i try to db2html a file i know works i just get the file outputed to
stdout rendered as plain text.

Before lots of errors on almost every tag the following it outputted:

input file was called gnome-stones.005.sgml -- output will be in
gnome-stones.005

working on ../gnome-stones.005.sgml
jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"
jade:../gnome-stones.005.sgml:4:0:E: reference to entity "ARTICLE" for which
no system identifier could be generated
jade:../gnome-stones.005.sgml:1:0: entity was defined here
jade:../gnome-stones.005.sgml:4:0:E: DTD did not contain element declaration
for document type name


I think this could be a DTD error but i'm really not sure what to do now.

Any advice on what to do would be greatly appreciated.

rob
--=20
Rob 'robster' Bradford
rob@debianplanet.org

Founder/Lead Developer: Debian Planet

--gKMricLos+KVdGMg
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.4 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD8DBQE6ljqICw8pKd+B7oMRAle6AJ0dl9TmIjMDMlf0AXJiv0q/D5w2iQCdEtrw
sdC62cmPwhiJb/8gP6TUep4=
=ZPbk
-----END PGP SIGNATURE-----

--gKMricLos+KVdGMg--


From jules@blueberry.jellybean.co.uk  Fri Feb 23 05:43:53 2001
Return-Path: <jules@blueberry.jellybean.co.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from blueberry.jellybean.co.uk (blueberry.jellybean.co.uk [194.88.75.31])
	by mail.gnome.org (Postfix) with ESMTP id E273E2DD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 05:43:52 -0500 (EST)
Received: from jules by blueberry.jellybean.co.uk with local (Exim 3.16 #1 (Debian))
	id 14WFhO-0003OP-00; Fri, 23 Feb 2001 10:43:42 +0000
Date: Fri, 23 Feb 2001 10:43:42 +0000
From: Jules Bean <jules@jellybean.co.uk>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223104341.B12325@blueberry.jellybean.co.uk>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
> 
> I downloaded and installed gnome-doc-tools and everything it depeneded on
> (cygnus-stylesheets etc).

Which version of gnome-doc-tools?

I'm about to try using eliot landrum's latest debian packages of
gnome-doc-tools, and if it works, upload it into debian. (I need it to 
build the docs of the balsa package, which I maintain).

Jules


From aliabdin@aucegypt.edu  Fri Feb 23 06:16:27 2001
Return-Path: <aliabdin@aucegypt.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from jerry.aucegypt.edu (jerry.aucegypt.edu [208.159.7.6])
	by mail.gnome.org (Postfix) with ESMTP id 695BB2CE41
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 06:16:27 -0500 (EST)
Received: from localhost.localdomain ([217.52.7.140])
 by auc.AUCEGYPT.EDU (PMDF V5.2-31 #41700)
 with ESMTP id <01K0G8WO5SKG9GVA8P@auc.AUCEGYPT.EDU> for
 gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:19:17 EGYPT
Received: by localhost.localdomain (Postfix, from userid 500)
	id 7DF7756FD; Wed, 21 Feb 2001 23:01:25 +0200 (EET)
Date: Wed, 21 Feb 2001 23:01:25 +0200
From: Ali Abdin <aliabdin@aucegypt.edu>
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
In-reply-to: <01021815165800.10931@7of9>
To: battery841@mediaone.net
Cc: gnome-doc-list@gnome.org
Message-id: <20010221210125.7DF7756FD@localhost.localdomain>
MIME-version: 1.0
X-Mailer: Evolution (0.8 - Preview Release)
Content-type: text/plain
References: <20010215172159.A11517@math.sunysb.edu>
 <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com>
 <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9>
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On 18 Feb 2001 15:16:58 -0600, Kevin Breit wrote:
> On Sunday 18 February 2001 02:27 pm, NBC said you wrote:
> > Is there any interest in having any of the user or developer docs
> > recorded? I'm thinking audio books, or even inserting <audioobject> and
> > <audiodata> tags into the docs themselves.
> >
> > All I will need is someone with a good voice to volunteer. (I have a small
> > studio setup near Chicago.)
> That'd be interesting.  It would be best to have it in mp3 format.  If you 
> wanted, and we got this rolling soon enough, I could do some voice stuff 
> since I live in the Chicago burbs.


No it wouldn't. It would be best to have it in ogg format!!!! :)

I don't think it is worth doing until we have a nice way of actually
playing these files ;)

Perhaps somebody should talk with Sun about this since they are doing
some GNOME Accessibility work

Regards,
Ali


From kirillov@peconic.math.sunysb.edu  Fri Feb 23 10:51:42 2001
Return-Path: <kirillov@peconic.math.sunysb.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from peconic.math.sunysb.edu (mail.math.sunysb.edu [129.49.18.67])
	by mail.gnome.org (Postfix) with ESMTP id DC0DB2E516
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 10:51:41 -0500 (EST)
Received: from copiague.math.sunysb.edu (IDENT:root@copiague [129.49.18.192])
	by peconic.math.sunysb.edu (8.9.3/8.9.3) with ESMTP id KAA21411;
	Fri, 23 Feb 2001 10:51:37 -0500 (EST)
Received: (from kirillov@localhost)
	by copiague.math.sunysb.edu (8.9.3/8.9.3) id KAA21208;
	Fri, 23 Feb 2001 10:51:37 -0500
Date: Fri, 23 Feb 2001 10:51:37 -0500
From: Alexander Kirillov <kirillov@math.sunysb.edu>
To: Rob Bradford <rob@funky-penguin.co.uk>
Cc: gnome-doc-list@gnome.org
Subject: Re: Unable to render sgml to html on Debian
Message-ID: <20010223105137.B21128@math.sunysb.edu>
References: <20010223102512.A5374@funky-penguin.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <20010223102512.A5374@funky-penguin.co.uk>; from rob@funky-penguin.co.uk on Fri, Feb 23, 2001 at 10:25:12AM +0000
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Fri, Feb 23, 2001 at 10:25:12AM +0000, Rob Bradford wrote:
> I did used to have this working a long time ago but i moved boxes and now
> when i come back to work on it doesnt seem to work.
[snip] 
> working on ../gnome-stones.005.sgml
> jade:/usr/lib/sgml/catalog:2:8:E: CATALOG entries cause loop
> jade:../gnome-stones.005.sgml:1:69:W: cannot generate system identifier for
> public text "-//GNOME//DTD DocBook PNG Variant V1.1//EN"

>From these messages, something is wrong with your CATALOG file -
probably DocBook PNG Variant V1.1, instead of referring to DOcBook
V3.1 as it should, refers to itself, or something like this. If you
send me your /usr/lib/sgml/catalog and the dtd file installed by
DocBook PNG Variant V1.1, I might be able to tell you more. 

Sasha


From pablodc@mapfre.com.ar  Fri Feb 23 11:10:02 2001
Return-Path: <pablodc@mapfre.com.ar>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail.mapfre.com.ar (mail.mapfre.com.ar [200.32.86.3])
	by mail.gnome.org (Postfix) with ESMTP id 5A27C2C906
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 11:09:48 -0500 (EST)
Received: by mail.mapfre.intranet.ar with Internet Mail Service (5.5.2448.0)
	id <FKPFQT5Y>; Fri, 23 Feb 2001 13:11:36 -0300
Message-ID: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
From: Pablo del Campo <pablodc@mapfre.com.ar>
To: gnome-doc-list@gnome.org
Subject: Strings Unstranslated in Nautilus (spanish)
Date: Fri, 23 Feb 2001 13:11:30 -0300
Importance: high
X-Priority: 1
MIME-Version: 1.0
X-Mailer: Internet Mail Service (5.5.2448.0)
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi everyone:

	My name is Pablo and I working in the Nautilus=B4s spanish
translation.

	I have a couple of troubles with some strings that are translated in
the es.po but Nautilus insist in display them in english, I write this =
mail
for someone that can help me whith this:

Some of the strings are:

* Customer (I don=B4t have this string in the es,po after run =
./update.sh es),
it=B4s in the Help menu.
* All the Strings of the MP3 player are translated in the es.po but
displayed in english when use it in Nautilus.
* The users level that are displayed in the Assistant when first Launch
Nautilus.
* two or three strings in the RPM view (I=B4dont remember exactly what =
they
are right now).

If someone can help whith this write me at pablodc@bigfoot as fast as =
you
can.

Thanks and please forgive my bad english.

    .-.     Pablo Gonzalo del Campo
 .-.   .-.     MAPFRE Aconcagua
(___\ /___)       Sistemas
     |          Programador
     =20


From erik@core.com  Fri Feb 23 13:54:15 2001
Return-Path: <erik@core.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.mx.voyager.net (mail2.mx.voyager.net [216.93.66.201])
	by mail.gnome.org (Postfix) with ESMTP id CAE9A2BD2D
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 13:54:14 -0500 (EST)
Received: from core.com (tnt15b-74.focal-chi.corecomm.net [216.214.210.74])
	by mail2.mx.voyager.net (8.10.2/8.10.2) with ESMTP id f1NIsjv78655
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 18:54:45 GMT
Received: (from erik@localhost)
	by core.com (8.11.0/8.11.0) id f1NJ2Up14527
	for gnome-doc-list@gnome.org; Fri, 23 Feb 2001 13:02:30 -0600
Date: Fri, 23 Feb 2001 13:02:30 -0600
From: Erik Jarvi <ejarvi@megsinet.net>
To: gnome-doc-list@gnome.org
Subject: Re: Recorded Docs (was Re: GNOME Users Guide)
Message-ID: <20010223130230.B6594@megsinet.net>
Reply-To: ejarvi@megsinet.net
References: <20010215172159.A11517@math.sunysb.edu> <Pine.LNX.4.21.0102152353460.23325-100000@foodle.eazel.com> <20010218142702.L12018@megsinet.net> <01021815165800.10931@7of9> <20010221210125.7DF7756FD@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010221210125.7DF7756FD@localhost.localdomain>; from "aliabdin@aucegypt.edu on Wed, Feb 21, 2001 at 11:01:25PM
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

On Wed, Feb 21, 2001 at 11:01:25PM +0200, Ali Abdin wrote:
> 
> No it wouldn't. It would be best to have it in ogg format!!!! :)

Well, they will be recorded/edited as 24bit 44.1kHz SoundDesignerII format, but
after that I can convert them into anything. :)

> I don't think it is worth doing until we have a nice way of actually
> playing these files ;)

There are plenty of ways to play these files. :) (but none are intergrated
specifically for this.)

My view is why wait? If someone actually uses this between the time the
recording/editing is finished and a hacker get some intergration into I think
would be nautilus, then it will be worth it. I see this as the old chicken and
egg problem...  or is it the carrot in front of the horse? Heh.

I talked to Kevin on irc, what I think we'll do is a proof of concept demo.

> Perhaps somebody should talk with Sun about this since they are doing
> some GNOME Accessibility work

Who at Sun should we get in contact with?

-- 
All music aspires to the condition of muzak.


From dan@eazel.com  Fri Feb 23 23:09:35 2001
Return-Path: <dan@eazel.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from foodle.eazel.com (eazel130.eazel.com [64.0.4.130])
	by mail.gnome.org (Postfix) with ESMTP id 3A9E72BAAF
	for <gnome-doc-list@gnome.org>; Fri, 23 Feb 2001 23:09:35 -0500 (EST)
Received: from localhost (dan@localhost)
	by foodle.eazel.com (8.11.0/8.11.0) with ESMTP id f1O47Ke02058;
	Fri, 23 Feb 2001 20:07:20 -0800
X-Authentication-Warning: foodle.eazel.com: dan owned process doing -bs
Date: Fri, 23 Feb 2001 20:07:19 -0800 (PST)
From: Dan Mueth <dan@eazel.com>
To: Pablo del Campo <pablodc@mapfre.com.ar>
Cc: gnome-doc-list@gnome.org, nautilus-list@lists.eazel.com
Subject: Re: Strings Unstranslated in Nautilus (spanish)
In-Reply-To: <76D24398E9CDD3119BDD00508B78691C01FE93DE@mail.mapfre.intranet.ar>
Message-ID: <Pine.LNX.4.21.0102231954540.27264-100000@foodle.eazel.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=ISO-8859-1
Content-Transfer-Encoding: 8BIT
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi Pablo,

Thanks for pointing this out.  I am no hacker, but my unexpert opinion is
that this is un-gettext'd:

components/rpmview/nautilus-rpm-view.c:

gtk_label_set_text
(GTK_LABEL(rpm_view->details->package_installed_message), "This package is
currently installed");

I suspect we have a fair number of places where ungettext'd strings have
slipped in.

Any Nautilus hackers want to volunteer to grep through CVS and fix any
strings which are not gettext-ized?

Dan




On Fri, 23 Feb 2001, Pablo del Campo wrote:

> Hi everyone:
> 
> 	My name is Pablo and I working in the Nautilusīs spanish
> translation.
> 
> 	I have a couple of troubles with some strings that are translated in
> the es.po but Nautilus insist in display them in english, I write this mail
> for someone that can help me whith this:
> 
> Some of the strings are:
> 
> * Customer (I donīt have this string in the es,po after run ./update.sh es),
> itīs in the Help menu.
> * All the Strings of the MP3 player are translated in the es.po but
> displayed in english when use it in Nautilus.
> * The users level that are displayed in the Assistant when first Launch
> Nautilus.
> * two or three strings in the RPM view (Iīdont remember exactly what they
> are right now).
> 
> If someone can help whith this write me at pablodc@bigfoot as fast as you
> can.
> 
> Thanks and please forgive my bad english.
> 
>     .-.     Pablo Gonzalo del Campo
>  .-.   .-.     MAPFRE Aconcagua
> (___\ /___)       Sistemas
>      |          Programador
>       
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 





From hobbit@aloss.ukuu.org.uk  Sun Feb 25 04:27:39 2001
Return-Path: <hobbit@aloss.ukuu.org.uk>
Delivered-To: gnome-doc-list@gnome.org
Received: from aloss.ukuu.org.uk (pc80-car17.cable.ntl.com [62.252.63.80])
	by mail.gnome.org (Postfix) with ESMTP id EB49C2BACE
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 04:27:38 -0500 (EST)
Received: (from hobbit@localhost)
	by aloss.ukuu.org.uk (8.11.0/8.11.0) id f1P9V4X12307
	for gnome-doc-list@gnome.org; Sun, 25 Feb 2001 09:31:04 GMT
Date: Sun, 25 Feb 2001 09:31:04 +0000
From: Telsa Gwynne <hobbit@aloss.ukuu.org.uk>
To: gnome-doc-list@gnome.org
Subject: bug-buddy docs 1.4 ready? Please check :) 
Message-ID: <20010225093104.B12247@aloss.ukuu.org.uk>
Mail-Followup-To: gnome-doc-list@gnome.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Okay, the proto-docs for bug-buddy are on the web at
http://www.linux.org.uk/~telsa/GDP/bug-buddy-new.sgml

The text is fine, I think. As in, I don't see too many errors.
I have checked for most of the 1.4-readiness stuff. But I have
got myself intro a terrible muddle: which licence am I supposed 
to be including under what id tag? I think I have it wrong. Please 
give it a quick check and tell me. Then I'll throw them at Jacob 
for CVS. (I haven't put them straight into CVS cos every time I 
touch it something else goes wrong. :))

Telsa


From chris@wilddev.net  Sun Feb 25 05:57:41 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 47E5B2BAFB
	for <gnome-doc-list@gnome.org>; Sun, 25 Feb 2001 05:57:40 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id DAA21647;
	Sun, 25 Feb 2001 03:07:13 -0800
Message-ID: <3A98E54F.9000900@wilddev.net>
Date: Sun, 25 Feb 2001 02:58:23 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list@gnome.org
Cc: ian@eazel.com
Subject: GNOME UG Proposed Framework
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I wish to get comments from people on what they think of this list of 
docs to be included in the UG. The major change in 1.4 is the addition 
of Nautilus. I'm going to pull the current copies of these docs from CVS 
to see what needs to be done to get them together for the UG. If Ian 
gets to busy to do the scripts then I may just attempt to put them 
together manually.

Chris

Intro to GNOME
GNOME Quick Start
Window Managers and GNOME
The Gnome Desktop
Nautilus
Panel
   -Applets
GNOME System Utilities
Menu Editor
GNOME Control Center
Appendix
   -A Linux Primer
   -B GDP Team
   -C GNU FDL



From trevor.curtis@home.com  Mon Feb 26 10:37:37 2001
Return-Path: <trevor.curtis@home.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from femail3.rdc1.on.home.com (femail3.rdc1.on.home.com [24.2.9.90])
	by mail.gnome.org (Postfix) with ESMTP id 7899C2BF20
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 10:37:37 -0500 (EST)
Received: from home.com ([24.112.10.196]) by femail3.rdc1.on.home.com
          (InterMail vM.4.01.03.00 201-229-121) with SMTP
          id <20010226153708.SBMY12119.femail3.rdc1.on.home.com@home.com>
          for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 07:37:08 -0800
Date: Mon, 26 Feb 2001 10:39:01 -0500
From: Trevor Curtis <trevor.curtis@home.com>
To: gnome-doc-list@gnome.org
Subject: Gnome Tali doc converted
Message-ID: <20010226103900.A5114@mail.com>
Reply-To: Trevor Curtis <trevor.curtis@home.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
X-Operating-System: Linux frink.thesimpsons.ca 2.4.2
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

I just finished converting the Gnome Tali game manual from html to
sgml. This is my first attempt at docbooking something so any feedback
would be great; negative or otherwise :)

My biggest problem was decided what should and shouldn't be tagged and
how to or not to tag them. So if there are issues here concerning that
just let me know.

So for those you who wouldn't mind you can find it here:
http://www.scs.carleton.ca/~tcurtis/gtali.sgml

thanks in advance,
-- 
Trevor Curtis
http://members.home.net/jbrabazon
--------------------------------------------------------------
"The only people who have anything to fear from free software,
are those whose products are worth even less."  --David Emery.



From jfleck@swcp.com  Mon Feb 26 11:11:36 2001
Return-Path: <jfleck@swcp.com>
Delivered-To: gnome-doc-list@gnome.org
Received: from swcp.com (unknown [216.184.13.41])
	by mail.gnome.org (Postfix) with ESMTP id 99DE12DDEE
	for <gnome-doc-list@gnome.org>; Mon, 26 Feb 2001 11:11:34 -0500 (EST)
Received: (from jfleck@localhost)
	by swcp.com (8.9.3/8.9.3) id JAA03237
	for gnome-doc-list@gnome.org; Mon, 26 Feb 2001 09:10:10 -0700
Date: Mon, 26 Feb 2001 09:10:09 -0700
From: John Fleck <jfleck@inkstain.net>
To: gnome-doc-list@gnome.org
Subject: Re: Gnome Tali doc converted
Message-ID: <20010226091009.A1672@inkstain.net>
Mail-Followup-To: gnome-doc-list@gnome.org
References: <20010226103900.A5114@mail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.95.4us
In-Reply-To: <20010226103900.A5114@mail.com>; from Trevor Curtis on Mon, Feb 26, 2001 at 10:39:01AM -0500
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Trevor -

The markup looks fine to me.

The only change needed that I saw was the reference to
bugs.gnome.org. It needs to be changed to bugzilla.gnome.org. We need
to get that changed in the templates. Sorry.

I also tested it in Nautilus, and it passed.

The next step, which would be great if you have the energy, would be
to add screenshots.

Cheers,

John

On Mon, Feb 26, 2001 at 10:39:01AM -0500, Trevor Curtis wrote:
> I just finished converting the Gnome Tali game manual from html to
> sgml. This is my first attempt at docbooking something so any feedback
> would be great; negative or otherwise :)
> 
> My biggest problem was decided what should and shouldn't be tagged and
> how to or not to tag them. So if there are issues here concerning that
> just let me know.
> 
> So for those you who wouldn't mind you can find it here:
> http://www.scs.carleton.ca/~tcurtis/gtali.sgml
> 

-- 
John Fleck
jfleck@inkstain.net (h)
jfleck@abqjournal.com (w)
http://www.inkstain.net/fleck/
http://www.abqjournal.com/scitech/


From battery841@mediaone.net  Tue Feb 27 17:24:15 2001
Return-Path: <battery841@mediaone.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from elmls01.ce.mediaone.net (elmls01.ce.mediaone.net [24.131.128.25])
	by mail.gnome.org (Postfix) with ESMTP id 576F82CA94
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 17:24:15 -0500 (EST)
Received: from 7of9 (rm01-24-131-191-98.ce.mediaone.net [24.131.191.98])
	by elmls01.ce.mediaone.net (8.8.7/8.8.7) with SMTP id QAA19245
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 16:24:10 -0600 (CST)
Content-Type: text/plain;
  charset="iso-8859-1"
From: Kevin Breit <battery841@mediaone.net>
Reply-To: battery841@mediaone.net
To: gnome-doc-list@gnome.org
Subject: Gnibbles dox
Date: Tue, 27 Feb 2001 16:14:56 -0600
X-Mailer: KMail [version 1.2]
MIME-Version: 1.0
Message-Id: <01022716145600.18733@7of9>
Content-Transfer-Encoding: 8bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Greetings,
	Why aren't the Gnibbles documentation in Gnibbles?  I wrote the dox and they 
should be in CVS.  Any reasons?
Thanks
Kevin


From gleblanc@cu-portland.edu  Tue Feb 27 23:48:33 2001
Return-Path: <gleblanc@cu-portland.edu>
Delivered-To: gnome-doc-list@gnome.org
Received: from mail2.aracnet.com (mail2.aracnet.com [216.99.193.35])
	by mail.gnome.org (Postfix) with ESMTP
	id F09D12DECF; Tue, 27 Feb 2001 23:48:32 -0500 (EST)
Received: from peecee.linuxweasel.com (216-99-218-48.dsl.aracnet.com [216.99.218.48])
	by mail2.aracnet.com (8.11.0/8.11.0) with ESMTP id f1S4mWn15023;
	Tue, 27 Feb 2001 20:48:32 -0800
Message-Id: <200102280448.f1S4mWn15023@mail2.aracnet.com>
Subject: Minutes for the GDP Release Committee meeting Feb 25, 2001
From: Gregory Leblanc <gleblanc@cu-portland.edu>
To: gnome-doc-list@gnome.org, gnome-1.4-list@gnome.org
Content-Type: text/plain
X-Mailer: Evolution (0.8 - Preview Release)
Date: 27 Feb 2001 20:46:45 -0800
Mime-Version: 1.0
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Minutes for the GDP Release Committee meeting Feb 25, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Laszlo Kovacs
John Fleck
Alexander Kirillov
Chris Lyttle (arrived 1:54)

Absent:
-------
Kenny Graunke
Ali Abdin


Regrets:
--------


Decisions:
----------

- Nautilus will not have the ability to fall back on the
  non-scrollkeeper sidebar.  Scrollkeeper is now required for
  Nautilus.

Work Done:
----------

- DONE: Dan Mueth -- HACKING files created in gnome-user-docs and
  gnome-devel-doc.  

- DONE: Alexander Kirillov -- created a list of documentation to be
  moved into the gnome-user-docs module, and send it to Gregory
  Leblanc <gleblanc@cu-portland.edu>
- DONE: Telsa Gwynne -- created a gnome-user-docs product in
  bugzilla.

- DONE: John Fleck and Dan Mueth -- tested l10n and i18n in
  gnome-db2html2.  It doesn't work, but a detailed bug report has been
  filed, and "it should be easy to fix".

- DONE: Dan Mueth, John Fleck, Mike Fleming-- bugs #4302, #5945, and
  #6761 are fixed and verified.

- DONE: Laszlo Kovacs -- Enabled scrollkeeper in the default builds of
  Nautilus, and in the hourly builds.

- DONE: Kevin Breit -- Divided docs into groups so that QA volunteers
  can sign up.
  http://battery841.myip.org/school/gnome-1.4-category.txt/ps

- DONE: Laszlo Kovacs -- locale fallback in scrollkeeper has been
  fixed.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth Kenny Graunke -- create build system in
  gnome-user-docs and gnome-devel-docs.  Once build system is in place
  inform gnome-hackers about the new modules and refer them to the
  HACKING files for further information.

- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Gregory Leblanc -- find script that puts the FAQ (and possibly
  other gnome-user-docs documents) onto the website, and find the
  maintainer.  Have the script changed to look to gnome-user-docs
  instead of gnome-docu.

- TODO: Telsa Gwynne -- add components and version numbers to the
  gnome-user-docs module in bugzilla.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.  Mail list of packages to gnome-doc-list for
  volunteers.

- IN PROGRESS: Dan Mueth -- Emailed Jacob Berkman about making
  nautilus the default help browser in gnome-libs.

- IN PROGRESS: John Fleck -- check on support for using multiple fonts
  in the Nautilus Help Sidebar.

- TODO: John Fleck, Laszlo Kovacs, Dan Mueth -- work out l10n issues.

- IN PROGRESS: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- IN PROGRESS: Kevin Breit -- develop quality assurance tests, and
  document this procedure so that it can be applied for GNOME
  1.4. See: 
  http://battery841.myip.org/school/checklist.txt
  http://www.gnome.org/~mjs/gnome-test-plans/ and
  gnome-test-plans in CVS for details.

- TODO: John Fleck -- determine status of glossary.[xml sgml] so that
  it can be translated.

- IN PROGRESS: Telsa Gwynne -- talk to the i18n teams about making
  translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)

- TODO: Chris Lyttle -- Work on GNOME Users Guide.  Add a "New in
  GNOME 1.4" section near the beginning of the Guide.  See about the
  feasibility of getting the Users Guide included with Beta 3

- TODO: Kevin Breit -- Polish the existing dia documentation and have
  it included (and linked to the help menu) in the next release.

- TODO: Dan Mueth -- Assist John Fleck in verifing some
  Nautilus/gnome-db2html2 bugs.  

Agenda Items Left For Next Meeting:
-----------------------------------

0) Discuss improving meetings
1) Review which packages need maintainers
2) QA review

Agenda:
-------
0) Review TODO's from last meeting
1) Discuss GNOME User Guide
2) Discuss whether Dia doc is ready for inclusion
3) Discuss improving meetings
4) Review which packages need maintainers
5) QA review
6) Nautilus bug verification





From chris@wilddev.net  Wed Feb 28 02:04:57 2001
Return-Path: <chris@wilddev.net>
Delivered-To: gnome-doc-list@gnome.org
Received: from hub.wilddev.net (hub.wilddev.net [216.86.200.162])
	by mail.gnome.org (Postfix) with ESMTP id 64AC12BB09
	for <gnome-doc-list@gnome.org>; Wed, 28 Feb 2001 02:04:56 -0500 (EST)
Received: from wilddev.net (IDENT:chris@meher.wilddev.net [192.168.1.3])
	by hub.wilddev.net (8.9.3/8.9.3) with ESMTP id XAA30737
	for <gnome-doc-list@gnome.org>; Tue, 27 Feb 2001 23:14:49 -0800
Message-ID: <3A9CA358.5080701@wilddev.net>
Date: Tue, 27 Feb 2001 23:06:00 -0800
From: Chris Lyttle <chris@wilddev.net>
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.0-ac10 i686; en-US; 0.7) Gecko/20010211
X-Accept-Language: en
MIME-Version: 1.0
To: gnome-doc-list <gnome-doc-list@gnome.org>
Subject: GNOME UG vs KDE UG
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: gnome-doc-list-admin@gnome.org
Errors-To: gnome-doc-list-admin@gnome.org
X-BeenThere: gnome-doc-list@gnome.org
X-Loop: gnome-doc-list@gnome.org
X-Mailman-Version: 2.0beta5
Precedence: bulk
List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>

Hi all
I was surfing the KDE site looking for ideas and I noticed

http://www.kde.org/documentation/userguide/index.html

This impressed me as it is task based, something we have discussed doing 
for the gdp docs. I am thinking now that I might try to incorporate some 
things into the UG that are more task oriented (in the time available) 
and plan on rewriting the UG as a standalone task based doc for possibly 2.0

Let me know your thoughts

Chris