For me, as a reader whose mother language isn't English, the
old words bring a little difficulty to catch the meaning, this
patch rewords the subsection in a more clarificatory way.
This patch also add blank lines as separator at two places
to improve readability.
Signed-off-by: Wang YanQing
---
On Fri, 4 May 2018 18:10:44 +0100
Robin Murphy wrote:
> Hi Kim,
Hi Robin,
> On 04/05/18 01:30, Kim Phillips wrote:
> > On Tue, 1 May 2018 12:54:05 +0100
> > Will Deacon wrote:
> >> On Fri, Apr 27, 2018 at 11:56:25AM -0500, Kim Phillips wrote:
> >>> On Fri, 27 Apr 2018 17:09:14 +0100
> >>> Will
On Mon, May 07, 2018 at 07:57:12PM -0400, Waiman Long wrote:
> On 05/07/2018 06:39 PM, Luis R. Rodriguez wrote:
> > On Mon, May 07, 2018 at 04:59:09PM -0400, Waiman Long wrote:
> >> A user can write arbitrary integer values to msgmni and shmmni sysctl
> >> parameters without getting error, but the
On Wed, May 09, 2018 at 12:35:40PM -0600, Jonathan Corbet wrote:
> On Wed, 9 May 2018 17:20:26 +0200
> Peter Zijlstra wrote:
>
> > The whole rst wankery is detrimental to that interface in order to
> > pander to something else.. I don't see the value. I've objected before,
> > and I suppose I'll
On Wed, 9 May 2018, Mauro Carvalho Chehab wrote:
> The script:
> ./scripts/documentation-file-ref-check --fix-rst
>
> Gives multiple hints for broken references on some files.
> Manually use the one that applies for some files.
>
> Signed-off-by: Mauro Carvalho Chehab
Acked-by: James Mo
> Am 09.05.2018 um 20:35 schrieb Jonathan Corbet :
>
>> Why should I care for people not using text editors to write code?
Eh? .. why must readers write code?
We have rules how to write kernel-doc markup since the beginning of the century.
If you do not want to contribute kernel-doc markups, th
On Wed, 9 May 2018 17:20:26 +0200
Peter Zijlstra wrote:
> The whole rst wankery is detrimental to that interface in order to
> pander to something else.. I don't see the value. I've objected before,
> and I suppose I'll object again.
One person's wankery is another's integrated, browsable, and s
On Mon, 7 May 2018 06:35:52 -0300
Mauro Carvalho Chehab wrote:
> Gets rid of those warnings and better document the parameters.
>
> ./include/linux/mtd/rawnand.h:752: warning: Function parameter or member
> 'timings.sdr' not described in 'nand_data_interface'
> ./include/linux/mtd/rawnand.
On Wed, May 09, 2018 at 08:45:18AM -0600, Jonathan Corbet wrote:
> On Wed, 9 May 2018 10:41:20 +0200
> Peter Zijlstra wrote:
>
> > > This is easily done by using "::" instead of just ":".
> >
> > And I'll voice my objection once again. This makes a regular comment
> > worse. This rst stuff is
Em Wed, 9 May 2018 10:18:47 -0300
Mauro Carvalho Chehab escreveu:
> commit 5d6d1ddd2730 ("firmware: move firmware loader into its own directory")
> and other commits renamed the old firmware_class.c file and split it
> into separate files, but documentation was not changed accordingly,
> causing
On Wed, 9 May 2018 10:41:20 +0200
Peter Zijlstra wrote:
> > This is easily done by using "::" instead of just ":".
>
> And I'll voice my objection once again. This makes a regular comment
> worse. This rst stuff is utter shit for making normal text files less
> readable in your favourite text
Em Wed, 9 May 2018 15:43:19 +0200
Andrea Parri escreveu:
> Hi Mauro,
>
> On Wed, May 09, 2018 at 10:18:51AM -0300, Mauro Carvalho Chehab wrote:
> > There's a github URL there, but it is not prefixed by https.
> > Add a prefix, to avoid false-positives with:
> > ./scripts/documentation-file-r
Hi Mauro,
On Wed, May 09, 2018 at 10:18:51AM -0300, Mauro Carvalho Chehab wrote:
> There's a github URL there, but it is not prefixed by https.
> Add a prefix, to avoid false-positives with:
> ./scripts/documentation-file-ref-check
>
> As a side effect, Sphinx should also generate a cross-r
Em Wed, 9 May 2018 14:22:21 +0200
Boris Brezillon escreveu:
> On Wed, 9 May 2018 09:10:34 -0300
> Mauro Carvalho Chehab wrote:
>
> > Hi Boris,
> >
> > Em Mon, 7 May 2018 08:32:32 -0300
> > Mauro Carvalho Chehab escreveu:
> >
> > > Hi Boris,
> > >
> > > Em Mon, 7 May 2018 11:46:50 +0200
>
As stated at:
http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#footnotes
A footnote should contain either a number, a reference or
an auto number, e. g.:
[1], [#f1] or [#].
While using [*] accidentaly works for html, it fails for other
document outputs. In p
There's a github URL there, but it is not prefixed by https.
Add a prefix, to avoid false-positives with:
./scripts/documentation-file-ref-check
As a side effect, Sphinx should also generate a cross-ref.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/core-api/refcount-vs-atomic.
./Documentation/crypto/crypto_engine.rst:13: WARNING: Unexpected indentation.
./Documentation/crypto/crypto_engine.rst:15: WARNING: Block quote ends without
a blank line; unexpected unindent.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/crypto/crypto_engine.rst | 8 +---
1 file ch
The location of the dt bindings file is wrong: it was probably
badly renamed by some script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/admin-guide/ramoops.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/admin-guide/ramoops.rst
b/Documentation/a
commit 5d6d1ddd2730 ("firmware: move firmware loader into its own directory")
and other commits renamed the old firmware_class.c file and split it
into separate files, but documentation was not changed accordingly,
causing Sphinx errors.
Fixes for other files were already applied but dell_rbu.txt
/devel/v4l/docs/Documentation/driver-api/uio-howto.rst:715: WARNING: Unexpected
indentation.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/driver-api/uio-howto.rst | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/Documentation/driver-api/uio-howto.rst
b/Documentat
The original shell script works, but:
1) it is too slow;
2) it is hard to exclude rejex patterns
Convert it to perl.
Here, the new version is able to check the entire tree in
less than a second (after cached):
real0m0,284s
user0m0,668s
sys 0m0,
The script:
./scripts/documentation-file-ref-check --fix-rst
Gives multiple hints for broken references on some files.
Manually use the one that applies for some files.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/ABI/obsolete/sysfs-gpio | 2 +-
.../devicet
Changeset 9919cba7ff71 ("watchdog: Update documentation") updated
the documentation, removing the old nmi_watchdog.txt and adding
a file with a new content.
Update Kconfig files accordingly.
Fixes: 9919cba7ff71 ("watchdog: Update documentation")
Signed-off-by: Mauro Carvalho Chehab
---
arch/ar
The cgroup-v2.txt is already in ReST format. So, move it to the
admin-guide, where it belongs.
Cc: Tejun Heo
Cc: Li Zefan
Cc: Johannes Weiner
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/00-INDEX | 2 --
Documentation/{cgroup-v2.txt => admin-guide
Hi Jon,
Patches 1 to 5 on this series contain the patches that weren't yet
applied from the past patch series and touch only at Documentation.
There are two changes there:
patch 2: fixed the description and added a c/c to cgroup maintainers;
patch 4: rewritten according with Louis request, dro
On Wed, 9 May 2018 09:32:18 -0300
Mauro Carvalho Chehab wrote:
> > Looks good to me, thank you!
> > What tree should this be forwarded to, or folks from linux doc will pick it
> > up?
> >
> > Acked-by: Evgeniy Polyakov
>
> Jon prefers if this could go via the usual maintainer's tree.
>
> S
On Fri 04-05-18 08:33:55, Mauro Carvalho Chehab wrote:
> Em Fri, 04 May 2018 13:58:39 +0300
> Jani Nikula escreveu:
>
> > On Fri, 04 May 2018, Mauro Carvalho Chehab
> > wrote:
> > > From now on, I'll start using my @kernel.org as my development e-mail.
> > >
> > > As such, let's remove the entr
There are several places pointing to old documentation files:
Documentation/video4linux/API.html
Documentation/video4linux/bttv/
Documentation/video4linux/cx2341x/fw-encoder-api.txt
Documentation/video4linux/m5602.txt
Documentation/video4linux/v4l2-framework.txt
Documentation/video4lin
Em Tue, 08 May 2018 14:03:39 +0300
Evgeniy Polyakov escreveu:
> Hi
>
> 07.05.2018, 12:36, "Mauro Carvalho Chehab" :
> > Add a blank line to avoid this Sphinx warning:
> > ./drivers/w1/w1_io.c:197: WARNING: Definition list ends without a
> > blank line; unexpected unindent.
> >
> > Signe
Em Tue, 8 May 2018 15:49:08 +
"Luis R. Rodriguez" escreveu:
> On Mon, May 07, 2018 at 06:35:38AM -0300, Mauro Carvalho Chehab wrote:
> > commit 5d6d1ddd2730 ("firmware: move firmware loader into its own
> > directory")
> > and other commits renamed the old firmware_class.c file and split it
On Wed, 9 May 2018 09:10:34 -0300
Mauro Carvalho Chehab wrote:
> Hi Boris,
>
> Em Mon, 7 May 2018 08:32:32 -0300
> Mauro Carvalho Chehab escreveu:
>
> > Hi Boris,
> >
> > Em Mon, 7 May 2018 11:46:50 +0200
> > Boris Brezillon escreveu:
>
> > > Is there a simple
> > > way we can get rid of
Hi Boris,
Em Mon, 7 May 2018 08:32:32 -0300
Mauro Carvalho Chehab escreveu:
> Hi Boris,
>
> Em Mon, 7 May 2018 11:46:50 +0200
> Boris Brezillon escreveu:
> > Is there a simple
> > way we can get rid of the warning we have when not describing timings
> > but all of its fields?
>
> There's n
On Wed, 2018-05-09 at 09:04 -0300, Mauro Carvalho Chehab wrote:
> Em Mon, 07 May 2018 14:38:26 +0200
> Johannes Berg escreveu:
>
> > On Mon, 2018-05-07 at 15:37 +0300, Kalle Valo wrote:
> > > Mauro Carvalho Chehab writes:
> > >
> > > > Sphinx produces a lot of errors like this:
> > > >
Em Mon, 07 May 2018 14:38:26 +0200
Johannes Berg escreveu:
> On Mon, 2018-05-07 at 15:37 +0300, Kalle Valo wrote:
> > Mauro Carvalho Chehab writes:
> >
> > > Sphinx produces a lot of errors like this:
> > > ./include/net/mac80211.h:2083: warning: bad line: >
> > >
> > > Signed-off-by: Mau
On Mon, 7 May 2018 08:32:32 -0300
Mauro Carvalho Chehab wrote:
> Hi Boris,
>
> Em Mon, 7 May 2018 11:46:50 +0200
> Boris Brezillon escreveu:
>
> > Hi Mauro,
>
> > > diff --git a/include/linux/mtd/rawnand.h b/include/linux/mtd/rawnand.h
> > > index 5dad59b31244..b986f94906df 100644
> > > ---
Em Tue, 8 May 2018 09:51:14 -0600
Jonathan Corbet escreveu:
> On Mon, 7 May 2018 06:35:42 -0300
> Mauro Carvalho Chehab wrote:
>
> > The cgroup-v2.txt is already in ReST format. So, move it to the
> > core-api guide, where it belongs.
> >
> > Signed-off-by: Mauro Carvalho Chehab
>
> Hones
Em Mon, 7 May 2018 18:08:03 +0100
Jonathan Cameron escreveu:
> On Mon, 7 May 2018 06:35:51 -0300
> Mauro Carvalho Chehab wrote:
>
> > Solve those Sphinx warnings:
> >
> > ./include/linux/iio/iio.h:270: warning: Function parameter or member
> > 'scan_type.sign' not described in 'iio_chan_
Em Mon, 7 May 2018 07:23:22 -0700
"Paul E. McKenney" escreveu:
> On Mon, May 07, 2018 at 06:35:46AM -0300, Mauro Carvalho Chehab wrote:
> > The code example at rcupdate.h currently produce lots of warnings:
> >
> > ./include/linux/rcupdate.h:572: WARNING: Unexpected indentation.
> > ./in
On Mon, May 07, 2018 at 06:35:49AM -0300, Mauro Carvalho Chehab wrote:
> The flow diagram should be inside a code-block to avoid those
> warnings:
> ./include/linux/wait.h:110: WARNING: Block quote ends without a blank
> line; unexpected unindent.
> ./include/linux/wait.h:113: WARNING:
From: Huang Ying
Add document for newly added thp_swpout, thp_swpout_fallback fields in
/proc/vmstat.
Signed-off-by: "Huang, Ying"
Cc: "Kirill A. Shutemov"
Cc: Andrea Arcangeli
Cc: Johannes Weiner
---
Documentation/vm/transhuge.rst | 9 +
1 file changed, 9 insertions(+)
diff --git
40 matches
Mail list logo
