[Info-vax] Writer advice requested

[AEF]

On Nov 10, 3:42 am, DTL <didier.mora... at gmail.com> wrote:
> Folks,
>
> I'm heavily documenting a rather complicated script I wrote doing
> "advanced" error management within VBScripts.
> Should I limit the width of my comments to 80 c. then <CR><LF> ? To
> 132c. ? Should I not limit their length?
> What do you think?
> (I'm talking about full lines comments, not end of line comments).
>
> Thanks.

I am including more than is necessary, but I'm doing it for context
and with the hope that webpage designers will take heed, as I'm tired
of reading those really long lines that you can't shorten by making
the window smaller. (It makes it more like reading a lease!):


<quote>

Before customizing the document style, remember that many authors make
elementary errors when they try to design their own documents. The
only way to avoid these errors is by consulting a trained typographic
designer or reading about typographic design. All I can do here is
warn you against the very common mistake of making lines that are too
wide to read easily -- a mistake you won't make if you follow this
suggestion:


_use lines that contain no more than 75 characters, including
punctuation and spaces._


</quote>

This is from p. 85 of "LaTeX: user's guide & reference manual" by
Leslie Lamport.

The bottom line: To avoid making lines that are too wide to read
easily,


*** Use lines that contain no more than 75 characters, including
punctuation and spaces. ***


I'd think that with fixed-width font you might want to reduce this to
somewhere between 68 and 72.

AEF