From: Andi Drebes Date: Fri, 13 Oct 2006 17:53:05 +0000 Subject: [KJ] Is documentation in the kernel code desired? Message-Id: <200610131953.05746.lists-receive@programmierforen.de> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: kernel-janitors@vger.kernel.org Hi everybody! I'm currently going through some code in the kernel to understand how things work. I have to admit that some pieces are poorly documented. Especially for kernel newbies like me, documentation in the code could help a lot. I think that some lines of documentation at the top of important functions would be nice. I'm asking, because I don't know if documentation in the code is really desired as it blows up the code and requires changes in the documentation, too if the code is modified. Code-documentation could also be a nice project for the kernel-janitors. Regards, Andi _______________________________________________ Kernel-janitors mailing list Kernel-janitors@lists.osdl.org https://lists.osdl.org/mailman/listinfo/kernel-janitors