Ask Slashdot: How To Start Reading Other's Code?

BorgeStrand writes "I'm reviving an open source project and need to read up on a lot of existing code written by others. What are your tricks for quickly getting to grips with code written by others? The project is written in C++ using several APIs which are unknown to me. I know embedded C pretty well, so both the syntax, the APIs and the general functionality are things I wish to explore before I can contribute to the project."

Comments

Unit Tests

[Anonymous Coward]

If possible, I would try writing unit tests for the existing code. This tests your understanding of what you are reading and will come in handy later if you change the code. If unit tests already exist then I suggest that you read them since they will tell you the intention of each function.

Doxygen

[mapinguari]

Even without Doxygen's specific format for comments, you can use it to graph object relationships, call-trees, etc.

You can generate docs limited to a few files or classes if you just want to focus on them.

www.doxygen.org

Re:How to read code

[cdp0]

Are there tools that do this automatically?

Have a look at Scitools Understand.

Stackoverflow, CodingHorror

[Anonymous Coward]

Read this: http://stackoverflow.com/questions/3586073/reading-others-code

Also: http://www.codinghorror.com/blog/2012/04/learn-to-read-the-source-luke.html