i don't know whether eclipse will do the job - but i suppose yes. but you have to create the project files yourself.
we have a lot of doxygen comments in our code - and there is a quake2 programming guide - have a look at the coding article in our wiki