From: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
To: Andy Shevchenko <andy.shevchenko@gmail.com>
Cc: Linux Doc Mailing List <linux-doc@vger.kernel.org>,
Mauro Carvalho Chehab <mchehab@infradead.org>,
Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
Jonathan Corbet <corbet@lwn.net>,
Frederic Barrat <fbarrat@linux.ibm.com>,
Andrew Donnellan <ajd@linux.ibm.com>,
Maxime Coquelin <mcoquelin.stm32@gmail.com>,
Alexandre Torgue <alexandre.torgue@st.com>,
David Airlie <airlied@linux.ie>, Daniel Vetter <daniel@ffwll.ch>,
Maarten Lankhorst <maarten.lankhorst@linux.intel.com>,
Maxime Ripard <maxime.ripard@bootlin.com>,
Sean Paul <sean@poorly.run>,
Georgi Djakov <georgi.djakov@linaro.org>,
Matan Ziv-Av <matan@svgalib.org>,
Benjamin Herrenschmidt <benh@kernel.crashing.org>,
Paul Mackerras <paulus@samba.org>,
Michael Ellerman <mpe@ellerman.id.au>,
"open list:LINUX FOR POWERPC PA SEMI PWRFICIENT"
<linuxppc-dev@lists.ozlabs.org>,
linux-stm32@st-md-mailman.stormreply.com,
linux-arm Mailing List <linux-arm-kernel@lists.infradead.org>,
dri-devel@lists.freedesktop.org,
Linux PM <linux-pm@vger.kernel.org>,
Platform Driver <platform-driver-x86@vger.kernel.org>
Subject: Re: [PATCH v3 06/20] docs: mark orphan documents as such
Date: Tue, 11 Jun 2019 14:05:01 -0300 [thread overview]
Message-ID: <20190611140501.11ba091b@coco.lan> (raw)
In-Reply-To: <CAHp75VfTNJOGZx-PoUXLRvzghqf6bVUdJ+yFjE9hNtDLCQ1=UA@mail.gmail.com>
Em Tue, 11 Jun 2019 19:52:04 +0300
Andy Shevchenko <andy.shevchenko@gmail.com> escreveu:
> On Fri, Jun 7, 2019 at 10:04 PM Mauro Carvalho Chehab
> <mchehab+samsung@kernel.org> wrote:
> > Sphinx doesn't like orphan documents:
>
> > Documentation/laptops/lg-laptop.rst: WARNING: document isn't included in any toctree
>
> > Documentation/laptops/lg-laptop.rst | 2 ++
>
> > diff --git a/Documentation/laptops/lg-laptop.rst b/Documentation/laptops/lg-laptop.rst
> > index aa503ee9b3bc..f2c2ffe31101 100644
> > --- a/Documentation/laptops/lg-laptop.rst
> > +++ b/Documentation/laptops/lg-laptop.rst
> > @@ -1,5 +1,7 @@
> > .. SPDX-License-Identifier: GPL-2.0+
> >
> > +:orphan:
> > +
> > LG Gram laptop extra features
> > =============================
> >
>
> Can we rather create a toc tree there?
> It was a first document in reST format in that folder.
Sure, but:
1) I have a patch converting the other files on this dir to rst:
https://git.linuxtv.org/mchehab/experimental.git/commit/?h=convert_rst_renames_v4.1&id=abc13233035fdfdbc5ef2f2fbd3d127a1ab15530
2) It probably makes sense to move the entire dir to
Documentation/admin-guide.
So, I would prefer to have the :orphan: here while (1) is not merged.
Thanks,
Mauro
next prev parent reply other threads:[~2019-06-11 17:05 UTC|newest]
Thread overview: 28+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-06-07 18:54 [PATCH v3 01/20] ABI: sysfs-devices-system-cpu: point to the right docs Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 02/20] isdn: mISDN: remove a bogus reference to a non-existing doc Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 03/20] docs: zh_CN: get rid of basic_profiling.txt Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 04/20] docs: mm: numaperf.rst: get rid of a build warning Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 05/20] docs: bpf: get rid of two warnings Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 06/20] docs: mark orphan documents as such Mauro Carvalho Chehab
2019-06-11 16:52 ` Andy Shevchenko
2019-06-11 17:05 ` Mauro Carvalho Chehab [this message]
2019-06-11 18:23 ` Andy Shevchenko
2019-06-07 18:54 ` [PATCH v3 07/20] docs: amd-memory-encryption.rst get rid of warnings Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 08/20] docs: zh_CN: avoid duplicate citation references Mauro Carvalho Chehab
2019-06-10 3:52 ` Alex Shi
2019-06-07 18:54 ` [PATCH v3 09/20] docs: it: license-rules.rst: get rid of warnings Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 10/20] docs: gpio: driver.rst: fix a bad tag Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 11/20] docs: security: trusted-encrypted.rst: fix code-block tag Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 12/20] docs: security: core.rst: Fix several warnings Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 13/20] docs: net: dpio-driver.rst: fix two codeblock warnings Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 14/20] docs: net: sja1105.rst: fix table format Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 15/20] docs: move protection-keys.rst to the core-api book Mauro Carvalho Chehab
2019-06-09 9:19 ` Geert Uytterhoeven
2019-06-07 18:54 ` [PATCH v3 17/20] dt: bindings: fix some broken links from txt->yaml conversion Mauro Carvalho Chehab
2019-06-07 18:57 ` Mark Brown
2019-06-08 10:51 ` Mauro Carvalho Chehab
2019-06-07 19:07 ` Applied "ASoC: dt-bindings: fix some broken links from txt->yaml conversion" to the asoc tree Mark Brown
2019-06-07 18:54 ` [PATCH v3 18/20] docs: isdn: remove hisax references from kernel-parameters.txt Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 19/20] docs: fs: fix broken links to vfs.txt with was renamed to vfs.rst Mauro Carvalho Chehab
2019-06-07 18:54 ` [PATCH v3 20/20] docs: pci: fix broken links due to conversion from pci.txt to pci.rst Mauro Carvalho Chehab
2019-06-08 15:37 ` Paul E. McKenney
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20190611140501.11ba091b@coco.lan \
--to=mchehab+samsung@kernel.org \
--cc=airlied@linux.ie \
--cc=ajd@linux.ibm.com \
--cc=alexandre.torgue@st.com \
--cc=andy.shevchenko@gmail.com \
--cc=benh@kernel.crashing.org \
--cc=corbet@lwn.net \
--cc=daniel@ffwll.ch \
--cc=dri-devel@lists.freedesktop.org \
--cc=fbarrat@linux.ibm.com \
--cc=georgi.djakov@linaro.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-pm@vger.kernel.org \
--cc=linux-stm32@st-md-mailman.stormreply.com \
--cc=linuxppc-dev@lists.ozlabs.org \
--cc=maarten.lankhorst@linux.intel.com \
--cc=matan@svgalib.org \
--cc=maxime.ripard@bootlin.com \
--cc=mchehab@infradead.org \
--cc=mcoquelin.stm32@gmail.com \
--cc=mpe@ellerman.id.au \
--cc=paulus@samba.org \
--cc=platform-driver-x86@vger.kernel.org \
--cc=sean@poorly.run \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).