Sebastian Fricke <sebastian.fricke@xxxxxxxxxxxxx> writes: > The RFC contains: > - a general debugging guide split into debugging for driver developers and > debugging from userspace > - a new summary page for all media related documentation. This is inspired by > other subsystems, which first of all allows a user to find the subsystem > under the subsystems page and secondly eases general navigation through the > documentation that is sprinkled onto multiple places. > - a guide on how to debug code in the media subsystem, which points to the > parts of the general documentation and adds own routines. I've just begun to take a look at this, apologies for taking so long. Overall: - I have been trying to reduce the number of top-level directories under Documentation/, and this adds two more. Can we avoid that? Let's start in that direction by putting your debugging guide inside Documentation/process, please. - If we *must* create a separate "media" directory, please make it devices/media. My plan is to move most of the device-specific documentation under Documentation/devices, making it match the source layout; I just haven't summoned up the energy to start the slog of actually doing it. But it would be nice to avoid that altogether here. If we create Documentation/process/debugging/, it should be able to hold both your general and media-specific guides, and perhaps other subsystem-specific guides could eventually land there as well. - Please adhere to the 80-column limit for written text. It really does make a difference for people reading it. Thanks, jon
