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 _______________________________________________ Pan-users mailing list Pan-users@nongnu.org http://lists.nongnu.org/mailman/listinfo/pan-users
