From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: martin rudalics Newsgroups: gmane.emacs.devel Subject: Re: emacs-26 07ea5ef99a: Fix reference style in org.texi Date: Mon, 02 Oct 2017 08:46:19 +0200 Message-ID: <59D1E0BB.9060202@gmx.at> References: <873772qswe.fsf@kyleam.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1506926845 3555 195.159.176.226 (2 Oct 2017 06:47:25 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 2 Oct 2017 06:47:25 +0000 (UTC) Cc: emacs-devel@gnu.org To: Kyle Meyer Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Oct 02 08:47:17 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dyuVX-0007nz-EC for ged-emacs-devel@m.gmane.org; Mon, 02 Oct 2017 08:47:15 +0200 Original-Received: from localhost ([::1]:50910 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dyuVZ-0006B6-Du for ged-emacs-devel@m.gmane.org; Mon, 02 Oct 2017 02:47:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40011) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dyuUx-0006At-6J for emacs-devel@gnu.org; Mon, 02 Oct 2017 02:46:40 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dyuUr-0001FN-LD for emacs-devel@gnu.org; Mon, 02 Oct 2017 02:46:39 -0400 Original-Received: from mout.gmx.net ([212.227.15.19]:57960) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dyuUr-0001EO-C3 for emacs-devel@gnu.org; Mon, 02 Oct 2017 02:46:33 -0400 Original-Received: from [192.168.1.100] ([46.125.250.13]) by mail.gmx.com (mrgmx001 [212.227.17.190]) with ESMTPSA (Nemesis) id 0M1nbu-1dAfQP0c4w-00thJm; Mon, 02 Oct 2017 08:46:27 +0200 In-Reply-To: <873772qswe.fsf@kyleam.com> X-Provags-ID: V03:K0:ETglmpfDWdHVYJTdMt1HPqn9w0AdgxaH61RXtagXAPR5UrhUhLy eQ0dvTsaekfPqwOuXoU/yyvgg2AM8IvJ7P2Dp4HtR+Km0dsEG3U+IjL+GFxwR64ZLqMzAiY N1n9XN1rrCWFNqaMTHmMTgbrAxvEg0I72qarKqD4LX5tPQardXnhxbxu+lFbMVS68f5cneL jyrmLmdTQAelGYImD8IjQ== X-UI-Out-Filterresults: notjunk:1;V01:K0:b1uHPFE2S4E=:tt4BbHVorarYsRsAWVoaGm hz6yIj7AnFmy3LqyQ8djDXDqORGOdJxPZkdbY11zsv2xgYLLLGOkoO1erJa58OG5nv6JOEaPS ayfdsqOQOVyAplbvRRX3COoqSxttADMBVkDhL4bC+g2CAA8ghZbw2Q25wM0lskH77OcdXushM t8QEm3i4Dd8oOKtZaAJlehLzrZAbo1pLcYMA2XsycgYRiNPvR+q88KWKWqefbeLKrS2b5y4TE RuOe4aIg1KrPF088xNu5JzC1bTF43FkDtgKuhypR6v8yGAtjald8bXanhXLTZ9Yhc2J8KmO7h saFb+FBROng/5fShvVeB2IEQuxgH6x9vl75kys8EnqNVWcLIHYCiJTfqpcMUQiUi2rfWNelyh /fS0YdVlgA7Zb68HDrdCUljdaKXWB5AbKGgMdWt7mzLwSs0vdoURLmDPG1ONrrFbhZI431Wo2 qn7qyIjiKrjA+saV5zvNZoHQoyI5+Dok7VffnwWIitmNt+eSm7kBZKFNbQCa5/2+2yvWjXgSu kbdeydiN64wzSAUfMxmZ2m4tOxup2Faj9GEr9yVle/P8RRILR1W+qHrg7YQ9knLRl524zV7T1 fSbsV1rlkZUOLa+krA54wHsL89aa2yS8QddaigIiNSUnNpLtoSJgODdWiu+BhWjPpkdt4hFT5 +WLdoiegjYqIf7vlfWg4r90J56ddZbOW51BJ4Nim12kKznbpCRNZdBab8PrfvHb/MwcpAPk5d 4zAkmDsJJrQsOAunR5d+2GSDuWBttv1iyq0Ias8AKBH7n3hkEej6rAqM0eoHTcjKiJ+7XPBT X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 212.227.15.19 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:219001 Archived-At: > I'm reviewing this commit for backport to the Org repo, and I don't > understand what it's fixing. Both variants seem to produce the > equivalent output. Could you please explain to me what the difference > is? The output _should_ be equivalent. But section 8.4.1 of the texinfo manual says here: Caution: A period or comma *must* follow the closing brace of an `@xref'. It is required to terminate the cross reference. This period or comma will appear in the output, both in the Info file and in the printed manual. And your version got me the following warning (with makeinfo 4.13): GEN ../../../doc/misc/../../info/org.info ../../../doc/misc/org.texi:14038: warning: `.' or `,' must follow @xref, not `f'. Maybe this has been changed for current versions of texinfo but 4.13 is still permitted to build Emacs (at least on slower systems). My commit message should have explained that but I initially wanted to mark it as marginal so I did not bother. Apologies for any inconvenience, martin