(forgot to CC linux-mm) On Tue, Jan 30, 2018 at 12:52:37PM +0200, Mike Rapoport wrote: > Hello, > > The mm kernel-doc documentation is not in a great shape. > > Some of the existing kernel-doc annotations were not reformatted during > transition from dockbook to sphix. Sometimes the parameter descriptions > do not match actual code. But aside these rather mechanical issues there > are several points it'd like to discuss: > > * Currently, only 14 files are linked to kernel-api.rst under "Memory > Management in Linux" section. We have more than hundred files only in mm. > Even the existing documentation is not generated when running "make > htmldocs" > * Do we want to keep "Memory Management in Linux" under kernel-api.rst or > maybe it's worth adding, say, mm.rst? > * What is the desired layout of the documentation, what sections we'd like > to have, how the documentation should be ordered? > > -- > Sincerely yours, > Mike. -- Sincerely yours, Mike. -- To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to majordomo@xxxxxxxxx. For more info on Linux MM, see: http://www.linux-mm.org/ . Don't email: <a href=mailto:"dont@xxxxxxxxx";> email@xxxxxxxxx </a>
