Making documentation - was RE: Docu updates question..

Tony Lambregts tony_lambregts at telusplanet.net
Fri Nov 8 14:48:23 CST 2002


Sylvain Petreolle wrote:

>Like Vincent said, the most convenient form of the doc (I think), fails
>when you do :
>  
>
>>2b. make html
>>    
>>
>
>See bug #688 http://bugs.winehq.com/show_bug.cgi?id=688
>
>  
>
When I run "./make_winehq" (with the docbook packages installed) it 
produces the html files in  wine-doc with meaningfull names  but "make 
html" produces xNNNN files (just like bug report) so make_winehq is the 
prefered method,  yes? Is it realy a bug then?


I think that at the beginning of the document we had a getting started 
section.  This section would tell the developer that they needed to 
install have jade, tetex, docbook and perl installed in order to create 
html, pdf, and ps files from the sgml files. There should be links to 
the section on what is required for the various distrbutions and what 
command to run (./make_winhq).

Right now there is only the section for RedHat . I would be really nice 
if we had sections for other distributions as well
  
The sections on setting up the docbook from section 3.2.1.4 on  needs 
work since it contains a lot of sections that are incomplete and to a 
large extent it is unclear (to me) what is required.

As I pointed out before there is a bug about this 
http://bugs.winehq.com/show_bug.cgi?id=727

--

Tony Lambregts






More information about the wine-devel mailing list