On Tue, May 05, 2020 at 01:43:51PM +0100, Russell King - ARM Linux admin wrote: > On Tue, May 05, 2020 at 11:44:55AM +0100, Will Deacon wrote: > > Michael has been nagging me on and off about that for, what, 10 years now? > > I would therefore be very much in favour of having our ptrace extensions > > documented! > > > > We could even put this stuff under Documentation/arm64/man/ if it's deemed > > too CPU-specific for the man-pages project, but my preference would still > > be for it to be hosted there alongside all the other man pages. > > Stuffing random things into the kernel tree is painful for some people. > > For example, if you cross-build your kernel, then the stuff in the > tools/ subdirectory is totally useless (I think everything except > perf) because you can't build it. > > Let's stop making the mistake of constantly shoving stuff into the > kernel source tree. For userspace tools, I'm inclined to agree, but this is just documentation so it shouldn't cause any issues with cross building. But to be clear: I'd still prefer it to be part of the man-pages project, and would only consider it for inclusion in the kernel tree if it was rejected for being too CPU-specific. Will