Eric Blake wrote:
> On 04/16/2012 12:22 PM, Jim Meyering wrote:
>> +++ b/top/maint.mk
>> @@ -932,8 +932,11 @@ sc_prohibit_doubled_word:
>> # A regular expression matching undesirable combinations of words like
>> # "can not"; this matches them even when the two words appear on different
>> # lines, but not when there is an intervening delimiter like "#" or "*".
>> +# Similarly undesirable, "See @xref{...}" expands to "See *Note ...".
>
> Doesn't it actually expand to "See see *Note"?
What I wrote is the expansion in "info" output.
In dvi/pdf output, it does expand to "See see Section..." (i.e., no
"*Note" there), so I'll have to revise the advice in the comment.
Per "info texinfo",
8.4 `@xref'
===========
The `@xref' command generates a cross reference for the beginning of a
sentence.
So any preceding token should be punctuation.
Thanks.
