Section on #+include keyword is missing quite some info in the org-manual.org

Section on #+include keyword is missing quite some info in the org-manual.org

[Kaushal Modi]

Hello,

I was visiting the Org manual to verify if I got the :only-contents
parameter of #+include keyword correct, and noticed that that info is
completely missing from that section in the new org-manual.org.

Reverting back to older texi, it is missing pieces like below and much more too:

#+INCLUDE: "./paper.org::#theory" :only-contents t
   @r{Include the body of the heading with the custom id @samp{theory}}
#+INCLUDE: "./paper.org::mytable"  @r{Include named element.}
#+INCLUDE: "./paper.org::*conclusion" :lines 1-20
   @r{Include the first 20 lines of the headline named @samp{conclusion}.}


If this is not intentional (looks like it's not because that feature
works great and I would miss it if it did not), I can commit update to
org-manual.org with that whole section restored from the past.

But I am wondering if things are more serious.. how do we ensure that
the org-manual.org is not missing out the useful info from the old
org.texi?

--
Kaushal Modi

Re: Section on #+include keyword is missing quite some info in the org-manual.org

[Nicolas Goaziou]

Hello,

Kaushal Modi <kaushal.modi@gmail.com> writes:

> I was visiting the Org manual to verify if I got the :only-contents
> parameter of #+include keyword correct, and noticed that that info is
> completely missing from that section in the new org-manual.org.
>
> Reverting back to older texi, it is missing pieces like below and much more too:
>
> #+INCLUDE: "./paper.org::#theory" :only-contents t
>    @r{Include the body of the heading with the custom id @samp{theory}}
>
> #+INCLUDE: "./paper.org::mytable"  @r{Include named element.}
> #+INCLUDE: "./paper.org::*conclusion" :lines 1-20
>
>    @r{Include the first 20 lines of the headline named @samp{conclusion}.}
>
>
> If this is not intentional (looks like it's not because that feature
> works great and I would miss it if it did not), I can commit update to
> org-manual.org with that whole section restored from the past.

This is not intentional. Could you re-introduce the latest revision of
that section?

> But I am wondering if things are more serious.. how do we ensure that
> the org-manual.org is not missing out the useful info from the old
> org.texi?

Eyeballing. I did it a couple of times already, but more eyes are
needed, obviously.

Thank you.

Regards,

-- 
Nicolas Goaziou

Re: Section on #+include keyword is missing quite some info in the org-manual.org

[Kaushal Modi]

[-- Attachment #1: Type: text/plain, Size: 440 bytes --]

On Wed, Sep 26, 2018 at 6:47 AM Nicolas Goaziou <mail@nicolasgoaziou.fr>
wrote:

>
> This is not intentional. Could you re-introduce the latest revision of
> that section?
>

I was just setting out to fix this in the manual, but I see that you
already did this :)

I was thinking of adding cindices like the ones you added for header
arguments.

#+cindex: @samp{minlevel}, include
#+cindex: @samp{lines}, include
.. etc.

Would that be OK?

[-- Attachment #2: Type: text/html, Size: 869 bytes --]

Re: Section on #+include keyword is missing quite some info in the org-manual.org

[Kaushal Modi]

[-- Attachment #1: Type: text/plain, Size: 421 bytes --]

On Mon, Oct 1, 2018 at 3:25 PM Kaushal Modi <kaushal.modi@gmail.com> wrote:

> I was thinking of adding cindices like the ones you added for header
> arguments.
>
> #+cindex: @samp{minlevel}, include
> #+cindex: @samp{lines}, include
> .. etc.
>
> Would that be OK?
>

I went ahead as this wasn't a major edit, and committed this in
https://code.orgmode.org/bzg/org-mode/commit/5abfdeeb8f72dfc2db324e8e731f4e16f2b54bea
.

[-- Attachment #2: Type: text/html, Size: 983 bytes --]