Re: @var --> @code
"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.