#2633: Doc directory for udev
-----------------------+----------------------------------------------------
Reporter: jhuntwork | Owner: lfs-b...@…
Type: defect | Status: new
Priority: normal | Milestone: 6.7
Component: Book | Version: SVN
Severity: normal | Keywords:
-----------------------+----------------------------------------------------
Comment(by br...@…):
Replying to [comment:3 jhuntwork]:
> Since they're HTML format, why specifically do they belong in a gtk-doc
directory?
Just because that's where all the rest of the HTML docs that gtk-doc
builds (from comments in the code, IIRC) get installed -- most gtk-ish or
gnome-ish packages tend to drop something there. I have directories for
all the gtk packages, plus gladeui, lots of bits of gimp, libsoup,
libxml2, pygtk, and rsvg, in there on my system.
No really good reason other than "that's what all the packages similar to
this do", though.
> Sorry for my ignorance on this, never worked with gtk-doc before. Are
there things specific to gtk-doc about those files?
Just the tool that was used to create them, and (because of that) the
general layout and style.
(I've actually never run gtk-doc myself either. These files get built on
the development machine, then get included in the released tarball. You
can use --with-gtk-doc (or whatever the configure switch is) to rebuild
them if you want, but otherwise there's a Makefile piece that dumps them
into /usr/share/gtk-doc/html/${package}.)
Now, that being said, I don't know why the gtk-doc people wrote that
snippet to use /usr/share/gtk-doc instead of /usr/share/doc. Perhaps
because gtk+ already had a /usr/share/doc/gtk+ directory, with entirely
different contents? (Not at all an API reference, more of a developer
tutorial plus a FAQ. Not information that fits into code comments.)
--
Ticket URL: <http://wiki.linuxfromscratch.org/lfs/ticket/2633#comment:4>
LFS Trac <http://wiki.linuxfromscratch.org/lfs/>
Linux From Scratch: Your Distro, Your Rules.
--
http://linuxfromscratch.org/mailman/listinfo/lfs-book
FAQ: http://www.linuxfromscratch.org/lfs/faq.html
Unsubscribe: See the above information page
