Suggestion for 6.27.1
jastev at alumni.rice.edu
Sun Jan 8 13:29:21 PST 2006
For folks who succumb to the mindless tedium of copying and pasting from
the grey boxes to their shell, it would be easy to execute
env PAGE=[paper_size] \
which is not going to yield happy results. I suggest you use your "red
box" paradigm on the preceding paragraph:
" Groff expects the environment variable PAGE to contain the default
paper size. For users in the United States, PAGE=letter is appropriate.
Elsewhere, PAGE=A4 may be more suitable."
in order to alert people who may be, ah, "skimming" the explanatory text
that they should pay attention.
The same thing is probably in order for the last paragraph of 6.45 (grub).
Finally, you may want to use a similar approach (but perhaps a different
color, or some other distinguishing style) for optional items. Examples
are the locale installs, tex and the /usr/share/info/dir recreation in
6.34.1 (texinfo), the "if reinstalling bzip2" stanza in 6.40, the PCRE
libs in 6.44.1 (grep), etc.
More information about the hlfs-dev