Hi Mauro,
[auto build test WARNING on linus/master]
[also build test WARNING on next-20170512]
[cannot apply to v4.11]
[if your patch is applied to the wrong git tree, please drop us a note to help
improve the system]
url:
https://github.com/0day-ci/linux/commits/Mauro-Carvalho-Chehab/docs
On Sat, May 13, 2017 at 12:11:09AM +0200, Peter Zijlstra wrote:
> On Fri, May 12, 2017 at 06:51:50PM -0300, Mauro Carvalho Chehab wrote:
> > > * Return:
> > > * * 0 - ready to wait
> > > * * 1 - acquired the lock
> > > * * <0 - error
> > >
> > > I'm fine with either though, just curious i
On Fri, May 12, 2017 at 06:51:50PM -0300, Mauro Carvalho Chehab wrote:
> > * Return:
> > * * 0 - ready to wait
> > * * 1 - acquired the lock
> > * * <0 - error
> >
> > I'm fine with either though, just curious if this would be an improvement,
> > or if
> > we have an established policy (
On Fri, May 12, 2017 at 06:51:50PM -0300, Mauro Carvalho Chehab wrote:
> Em Fri, 12 May 2017 09:41:22 -0700
> Darren Hart escreveu:
>
> > On Fri, May 12, 2017 at 10:59:47AM -0300, Mauro Carvalho Chehab wrote:
> > > There are a few issues on some kernel-doc markups that was
> > > causing troubles
Em Fri, 12 May 2017 09:41:22 -0700
Darren Hart escreveu:
> On Fri, May 12, 2017 at 10:59:47AM -0300, Mauro Carvalho Chehab wrote:
> > There are a few issues on some kernel-doc markups that was
> > causing troubles with kernel-doc output on ReST format.
> > Fix them.
> >
> > No functional changes
On Friday, May 12, 2017 03:20:48 PM Jonathan Corbet wrote:
> On Fri, 12 May 2017 22:47:25 +0200
> "Rafael J. Wysocki" wrote:
>
> > > Hi Jon,
> > >
> > > All of the dependencies for this patch have been merged, so I can route it
> > > through the PM tree.
> > >
> > > Please let me know if you pr
On Fri, 12 May 2017 22:47:25 +0200
"Rafael J. Wysocki" wrote:
> > Hi Jon,
> >
> > All of the dependencies for this patch have been merged, so I can route it
> > through the PM tree.
> >
> > Please let me know if you prefer to take it into the documentation tree
> > instead.
>
> I'm taking t
On Friday, May 05, 2017 11:38:42 PM Rafael J. Wysocki wrote:
> From: Rafael J. Wysocki
>
> Add a document describing the current behavior and user space
> interface of the intel_pstate driver in the RST format and
> drop the existing outdated intel_pstate.txt document.
>
> Also update admin-guid
Hello,
Some data type definitions are provided by Linux source files.
How would you like to see them represented in the documentation formats
which are generated by the Sphinx software?
Regards,
Markus
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a messag
Am 12.05.2017 um 15:59 schrieb Mauro Carvalho Chehab :
> Use pandoc to convert documentation to ReST by calling
> Documentation/sphinx/tmplcvt script.
>
> - Manually adjust tables with got broken by conversion
>
> Signed-off-by: Mauro Carvalho Chehab
> ---
> Documentation/DocBook/Makefile
Am 12.05.2017 um 15:59 schrieb Mauro Carvalho Chehab :
> Use pandoc to convert documentation to ReST by calling
> Documentation/sphinx/tmplcvt script.
>
> - Manually adjust tables with got broken by conversion
>
> Signed-off-by: Mauro Carvalho Chehab
> ---
> Documentation/DocBook/Makefile
On Fri, May 12, 2017 at 12:25:22PM +1000, Balbir Singh wrote:
> On Thu, 2017-05-11 at 20:16 +0100, Roman Gushchin wrote:
> > The meaning of each value is the same as for global counters,
> > available using /proc/vmstat.
> >
> > Also, for consistency, rename mem_cgroup_count_vm_event() to
> > coun
On Fri, May 12, 2017 at 10:59:47AM -0300, Mauro Carvalho Chehab wrote:
> There are a few issues on some kernel-doc markups that was
> causing troubles with kernel-doc output on ReST format.
> Fix them.
>
> No functional changes.
>
> Signed-off-by: Mauro Carvalho Chehab
No objection. One questio
Am 12.05.2017 um 15:59 schrieb Mauro Carvalho Chehab :
> Use pandoc to convert documentation to ReST by calling
> Documentation/sphinx/tmplcvt script.
>
> - Manually adjusted to use ..note and ..warning
> - Minor fixes for it to be parsed without errors
> - Use **bold** for emphasis.
>
> Signed
- Fixed bugs in example for shash and rng (added missing "*" and " *").
- Corrected pr_info() in calc_hash().
- Added example usage of calc_hash().
- No need for negate PTR_ERR to get error code, as crypto_alloc_rng
already returns negative values like ERR_PTR(-ENOMEM). Fixed.
Signed-off-by: Kam
As we add more documents, it makes more sense to sort the
entries there in alphabetical order, as it makes easier to
check if something is not there.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/conf.py | 13 +++--
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/D
The userspace API book was added without the bits required to
generate PDF output. Add them.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/conf.py | 2 ++
1 file changed, 2 insertions(+)
diff --git a/Documentation/conf.py b/Documentation/conf.py
index bca751960dec..2e215477edf5 100644
Sphinx gets confused when it finds identation without a
good reason for it and without a preceding blank line:
./fs/mpage.c:347: ERROR: Unexpected indentation.
./fs/namei.c:4303: ERROR: Unexpected indentation.
./fs/fs-writeback.c:2060: ERROR: Unexpected indentation.
No fun
The sound subsystem book was added without the bits required to
generate PDF output. Add them.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/conf.py | 2 ++
Documentation/sound/conf.py | 10 ++
2 files changed, 12 insertions(+)
create mode 100644 Documentation/sound/conf
Those functions are currently ignored, causing references at
the documentation to be lost. Don't ignore it.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/filesystems/index.rst | 1 -
1 file changed, 1 deletion(-)
diff --git a/Documentation/filesystems/index.rst
b/Documentation/filesys
kernel-doc script expects that a function documentation to
be just before the function, otherwise it will be ignored.
So, move the kernel-doc markup to the right place.
Signed-off-by: Mauro Carvalho Chehab
---
fs/jbd2/transaction.c | 38 +++---
1 file changed, 19
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile| 2 +-
Documentation/DocBook/s390-drivers.tmpl | 161 --
Documentation/driver-api/index.
Those tables have a "caption" at the end, but ReST
actually expects it on a different way.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/kernel-hacking/locking.rst | 66
1 file changed, 34 insertions(+), 32 deletions(-)
diff --git a/Documentation/kernel
As kdbg.rst uses the ".. important::" annotation, let's define a
color for PDF output.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/conf.py | 8 +++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/Documentation/conf.py b/Documentation/conf.py
index bfa95c881956..e9480
Sphinx require explicit tags in order to use a list of possible
values, otherwise it produces this error:
./fs/eventfd.c:219: WARNING: Option list ends without a blank line;
unexpected unindent.
Signed-off-by: Mauro Carvalho Chehab
---
fs/eventfd.c | 4 ++--
1 file changed, 2 insertion
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/w1.tmpl | 101 -
Documentation/driver-api/index.rst | 1 +
Documentation/driver-api/w1.rst| 7
Sphinx is very pedantic with regards to ident/spacing.
Fix some kernel-doc markups in order to solve those
errors/warnings:
./drivers/scsi/scsicam.c:121: WARNING: Inline emphasis start-string without
end-string.
./drivers/scsi/scsicam.c:121: WARNING: Inline emphasis start-string without
end-stri
Instead of just using text for functions and structs, use
the C domain tags, in order to allow cross-referencing with
the kernel-doc markups.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/driver-api/libata.rst | 244 ++--
1 file changed, 124 insertions(+)
Sphinx got confused with the markup identation:
./drivers/ata/libata-scsi.c:3402: ERROR: Unexpected indentation.
No functional changes.
Signed-off-by: Mauro Carvalho Chehab
---
drivers/ata/libata-scsi.c | 7 ---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/drivers/a
There are a few syntax violations that cause outputs of
a few comments to not be properly parsed in ReST format.
No functional changes.
Signed-off-by: Mauro Carvalho Chehab
---
fs/locks.c | 18 --
1 file changed, 8 insertions(+), 10 deletions(-)
diff --git a/fs/locks.c b/fs/loc
The crypto API book was added without the bits required to
generate PDF output. Add them.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/conf.py| 2 ++
Documentation/crypto/conf.py | 10 ++
2 files changed, 12 insertions(+)
create mode 100644 Documentation/crypto/conf.p
Correct a few minor issues with ReST notation used on
this file (produced by an automatic tool).
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/kernel-hacking/locking.rst | 16
1 file changed, 8 insertions(+), 8 deletions(-)
diff --git a/Documentation/kernel-hacking/loc
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile| 1 -
Documentation/DocBook/networking.tmpl | 111 -
Documentation/conf.py | 2 +
kernel-doc will try to interpret a foo() string, except if
properly escaped.
Signed-off-by: Mauro Carvalho Chehab
---
fs/jbd2/transaction.c | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/fs/jbd2/transaction.c b/fs/jbd2/transaction.c
index fe7f4a373436..38e1dcabbaca 10064
Sphinx is very pedantic with regards to identation and
escape sequences:
./include/net/sock.h:1967: ERROR: Unexpected indentation.
./include/net/sock.h:1969: ERROR: Unexpected indentation.
./include/net/sock.h:1970: WARNING: Block quote ends without a blank line;
unexpected unindent.
./in
The automatic conversion didn't work too well for this file.
It added weird html blocks inside it, and did some weird
things for literals. Manually fix it, in order to present
a nice display at html/pdf outputs.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/dev-tools/kgdb.rst | 489
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile | 1 -
Documentation/DocBook/scsi.tmpl| 409 -
Documentation/driver-api/index.rst
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Some manual adjustments were required due to some
conversion error on some literals.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile | 2 +-
Documentation/DocBook/z8530b
This document is fairly updated. Yet, some stuff moved to
other kernel headers. So, update to point to the right
places.
While here, adjust some minor ReST markups.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/kernel-hacking/index.rst | 179 ++---
1 file ch
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile |2 +-
Documentation/DocBook/libata.tmpl | 1625 ---
Documentation/driver-api/index.rst
The dev-tools API book was added without the bits required to
generate PDF output at the main conf.py. Add them.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/conf.py | 2 ++
1 file changed, 2 insertions(+)
diff --git a/Documentation/conf.py b/Documentation/conf.py
index ce62723491d4..
On Fri, 2017-05-12 at 11:00 -0300, Mauro Carvalho Chehab wrote:
> There are a few syntax violations that cause outputs of
> a few comments to not be properly parsed in ReST format.
>
> No functional changes.
>
> Signed-off-by: Mauro Carvalho Chehab
> ---
> fs/locks.c | 18 --
>
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile | 4 +-
Documentation/DocBook/rapidio.tmpl | 155 ---
Documentation/driver-api/index.rst
Instead of just mention the function names, use cross-references
to the kernel-doc tags where pertinent.
While not all function documentation is included here, I
double-checked that all functions mentioned there still
exists.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/filesystems/in
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
- Manually adjusted to use ..note and ..warning
- Minor fixes for it to be parsed without errors
- Use **bold** for emphasis.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile
There are a few issues on some kernel-doc markups that was
causing troubles with kernel-doc output on ReST format.
Fix them.
No functional changes.
Signed-off-by: Mauro Carvalho Chehab
---
include/linux/mutex.h | 6 +++---
kernel/futex.c | 40
There's no kernel-documentation.rst file at Documentation/
anymore. So, remove it from the list of LaTeX-generated
documents.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/conf.py | 2 --
1 file changed, 2 deletions(-)
diff --git a/Documentation/conf.py b/Documentation/conf.py
index 1a
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile | 2 +-
Documentation/DocBook/filesystems.tmpl | 381 -
Documentation/conf.py
Use pandoc to convert documentation to ReST by calling
Documentation/sphinx/tmplcvt script.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/DocBook/Makefile| 2 +-
Documentation/DocBook/kgdb.tmpl | 918 -
Documentation/dev-tools/index.rst | 1
Use a different markup for this table, in order to make it
smaller when seeing in text mode.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/kernel-hacking/locking.rst | 37
1 file changed, 14 insertions(+), 23 deletions(-)
diff --git a/Documentation/kern
The "%" escape code of kernel-doc only handle letters. It
doesn't handle special chars. So, use the ``literal``
notation. That fixes this warning:
./include/linux/skbuff.h:2695: WARNING: Inline literal start-string without
end-string.
No functional changes.
Signed-off-by: Mauro Carvalho Chehab
* Do you need an urgent loan? We offer all kinds of loan
* Very fast and urgent transfer to your bank account.
* Payment begins (6) months after you get the money in your bank account
* Low interest rates 2%
* Payment of long-term (1-30 years) duration
For more information and loan application form
52 matches
Mail list logo
