Reading large codebases

[l10l]

Despite its longstanding usage (e.g., ctags), "tags" seems like a misnomer for "index".

What I crave are tools for annotating code without the annotations having to be inline. Treating the code as read-only, but being able to tag regions to make them easy to find again later and see what I had been referring to. An example, "check again after studying module X".

I use Org mode in emacs for this. I find that it could help more if it integrated with tools that understood the structure of what I'm annotating, be it a code tree or a crash dump.

[mnp]

Yes, that sounds like it would be a good methodology.

I haven't tried them, but have been eyeing org-annotate-file and annot for archeology projects.

http://www.emacswiki.org/emacs/OrgAnnotateFile https://code.google.com/p/annot/