Re: doc-strings: T vs t

[Gerd Moellmann]

address@hidden (Pavel Janík) writes:

> Hi,
> 
> some variables/predicates have doc-strings beginning with T, like
> input-pending-p:
> 
> T if command input ...
> 
> Others like lucid-menu-bar-dirty-flag have doc-strings with t at the
> beginning:
> 
> t means menu bar...
> 
> Generally: how should we wrote the t, nil or functions names in the
> doc-strings at the beginning of sentences?

I've always just avoided that case by reformulating the doc.  Does
lispref/tips.texi say anything about this?  Maybe it should if it
doesn't.

> I do not think, that using T, Nil or (e.g.) Forward-char is good. 

Agreed.