Engine documentation online

A forum for the discussion and development of programs to assist working on or playing with the Vegastrike engine and data sets.
Post Reply
ezee
Intrepid Venturer
Intrepid Venturer
Posts: 703
Joined: Tue Feb 11, 2014 12:47 am
Location: FRANCE
Contact:

Engine documentation online

Post by ezee »

Hi !

As i am taking the train for programming in the Vega strike environment , i have found useful to compile a doc of
the actual vegastrike-src-0.5.1.r1 source code .

I have the doc in my dropbox , and i share with you the index here :
https://www.dropbox.com/s/jb46a58c5tu4gie/index.html

A better exemple here with a list of all the classes :
https://www.dropbox.com/s/51zjzptovep7xeq/classes.html

This is useful because even if the code is not commented , all the class hierarchy is described , with links to the source files .
Yeah , it's a Doxygen generated html doc ...

A cool thing would be that this doc will be accessible via the wiki for exemple ?
( a strategic place could be here : http://wiki.vega-strike.org/DOCs )
When someone has a specific idea , the doc is there , giving to everyone a way to examine how to achieve the goal or just
argument .
And i think it's a good thing to share the same information , for a better understanding .

The OGRE3D community use it for exemple :
http://www.ogre3d.org/docs/api/1.9/

I don't know how long the folder will exist in my dropbox , so perhaps you could consider to host a doc like this in your server ?
( if you finally find that it's a good idea of course ) .

Edit :
mmm... the links i provided point to a download of a single file, in a result the full doc won't be browsable .
:mrgreen:
SO HERE IS THE ALL DOC ( 25 mega ):
https://www.dropbox.com/sh/96p8y63u3w8q6ka/mIt-ccYNue
My goal is to provide a doc online , but i actually don't own a http server .
Someone ?
:)

Code: Select all

 if (!track.HasWeapons())
            {
                // So what are you going to threaten me with? Exhaustion gas?
                return ThreatLevel::None;
            }
Vegastrike evolved
DEV YOUTUBE CHANNEL
Vegastrike evolved wiki
TBeholder
Elite Venturer
Elite Venturer
Posts: 753
Joined: Sat Apr 15, 2006 2:40 am
Location: chthonic safety

Re: Engine documentation online

Post by TBeholder »

Currently, the main sourcecode docs are comments to patches and the annotated list of confvars. ;)
Seriously, though, this stuff says a lot.
"Two Eyes Good, Eleven Eyes Better." -Michele Carter
klauss
Elite
Elite
Posts: 7243
Joined: Mon Apr 18, 2005 2:40 pm
Location: LS87, Buenos Aires, República Argentina

Re: Engine documentation online

Post by klauss »

Nice. We could certainly add this to the site. It would be nice if it was automatically updated too, but for now manual updating will have to do.
Oíd mortales, el grito sagrado...
Call me "Menes, lord of Cats"
Wing Commander Universe
ezee
Intrepid Venturer
Intrepid Venturer
Posts: 703
Joined: Tue Feb 11, 2014 12:47 am
Location: FRANCE
Contact:

Re: Engine documentation online

Post by ezee »

Thank you TbeHolder for the link !
:wink:

Hi Klauss .
It would be nice if it was automatically updated too, but for now manual updating will have to do.
Yes , i think that someone in the dev team could be assigned with that task ( to make the doc for each release ) .
And someone else in charge of the wiki could then put the doc online ?
I'm glad that you've find that idea nice , that's promising for the future recruitment of devs .
:wink:

Automatically updated ? mmm... you know a way to achieve that ?
I will search a bit .
:)

Code: Select all

 if (!track.HasWeapons())
            {
                // So what are you going to threaten me with? Exhaustion gas?
                return ThreatLevel::None;
            }
Vegastrike evolved
DEV YOUTUBE CHANNEL
Vegastrike evolved wiki
klauss
Elite
Elite
Posts: 7243
Joined: Mon Apr 18, 2005 2:40 pm
Location: LS87, Buenos Aires, República Argentina

Re: Engine documentation online

Post by klauss »

ezee wrote:Automatically updated ? mmm... you know a way to achieve that ?
I will search a bit .
:)
Just a cron somewhere, that checks for commits, and if any, rebuilds the docs and rsyncs to the webserver. Simple to set up, if one has a machine always-on to do that.
Oíd mortales, el grito sagrado...
Call me "Menes, lord of Cats"
Wing Commander Universe
loki1950
The Shepherd
Posts: 5841
Joined: Fri May 13, 2005 8:37 pm
Location: Ottawa
Contact:

Re: Engine documentation online

Post by loki1950 »

And someone else in charge of the wiki could then put the doc online ?
Nothing is stopping you as all that is needed is a forum account for edit rights ;) After all what use is a wiki if it can't be edited by users.

Enjoy the Choice :)
my box::HP Envy i5-6400 @2Q70GHzx4 8 Gb ram/1 Tb(Win10 64)/3 Tb Mint 19.2/GTX745 4Gb acer S243HL K222HQL
Q8200/Asus P5QDLX/8 Gb ram/WD 2Tb 2-500 G HD/GF GT640 2Gb Mint 17.3 64 bit Win 10 32 bit acer and Lenovo ideapad 320-15ARB Win 10/Mint 19.2
ezee
Intrepid Venturer
Intrepid Venturer
Posts: 703
Joined: Tue Feb 11, 2014 12:47 am
Location: FRANCE
Contact:

Re: Engine documentation online

Post by ezee »

Nothing is stopping you as all that is needed is a forum account for edit rights ;)
ah ah ah , sure !
But my skill is actually limited to c++ code ( i'm a noob with php , never tried to edit a wiki , etc ... )
Well , i like to learn new things so why not ?
Thank you for allow me to apply my ideas !

But ... The doc is a big folder . ( 25 megas with .html and latex - i can remove the latex part )
Can i upload the folder via a ftp ? ANd where ?
Then i could just add a link in the wiki to the index of the .html tree .

Do You know a better way ?
:?:

Edit : Okay , i added a line in the wiki , but that is all i can do for now :
http://wiki.vega-strike.org/DOCs

I think the link should point to a page dedicated to the actual release version ,
with a direct link to the index of the html doc ( hosted where ? )

Code: Select all

 if (!track.HasWeapons())
            {
                // So what are you going to threaten me with? Exhaustion gas?
                return ThreatLevel::None;
            }
Vegastrike evolved
DEV YOUTUBE CHANNEL
Vegastrike evolved wiki
loki1950
The Shepherd
Posts: 5841
Joined: Fri May 13, 2005 8:37 pm
Location: Ottawa
Contact:

Re: Engine documentation online

Post by loki1950 »

It really should be hosted on our sever but I don't have access www2 is the prime maintainer of our domain pheonixstorm and klauss also have the sever pw so a PM to ether of them should do the trick for setting things up like ftp access for you or watt ever works.

Enjoy the Choice :)
my box::HP Envy i5-6400 @2Q70GHzx4 8 Gb ram/1 Tb(Win10 64)/3 Tb Mint 19.2/GTX745 4Gb acer S243HL K222HQL
Q8200/Asus P5QDLX/8 Gb ram/WD 2Tb 2-500 G HD/GF GT640 2Gb Mint 17.3 64 bit Win 10 32 bit acer and Lenovo ideapad 320-15ARB Win 10/Mint 19.2
ezee
Intrepid Venturer
Intrepid Venturer
Posts: 703
Joined: Tue Feb 11, 2014 12:47 am
Location: FRANCE
Contact:

Re: Engine documentation online

Post by ezee »

Thank you Loki .
I have finally used my personal space to upload the doc .
http://wiki.vega-strike.org/DOXYGEN_DOCUMENTATION
You are free buddies to host the doc ( to secure the thing just in in case ) and change the link in the wiki .
WE HAVE A DEV DOC ONLINE GUYS !
:lol:

PS : This is a very basic doc ( but very cool too , try the search box ...), i don't master DOxygen .
I will try to make it better , and fill for exemple the ToDO list with updated text .
Also a brief presentation would be nice at the main page of that doc.

Code: Select all

 if (!track.HasWeapons())
            {
                // So what are you going to threaten me with? Exhaustion gas?
                return ThreatLevel::None;
            }
Vegastrike evolved
DEV YOUTUBE CHANNEL
Vegastrike evolved wiki
Post Reply