[Geany] the fine manual

[Enrico Tröger]

On Wed, 1 Aug 2007 13:01:15 -0400, "John Gabriele" <jmg3000 at gmail.com>
wrote:

> On 8/1/07, Enrico Tröger <enrico.troeger at uvena.de> wrote:
> > On Tue, 31 Jul 2007 21:57:40 -0400, "John Gabriele"
> > <jmg3000 at gmail.com> wrote:
> >
> > > Updating Geany's manual is, IMO, a bit of a chore. Just my
> > > preference I suppose, but working with docbook to write docs
> > > seems way too onerous. There's a lot of tags to remember, and the
> > > whole thing is very <emphasis>very</emphasis> verbose. But most
> > > of all, docbook is not very pretty to read in source form.
> >
> > I don't think so. DocBook is IMO a nice format for writing larger
> > documents and mainly you don't need so many tags. Just a question of
> > personal preference.
> 
> It looks like, with docbook, you can use lots of tags if you like:
> 
> <screen><prompt>%
> </prompt><userinput><command>./configure</command></userinput></screen>
> 
> but you don't always have to. So, what the current manual sometimes
> inconsistently ends up with is some sections where the author is using
> lots of tags, and other sections where the author is scraping by with
> as few as possible.
Just to be clear: I _don't_ like the above tag construction. But
sometimes such things are necessary ;-(.

> > > [snip]
> >
> > Wow, it looks very promising. I must admit your stylesheet is very
> > nice, IMO not yet perfect,
> 
> Right. For one thing, I failed to put in a style to render those
> "notes" sections correctly.
> 
> > but much cooler than mine(which was just
> > stolen from Xfce ;-)).
> 
> Thanks. It's the style I use for my own notes online.
You should quickly define it under a restrictive license or I'll steal
it too ;-).


Regards,
Enrico

-- 
Get my GPG key from http://www.uvena.de/pub.key
Powered by Debian GNU/Linux, GnuPG and Sylpheed.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://lists.geany.org/pipermail/users/attachments/20070801/95ff6508/attachment.pgp>