[cairo] Docs

[Carl Worth]

On Sat, 13 Aug 2005 22:57:10 +1000, Russell Shaw wrote:
> When i change a .c file in cairo/src and rebuild, cairo/doc/public/html/cairo.devhelp
> doesn't get updated. How do i do that? I have done ./configure --enable-gtk-doc.

I cannot reproduce this problem.

With the latest cairo source code from CVS, I see the following
behavior.

(1) Touch cairo.c, without changing any documentation
=====================================================
	cairo:$ ls -l doc/public/html/cairo.devhelp
	-rw-r--r--  1 cworth cworth 22348 Aug 15 14:44 doc/public/html/cairo.devhelp
	cairo:$ touch src/cairo.c
	cairo:$ make
	...
	cairo:$ ls -l doc/public/html/cairo.devhelp
	-rw-r--r--  1 cworth cworth 22348 Aug 15 14:44 doc/public/html/cairo.devhelp

Notice here that cairo.devhelp was unchanged.

(2) Edit cairo.c, changing some documentation
=============================================
	cairo:$ ls -l doc/public/html/cairo.devhelp
	-rw-r--r--  1 cworth cworth 22348 Aug 15 14:44 doc/public/html/cairo.devhelp
	cairo:$ sed -i -e 's/for the context/for the new context/' src/cairo.c
	cairo:$ make
	...
	Writing cairo.devhelp for book(cairo)
	...
	cairo:$ ls -l doc/public/html/cairo.devhelp
	-rw-r--r--  1 cworth cworth 22348 Aug 15 14:50 doc/public/html/cairo.devhelp

Here cairo.devhelp definitely changed.

This seems like desired behavior. That is, when the documentation
strings in the source files change, the cairo.devhelp file is
rebuilt. Are you finding that that behavior doesn't hold? Or is there
some different behavior that you actually want?

-Carl
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.freedesktop.org/archives/cairo/attachments/20050815/e78adf8e/attachment.pgp