From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii 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 22:36:07 +0200 Message-ID: <83pq49apu0.fsf@gnu.org> References: <83txtlat5d.fsf@gnu.org> <87mwzdufud.fsf@bzg.ath.cx> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1351024579 3715 80.91.229.3 (23 Oct 2012 20:36:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 23 Oct 2012 20:36:19 +0000 (UTC) Cc: emacs-devel@gnu.org To: Bastien Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Oct 23 22:36:27 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 1TQlD9-00020o-F5 for ged-emacs-devel@m.gmane.org; Tue, 23 Oct 2012 22:36:27 +0200 Original-Received: from localhost ([::1]:45237 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQlD1-00080Q-Rc for ged-emacs-devel@m.gmane.org; Tue, 23 Oct 2012 16:36:19 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:40053) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQlCy-000809-JX for emacs-devel@gnu.org; Tue, 23 Oct 2012 16:36:17 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TQlCu-00077W-5e for emacs-devel@gnu.org; Tue, 23 Oct 2012 16:36:16 -0400 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:37080) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQlCs-00076A-89; Tue, 23 Oct 2012 16:36:10 -0400 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MCD00D0057M0C00@a-mtaout20.012.net.il>; Tue, 23 Oct 2012 22:36:08 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MCD00C4F588K9C0@a-mtaout20.012.net.il>; Tue, 23 Oct 2012 22:36:08 +0200 (IST) In-reply-to: <87mwzdufud.fsf@bzg.ath.cx> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-Received-From: 80.179.55.166 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:154485 Archived-At: > From: Bastien > Cc: emacs-devel@gnu.org > Date: Tue, 23 Oct 2012 21:51:38 +0200 > > > @pxref should only be used inside parentheses. > > Then (info "(texinfo)ref") is giving a misleading example: Indeed, it does. The next node in the Texinfo manual says: The parenthetical reference command, `@pxref', is nearly the same as `@xref', but it is best used at the end of a sentence or before a closing parenthesis. The place where you used it is neither of these two. > > 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. ^^^ If I add a comma after the first @ref, like this: For further details, see @ref{Exporting,,,org, The Org Manual}, and @ref{Publishing,,,org, The Org Manual}. ^^^ there's no period in the Info output: For further details, see *note Exporting: (org)Exporting, and *note Publishing: (org)Publishing.