[Scummvm-devel] I would like to volunteer to work on writing the manual

Max Horn max at quendi.de
Sun Dec 18 07:25:00 CET 2005


Am 18.12.2005 um 12:25 schrieb James 'Ender' Brown:

>> Also: I think it would be possible to write the docs in another
>> format initially (e.g. HTML, OpenOffice, RTF, LaTeX). I would always
>> be able to convert them to DocBook later. Please note that I am not
>> *eager* to convert a manual to DocBook, but it's far easier for me to
>> do than to write the docs from scratch :-). And we could even decide
>> to drop DocBook altogether in favor of something different (provided
>> there is a good alternative); I am not married to that format :-)
>
> I also have been more in favor of something other than docbook.
> Personally I'd like a HTML manual, which could easily be converted to
> various formats. OpenOffice is not very optimal for format conversion,
> nor really is RTF... although it can be made acceptable, it's just a
> longer process :)

The point i was trying to make was this: I don't really care whether  
the manual is *initially* written using DocBook, HTML, or even *MS  
Word* -- I can always convert it later. Any of these formats.

The major problem is *writing* the manual. This hasn't happened in  
the last two years. Neither Ender nor I did make any visible progress  
(well -- I did make a tiny little bit of it, at least, we never saw  
anything from James, unfortunately). We can have the format debate  
afterwards (again).


Bye,
Max




More information about the Scummvm-devel mailing list