2010-06-22 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
+ Formatting cleanups for optional arguments.
+ * doc/autoconf.texi (Configuration Actions, Help Formatting)
+ (External Software): Use @r{} for brackets denoting optional
+ arguments, where @ovar is not safe to use.
+
Clarify nested double-quotes and backquotes shell issues.
* doc/autoconf.texi (Shellology): New anchor for pdksh.
(Shell Substitutions): Link to it for escaped double-quotes
@c FIXME: Can't use @ovar here, Texinfo 4.0 goes lunatic and emits something
@c awful.
@example
-AC_CONFIG_@var{ITEMS}(@var{tag}@dots{}, [@var{commands}], [@var{init-cmds}])
+AC_CONFIG_@var{ITEMS}(@var{tag}@dots{}, @r{[}@var{commands}@r{]}, @r{[}@var{init-cmds}@r{]})
@end example
@noindent
@c FIXME: Can't use @ovar here, Texinfo 4.0 goes lunatic and emits something
@c awful.
@example
---with-@var{package}[=@var{arg}]
+--with-@var{package}@r{[}=@var{arg}@r{]}
--without-@var{package}
@end example
@c FIXME: Can't use @ovar here, Texinfo 4.0 goes lunatic and emits something
@c awful.
@example
---enable-@var{feature}[=@var{arg}]
+--enable-@var{feature}@r{[}=@var{arg}@r{]}
--disable-@var{feature}
@end example