[Pan-users] Re: 0.134 and Beyond

[Petr Kovar]

Hi!

Duncan, Tue, 29 Sep 2009 11:09:40 +0000 (UTC):

> Jeff Berman posted on Mon, 28 Sep 2009 17:33:44 -0700 as excerpted:
> 
> > Hey, didn't someone put together a documentation wiki of sorts for Pan?
> > Seems that would be the place to put it.  And if Pan's "About" window
> > linked to the wiki, that would be nice.
> 
> Yes, I strongly agree and in fact was just discussing with someone a 
> couple days before this thread, there's actually two sites with pan docs 
> ATM, and it'd be great to have them at least linked from the about dialog 
> and/or help menu directly, if not merged into pan's repository and 
> shipped as part of the tarball.
> 
> I believe I posted the links recently, but here they are again, for 
> Charles:
> 
> Darren's FAQ:
> http://www.darrenalbers.net/wiki/index.php?title=Pan_FAQ
> 
> Doug's work on a pan manual:
> http://doug.freeshell.org/files/pan_docs070107.tar.gz

Actually, this seems to be quite a great docs material, at least to start
with. Having some DocBook experiences myself, I'd like to help out with
finishing the work, since Pan doesn't provide any documentation for now
and in my opinion, it'd really be a pity to let the existing manual rot in a
fairly obscure form & place. :-)

However, it's obviously up to the Pan's main author to decide in which way
he wants the Pan docs to be distributed, that is, whether to distribute
simple HTML files linked (most likely) from the Pan's Help menu, or whether
to use the approach common among the GNOME modules, i.e. to distribute XML
file(s) and use GNOME's Yelp as a help viewer.

I'm not sure though how would the latter approach work in some environments
like Windows and if the requirement for gnome-doc-utils (which isn't
avoidable as far as I can tell) could potentially trigger some other
(unnecessary) problems. In any case, this is beyond my DocBook authoring
skills anyway. :-)

Best,
Petr Kovar