"Ilya N. Golubev" <gin(a)mo.msk.ru> writes:
Texinfo documentation clearly says that `@code', not `@var'
must be
used for the names of particular variables in programming languages.
You are right. Judging by the number of places you've corrected, this
must be a very common misunderstanding. I remember that I
misunderstood @var{} as well, until I encountered the UPPERCASE
convention for specifying text that will be substituted with the
actual contents (i.e. "variable" text).
This line illustrates both the correct and the incorrect usage of
@var:
@defun ldap-decode-string str
-Decode a string @var{str} according to @var{ldap-coding-system}.
+Decode a string @var{str} according to @code{ldap-coding-system}.
@end defun
In fact, it would be even better to get rid of the "string STR"
phrase, and write the more natural:
@defun ldap-decode-string string
Decode a string @var{string} according to @code{ldap-coding-system}.
@end defun
...but that's a stylistic change that this patch doesn't (and
shouldn't) make.