Re: tmpl/ to xml/ without DOCTYPE front matter



Hi.

How can I indicate in the source code the various sections, i.e. short/long description, "See also", etc. That's the only thing I was actually editing the templates for.

Thanks.

Phil

Stefan Kost wrote:
Hi Philip,

I also once struggled with a similar issue. Anyway there is no need to
edit the tmpl files. You can comment inside the sources and hopefully,
one day, there won't be any tmpl files anymore.

Stefan

Philip Kovacs wrote:
I notice that when I edit a tmpl/ template file and rebuild, the corresponding
xml/ file gets the DOCTYPE front matter from the PROJECT-docs.sgml file,
which unfortunately includes all the ENTITY's that I added to that -docs.sgml
file, of the form:

<!ENTITY Something SYSTEM "xml/project-something.xml">

The .xml file in xml/ do not compile due to those echoed entities, since the
the current directory has shifted down one level, i.e. into xml/.

I find that I have to manually rip out everything before <refentry id="">
in the xml/ files after editing the templates.

It seems as those I have to distrtibute both the tmpl/ and the edited xml/
files as well in order for people to build proper docs.  I notice the gtk+
tarballs do just that, i.e. distribute xml/ files with the DOCBOOK/ENTITY
front matter all (manually?) ripped out.

No auto way to do this?

Phil
_______________________________________________
gtk-doc-list mailing list
gtk-doc-list gnome org
http://mail.gnome.org/mailman/listinfo/gtk-doc-list





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