[PATCH libICE docs] Add top-level target for documentation.

Dan Nicholson dbn.lists at gmail.com
Tue Nov 23 11:32:18 PST 2010


On Mon, Nov 22, 2010 at 2:26 PM, Trevor Woerner <twoerner at gmail.com> wrote:
> From: Trevor Woerner <twoerner at gmail.com>
>
> Builds user and developer documentation/specifications.
>
> Signed-off-by: Trevor Woerner <twoerner at gmail.com>
> ---
>  Makefile.am |    7 ++++++-
>  1 files changed, 6 insertions(+), 1 deletions(-)
>
> diff --git a/Makefile.am b/Makefile.am
> index c2110ec..d0102e8 100644
> --- a/Makefile.am
> +++ b/Makefile.am
> @@ -5,7 +5,7 @@ pkgconfig_DATA = ice.pc
>
>  MAINTAINERCLEANFILES = ChangeLog INSTALL
>
> -.PHONY: ChangeLog INSTALL
> +.PHONY: ChangeLog INSTALL documents
>
>  INSTALL:
>        $(INSTALL_CMD)
> @@ -15,6 +15,11 @@ ChangeLog:
>
>  dist-hook: ChangeLog INSTALL
>
> +# Generically invoked from build.sh --cmd "make documents"
> +# Builds User's documentation and Developer's documentation/specifications
> +documents:
> +       cd specs && $(MAKE) $(AM_MAKEFLAGS) install
> +
>  if LINT
>  lint:
>        (cd src && $(MAKE) $(MFLAGS) lint)

Rather than creating a new target, maybe it would be possible to reuse
all the documentation targets that automake already defines for
texinfo. Then you can rely on the target being there for every
package. I haven't given it much thought, but if "make install-html"
was useful, that would be really nice.

--
Dan


More information about the xorg-devel mailing list