From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Documentation fix
Date: Wed, 24 May 2017 17:43:22 +0200
Message-ID: <87o9uiclb9.fsf@nicolasgoaziou.fr>
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>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:43765)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dDYRm-0006Xy-Cj
	for emacs-orgmode@gnu.org; Wed, 24 May 2017 11:43:39 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dDYRj-000175-95
	for emacs-orgmode@gnu.org; Wed, 24 May 2017 11:43:38 -0400
Received: from relay4-d.mail.gandi.net ([217.70.183.196]:39956)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1dDYRj-00016h-35
	for emacs-orgmode@gnu.org; Wed, 24 May 2017 11:43:35 -0400
In-Reply-To: <87mva2xupr.fsf@yandex.com> (Colin Baxter's message of "Wed, 24
	May 2017 14:14:40 +0100")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Colin Baxter <m43cap@yandex.com>
Cc: emacs-orgmode@gnu.org, Robert Klein <roklein@roklein.de>

Hello,

Colin Baxter <m43cap@yandex.com> 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

[...]

>
> The 'make all' process continues satisfactorily to its conclusion.

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.

This would be wrong. The @orgcmd macro above already introduces @item,
so the second one really needs to be @itemx.

One solution would be to replace the @itemx ... with @xorgkey, @xorgcmd,
or @xorgcmdnki depending on the needs. But then, it would fall-back to
the other warning, i.e., a @table without any @item (all are
@orgsomething macros).

I'm no Texinfo expert, so I'm not sure what is the best way to handle
this. Maybe also create a special macro that would create a table. It
sounds convoluted, though.

Regards,

-- 
Nicolas Goaziou