it would seem that at least a couple of the current kernel-doc
manuals have strange and inconsistent content -- i'm thinking of
kernel-api and device-drivers. given that these are two different
manuals, one would think that kernel-api would cover, say, the *basic*
kernel programming API (you know, memory, locking, etc.), while the
device-drivers manual would cover device driver-specific content.
however, the allegedly kernel-level manual includes a couple
sections on character and misc devices, while the device driver manual
includes what would seem to be more general content such as timers,
workqueues, wait queues, etc.
would it make sense to shift some content around to make the manuals
more focused? or perhaps just take the larger manuals and break them
out into smaller and more specific manuals? having more but smaller
manuals would certainly make it easier to keep manuals up to date.
thoughts?
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
