Re: [RFC v2 00/38] Improve ABI documentation generation

2025-01-29 Thread Jonathan Corbet
Mauro Carvalho Chehab writes: > So, I'm proposing to change the minimal requirements to: > - Sphinx 3.4.3; > - Python 3.9 > > By setting Sphinx minimal version to 3.4.3, we can get rid of all > Sphinx backward-compatible code. That's certainly a nice thought. With regard to Python .

Re: [RFC v2 00/38] Improve ABI documentation generation

2025-01-28 Thread Jonathan Corbet
Mauro Carvalho Chehab writes: > Hi Jon/Greg, > > That's the second version of my RFC patches meant to modenize the ABI > parser that I wrote in Perl. I have a couple of minor comments on the individual patches, but overall I do like this direction. It would be nice, though, if the code were a b

Re: [PATCH v2] docs: Move fault injection section to dev-tools

2024-09-05 Thread Jonathan Corbet
Breno Leitao writes: > Fault injection is a development tool, and should be under dev-tools > section. > > Suggested-by: Jonathan Corbet > Signed-off-by: Breno Leitao > --- > Changelog: > > v2: > * Fixed a remaining file pointing to the wrong file, as repor

Re: [PATCH v2 4/4] coding-style: add explanation about pr_fmt macro

2019-09-14 Thread Jonathan Corbet
On Fri, 13 Sep 2019 19:03:00 -0300 André Almeida wrote: > The pr_fmt macro is useful to format log messages printed by pr_() > functions. Add text to explain the purpose of it, how to use and an > example. So I've finally had a chance to take a real look at this... > diff --git a/Documentat

Re: [PATCH 4/4] coding-style: add explanation about pr_fmt macro

2019-09-14 Thread Jonathan Corbet
; > > Signed-off-by: André Almeida > > Since Jonathan Corbet is documentation maintainer, shouldn't he be Cc'ed > explicitly for documentation patches? See also the MAINTAINERS file. ...and indeed I was CC'd on the patch - and your response :) Thanks, jon

Re: [PATCH v4 3/8] block: blk-crypto for Inline Encryption

2019-08-26 Thread Jonathan Corbet
On Wed, 21 Aug 2019 00:57:09 -0700 Satya Tangirala wrote: > We introduce blk-crypto, which manages programming keyslots for struct > bios. With blk-crypto, filesystems only need to call bio_crypt_set_ctx with > the encryption key, algorithm and data_unit_num; they don't have to worry > about gett

Re: [PATCH v4 05/28] docs: cgroup-v1: convert docs to ReST and rename to *.rst

2019-06-14 Thread Jonathan Corbet
On Wed, 12 Jun 2019 14:52:41 -0300 Mauro Carvalho Chehab wrote: > Convert the cgroup-v1 files to ReST format, in order to > allow a later addition to the admin-guide. > > The conversion is actually: > - add blank lines and identation in order to identify paragraphs; > - fix tables markups; >

Re: [PATCH 06/13] keys: Add a notification facility [ver #4]

2019-06-10 Thread Jonathan Corbet
On Fri, 07 Jun 2019 15:18:19 +0100 David Howells wrote: > Add a key/keyring change notification facility whereby notifications about > changes in key and keyring content and attributes can be received. > > Firstly, an event queue needs to be created: > > fd = open("/dev/event_queue", O_RD

Re: [PATCH 13/18] io_uring: add file set registration

2019-02-11 Thread Jonathan Corbet
On Mon, 11 Feb 2019 17:35:21 + Al Viro wrote: > If you turn that thing into a coherent text, I'd appreciate a chance > to take a look at the result and see if anything else needs to be > corrected... Thanks for the updated info! I'm likely to do a watered-down version for some disreputable

Re: [PATCH 13/18] io_uring: add file set registration

2019-02-11 Thread Jonathan Corbet
On Thu, 7 Feb 2019 11:45:40 -0700 Jens Axboe wrote: > > OK, braindump time: > > [snip] > > This is great info, and I think it belongs in Documentation/ somewhere. > Not sure I've ever seen such a good and detailed dump of this before. I suspect I might be able to make something like that hap

Re: [PATCH 05/16] Add io_uring IO interface

2019-01-15 Thread Jonathan Corbet
On Mon, 14 Jan 2019 19:55:20 -0700 Jens Axboe wrote: So the [0/16] cover letter seems to have gone astray this time? Anyway, a couple of minor notes/questions: > The submission queue (SQ) and completion queue (CQ) rings are shared > between the application and the kernel. This eliminates the ne

[PATCH] block: fix kerneldoc comment for blk_attempt_plug_merge()

2019-01-09 Thread Jonathan Corbet
parameter 'request_count' description in 'blk_attempt_plug_merge' Remove the obsolete description and make things a little quieter. Signed-off-by: Jonathan Corbet --- block/blk-core.c | 1 - 1 file changed, 1 deletion(-) diff --git a/block/blk-core.c b/block/blk-core.c in

Re: [PATCH] Documentation: block: cmdline-partition.txt fixes and additions

2018-05-08 Thread Jonathan Corbet
On Sun, 6 May 2018 11:50:29 -0700 Randy Dunlap wrote: > Make the description of the kernel command line option "blkdevparts" > a bit more flowing and readable. > > Fix a few typos. > Add the optional and suffixes. > Note that size can be "-" to indicate all of the remaining space. > > Signed-

Re: [PATCH v3 05/11] PCI/P2PDMA: Add P2P DMA driver writer's documentation

2018-03-12 Thread Jonathan Corbet
On Mon, 12 Mar 2018 13:35:19 -0600 Logan Gunthorpe wrote: > Add a restructured text file describing how to write drivers > with support for P2P DMA transactions. The document describes > how to use the APIs that were added in the previous few > commits. > > Also adds an index for the PCI documen

Re: [PATCH v2] block/loop: add documentation for sysfs interface

2018-02-23 Thread Jonathan Corbet
On Sat, 17 Feb 2018 11:43:04 +0530 Aishwarya Pant wrote: > Documentation has been compiled from git logs and by reading through > code. > > Signed-off-by: Aishwarya Pant > --- > For drivers/block/loop.c, I don't see any maintainers or mailing lists except > for LKML. I am guessing linux-block m

Re: [RESEND PATCH v2] Documentation/ABI: clean up sysfs-class-pktcdvd

2018-02-23 Thread Jonathan Corbet
On Fri, 23 Feb 2018 18:46:32 +0530 Aishwarya Pant wrote: > Clean up the sysfs documentation such that it is in the same format as > described in Documentation/ABI/README. Mainly, the patch moves the > attribute names to the 'What:' field. This might be useful for scripting > and tracking changes

Re: [PATCH 0/9] convert genericirq.tmpl and kernel-api.tmpl to DocBook

2017-04-02 Thread Jonathan Corbet
On Thu, 30 Mar 2017 17:11:27 -0300 Mauro Carvalho Chehab wrote: > This series converts just two documents, adding them to the > core-api.rst book. It addresses the errors/warnings that popup > after the conversion. > > I had to add two fixes to scripts/kernel-doc, in order to solve > some of the