[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [O] Documentation fix
From: |
Nicolas Goaziou |
Subject: |
Re: [O] Documentation fix |
Date: |
Wed, 24 May 2017 17:43:22 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux) |
Hello,
Colin Baxter <address@hidden> 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
- [O] Documentation fix, Robert Klein, 2017/05/15
- Re: [O] Documentation fix, Nicolas Goaziou, 2017/05/15
- Re: [O] Documentation fix, Robert Klein, 2017/05/15
- Re: [O] Documentation fix, Nicolas Goaziou, 2017/05/15
- Re: [O] Documentation fix, Colin Baxter, 2017/05/15
- Re: [O] Documentation fix, Nicolas Goaziou, 2017/05/15
- Re: [O] Documentation fix, Colin Baxter, 2017/05/15
- Re: [O] Documentation fix, Nicolas Goaziou, 2017/05/23
- Re: [O] Documentation fix, Colin Baxter, 2017/05/24
- Re: [O] Documentation fix,
Nicolas Goaziou <=
- Re: [O] Documentation fix, Colin Baxter, 2017/05/25