Hello! On Wed, Feb 26, 2025 at 10:38:05PM +0100, Günther Noack wrote: > That duplication is *precisely* the problem we have in Landlock. :) > > (If you look at the patch series I've been sending with both the patches sent to > linux-security-modules@ and linux-man@, you'll see the duplication, > e.g. https://lore.kernel.org/all/20250226211814.31420-2-gnoack@xxxxxxxxxx/) Yeah, I've been looking at those that you've CCd me. I just thought that the user-space part of the documentation was minoritary, and that it was part of a much larger documentation that would include many internals. But if most .rst docs are UAPI, then I think it should all be burnt down to flames. :-) > Documentation of user space APIs is not unusual in the kernel documentation, > there is the entire subdirectory Documentation/userspace-api for it. Huh! You're indeed right. A great percentage of Documentation/ is the UAPI. alx@debian:~/.../Documentation$ find * -type f \ | xargs wc | tail -n1; 110625 453670 3990219 total alx@debian:~/.../Documentation$ find userspace-api/ -type f \ | xargs wc | tail -n1; 96501 368382 3411766 total If anyone wants to burn that and send the parts that are missing form the manual pages, you're invited. :-) Have a lovely night! Alex -- <https://www.alejandro-colomar.es/>
Attachment:
signature.asc
Description: PGP signature
