Update and expand our brep command manual pageBRL-CAD
Status: ClosedTime to complete: 100 hrs Mentors: Sean, Ch3ckTags: text editing, docbook, documentation, xml

This is a follow-on task to http://www.google-melange.com/gci/task/view/google/gci2013/6304634838712320

BRL-CAD's MGED geometry editor provides hundreds of commands. One of those commands for manipulating and visualizing geometry is the ''brep'' command.

This task involves writing and/or extensively expanding the manual page for that command in the Docbook XML format. Note that the brep command has numerous options that you will be expected to document.

There are lots of examples to follow if you're not familiar with docbook or xml. It's really very simple, a lot like html.

References:

  • doc/docbook/system/mann/en/*.xml (read these for examples to follow)
  • bin/mged (you'll need to run this to actually use the ''brep'' command, if you want to learn it in order to document it)
  • bin/csgbrep (will create a slew of 'brep' NURBS objects that the ''brep'' command can work with if you want to learn how to use the command interactively first)

Code:

  • doc/docbook/system/mann/en/brep.xml (you expand/update this)

Running ''make'' in a build directory will compile your documentation into html and man page format so you can validate the syntax and formatting. See [[Compiling]] for help. Your update must pass validation, which happens when you run "make" so do be sure to compile BRL-CAD.

Uploaded Work
File name/URLFile sizeDate submitted
task-31-update-expand-brep-man-page.diff25.4 KBDecember 16 2014 01:53 UTC
Comments
Andromeda Galaxyon December 15 2014 17:40 UTCTask Claimed

I would like to work on this task.

Deepak on December 15 2014 17:48 UTCTask Assigned

This task has been assigned to Andromeda Galaxy. You have 100 hours to complete this task, good luck!

Andromeda Galaxyon December 16 2014 01:53 UTCReady for review

The work on this task is ready to be reviewed.

Sean on December 16 2014 06:12 UTCTask Closed

Congratulations, this task has been completed successfully.