Create an User's manual and improve development-process book
Get series with b4
b4 am [email protected]Versions newest first
- v1 Latest32 patches 16 repliesIn review
Patches in v1 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/32 | Documentation/applying-patches.txt: fix a bad external linkDocumentation/ | +1 | 0 replies | |
| 2/32 | REPORTING-BUGS: convert to ReST markupREPORTING-BUGS | +37 | 0 replies | |
| 3/32 | README: convert it to ReST markupREADME | +58 | 0 replies | |
| 4/32 | Documentation/kernel-parameters.txt: convert to ReST markupDocumentation/ | +19 | 0 replies | |
| 5/32 | docs-rst: add documents to development-processDocumentation/ Documentation/ Documentation/ +10 more | +31 | 0 replies | |
| 6/32 | docs-rst: create an user's manual bookDocumentation/ Documentation/ Documentation/ +6 more | +36 | 0 replies | |
| 7/32 | Documentation/adding-syscalls.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +141 | 0 replies | |
| 8/32 | Documentation/bad_memory.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +18 | 0 replies | |
| 9/32 | Documentation/basic_profiling.rst: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +38 | 0 replies | |
| 10/32 | Documentation/binfmt_misc.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +79 | 0 replies | |
| 11/32 | Documentation/serial-console.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +37 | 0 replies | |
| 12/32 | Documentation/braille-console: convert it to ReST markupDocumentation/ Documentation/ Documentation/ +1 more | +21 | 0 replies | |
| 13/32 | Documentation/BUG-HUNTING: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +84 | 0 replies | |
| 14/32 | Documentation/CodeOfConflict: add it to the development-process bookDocumentation/ Documentation/ | +2 | 0 replies | |
| 15/32 | Documentation/devices.rst: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +560 | 0 replies | |
| 16/32 | Documentation/dynamic-debug-howto.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +157 | 0 replies | |
| 17/32 | Documentation/initrd.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +110 | 0 replies | |
| 18/32 | Documentation/init.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +18 | 0 replies | |
| 19/32 | Documentation/magic-number.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +113 | 0 replies | |
| 20/32 | Documentation/md.txt: Convert to ReST markupDocumentation/ Documentation/ Documentation/ | +323 | 0 replies | |
| 21/32 | Documentation/module-signing.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +57 | 0 replies | |
| 22/32 | Documentation/mono.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +25 | 0 replies | |
| 23/32 | Documentation/java.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +131 | 0 replies | |
| 24/32 | Documentation/oops-tracing.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +140 | 0 replies | |
| 25/32 | Documentation/parport.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +140 | 0 replies | |
| 26/32 | Documentation/ramoops.txt: convert it to ReST formatDocumentation/ Documentation/ Documentation/ | +49 | 0 replies | |
| 27/32 | Documentation/sysfs-rules.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +115 | 0 replies | |
| 28/32 | Documentation/sysrq.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +151 | 0 replies | |
| 29/32 | Documentation/unicode.txt: convert it to ReST markupDocumentation/ Documentation/ Documentation/ | +20 | 0 replies | |
| 30/32 | Documentation/VGA-softcursor.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +52 | 0 replies | |
| 31/32 | Documentation/volatile-considered-harmful.txt: convert to ReST markupDocumentation/ Documentation/ Documentation/ | +13 | 0 replies | |
| 32/32 | Documentation/parport.txt: fix table to show on LaTeXDocumentation/ | +22 | 0 replies |
Reviews trailers per patch
1 of 32 patches has a Reviewed-by or Acked-by.
| Patch | Greg Kroah-Hartman |
|---|---|
| 1/32 | |
| 2/32 | |
| 3/32 | |
| 4/32 | |
| 5/32 | A-b |
| 6/32 | |
| 7/32 | |
| 8/32 | |
| 9/32 | |
| 10/32 | |
| 11/32 | |
| 12/32 | |
| 13/32 | |
| 14/32 | |
| 15/32 | |
| 16/32 | |
| 17/32 | |
| 18/32 | |
| 19/32 | |
| 20/32 | |
| 21/32 | |
| 22/32 | |
| 23/32 | |
| 24/32 | |
| 25/32 | |
| 26/32 | |
| 27/32 | |
| 28/32 | |
| 29/32 | |
| 30/32 | |
| 31/32 | |
| 32/32 |
Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.
Cover letter [PATCH 00/32] Create an User's manual and improve development-process book
This patch series continues the efforts of converting the Linux Kernel documentation to Sphinx.
It contains text to ReST conversion of several files under Documentation, and a few ones under the main dir (README, REPORTING-BUGS).
As several of the files that document the user's book and the development process have a very known name and location, this series opts to keep them in the same location, adding a symbolic link under Documentation/user and Documentation/development-process.
The advantage of this approach is that people should not learn that those files got moved, and sites/git history pointing to those files will still be pointing to the real thing. The disadvantage is that it is more complex to see what files were already added to a ReST book and on what book those files were grouped.
When compared with the patches I sent to ML before the merge window, I removed the patch adding MAINTAINERS to the User's manual, and added several other files to both books.
All patches on this series can be found on my development tree:
https://git.linuxtv.org/mchehab/experimental.git/log/?h=lkml-books
and are all based on Kernel 4.9-rc1.
The Kernel docs html output after this series can be seen at:
https://mchehab.fedorapeople.org/kernel_docs/
NOTE:
====
In my opinion, it would be better to move the converted files to be inside a Sphinx build directory, but Jon seems reluctant to that, so, this series use symlinks, as it is easy to move the files in the future with a very simple patch, if we decide to do so.
Mauro Carvalho Chehab (32):
Documentation/applying-patches.txt: fix a bad external link
REPORTING-BUGS: convert to ReST markup
README: convert it to ReST markup Documentation/kernel-parameters.txt: convert to ReST markup
docs-rst: add documents to development-process
docs-rst: create an user's manual book Documentation/adding-syscalls.txt: convert it to ReST markup Documentation/bad_memory.txt: convert it to ReST markup Documentation/basic_profiling.rst: convert to ReST markup Documentation/binfmt_misc.txt: convert it to ReST markup Documentation/serial-console.txt: convert it to ReST markup Documentation/braille-console: convert it to ReST markup Documentation/BUG-HUNTING: convert to ReST markup Documentation/CodeOfConflict: add it to the development-process book Documentation/devices.rst: convert it to ReST markup Documentation/dynamic-debug-howto.txt: convert it to ReST markup Documentation/initrd.txt: convert to ReST markup Documentation/init.txt: convert to ReST markup Documentation/magic-number.txt: convert it to ReST markup Documentation/md.txt: Convert to ReST markup Documentation/module-signing.txt: convert to ReST markup Documentation/mono.txt: convert to ReST markup Documentation/java.txt: convert to ReST markup Documentation/oops-tracing.txt: convert to ReST markup Documentation/parport.txt: convert to ReST markup Documentation/ramoops.txt: convert it to ReST format Documentation/sysfs-rules.txt: convert it to ReST markup Documentation/sysrq.txt: convert to ReST markup Documentation/unicode.txt: convert it to ReST markup Documentation/VGA-softcursor.txt: convert to ReST markup Documentation/volatile-considered-harmful.txt: convert to ReST markup Documentation/parport.txt: fix table to show on LaTeX
Documentation/BUG-HUNTING | 162 +-- Documentation/SecurityBugs | 12 +- Documentation/VGA-softcursor.txt | 73 +- Documentation/adding-syscalls.txt | 263 ++--- Documentation/applying-patches.txt | 2 +- Documentation/bad_memory.txt | 26 +- Documentation/basic_profiling.txt | 59 +- Documentation/binfmt_misc.txt | 134 ++- Documentation/braille-console.txt | 30 +- Documentation/conf.py | 2 + Documentation/development-process/Changes.rst | 1 + .../development-process/CodeOfConflict.rst | 1 + Documentation/development-process/CodingStyle.rst | 1 + Documentation/development-process/HOWTO.rst | 1 + .../development-process/ManagementStyle.rst | 1 + .../development-process/SubmitChecklist.rst | 1 + .../development-process/SubmittingDrivers.rst | 1 + .../development-process/SubmittingPatches.rst | 1 + .../development-process/adding-syscalls.rst | 1 + .../development-process/applying-patches.rst | 1 + .../development-process/email-clients.rst | 1 + Documentation/development-process/index.rst | 23 + Documentation/development-process/kernel-docs.rst | 1 + Documentation/development-process/magic-number.rst | 1 + .../development-process/stable_api_nonsense.rst | 1 + .../development-process/stable_kernel_rules.rst | 1 + .../volatile-considered-harmful.rst | 1 + Documentation/devices.txt | 1090 ++++++++++---------- Documentation/dynamic-debug-howto.txt | 297 +++--- Documentation/index.rst | 1 + Documentation/init.txt | 29 +- Documentation/initrd.txt | 199 ++-- Documentation/java.txt | 244 ++--- Documentation/kernel-parameters.txt | 33 +- Documentation/magic-number.txt | 216 ++-- Documentation/md.txt | 528 ++++++---- Documentation/module-signing.txt | 117 +-- Documentation/mono.txt | 44 +- Documentation/oops-tracing.txt | 255 ++--- Documentation/parport.txt | 287 +++--- Documentation/ramoops.txt | 86 +- Documentation/serial-console.txt | 68 +- Documentation/sysfs-rules.txt | 218 ++-- Documentation/sysrq.txt | 266 ++--- Documentation/unicode.txt | 22 +- Documentation/user/BUG-HUNTING.rst | 1 + Documentation/user/README.rst | 1 + Documentation/user/REPORTING-BUGS.rst | 1 + Documentation/user/SecurityBugs.rst | 1 + Documentation/user/VGA-softcursor.rst | 1 + Documentation/user/bad_memory.rst | 1 + Documentation/user/basic_profiling.rst | 1 + Documentation/user/binfmt_misc.rst | 1 + Documentation/user/braile-console.rst | 1 + Documentation/user/conf.py | 10 + Documentation/user/devices.rst | 1 + Documentation/user/dynamic-debug-howto.rst | 1 + Documentation/user/index.rst | 34 + Documentation/user/init.rst | 1 + Documentation/user/initrd.rst | 1 + Documentation/user/java.rst | 1 + Documentation/user/kernel-parameters.rst | 1 + Documentation/user/md.rst | 1 + Documentation/user/module-signing.rst | 1 + Documentation/user/mono.rst | 1 + Documentation/user/oops-tracing.rst | 1 + Documentation/user/parport.rst | 1 + Documentation/user/ramoops.rst | 1 + Documentation/user/serial-console.rst | 1 + Documentation/user/sysfs-rules.rst | 1 + Documentation/user/sysrq.rst | 1 + Documentation/user/unicode.rst | 1 + Documentation/volatile-considered-harmful.txt | 19 +- README | 105 +- REPORTING-BUGS | 66 +- 75 files changed, 2791 insertions(+), 2270 deletions(-) create mode 120000 Documentation/development-process/Changes.rst create mode 120000 Documentation/development-process/CodeOfConflict.rst create mode 120000 Documentation/development-process/CodingStyle.rst create mode 120000 Documentation/development-process/HOWTO.rst create mode 120000 Documentation/development-process/ManagementStyle.rst create mode 120000 Documentation/development-process/SubmitChecklist.rst create mode 120000 Documentation/development-process/SubmittingDrivers.rst create mode 120000 Documentation/development-process/SubmittingPatches.rst create mode 120000 Documentation/development-process/adding-syscalls.rst create mode 120000 Documentation/development-process/applying-patches.rst create mode 120000 Documentation/development-process/email-clients.rst create mode 120000 Documentation/development-process/kernel-docs.rst create mode 120000 Documentation/development-process/magic-number.rst create mode 120000 Documentation/development-process/stable_api_nonsense.rst create mode 120000 Documentation/development-process/stable_kernel_rules.rst create mode 120000 Documentation/development-process/volatile-considered-harmful.rst create mode 120000 Documentation/user/BUG-HUNTING.rst create mode 120000 Documentation/user/README.rst create mode 120000 Documentation/user/REPORTING-BUGS.rst create mode 120000 Documentation/user/SecurityBugs.rst create mode 120000 Documentation/user/VGA-softcursor.rst create mode 120000 Documentation/user/bad_memory.rst create mode 120000 Documentation/user/basic_profiling.rst create mode 120000 Documentation/user/binfmt_misc.rst create mode 120000 Documentation/user/braile-console.rst create mode 100644 Documentation/user/conf.py create mode 120000 Documentation/user/devices.rst create mode 120000 Documentation/user/dynamic-debug-howto.rst create mode 100644 Documentation/user/index.rst create mode 120000 Documentation/user/init.rst create mode 120000 Documentation/user/initrd.rst create mode 120000 Documentation/user/java.rst create mode 120000 Documentation/user/kernel-parameters.rst create mode 120000 Documentation/user/md.rst create mode 120000 Documentation/user/module-signing.rst create mode 120000 Documentation/user/mono.rst create mode 120000 Documentation/user/oops-tracing.rst create mode 120000 Documentation/user/parport.rst create mode 120000 Documentation/user/ramoops.rst create mode 120000 Documentation/user/serial-console.rst create mode 120000 Documentation/user/sysfs-rules.rst create mode 120000 Documentation/user/sysrq.rst create mode 120000 Documentation/user/unicode.rst
Signature · 1 line
2.7.4