From: Andy Shevchenko <andy.shevchenko@gmail.com>
To: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
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 21:23:32 +0300 [thread overview]
Message-ID: <CAHp75VcdMXHf=hz_m5ySZ-=fBU=qkFxry9Q-Dos9Jx0qoyHCXQ@mail.gmail.com> (raw)
In-Reply-To: <20190611140501.11ba091b@coco.lan>
On Tue, Jun 11, 2019 at 8:05 PM Mauro Carvalho Chehab
<mchehab+samsung@kernel.org> wrote:
>
> 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.
Fine to me as long as you will drop it by the mentioned effort.
--
With Best Regards,
Andy Shevchenko
WARNING: multiple messages have this Message-ID (diff)
From: Andy Shevchenko <andy.shevchenko@gmail.com>
To: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
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>
Subject: Re: [PATCH v3 06/20] docs: mark orphan documents as such
Date: Tue, 11 Jun 2019 21:23:32 +0300 [thread overview]
Message-ID: <CAHp75VcdMXHf=hz_m5ySZ-=fBU=qkFxry9Q-Dos9Jx0qoyHCXQ@mail.gmail.com> (raw)
In-Reply-To: <20190611140501.11ba091b@coco.lan>
On Tue, Jun 11, 2019 at 8:05 PM Mauro Carvalho Chehab
<mchehab+samsung@kernel.org> wrote:
>
> 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.
Fine to me as long as you will drop it by the mentioned effort.
--
With Best Regards,
Andy Shevchenko
WARNING: multiple messages have this Message-ID (diff)
From: Andy Shevchenko <andy.shevchenko@gmail.com>
To: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Cc: Linux Doc Mailing List <linux-doc@vger.kernel.org>,
David Airlie <airlied@linux.ie>,
dri-devel@lists.freedesktop.org,
Platform Driver <platform-driver-x86@vger.kernel.org>,
Paul Mackerras <paulus@samba.org>,
linux-stm32@st-md-mailman.stormreply.com,
Alexandre Torgue <alexandre.torgue@st.com>,
Jonathan Corbet <corbet@lwn.net>,
Maxime Ripard <maxime.ripard@bootlin.com>,
Andrew Donnellan <ajd@linux.ibm.com>,
Linux PM <linux-pm@vger.kernel.org>,
Maarten Lankhorst <maarten.lankhorst@linux.intel.com>,
Matan Ziv-Av <matan@svgalib.org>,
Mauro Carvalho Chehab <mchehab@infradead.org>,
Daniel Vetter <daniel@ffwll.ch>, Sean Paul <sean@poorly.run>,
linux-arm Mailing List <linux-arm-kernel@lists.infradead.org>,
Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
Maxime Coquelin <mcoquelin.stm32@gmail.com>,
Frederic Barrat <fbarrat@linux.ibm.com>,
"open list:LINUX FOR POWERPC PA SEMI PWRFICIENT"
<linuxppc-dev@lists.ozlabs.org>,
Georgi Djakov <georgi.djakov@linaro.org>
Subject: Re: [PATCH v3 06/20] docs: mark orphan documents as such
Date: Tue, 11 Jun 2019 21:23:32 +0300 [thread overview]
Message-ID: <CAHp75VcdMXHf=hz_m5ySZ-=fBU=qkFxry9Q-Dos9Jx0qoyHCXQ@mail.gmail.com> (raw)
In-Reply-To: <20190611140501.11ba091b@coco.lan>
On Tue, Jun 11, 2019 at 8:05 PM Mauro Carvalho Chehab
<mchehab+samsung@kernel.org> wrote:
>
> 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.
Fine to me as long as you will drop it by the mentioned effort.
--
With Best Regards,
Andy Shevchenko
WARNING: multiple messages have this Message-ID (diff)
From: Andy Shevchenko <andy.shevchenko@gmail.com>
To: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Cc: Linux Doc Mailing List <linux-doc@vger.kernel.org>,
David Airlie <airlied@linux.ie>,
Benjamin Herrenschmidt <benh@kernel.crashing.org>,
dri-devel@lists.freedesktop.org,
Platform Driver <platform-driver-x86@vger.kernel.org>,
Paul Mackerras <paulus@samba.org>,
linux-stm32@st-md-mailman.stormreply.com,
Alexandre Torgue <alexandre.torgue@st.com>,
Jonathan Corbet <corbet@lwn.net>,
Michael Ellerman <mpe@ellerman.id.au>,
Maxime Ripard <maxime.ripard@bootlin.com>,
Andrew Donnellan <ajd@linux.ibm.com>,
Linux PM <linux-pm@vger.kernel.org>,
Maarten Lankhorst <maarten.lankhorst@linux.intel.com>,
Matan Ziv-Av <matan@svgalib.org>,
Mauro Carvalho Chehab <mchehab@infradead.org>,
Daniel Vetter <daniel@ffwll.ch>, Sean Paul <sean@poorly.run>,
linux-arm Mailing List <linux-arm-kernel@lists.infradead.org>,
Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
Maxime Coquelin <mcoquelin.stm32@gmail.com>,
Frederic Barrat <fbarrat@linux.ibm.com>,
"open list:LINUX FOR POWERPC PA SEMI PWRFICIENT"
<linuxppc-dev@lists.ozlabs.org>,
Georgi Djakov <georgi.djakov@linaro.org>
Subject: Re: [PATCH v3 06/20] docs: mark orphan documents as such
Date: Tue, 11 Jun 2019 21:23:32 +0300 [thread overview]
Message-ID: <CAHp75VcdMXHf=hz_m5ySZ-=fBU=qkFxry9Q-Dos9Jx0qoyHCXQ@mail.gmail.com> (raw)
In-Reply-To: <20190611140501.11ba091b@coco.lan>
On Tue, Jun 11, 2019 at 8:05 PM Mauro Carvalho Chehab
<mchehab+samsung@kernel.org> wrote:
>
> 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.
Fine to me as long as you will drop it by the mentioned effort.
--
With Best Regards,
Andy Shevchenko
_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next prev parent reply other threads:[~2019-06-11 18:23 UTC|newest]
Thread overview: 60+ 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-07 18:54 ` Mauro Carvalho Chehab
2019-06-07 18:54 ` Mauro Carvalho Chehab
2019-06-07 18:54 ` Mauro Carvalho Chehab
2019-06-11 16:52 ` Andy Shevchenko
2019-06-11 16:52 ` Andy Shevchenko
2019-06-11 16:52 ` Andy Shevchenko
2019-06-11 16:52 ` Andy Shevchenko
2019-06-11 17:05 ` Mauro Carvalho Chehab
2019-06-11 17:05 ` Mauro Carvalho Chehab
2019-06-11 17:05 ` Mauro Carvalho Chehab
2019-06-11 17:05 ` Mauro Carvalho Chehab
2019-06-11 18:23 ` Andy Shevchenko [this message]
2019-06-11 18:23 ` Andy Shevchenko
2019-06-11 18:23 ` Andy Shevchenko
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 ` 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 ` 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-07 18:54 ` Mauro Carvalho Chehab
2019-06-07 18:54 ` Mauro Carvalho Chehab
2019-06-07 18:54 ` mchehab+samsung
2019-06-09 9:19 ` Geert Uytterhoeven
2019-06-09 9:19 ` Geert Uytterhoeven
2019-06-09 9:19 ` Geert Uytterhoeven
2019-06-09 9:19 ` geert
2019-06-07 18:54 ` [PATCH v3 16/20] docs: fix broken documentation links Mauro Carvalho Chehab
2019-06-07 18:54 ` Mauro Carvalho Chehab
2019-06-07 18:54 ` [Xen-devel] " Mauro Carvalho Chehab
2019-06-07 18:54 ` Mauro Carvalho Chehab
2019-06-07 18:54 ` Mauro Carvalho Chehab
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:54 ` Mauro Carvalho Chehab
2019-06-07 18:54 ` Mauro Carvalho Chehab
2019-06-07 18:57 ` Mark Brown
2019-06-08 10:51 ` Mauro Carvalho Chehab
2019-06-08 10:51 ` Mauro Carvalho Chehab
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 19:07 ` 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-07 18:54 ` Mauro Carvalho Chehab
2019-06-08 15:37 ` Paul E. McKenney
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='CAHp75VcdMXHf=hz_m5ySZ-=fBU=qkFxry9Q-Dos9Jx0qoyHCXQ@mail.gmail.com' \
--to=andy.shevchenko@gmail.com \
--cc=airlied@linux.ie \
--cc=ajd@linux.ibm.com \
--cc=alexandre.torgue@st.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+samsung@kernel.org \
--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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.