From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Bastien Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] /srv/bzr/emacs/trunk r110632: * text.texi (Org Authoring): Change @ref to @pxref. Date: Tue, 23 Oct 2012 21:51:38 +0200 Message-ID: <87mwzdufud.fsf@bzg.ath.cx> References: <83txtlat5d.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1351021897 11855 80.91.229.3 (23 Oct 2012 19:51:37 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 23 Oct 2012 19:51:37 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Oct 23 21:51:45 2012 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TQkVq-0002Vi-B5 for ged-emacs-devel@m.gmane.org; Tue, 23 Oct 2012 21:51:42 +0200 Original-Received: from localhost ([::1]:60800 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQkVi-0006J5-Q7 for ged-emacs-devel@m.gmane.org; Tue, 23 Oct 2012 15:51:34 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:48913) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQkVg-0006Ip-19 for emacs-devel@gnu.org; Tue, 23 Oct 2012 15:51:32 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TQkVa-0000hO-Ad for emacs-devel@gnu.org; Tue, 23 Oct 2012 15:51:31 -0400 Original-Received: from mail-wg0-f49.google.com ([74.125.82.49]:40591) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQkVV-0000eK-88; Tue, 23 Oct 2012 15:51:21 -0400 Original-Received: by mail-wg0-f49.google.com with SMTP id gg4so2504043wgb.30 for ; Tue, 23 Oct 2012 12:51:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type; bh=JijKw7KrBvgG008g4n5SnHhwiLmEl9BIp3F4/MRRx/0=; b=cWQEzoaQgDqlCMNrF7dmW5wSS2o6pHxEqIv3cL5vXYhd2LCpPI58QF0Ski1dJVp6Qm 8EKfn9aF1JjLJn495TByGo1jGIkm090E3H8nQURofG2kj4+uXfHHliZICE2cj/0do/jW IG1Xy2I7PaKTapibKHHueJp3HrXYqVe2X8IOBiFeIN0pkiN6Sfqx0qZFwuyF0Ot4gBsz p1HEDS+PWLutMHnttoChGLP+eCiDWVaQnjrdQSY2y9A1UxfxQ3l1RV0HWpa9Qj69u3IB 31YMd8v6XjK34Z5aAAM8fbyhwnmtkfj9de720Lq6pLxaVg6U3qsMoywKN+DR/mXEK9Mc eYlw== Original-Received: by 10.180.99.194 with SMTP id es2mr364860wib.15.1351021880261; Tue, 23 Oct 2012 12:51:20 -0700 (PDT) Original-Received: from bzg.localdomain (mar75-2-81-56-68-112.fbx.proxad.net. [81.56.68.112]) by mx.google.com with ESMTPS id f1sm393054wiy.2.2012.10.23.12.51.18 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 23 Oct 2012 12:51:19 -0700 (PDT) Original-Received: by bzg.localdomain (Postfix, from userid 1000) id 3E58922E87; Tue, 23 Oct 2012 21:51:38 +0200 (CEST) In-Reply-To: <83txtlat5d.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 23 Oct 2012 21:24:30 +0200") User-Agent: Gnus/5.130006 (Ma Gnus v0.6) Emacs/24.2.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 74.125.82.49 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:154484 Archived-At: Eli Zaretskii 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