Re: '>' -> '>' in the docs
- From: Owen Taylor <otaylor redhat com>
- To: Tim Janik <timj gtk org>
- Cc: Matthias Clasen <matthiasc poet de>, Gtk+ Developers <gtk-devel-list gnome org>
- Subject: Re: '>' -> '>' in the docs
- Date: 22 Nov 2001 12:35:21 -0500
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]