Manuel Ebner <[email protected]> writes: > On Tue, 2026-03-17 at 09:04 -0600, Jonathan Corbet wrote: >> Manuel Ebner <[email protected]> writes: >> > remove footnote for sphinx >> > in the paragraph before the list it says: >> > "Also, not all tools are necessary on all systems; >> > obviously, if you don't have any PC Card hardware, for example, >> > you probably needn't concern yourself with pcmciautils." > > i understand this paragraph like this: > most or all tools can be optional, depending on the specific use case. > e.g. quota-tools is optional for people compiling the kernel. > that's why i removed the optional markings. > > and pcmciautils, the example in the the file, is not marked as optional in > changes.rst: > > ====================== =============== > ======================================== > Program Minimal version Command to check the version > ====================== =============== > ======================================== > [...] > pcmciautils 004 pccardctl -V
The markings can certainly be done in a more thoughtful way; I don't see that as an argument for simply removing them, though. >> > remove "(optional)" for the same reason as above >> >> Here you have lost some information - now the document doesn't say >> *which* tools are optional. That is, I think, not ideal. > > that's true. > my question is: what are the tools optional for? > or what is the criteria for "optional"? Well, that would be an awfully nice addition to the documentation, but I wouldn't require that to get your current changes in :) Thanks, jon
