Index: texinfo.texi =================================================================== --- texinfo.texi (révision 5369) +++ texinfo.texi (copie de travail) @@ -6309,7 +6309,11 @@ (Note that in the preceding example the closing brace is followed by a comma, and then by the clause, which is followed by a period.) +The second argument to the xref commands must observe some +restrictions for node names described in @ref{Node Line Requirements}. +The issue you're most likely to run into is that colons cannot be used. + @node Three Arguments @subsection @code{@@xref} with Three Arguments @cindex Three-argument form of cross references @@ -6321,12 +6325,7 @@ reference is printed. Use a third argument when the node name is unsuitable because of syntax or meaning. -The third argument to the xref commands must observe the same -restrictions as node names described in @ref{Node Line Requirements}. -The issue you're most likely to run into is that commas, periods, and -colons cannot be used. - -Also, remember to write a comma or period after the closing brace of an +Remember to write a comma or period after the closing brace of an @code{@@xref} to terminate the cross reference. In the following examples, a clause follows a terminating comma. @@ -6396,6 +6395,10 @@ @noindent in a printed manual. +In that case, the third argument to the xref commands must observe some +restrictions for node names described in @ref{Node Line Requirements}. +The issue you're most likely to run into is that colons cannot be used. + As a practical matter, it is often best to write cross references with just the first argument if the node name and the section title are the same (or nearly so), and with the first and third arguments only if the