Doxygen
#1
For those who haven't noticed, I have managed to cobble together a doxygen config file that generates the doxygen documentation from the MCServer sources. This is especially useful for viewing the class hierarchy or some base overview of the code.

It would be immensely helpful if all the devs could add comments to newly written code, at least to the major functions, documenting what the code does. I've been doing something like that for some time, should you need an example.
This is even more useful for functions that are virtual and there are descendants overriding those functions. Interface definitions are a must. If there's ever a need to make yet another descendant, it's vital that we know what each virtual function does exactly. See the cChunkGenerator.h file for an example.

I know that writing docs is boring and noone likes to do that, but it's the stuff that helps the most in the long run. Please try to do it at least a little bit. Smile
Reply
Thanks given by: LogicParrot
#2
Warm up!!!

Wouldn't it be good if the DoxyGen manual generated automatically on @bearbin s buildserver?
Reply
Thanks given by:
#3
I tried setting automatic builds on my webhost: http://mc-server.xoft.cz/doxy/html/
I didn't manage to schedule it to run regularly, though.
Reply
Thanks given by:
#4
This is awesome
Reply
Thanks given by:
#5
It's easy using the crontab. Does it run on a linux server?
Reply
Thanks given by:
#6
I have a question: Doxygen is supposed to auto-generate the docs from source, but where is it grabbing the sentences from?
For instance, bool cWorld::AddChunkClient has this description:

Quote:Adds client to a chunk, if not already present; returns true if added, false if present

But this sentence does not exist in World.h or World.cpp. So, where was it fetched from?
Reply
Thanks given by:
#7
It does run on Linux, but I don't have root access to it - it's semi-managed. Also they seem to have some sort of CPU throttle, when I ran something too CPU-intensive for some time, the thing would just kick me and reboot.
Reply
Thanks given by:
#8
The doxy pages are about half a year old, the sources may have changed in the meantime.
Reply
Thanks given by:
#9
It's in the header: https://github.com/mc-server/MCServer/bl...#L357-L358
Reply
Thanks given by:
#10
(02-16-2015, 03:29 AM)xoft Wrote: It's in the header: https://github.com/mc-server/MCServer/bl...#L357-L358

Oh, thanks. So this is outdated.
Reply
Thanks given by:




Users browsing this thread: 2 Guest(s)