From mboxrd@z Thu Jan  1 00:00:00 1970
From: Kaushal Modi <kaushal.modi@gmail.com>
Subject: Section on #+include keyword is missing quite some info in the
 org-manual.org
Date: Tue, 25 Sep 2018 22:23:39 -0400
Message-ID: <CAFyQvY3oeSo__MwtXgqtxrwBU7PhoJb0kpCvaxR5yw2TEfXAfQ@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:48886)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kaushal.modi@gmail.com>) id 1g4ziD-0004Ta-1s
	for emacs-orgmode@gnu.org; Tue, 25 Sep 2018 22:38:01 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <kaushal.modi@gmail.com>) id 1g4zUw-00085S-Ui
	for emacs-orgmode@gnu.org; Tue, 25 Sep 2018 22:24:19 -0400
Received: from mail-lj1-x233.google.com ([2a00:1450:4864:20::233]:45424)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <kaushal.modi@gmail.com>)
	id 1g4zUw-00084z-Mg
	for emacs-orgmode@gnu.org; Tue, 25 Sep 2018 22:24:18 -0400
Received: by mail-lj1-x233.google.com with SMTP id x16-v6so17238883ljd.12
	for <emacs-orgmode@gnu.org>; Tue, 25 Sep 2018 19:24:18 -0700 (PDT)
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: emacs-org list <emacs-orgmode@gnu.org>

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