mbox series

[v2,0/8] docs: consolidate sysfs-block into Documentation/ABI/

Message ID 20211208005640.102814-1-ebiggers@kernel.org (mailing list archive)
Headers show
Series docs: consolidate sysfs-block into Documentation/ABI/ | expand

Message

Eric Biggers Dec. 8, 2021, 12:56 a.m. UTC
This series consolidates the documentation for /sys/block/<disk>/queue/
into Documentation/ABI/, where it is supposed to go (as per Greg KH:
https://lore.kernel.org/r/YaXXpEAwVGTLjp1e@kroah.com).

This series also updates MAINTAINERS to associate the block
documentation with the block layer.

This series applies to linux-block/for-next.

Changed v1 => v2:
   - Added patch which moves the documentation to the stable directory.
   - Added Reviewed-by tags.

Eric Biggers (8):
  docs: sysfs-block: move to stable directory
  docs: sysfs-block: sort alphabetically
  docs: sysfs-block: add contact for nomerges
  docs: sysfs-block: fill in missing documentation from queue-sysfs.rst
  docs: sysfs-block: document stable_writes
  docs: sysfs-block: document virt_boundary_mask
  docs: block: remove queue-sysfs.rst
  MAINTAINERS: add entries for block layer documentation

 Documentation/ABI/stable/sysfs-block  | 668 ++++++++++++++++++++++++++
 Documentation/ABI/testing/sysfs-block | 346 -------------
 Documentation/block/index.rst         |   1 -
 Documentation/block/queue-sysfs.rst   | 321 -------------
 MAINTAINERS                           |   2 +
 5 files changed, 670 insertions(+), 668 deletions(-)
 create mode 100644 Documentation/ABI/stable/sysfs-block
 delete mode 100644 Documentation/ABI/testing/sysfs-block
 delete mode 100644 Documentation/block/queue-sysfs.rst


base-commit: cb3b5daece093c8d921e4e8736c5d7eff1eeb98b

Comments

Martin K. Petersen Dec. 8, 2021, 3:01 a.m. UTC | #1
Eric,

> This series consolidates the documentation for /sys/block/<disk>/queue/
> into Documentation/ABI/, where it is supposed to go (as per Greg KH:
> https://lore.kernel.org/r/YaXXpEAwVGTLjp1e@kroah.com).
>
> This series also updates MAINTAINERS to associate the block
> documentation with the block layer.

Looks good to me. Glad to see these entries moved out of "testing".

Reviewed-by: Martin K. Petersen <martin.petersen@oracle.com>
Bart Van Assche Dec. 8, 2021, 6:35 p.m. UTC | #2
On 12/7/21 4:56 PM, Eric Biggers wrote:
> This series consolidates the documentation for /sys/block/<disk>/queue/
> into Documentation/ABI/, where it is supposed to go (as per Greg KH:
> https://lore.kernel.org/r/YaXXpEAwVGTLjp1e@kroah.com).
> 
> This series also updates MAINTAINERS to associate the block
> documentation with the block layer.

Thank you for having done this work! Once my two comments are addressed,
feel free to add the following to all patches in this series:

Reviewed-by: Bart Van Assche <bvanassche@acm.org>