bug-gnulib
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH] maint.mk: catch "see @xref{}"


From: Jim Meyering
Subject: Re: [PATCH] maint.mk: catch "see @xref{}"
Date: Mon, 16 Apr 2012 21:06:32 +0200

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 address@hidden'
    ===========

    The address@hidden' command generates a cross reference for the beginning 
of a
    sentence.

So any preceding token should be punctuation.

Thanks.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]