Messages in this thread |  | | From | Jonathan Corbet <> | | Subject | Re: [PATCH] Documentation/kernel-parameters: Move the kernel build options | | Date | Wed, 19 Nov 2025 08:42:43 -0700 |
| |
Borislav Petkov <bp@alien8.de> writes:
> On Tue, Nov 18, 2025 at 09:20:36AM -0700, Jonathan Corbet wrote: >> So I applied this, but it's dancing around the real problem: that this >> material is split into two files in the first place. I honestly don't >> remember why it was done that way > > I was wondering the same thing. > >> - maybe just to ease the RST transition back in 2016. I think we should >> really just pull all of kernel-parameters.txt into the RST file. > > Except the .txt file has its own formatting and if the conversion to .rst > makes it more unreadable due to the .rst formatting gunk, that would be a step > in the wrong direction, I'd say. > > So including it verbatim as it is done now looks like a good compromise. > Unless you have a better idea...
What the effect would be of making it all into proper RST is unclear, I don't think anybody has tried.
But we could certainly just put the whole contents of kernel-parameters.txt as a literal block within kernel-parameters.rst and at least have it all in one place.
jon
|  |