Write a section in the FreeBSD developers handbook about debugging the kernel with DCons FreeBSD
Status: Closed Time to complete: 120 hrs Mentors: Gavin Atkinson Tags: debugging, firewire, DocBook, documentation, SGML, FreeBSD

Description of task

The FreeBSD developers handbook outlines multiple ways to debug the system's kernel to find bugs and errors. What's missing is debugging the system using DCons. The steps to do so have been outlined in the following FreeBSD wiki page: http://wiki.freebsd.org/DebugWithDcons This needs to be written as a subsection in the debugging chapter: http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug.html so that developers can find enough information to use DCons for that purpose. The subsection needs to be correctly formatted and must conform to our documentation source code style guidelines.

Task requires:


A FreeBSD system (in a VirtualBox Virtual Machine) installed on your computer. 
Knowledge of the documentation guidelines for the FreeBSD project: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ 
Check out a copy of the documentation tree from the documentation repository to get the source code for the chapter

Uploaded Work
File name/URL File size Date submitted
gcin-fbsd-dev-dcons.diff 8.5 KB December 07 2011 16:41 UTC
gcin-fbsd-dev-dcons-proper.diff 8.5 KB December 07 2011 16:56 UTC
Comments
issyl0 on December 2 2011 09:36 UTC Task Claimed

I would like to work on this task.

Wojciech A. Koszek on December 2 2011 09:39 UTC Task Assigned

This task has been assigned to issyl0. You have 120 hours to complete this task, good luck!

Melange on December 7 2011 09:39 UTC Initial Deadline passed

Melange has detected that the initial deadline has passed and it has set the task status to ActionNeeded. The student has 24 hours to submit the work before the task is reopened and sent back to the pool for other students to claim.

issyl0 on December 7 2011 16:41 UTC Ready for review

The work on this task is ready to be reviewed.

Gavin Atkinson on December 7 2011 16:59 UTC Task Closed

Congratulations, this task has been completed successfully.

Gavin Atkinson on December 7 2011 17:23 UTC Notes

I had been working with issyl0 over IRC and email before submitting, hence the very short time between submitting the complete version and it being marked as complete.  I've mentioned the indentation issues to her, and will work with her offline to show how exactly the indentation should be, however I'm happy to accept the submitted work as-is.