Re: '>' -> '>' in the docs



Tim Janik <timj gtk org> writes:

> On Thu, 22 Nov 2001, Matthias Clasen wrote:
> 
> > I recently enabled --sgml-mode for gtk-doc and maybe someone noticed that
> > this breaks literal tags occuring
> > in inline docs and changed the few places where tags occurred literally.
> 
> i changed these for the newly created docs.
> i need to say it really don't like that though.
> if people need special markup, why not edit the tmpl/*.sgml
> files and leave us with inline docs that, just like the code
> they belong to, don't need escaping.

Because there are many things you simply can't express properly
without SGML markup -- embedded examples, <emphasis>, links,
etc, and it doesn't make sense to have to move 40% of your
docs to the tmpl/ files because you need one small bit of 
SGML markup.

Regards,
                                        Owen



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]