Re: stronger docs on @SHELL@ usage in Makefile

[Ralf Wildenhues]

Hi Eric,

* Eric Blake wrote on Wed, Apr 09, 2008 at 08:15:45PM CEST:
> 
> Does this patch look okay to install?

You meant "these patches", right?

> * doc/autoconf.texi (The Make Macro SHELL): Stronger wording on
> the importance of proper SHELL settings.
> Reported by Bruno Haible, in
> http://lists.gnu.org/archive/html/bug-libtool/2008-04/msg00029.html.

These parts are probably ok, but the discussion will still take longer
(I need to check a few things first), so I would appreciate if you could
wait a little bit.

> +       * doc/autoconf.texi: Use @command{make} throughout.

> --- a/doc/autoconf.texi
> +++ b/doc/autoconf.texi
> @@ -497,7 +497,7 @@ Portable Make Programming
>  * Backslash-Newline-Newline::   Empty last lines in macro definitions
>  * Backslash-Newline Comments::  Spanning comments across line boundaries
>  * Long Lines in Makefiles::     Line length limitations
> -* Macros and Submakes::         @code{make macro=value} and submakes
> +* Macros and Submakes::         @command{make macro=value} and submakes

This is not what the texinfo manual suggests:

| Use the address@hidden' command to indicate command names, such as `ls' or
| `cc'.
[...]
|   You should write the name of a program in the ordinary text font,
| rather than using address@hidden', if you regard it as a new English word,
| such as `Emacs' or `Bison'.
| 
|   When writing an entire shell command invocation, as in `ls -l', you
| should use either address@hidden' or address@hidden' at your discretion.

Cheers,
Ralf