[PW_SID:1082328] Auto-generate maintainer profile entries#1786
[PW_SID:1082328] Auto-generate maintainer profile entries#1786linux-riscv-bot wants to merge 12 commits into
Conversation
The media subsystem has a maintainers entry profile, but its entry is missing at MAINTAINERS. Add it. Acked-by: Randy Dunlap <rdunlap@infradead.org> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Message-ID: <5af4aa6a716228eea4d59dc26b97d642e1e7d419.1776176108.git.mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
The X86 subsystem has a maintainers entry profile, but its entry is missing at MAINTAINERS. Add it. Acked-by: Randy Dunlap <rdunlap@infradead.org> Acked-by: Dan Williams <djbw@kernel.org> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Message-ID: <970434c647aa1e1e9a81c87b4d5fed934d4018a7.1776176108.git.mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
Add a feature to allow auto-generating media entry profiles from the corresponding field inside MAINTAINERS file(s). Suggested-by: Dan Williams <djbw@kernel.org> Closes: https://lore.kernel.org/linux-doc/69dd6299440be_147c801005b@djbw-dev.notmuch/ Acked-by: Dan Williams <djbw@kernel.org> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Message-ID: <4e9512a3d05942c98361d06d60a118d7c78762b6.1776176108.git.mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
Instead of manually creating a TOC tree for them, use the new tag to auto-generate its TOC. Co-developed-by: Dan Williams <djbw@kernel.org> Signed-off-by: Dan Williams <djbw@kernel.org> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Message-ID: <9228f77b0339b8e5dea4a201ab6d4feb30cef5c2.1776176108.git.mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
As we're picking the name of the subsystem from MAINTAINERS, also use its subsystem name for the titles. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
Some subsystem profiles are maintained elsewhere. Add them to the output. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
When a maintainer's profile is stored outside process, they're already included on some other book and the name of the filesystem may not be there. That's why the logic picks the name from the subsystem's name. However, files directly placed together with maintainers-handbooks.rst (e.g. under Documentation/process/) is a different history: those aren't placed anywhere, so we can keep using their own names, letting Sphinx do his thing. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
Instead of showing as a "Contents:" with 2 identation levels, drop its title and show profiles as a list of entries. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
There are three "types" of profiles: 1. Profiles already included inside subsystem-specific documentation. This is the most common case; 2. Profiles that are hosted externally; 3. Profiles that are at the same location as maintainer-handbooks.rst. For (3), we need to create a TOC, as they don't exist elsewhere. Change the logic to create TOC just for (3), prepending the content of maintainer-handbooks with a sorted entry of all types, before the TOC. With such change, we can have an unique sorted list of profiles, having the subsystem names used there listed. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
os.path.relpath() will do the wrong thing with O=dir, as the build system uses "cd <dir>" internally. Solve it by using app.srcdir, which, on normal cases, point to Documentation/, or, when SPHINXDIRS=process, it will be set with Documentation/process. While here, remove a dead code while writing maintainer profiles, as now all entries should have both profile and entry. Reported-by: Randy Dunlap <rdunlap@infradead.org> Closes: https://lore.kernel.org/linux-doc/88335220-3527-4b1f-9500-417f7ebb7a02@infradead.org/T/#m6854cbd8d30e2c5d3e8c4173bae1c3d6922ff970 Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
Change the logic to parse MAINTAINERS file content just once, while still allowing using it multiple times. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Linux RISC-V bot <linux.riscv.bot@gmail.com>
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 1: "[v2,01/11] MAINTAINERS: add an entry for media maintainers profile" |
|
Patch 2: "[v2,02/11] MAINTAINERS: add maintainer-tip.rst to X86" |
|
Patch 2: "[v2,02/11] MAINTAINERS: add maintainer-tip.rst to X86" |
|
Patch 2: "[v2,02/11] MAINTAINERS: add maintainer-tip.rst to X86" |
|
Patch 2: "[v2,02/11] MAINTAINERS: add maintainer-tip.rst to X86" |
|
Patch 2: "[v2,02/11] MAINTAINERS: add maintainer-tip.rst to X86" |
|
Patch 2: "[v2,02/11] MAINTAINERS: add maintainer-tip.rst to X86" |
|
Patch 9: "[v2,09/11] docs: maintainers_include: improve its output" |
|
Patch 9: "[v2,09/11] docs: maintainers_include: improve its output" |
|
Patch 9: "[v2,09/11] docs: maintainers_include: improve its output" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 10: "[v2,10/11] docs: maintainers_include: fix support for O=dir" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
|
Patch 11: "[v2,11/11] docs: maintainers_include: parse MAINTAINERS just once" |
506e7f6 to
01805bc
Compare
PR for series 1082328 applied to workflow__riscv__fixes
Name: Auto-generate maintainer profile entries
URL: https://patchwork.kernel.org/project/linux-riscv/list/?series=1082328
Version: 2