Re: /*< private >*/ handling

[James Henstridge <james daa com au>]

Damon Chaplin wrote:

> On Wed, 2003-01-15 at 18:11, Damon Chaplin wrote:
>  
>
> > On Tue, 2003-01-14 at 16:26, Matthias Clasen wrote:
> >
> >    
> >
> > > Speaking about 1.0, what major problems do you want fixed before 1.0 ?
> > >      
>
> I spoke too soon. This bug is fairly bad:
>
>   http://bugzilla.gnome.org/show_bug.cgi?id=103595
>
> Lynx can't read the gtk-doc HTML files, which is bad for accessibility.
>
> I think it is for the SGML mode, and a problem in the DSSSL stylesheets
> rather than a gtk-doc bug. I'm not sure if we can work around it easily.
>  
I just read the Jade man page, and it documents a second SGML output 
format -- sgml-raw.  According the man page, it says that sgml-raw does 
not add the new lines inside elements.  I have committed this change 
which should solve the problem:

2003-01-18  James Henstridge  <james daa com au>

   * gtkdoc-mkhtml.in (declaration): switch the output type from
   "sgml" to "sgml-raw" when using Jade to process docs.  This gets
   rid of the line breaks inside the tags, which were confusing Lynx.

If it causes a problem, it should be pretty easy to revert.

James.

--
Email: james daa com au              | Linux.conf.au   http://linux.conf.au/
WWW:   http://www.daa.com.au/~james/ | Jan 22-25   Perth, Western Australia.