[Intel-gfx] [i-g-t 3/7] README: update the section on modifying and rebuilding documentation
Daniel Vetter
daniel at ffwll.ch
Tue Jun 10 16:38:37 CEST 2014
On Tue, Jun 10, 2014 at 03:30:53PM +0100, Thomas Wood wrote:
> Signed-off-by: Thomas Wood <thomas.wood at intel.com>
> ---
> README | 12 +++++-------
> 1 file changed, 5 insertions(+), 7 deletions(-)
>
> diff --git a/README b/README
> index cfa186d..5e98565 100644
> --- a/README
> +++ b/README
> @@ -108,16 +108,14 @@ 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
> + To regenerate the html files when updating documentation, use:
>
> $ 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
This is still requried afaik when you add new .c/.h files with api docs in
them.
-Daniel
> + If you've added/changed/removed a symbol or anything else that changes
> + the overall structure or indexes, this needs to be reflected in
> + intel-gpu-tools-sections.txt. Entirely new sections will also need to be
> + added to intel-gpu-tools-docs.xml in the appropriate place.
>
> DEPENDENCIES
> This is a non-exchaustive list of package dependencies required for
> --
> 1.9.3
>
> _______________________________________________
> Intel-gfx mailing list
> Intel-gfx at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/intel-gfx
--
Daniel Vetter
Software Engineer, Intel Corporation
+41 (0) 79 365 57 48 - http://blog.ffwll.ch
More information about the Intel-gfx
mailing list