Re: Documentation layout suggestion
- From: Owen Taylor <otaylor redhat com>
- To: gtk-doc-list redhat com
- Subject: Re: Documentation layout suggestion
- Date: 23 Aug 1999 12:52:02 -0400
Damon Chaplin <email@example.com> writes:
> Owen Taylor wrote:
> > > Would it be possible sometime in the future to combine the GTK+
> > > and GNOME docs into a single module? Wouldn't that make it
> > > easier to use cross-referencing between the two API's? Also, it
> > > would make it easier to install everything in one fell swoop.
> > > And finally, it seems like having everything together would
> > > increase the profile of the documentation efforts for both GTK+
> > > and GNOME. One-stop shop, so to speak.
> > Single module? Not as I typically understand "module".
> > It would be possible to build all the docs on a single
> > machine with a single htmldir. That would get the
> > cross references from GNOME to GTK+ right.
> Do we want to support multiple html directories?
> I don't think we should force people to install into a particular
> place. They may not have permission.
Hmmm, we could certainly support a "path" of directories
for gtkdoc-fixref. The interesting question is what you
do then for relative paths versus absolute paths. The
nice thing currently is that inter-module links are
relative so that the document is transportable.
I suppose what you could do then is make the links
relative within one path component and absolute between
][Date Next] [Thread Prev