From mboxrd@z Thu Jan 1 00:00:00 1970 From: Colin Baxter Subject: Re: Documentation fix Date: Thu, 25 May 2017 12:07:31 +0100 Message-ID: <87r2zdqjnw.fsf@yandex.com> References: <20170515083420.330b18ae@pckr186.mpip-mainz.mpg.de> <874lwmzkm5.fsf@nicolasgoaziou.fr> <20170515091327.06ffc503@pckr186.mpip-mainz.mpg.de> <87vap2xr1y.fsf@nicolasgoaziou.fr> <87r2zq1bd3.fsf@yandex.com> <87mvaexg8t.fsf@nicolasgoaziou.fr> <87mvad29zp.fsf@yandex.com> <8737bve5tg.fsf@nicolasgoaziou.fr> <87mva2xupr.fsf@yandex.com> <87o9uiclb9.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:33362) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dDqcJ-00081V-UV for emacs-orgmode@gnu.org; Thu, 25 May 2017 07:07:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dDqcF-000485-Uk for emacs-orgmode@gnu.org; Thu, 25 May 2017 07:07:43 -0400 Received: from forward5j.cmail.yandex.net ([5.255.227.23]:52165) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dDqcF-00045S-FQ for emacs-orgmode@gnu.org; Thu, 25 May 2017 07:07:39 -0400 In-Reply-To: <87o9uiclb9.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Wed, 24 May 2017 17:43:22 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Nicolas Goaziou Cc: emacs-orgmode@gnu.org, Robert Klein Dear Nicolas, >>>>> "NG" == Nicolas Goaziou writes: NG> Hello, Colin Baxter writes: >> I've appended (inline) the warnings associated with the >> documentation output of 'make all', removing extraneous output. >> >> ---- Begin -------- org-version: 9.0.7 >> (release_9.0.7-478-g30ceb5) makeinfo --no-split org.texi -o org >> makeinfo --html --number-sections --no-split -o org.html org.texi >> texi2pdf --batch --clean --expand org.texi -:1267: warning: >> @itemx should not begin @table -:1345: warning: @table has text >> but no @item NG> [...] >> >> The 'make all' process continues satisfactorily to its >> conclusion. NG> These are innocuous warnings. >> Deleting the 'x' from 'itemx' in org.texi at the lines >> corresponding to the warnings '@itemx should not begin @table', >> that is, at lines 1267, 7819, 10342, removes those >> warnings. That's all the patch did. NG> This would be wrong. The @orgcmd macro above already introduces NG> @item, so the second one really needs to be @itemx. Yes, I see that. NG> One solution would be to replace the @itemx ... with @xorgkey, NG> @xorgcmd, or @xorgcmdnki depending on the needs. But then, it NG> would fall-back to the other warning, i.e., a @table without any NG> @item (all are @orgsomething macros). NG> I'm no Texinfo expert, so I'm not sure what is the best way to NG> handle this. Maybe also create a special macro that would create NG> a table. It sounds convoluted, though. I'll look at this more carefully and see what I can do - if anything. It will have to wait until I have the time, though. Best wishes, Colin. -- -- Colin Baxter m43cap@yandex.com GnuPG fingerprint: 68A8 799C 0230 16E7 BF68 2A27 BBFA 2492 91F5 41C8