[PATCH] README: document quirks for regenerating gtk-doc

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

 



It sucks a bit atm :(

Signed-off-by: Daniel Vetter <daniel.vetter@xxxxxxxx>
---
 README | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README b/README
index 66462c8a9bda..7ae9bb2e2609 100644
--- a/README
+++ b/README
@@ -115,6 +115,17 @@ docs/
 	reference documenation in docs/reference/ You need to have the gtk doc
 	tools installed to generate this API documentation.
 
+	Note that the currrent gtk-docs integration sucks a bit wrt regenerating
+	the html files. You need at least
+
+	$ make clean -C docs && make -C docs
+
+	to regenerate them on any change. If you've added/changed/removed a
+	symbol or anything else that changes the overall structure or indexes,
+	you need a full rebuild:
+
+	$ git clean -dfx && ./autogen.sh --enable-gtk-doc && make -C docs
+
 DEPENDENCIES
 	This is a non-exchaustive list of package dependencies required for
 	building everything:
-- 
1.8.5.2

_______________________________________________
Intel-gfx mailing list
Intel-gfx@xxxxxxxxxxxxxxxxxxxxx
http://lists.freedesktop.org/mailman/listinfo/intel-gfx




[Index of Archives]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]
  Powered by Linux