On 5/5/20 2:43 PM, 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. Yes, and too often not easily noticeable for user-space programmers. > > 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. Agrred. Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/