With the other ideas you have you probably want to look at making plugins to do the parsing. Then adding plugins for documenting different things can be added (e.g. prototypes, dependencies, inheritance, even collecting existing pod). Could make for a very usefull tool.