Re: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools

[Georgi Georgiev]

maillog: 20/05/2005-06:06:21(+0100): Ciaran McCreesh types
> On Thu, 19 May 2005 04:44:25 +0100 Ciaran McCreesh <ciaranm@g.o>
> wrote:
> | http://www.firedrop.org.uk/devmanual/general-concepts/autotools/
>
> Updated based upon the feedback, thanks guys. If someone who's
> relatively clueless about autotools could give it a read and let me know
> what is and isn't clear I'd appreciate it.

That would be me.

Notes:

- typo?
	- The configure script is run to produce one or Makefile files from Makefile.in files.
	+ The configure script is run to produce one or more Makefile files from Makefile.in files.

- clarification

	AC_MSG_CHECKING(--enable-cscope argument)
	AC_ARG_ENABLE(cscope,
		[  --enable-cscope         Include cscope interface.],
		[enable_cscope=$enableval],
		[enable_cscope="no"])
	AC_MSG_RESULT($enable_cscope)
	if test "$enable_cscope" = "yes"; then
	  AC_DEFINE(FEAT_CSCOPE)
	fi

	<1 paragraph skipped>

	Important: The third argument is used when an option is
	specified, and the fourth is used when an option is not
	specified. A common misconception is that the third is enable
	and the fourth is disable — this is not the case.  You may
	encounter packages that get this wrong.

The phrase "when an option is specified" is a bit ambiguous, especially
since it is later referred by the explanation of AC_ARG_WITH. I was not
sure if "option" in this case means "option" as in
"--enable-foo=OPTION". I was confused, because one paragarph before the
example you talk about "--enable-foo and --disable-foo *switches* to
./configure".

Maybe the above can be written as: ‟The third argument is used when
either "--enable" or "--disable" is specified, and the fourth is used
when neither is specified.” Or you could simply stick to using
"switches" instead of "options"?

- coloring

	%.1 : %.in
		@regex_cmd@ -e "s,\@VERSION\@,$(VERSION),g" $? > $@

The first "@" is span.Special and the second one is span.Constant.

Good job by the way.

-- 
()   Georgi Georgiev   () There is only one thing in the world worse   ()
()    chutz@×××.net    () than being talked about, and that is not     ()
()  [phone]   () being talked about. -- Oscar Wilde           ()