Re: [PATCH] install.texi changes for underfull/overfull hboxes

["Joseph S. Myers" <jsm28 at cam dot ac dot uk>]

On Tue, 3 Sep 2002, Janis Johnson wrote:

> This patch changes the wording in several places in the installation
> instructions to get rid of messages about overfull and underfull
> hboxes from "make dvi".

 ... for the particular paper size configured on your system.  Texinfo
makes this configurable.

> I have patches to other files to get rid of _all_but_one_ of these
> messages, but will see how this patch flies before submitting them.

For the manuals that are printed by the FSF, changes that get rid of these
problems when @set FSFPRINT is uncommented in gcc-common.texi (selecting
smallbook paper size - I'm presuming that the same size will be used for
future printed editions as in the past) are the appropriate ones to make.  
Of course, you can also make changes that avoid such problems for
smallbook *and* the Texinfo default *and* A4.

Some particular changes (that are likely to avoid such warnings
independent of paper size, or that correct other typos) are still useful,
e.g.

> -As currently implemented, this options only take effect for native
> +As currently implemented, these options only take effect for native
>  builds; cross compiler binaries' names are not transformed even when a
> -transformation is explicitly asked for by one of this options.
> +transformation is explicitly asked for by one of these options.

and

> -The systems where it makes a difference whether you use the GNU assembler are
> -@samp{hppa1.0-@var{any}-@var{any}}, @samp{hppa1.1-@var{any}-@var{any}},
> -@samp{i386-@var{any}-sysv}, @samp{i386-@var{any}-isc},
> -@samp{i860-@var{any}-bsd}, @samp{m68k-bull-sysv},
> -@samp{m68k-hp-hpux}, @samp{m68k-sony-bsd},
> -@samp{m68k-altos-sysv}, @samp{m68000-hp-hpux},
> -@samp{m68000-att-sysv}, @samp{@var{any}-lynx-lynxos},
> -and @samp{mips-@var{any}}.
> -On any other system, @option{--with-gnu-as} has no effect.
> +The following systems are the only ones where it makes a difference
> +whether or not you use the GNU assembler.  On any other system,
> +@option{--with-gnu-as} has no effect.
> +
> +@itemize
> +@item @samp{hppa1.0-@var{any}-@var{any}}
> +@item @samp{hppa1.1-@var{any}-@var{any}}
> +@item @samp{i386-@var{any}-sysv}
> +@item @samp{i386-@var{any}-isc}
> +@item @samp{i860-@var{any}-bsd}
> +@item @samp{m68k-bull-sysv}
> +@item @samp{m68k-hp-hpux}
> +@item @samp{m68k-sony-bsd}
> +@item @samp{m68k-altos-sysv}
> +@item @samp{m68000-hp-hpux}
> +@item @samp{m68000-att-sysv}
> +@item @samp{@var{any}-lynx-lynxos}
> +@item @samp{mips-@var{any}}
> +@end itemize

and

>  If you want to save additional space during the bootstrap and in
>  the final installation as well, you can build the compiler binaries
> -without debugging information with @samp{make CFLAGS='-O' LIBCFLAGS='-g
> --O2' LIBCXXFLAGS='-g -O2 -fno-implicit-templates' bootstrap}.  This will save
> +without debugging information as in the following example.  This will save
>  roughly 40% of disk space both for the bootstrap and the final installation.
>  (Libraries will still contain debugging information.)
>  
> +@example
> +     make CFLAGS='-O' LIBCFLAGS='-g -O2' \
> +       LIBCXXFLAGS='-g -O2 -fno-implicit-templates' bootstrap
> +@end example
> +

(and probably more).

-- 
Joseph S. Myers
jsm28@cam.ac.uk