Re: [Emacs-diffs] /srv/bzr/emacs/trunk r110632: * text.texi (Org Authoring): Change @ref to @pxref.

[Bastien <bzg@gnu.org>]

Eli Zaretskii <eliz@gnu.org> writes:

> This change is wrong:
>
>> === modified file 'doc/emacs/text.texi'
>> --- a/doc/emacs/text.texi	2012-06-17 05:13:40 +0000
>> +++ b/doc/emacs/text.texi	2012-10-23 16:12:59 +0000
>> @@ -1399,7 +1399,7 @@
>>  #+end_example
>>  @end example
>>  
>> -  For further details, see @ref{Exporting,,,org, The Org Manual} and
>> +  For further details, @pxref{Exporting,,,org, The Org Manual}, and
>>  @ref{Publishing,,,org, The Org Manual}.
>
> @pxref should only be used inside parentheses.  

Then (info "(texinfo)ref") is giving a misleading example:

8.6 `@ref'
==========

`@ref' is nearly the same as `@xref' except that it does not generate a
`See' in the printed output, just the reference itself.  This makes it
useful as the last part of a sentence.

For example,

     For more information, @pxref{This}, and @ref{That}.

> What was the problem with "see @ref", apart of the fact that a comma
> was missing after the closing brace?

The period after the first ref@{...} in the info documentation.

See at the end of (info "(emacs)Org Authoring"):

   For further details, see *note Exporting: (org)Exporting. and *note Publishing:
 (org)Publishing.                                   ^^^

-- 
 Bastien