This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: Patch to use @: in manual
On Wed, Jun 27, 2001 at 01:08:19AM +0100, Joseph S. Myers wrote:
> In Texinfo, a full stop after a lowercase letter that does not end a
> sentence but is followed by whitespace (see the TeXbook for full
> details of how sentence ends are detected) should be followed by @:.
> This patch adds such @: uses to the GCC manual. It passes "make info"
> and "make dvi". Applied to mainline and branch.
>
> 2001-06-27 Joseph S. Myers <jsm28@cam.ac.uk>
>
> * doc/cpp.texi, doc/cppinternals.texi, doc/extend.texi,
> doc/gcc.texi, doc/install.texi, doc/invoke.texi, doc/md.texi,
> doc/tm.texi: Use @: where necessary when a full stop does not end
> a sentence.
>
> diff -ruN doc.orig/cpp.texi doc/cpp.texi
> --- doc.orig/cpp.texi Tue Jun 26 22:35:28 2001
> +++ doc/cpp.texi Tue Jun 26 23:45:25 2001
> @@ -864,7 +864,7 @@
> @cindex wrapper @code{#ifndef}
>
> If a header file happens to be included twice, the compiler will process
> -its contents twice. This is very likely to cause an error, e.g. when the
> +its contents twice. This is very likely to cause an error, e.g.@: when the
> compiler sees the same structure definition twice. Even if it does not,
This is great! Every TeXer should know about \@, and every Texinfoer
should know about @:. Unfortunately, most of these examples should
use a comma, not `@:'. \emph{The Chicago Manual of Style}, 13th
edition, says that `e.g.' and `i.e.' should be followed by a comma,
e.g., this is itself an example!
Thanks,
Jeffrey D. Oldham
oldham@codesourcery.com