Write a tutorial on compiling BRL-CAD with Eclipse on LinuxBRL-CAD
Status: ClosedTime to complete: 48 hrs Mentors: SeanTags: tutorial, compiling, eclipse, linux

BRL-CAD uses the CMake build system to generate outputs for a variety of platforms. It will output Makefiles, Microsoft Visual Studio build files, XCode project files, Eclipse build files and more.

This task involves generating an Eclipse project with our build and verifying that it successfully compiles all of BRL-CAD. Document the process on our wiki as a tutorial. Include images/screen shots when referring to visual actions within Eclipse.

References:

Uploaded Work
File name/URLFile sizeDate submitted
COMPILING BRL-CAD WITH ECLIPSE ON LINUX.pdf813.7 KBNovember 27 2012 23:27 UTC
How to use Eclipse CDT4 Generator.pdf722.2 KBNovember 28 2012 21:12 UTC
COMPILING BRL-CAD.pdf825.0 KBNovember 29 2012 01:50 UTC
COMPILING BRL-CAD 2.pdf1.3 MBNovember 29 2012 14:09 UTC
Comments
iwanmanewon November 27 2012 16:23 UTCTask Claimed

I would like to work on this task.

Harmanpreet Singh on November 27 2012 16:25 UTCTask Assigned

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

iwanmanewon November 27 2012 23:28 UTCReady for review

The work on this task is ready to be reviewed.

Sean on November 28 2012 05:30 UTCkeep that file

So your document is interesting and informative and fantastic and wrong.  Keep it, though.  I'm going to add another task just for you to claim.  You can add that pdf to that task after this one is closed out.


For this task, the point wasn't just compiling with Eclipse.  It was compiling through the cmake-generated Eclipse project.  cmake will output an Eclipse project.  You instructions should have been much shorter and something along the lines of:


run cmake with this option


run eclipse and select Import Existing Project


hit the build button


run mged


See the third reference in the task description in particular.

Sean on November 28 2012 05:30 UTCTask Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

iwanmanewon November 28 2012 21:12 UTCReady for review

The work on this task is ready to be reviewed.

Sean on November 28 2012 21:28 UTCTask Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

iwanmanewon November 28 2012 21:32 UTCReady for review

The work on this task is ready to be reviewed.

iwanmanewon November 28 2012 21:33 UTCproblem ?

what's the problem ?

Sean on November 28 2012 21:35 UTCerhm

That looks much better, it's the right logic steps but the wrong example.  You don't show how to build BRL-CAD...


This is supposed to be a tutorial on building BRL-CAD with Eclipse using the cmake eclipse generator, not a general how-to on using the generator.


From the first image/step, "Where is the source code:" should be pointing to a /home/iwcho/brlcad.src directory so that it picks up our build system.


From there, the rest of the screenshots will change because it'll be our build system and our options being displayed.  Make sense?


 

Sean on November 28 2012 21:36 UTCfor a final touch

there should be a "benchmark" build rule in Eclipse when you've imported and built that will run the BRL-CAD benchmark suite.  that'll be a nice finishing touch.

Sean on November 28 2012 21:37 UTCby the way

I've created the other task for your first write-up but won't published it just yet until this one is closed so nobody else claims it.

iwanmanewon November 28 2012 21:42 UTC ?

I'm ok about that, but from where i can get BRL-CAD example project ? I made it in that way, because I dont have any BRL-CAD projects. And can you give me some orientations about  "a "benchmark" build rule" ? 

Sean on November 28 2012 21:56 UTCmisunderstanding

You're completely misunderstanding something.


You don't need a "BRL-CAD example project" .. you need to download the BRL-CAD source code.  Our source code isn't an example -- it IS a project. 


To reiterate, I think you need to try and compile BRL-CAD from sources manually so that you will hopefully understand these steps a little better.  Follow these steps: http://brlcad.org/wiki/Compiling


Once you do that, it should make more sense.

Sean on November 28 2012 22:00 UTCTask Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

iwanmanewon November 29 2012 01:50 UTCReady for review

The work on this task is ready to be reviewed.

Sean on November 29 2012 03:14 UTCTask Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

Sean on November 29 2012 03:23 UTCmuch closer!

That's much better iwanmanew!  The only concern was the last page/image and the instructions.  You compiled, but you didn't say how you compiled.  The instructions should tell them what to do.  You also didn't run the benchmark, you just opened the source file for the benchmark.


Make an image that shows all of the compilation output as the main window.  Then show them how they can run MGED.  To run MGED, it should be listed on the left under [Targets].  Select it and tell it to run.  That'll make a nice final screenshot (mged windows on top of eclipse).


 

iwanmanewon November 29 2012 14:09 UTCReady for review

The work on this task is ready to be reviewed.

Sean on November 29 2012 14:19 UTCTask Closed

Congratulations, this task has been completed successfully.

Sean on November 29 2012 14:20 UTCperfect

Now that looks perfect. :)


Nice work, iwanmanew.

iwanmanewon November 29 2012 14:26 UTCthanks

Тhanks for the help ! Can you give me a link with my next task for the first tutorial which I made ?