[PATCH util-macros 0/4] Add doc macros for groff fop, ps2pdf

Alan Coopersmith Alan.Coopersmith at Sun.COM
Mon Feb 1 13:29:15 PST 2010


The reason some of these exist as separate options is because some of the docs
aren't interesting to include in packages, because they're only useful if you're
working on the source itself, not using the resulting binaries.

Those should probably all be the same option across the packages -
enable-devel-docs or something like that, but I'm not sure they should just be
lumped in with user docs completely.

	-alan-

Gaetan Nadon wrote:
> Second version.
> 
> This is the last installment of document generation control macros.
> The code is identical to the first 3 released, which were well reviewed.
> 
> In addition, the XORG_ENABLE_DOCS provides a --enable-docs option intended to replace the
> various ad hoc options like:
> enable-devel-docs
> enable-specs
> enable-builddocs
> enable-docs	(this one has been retained)
> 
> The default value is "yes" but can be changed in the configuration file:
> XORG_ENABLE_DOCS(no)
> 
> Assumption:
> The concept of "doc" does not apply to "man pages". They will continue to be build without
> condition. The exception are those built with xmlto. If the tool is not there,
> they will be skipped.
> 
> For additional info, see http://www.x.org/wiki/Development/Documentation/WritingDocumentation
> 
> 
> Gaetan Nadon (4):
>   Additional doc macros for GROFF, FOP and PS2PDF
>   Add XORG_ENABLE_DOCS to control the building of documentation
>   XORG_WITH_GROFF: add tests for -ms and -mm macro packages
>   Version bump: 1.6.0
> 
>  configure.ac      |    2 +-
>  xorg-macros.m4.in |  219 +++++++++++++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 220 insertions(+), 1 deletions(-)
> 
> _______________________________________________
> xorg-devel mailing list
> xorg-devel at lists.x.org
> http://lists.x.org/mailman/listinfo/xorg-devel

-- 
	-Alan Coopersmith-           alan.coopersmith at sun.com
	 Sun Microsystems, Inc. - X Window System Engineering



More information about the xorg-devel mailing list