They are English text and English text has rules.  Accuracy
and consistency counts for English, too.

The word 'the' is not capitlized unless it begins a sentence.
Why should any other word behave differently?  I know, because
programs are special. Well, they're not - at least within the
context of English text.

I spent most of my time for two years editing these pages
for publication.  To avoid the confusion that can be introduced
by capitalizing a magic word, where possible I rewrote the
sentence to avoid the problem.  Not
    Qsort sorts data
but
    The qsort function sorts data

If you see many instances that sow such confusion, either
I missed them the first time or, more likely, they've been
edited since by someone less focused.  Fix the text.

-rob


On 12/5/05, Lyndon Nerenberg <[EMAIL PROTECTED]> wrote:
>
> On Dec 5, 2005, at 5:14 PM, Rob Pike wrote:
>
> > Sentences begin with capital letters.
>
> But not all proper names do.
>
> These are man pages, not novels.  I think consistency (accuracy,
> really) wins here.
>
> --lyndon
>

Reply via email to