Ethereal-dev: Re: [Ethereal-dev] Re: How to pleasantly edit the user's guide?

Note: This archive is from the project's previous web site, ethereal.com. This list is no longer active.

From: Ed Warnicke <hagbard@xxxxxxxxxxxxxxxxxxx>
Date: Sat, 13 Mar 2004 15:13:28 -0500
Ulf,
   I did the last major overhaul (I think) of the
User's Guide.  You are correct that the sources
are in DocBook SGML.  At the time I last touched
them the DocBook XML processing chain (in
Debian at least) was a bit immature.  This is no
longer the case.  Converting to XML shouldn't
be terribly hard, someone probably even has
a script somewhere to do it. As to WYSIWYG editors for docbook...
I don't know.  I always editted docbook in
emacs and PSGML, and found it's WYGIWYW
(What you get is what you want) much more
comfortable than fighting a WYSIWYG editor. Just my biases :)

Ed
Ulf Lamping wrote:

Hi list!

Tried to send the following mail to the doc mailing list, but got no response till now.

Ulf Lamping wrote:

Hi List!

When looking at the archive of the doc mailing-list, no one seems to be currently working on the user's guide.

That's a pity, as I've made a lot of changes to the GUI in the last months, and the user's guide seems to
be in an state of "please immediatly update me" ;-)

I've downloaded the sources, but couldn't find an easy way to edit these (the documentation for the documentation is quite worse ;-).
When I understand it correct, these are Docbook sources in SGML format.

This format seems to be a bit out of date, as I've googled around and find for example the linux documentation project, which is preferring Docbook with XML, see: http://www.tldp.org/LDP/LDP-Author-Guide/html/docbookxml.html.

However, the differences between SGML and XML shouldn't be too high, and a somewhat simple conversion should do the job.

When going to edit the book, I would like to have some WYSIWYG editor for it, as this usually makes editing a *lot* faster, at least for me. At http://www.tldp.org/LDP/LDP-Author-Guide/html/tools-edit.html there are two favourites for me: AbiWord and OpenOffice, which are both available
on Win32 and Linux.


Any suggestions how I can get started?

Regards, ULFL



_______________________________________________
Ethereal-dev mailing list
Ethereal-dev@xxxxxxxxxxxx
http://www.ethereal.com/mailman/listinfo/ethereal-dev