Re: Applet Manual in 2.x

[Alexander Kirillov <kirillov math sunysb edu>]

Oh my, I am really embarrassed. The Handbook in general and this section
in particular is *outdated* (yes, I know, we must update it - any
volunteers?). This stuff about "applet manual for 2.x" was written in
2000 when we had rather vague idea as to what GNOME 2 will look like.
According to CVS logs, Dan Mueth commented this out in Nov. 2000 - and
the fact that it is still on the web shows that the web version was not
updated since that time. jfleck: can you take care of this?

As for what templates we should really be using for applets: AFAIK, at
the moment we do not have any (if I am wrong, please correct me). Irene
Ryan from Sun volunteered to write one, so hopefully soon we will have a
template. In the meantime, I suggest using the application template -
not the one in GDP handbook but from CVS,
gnome-docu/gdp/templates/gnome-app-tempalte.xml. This has been updated
for GNOME 2. 

Sorry for the confusion. BTW, any volunteers to rewrite the GDP
handbook? gleblanc converted it to XML, but the contents needs to be
rewritten, too. 

Sasha

On Sat, 2002-01-26 at 16:23, Daniel Carrera wrote:
> The template I've been using is on the very last page of the GDP
> handbook.  It says "Template 2: Applet Manual For GNOME 2.x", and comes
> right after "Template 2: Applet Manual For GNOME 1.x".
> 
> "Template 2: Applet Manual For GNOME 2.x" has two files.  One that I am
> not supposed to modify, and one that I am.  This second one doesn't have a
> <copyright> section, or anything of the sort.  It's not an <article>, but
> a <sec1>.
> 
> Did I misunderstand the purpose of this template?  Please let me know.
> 
> Thanks for the help,
> Daniel.
> 
> On 26 Jan 2002, Alexander Kirillov wrote:
> 
> > Daniel:
> > there seems to be some misunderstanding. Currently we only have an
> > *application* template  for gnome 2
> > (gnome-docu/gdp/templates/gnome-app-template.xml)
> > An applet template is being written, but in the meanwhile you can use
> > application template - it is close enough. This template does contain
> > <copyright> tag and, of course, it does contain <DOCTYPE ..>
> > declaration.
> >
> > BTW: please remember that, according to FDL, whenever you modify someone
> > else's document, you must:
> > a. keep his copyright and add yours to it
> > b. keep his name in the list of authors
> > c. edit section "history" as appropriate (in the template, this section
> > is done using <revhistroy> tag inside <articleinfo>)
> > d. give your document a title diffferent from that of the previous
> > version (e.g., GDict Manual V. 2 rather than jus GDict Manual).
> >
> >
> >
> > On Sat, 2002-01-26 at 11:43, Daniel Carrera wrote:
> > > Hello,
> > > I'm still updating the GDict applet manual for Gnome 2.  I have a couple
> > > of questions:
> > >
> > > 1) What should I do with the original writer's <copyright> information?
> > >    The template for Gnome 2.x doesn't seem to have it.  The closest thing
> > >    is the list of authors.
> > >
> > > 2) The original document has <!ENTITY version "1.4"> for the version of
> > >    the applet.  However, the new format doesn't have a DOCTYPE tag.  What
> > >    should I do?
> > >
> > > Thanks,
> > > Daniel.
> > >
> > > _______________________________________________
> > > gnome-doc-list mailing list
> > > gnome-doc-list gnome org
> > > http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> >
> >
> > _______________________________________________
> > gnome-doc-list mailing list
> > gnome-doc-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> >
>