[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-devel
Subject:    Re: KDE 4 Documentation - Have an app that needs doco love?
From:       Ian Wadham <ianw2 () optusnet ! com ! au>
Date:       2008-03-21 20:45:59
Message-ID: 200803220745.59877.ianw2 () optusnet ! com ! au
[Download RAW message or body]

On Sat, 22 Mar 2008 03:40 am, Richard A. Johnson wrote:
> I just want to toss this out to everyone who may have an application that
> either needs new documentation or updated documentation work done.
>
A bit off topic, but is there any way to make do-it-yourself
documentation easier to write?  I am currently writing docbook
doco for a new game in /playground, using a template and
plain-text editing in "vi" and I feel as if I am back in the "good
old days" of DEC's "runoff" and UNIX's "nroff", except that the
"tags" were all understandable/documented back then ... ;-)

CMake is a great help, because it is now quite easy to "compile"
and install your doco and see the WYG part of WYSIWYG (as
compared with a few years ago).  But is there a better and quicker
way of handling the actual writing?  Even WYSIWYG maybe?

I am having particular difficulty getting menuitem and shortcut
doco right, especially when there are alternate shortcuts.  There
seems to be no "clean" way to document an item that has two
shortcuts.

Cheers, Ian W.
 
>> Visit http://mail.kde.org/mailman/listinfo/kde-devel#unsub to unsubscribe <<
[prev in list] [next in list] [prev in thread] [next in thread]