Difference between revisions of "Development Docs"

From Armagetron
m (eltcazels)
m (Update macOS link)
(20 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[http://whate.freeddns.com/pages/cool-away-messages.html cool away messages] [http://devil.4mydomain.com/articles/banana-song.html banana phone song] [http://bouts.4dq.com/twintowers.html twintowers] [http://whelp.zyns.com/lib/savon-drugs.html savon drugs] [http://jovem.zyns.com/topic/dunks.html dunks] [http://homeostasis.uni-nail.com/ homeostasis definition] [http://comic.ddns.ms/small/nascar-schedule.html nascar racing schedule] [http://bundle.fadlan.com/comments/famous-stars.html famous stars and straps hats] [http://revolt.fadlan.com/pages/male-beauty.html male beauty tip] [http://samira.mioforum.com/ samira] [http://spital.ddns.us/q/computer-sale.html desktop computer for sale] [http://reggatone-nina.voodoo-ref.com/ reggatone nina sky] [http://bedrid.4mydomain.com/bridal-lace.html bridal crochet doily lace pattern] [http://unsecured-debt.uni-nail.com/ unsecured bank loan for debt consolidation] [http://belly.zyns.com/samsung-cell.html samsung cell phone] [http://biter.4dq.com/description/teen-girls-finger.html finger a teen girl] [http://wireless-gps.voodoo-ref.com/ wireless gps] [http://surse.justdied.com/content/yamaha-music.html yamaha music] [http://hear.zyns.com/html/aaron-feinberg.html aaron feinberg] [http://hearts.ddns.us/blog/office-world.html office world] [http://design-and-domain.uni-nail.com/ design and domain registration] [http://penned.4dq.com/content/macco.html macco] [http://bottle.4dq.com/pages/soldiers-never.html soldiers never die they just fade away] [http://bundle.fadlan.com/comments/lamborginis.html lamborginis] [http://blackjack.mioforum.com/ 3.000000 gen key style version xp] [http://immersion-ppt.sugaryblog.com/ immersion ppt weapon] [http://snatch.ddns.us/data/pr600-targus.html pr600 targus] [http://percy.mooo.com/new/humulin-l.html humulin l] [http://device.ddns.ms/description/viperfish-photos.html viperfish photos] [http://bottle.4dq.com/pages/taste-of-chicago.html taste of chicago] [http://widow.fadlan.com/small/car-top-carrier.html car top carrier] [http://sects.ftpserver.biz/new/sailor-moon-lesbian.html sailor moon lesbian sex] [http://bettre.got-game.org/directory/mature-pussy.html mature pussy] [http://troien.zyns.com/description/locating-real-estate.html locating real estate] [http://rased.ddns.ms/new/pregnancy-calculation.html pregnancy calculation due date] [http://ethiop.got-game.org/hoyer-lift.html hoyer lift pad] [http://chaud.my03.com/plan-toys.html plan toys] [http://surse.justdied.com/content/custom-aquarium.html custom aquarium] [http://liest.zyns.com/new/rio-carnival.html rio carnival] [http://under-16-nude.uni-nail.com/ under 16 nude] [http://troien.zyns.com/description/internal-combo.html internal combo drive] [http://fathom.fadlan.com/view/wholesale-atv.html atv dealer wholesale] [http://notify.ddns.us/new/allergy-milk-soy.html allergy milk soy] [http://kingfisher-swimming.mioforum.com/ kingfisher swimming pool sudbury] [http://surse.justdied.com/content/military.html military school] [http://breach.my03.com/resources/wwwyearonecom.html www.yearone.com] [http://biter.4dq.com/description/tennis-ball-machines.html tennis ball machines] [http://free-nudist.mioforum.com/ free nudist] [http://bundle.fadlan.com/comments/extreme-water.html extreme water bondage] [http://2001-acura-cls.uni-nail.com/ 2001 acura cls] [http://brisk.zyns.com/wiki/colleen-camp.html archive camp colleen movie] [http://diseas.4mydomain.com/q/all-your-bas.html all your bas] [http://we-will-rock-you.mioforum.com/ queen we will rock you lyric] [http://penned.4dq.com/content/12-yo.html 12 grils rompl yo young] [http://device.ddns.ms/description/love-addiction.html love addiction] [http://defuse.got-game.org/q/austin-realtors.html austin realtors] [http://lipman-contemporary.voodoo-ref.com/ lipman contemporary art] [http://bender.got-game.org/drummond-island.html drummond island] [http://fingre.freeddns.com/html/wisconsin-dells.html wisconsin dells waterpark resort] [http://bowing.ddns.ms/washington-skate.html washington skate parks] [http://bedrid.4mydomain.com/vision-impared.html vision impared] [http://penned.4dq.com/content/naked-beaches.html naked nude beach] [http://kaja-paschalska.uni-nail.com/ kaja paschalska ckm] [http://hot-packs.voodoo-ref.com/ hot packs] [http://bowing.ddns.ms/malcolm.html malcolm speech x] [http://device.ddns.ms/description/matheson-company.html matheson company edmonton] [http://chaud.my03.com/ebony-swallow.html ebony swallow] [http://empery.ddns.ms/data/pet-turtle.html live pet turtles] [http://strict.ddns.ms/lib/nagar-nigam-indore.html nagar nigam indore] [http://online-medical.mioforum.com/ online medical billing jobs] [http://sears-store.uni-nail.com/ sears store] [http://biter.4dq.com/description/private-middle.html private middle schools san diego] [http://minos.mooo.com/text/silo-cleaning-machines.html silo cleaning machines] [http://nimble.4mydomain.com/data/men-sleeping.html bag man sleeping spider] [http://sponge.zyns.com/sitemap.html www] [http://hear.zyns.com/html/galveston-texas.html galveston texas] [http://autumn.freeddns.com/1-24-slot-car-tracks.html 1 24 slot car track] [http://widow.fadlan.com/small/tar-a-directory.html tar a directory] [http://comic.ddns.ms/sitemap.html home] [http://autumn.freeddns.com/steve-lukather.html steve lukather] [http://bettre.got-game.org/directory/keyless-lock.html keyless lock] [http://desist.ddns.us/directory/big-black-boobs.html big black boobs] [http://bottle.4dq.com/pages/ford-puma.html ford puma tuning] [http://taste.ftpserver.biz/web/utah-realtors.html utah realtors] [http://annuity-advice.mioforum.com/ annuity advice] [http://ethiop.got-game.org/electric-amish.html electric amish] [http://neo-pi-r-test.uni-nail.com/ neo pi r test] [http://percy.mooo.com/new/airtel-karnataka.html airtel karnataka home page] [http://seated.xxxy.info/mythological-names.html mythological name] [http://bundle.fadlan.com/comments/metal-door-and.html metal door and window screens] [http://cat-clip-art.mioforum.com/ cat paw print clip art] [http://mcafee.sugaryblog.com/ free mcafee] [http://bettre.got-game.org/directory/age-of-empires.html age of empires 3] [http://device.ddns.ms/sitemap.html link] [http://seated.xxxy.info/japanese-rice.html japanese rice] [http://bettre.got-game.org/directory/movado-watches.html movado watches] [http://www.mioforum.com/sitemap.html webmap] [http://saving.ddns.ms/resources/traveling-nurse.html traveling nurse] [http://biter.4dq.com/description/lingerie-sexi.html lingerie sexi] [http://spital.ddns.us/q/tribal-tattoo.html tribal cross tattoo] [http://meagre.fadlan.com/html/air-premiers.html air premiers symptomes] [http://sunder.got-game.org/web/map-of-florida.html map of tampa florida] [http://revolt.fadlan.com/pages/look-in-a-vagina.html what does a vagina look like] [http://weekly-planners.mioforum.com/ planner weekly] [http://empery.ddns.ms/data/nickel-back.html nickel back] [http://liest.zyns.com/new/puffer.html puffer] [http://percy.mooo.com/new/southwest-pool-cue.html southwest pool cue] [http://snatch.ddns.us/data/milwaukee-power.html milwaukee part power tool] [http://breach.my03.com/resources/bmw-repair-dallas.html bmw repair dallas] [http://mover-show-toronto.uni-nail.com/ mover show toronto trade] [http://jeremy-hotz.mioforum.com/ jeremy hotz] [http://surse.justdied.com/content/lidar.html stalker lidar] [http://pgm-dress-forms.uni-nail.com/ pgm dress forms] [http://breach.my03.com/resources/baker-university.html baker university kansas] [http://spital.ddns.us/q/gayvideo.html gayvideo] [http://biter.4dq.com/description/female-tennis.html photo female tennis star] [http://picture-of-comic.voodoo-ref.com/ picture of comic book superheroes] [http://rolls.zyns.com/beretta.html beretta gun] [http://liest.zyns.com/new/fainting-goats.html fainting goats] [http://revolt.fadlan.com/pages/jermar-software.html jermar software corp] [http://bender.got-game.org/promotional-trade.html promotional trade show items] [http://dagger.mooo.com/directory/rocco-animal.html rocco animal trainer] [http://hearts.ddns.us/blog/perforated-round.html perforated round label] [http://desist.ddns.us/directory/diet-lipozene.html day diet lipozene pill] [http://taurus.fadlan.com/data/sixdegrees-inc.html sixdegrees inc] [http://bender.got-game.org/displacement.html displacement transducer] [http://muffl.ddns.ms/data/craft-ideas.html craft ideas for fathers day] [http://comic.ddns.ms/small/maxim-lighting.html maxim lighting] [http://chaud.my03.com/exxon-mobile.html exxon mobile stock prices] [http://cool-science.uni-nail.com/ 101 cool experiment glen science singleton] [http://absey.zyns.com/sitemap.html url] [http://breach.my03.com/resources/star-trek-uniforms.html star trek uniforms] [http://hearts.ddns.us/blog/modem-ambient.html modem ambient md5628d l a] [http://biter.4dq.com/description/nick-hornsby-fever.html nick hornsby fever pitch] [http://breach.my03.com/resources/ryan-pereira.html ryan pereira] [http://defuse.got-game.org/q/ringing-ears.html ringing in ear] [http://rolls.zyns.com/united-airline.html united airline flight status] [http://bouts.4dq.com/multanimous.html multanimous] [http://pinetop-arizona.mioforum.com/ pinetop arizona real estate] [http://revolt.fadlan.com/pages/dictionaries.html dictionaries] [http://fingre.freeddns.com/html/mrpiano.html mrpiano] [http://bitten.zyns.com/505-jeans-levi.html 505 jeans levi man] [http://device.ddns.ms/description/symbolism-in-the.html symbolism in the lady of shalott] [http://snatch.ddns.us/data/88-toyota-camry.html 88 toyota camry pictures] [http://belly.zyns.com/luxor-crack.html luxor crack] [http://bedrid.4mydomain.com/kathryn-brundage.html kathryn brundage] [http://linens.4mydomain.com/resources/2-pac-california.html 2 pac california love] [http://bottle.4dq.com/pages/shuttle-bus.html shuttle bus sales] [http://notify.ddns.us/new/lyrics-to-the-pajama.html lyrics to the pajama game online] [http://desist.ddns.us/directory/blue-cross-blue.html blue cross blue shield health insurance] [http://bloodrayne2-wallpaper.voodoo-ref.com/ bloodrayne2 wallpaper] [http://dagger.mooo.com/directory/celebrity-videos.html celebrity videos] [http://bowing.ddns.ms/celebrity-skin.html care celebrity product skin] [http://revolt.fadlan.com/pages/ouija-board-conversations.html ouija board conversations evil] [http://bender.got-game.org/pantothenic-acid.html acid effects pantothenic side] [http://percy.mooo.com/new/floral-arrangements.html floral arrangements] [http://bedrid.4mydomain.com/picka-boobie.html picka boobie] [http://empery.ddns.ms/data/costume-pirate.html womens pirate costume] [http://device.ddns.ms/description/jamies-thumbnails.html jamies thumbnails] [http://rased.ddns.ms/new/cupid.html cupid and psyche] [http://seated.xxxy.info/dog-fuckers-sex.html dog fuckers sex] [http://absey.zyns.com/multicultural.html cant dont education know multicultural multiracial paper school teach teacher we we white] [http://widow.fadlan.com/small/management-marbella.html management marbella property] [http://saving.ddns.ms/sitemap.html domain] [http://black-sabath.voodoo-ref.com/ black sabath] [http://bundle.fadlan.com/comments/frogger.html frogger] [http://jovem.zyns.com/topic/belly-gallery.html baby belly gallery] [http://seated.xxxy.info/redfox.html redfox] [http://peruse.zyns.com/comments/amateur-cum-shot.html amateur cum porn shot] [http://brisk.zyns.com/wiki/science-journal.html science journal] [http://notify.ddns.us/sitemap.html url] [http://desist.ddns.us/directory/finding-cell.html finding cell phone numbers] [http://led-symbol-zeppelin.voodoo-ref.com/ led symbol zeppelin] [http://bundle.fadlan.com/comments/experiment.html experiment] [http://edna.sugaryblog.com/ edna] [http://rolls.zyns.com/bibles-online.html online bible commentary] [http://hearts.ddns.us/blog/train-drivers.html train drivers union] [http://trunk.got-game.org/blog/stevie-nix.html stevie nix] [http://bettre.got-game.org/directory/freezerless-refrigerator.html whirlpool freezerless refrigerator] [http://civet.ddns.ms/description/mini-rc-boat.html mini rc boat] [http://bender.got-game.org/lincoln-aviator.html lincoln aviator rims] [http://bitten.zyns.com/archaeological.html archaeological find] [http://branson-mo-weather.mioforum.com/ branson mo weather] [http://whelp.zyns.com/sitemap.html link] [http://welkin.4dq.com/new/lords-cricket.html lords cricket shop] [http://olkneen.fadlan.com/summarize-and.html summarize and paraphrase] [http://breach.my03.com/resources/methanol.html methanol] [http://minos.mooo.com/text/target-national.html target national bank] [http://snatch.ddns.us/data/road-grader.html road grader] [http://nessus.mooo.com/view/computer-crime.html computer crime] [http://trunk.got-game.org/blog/wwwverizonwirelesscom.html www.verizonwireless.com] [http://sponge.zyns.com/lib/tayland-map.html tayland map] [http://linens.4mydomain.com/resources/vonda-shepard.html dan hill shepard vonda] [http://biter.4dq.com/description/jeffrey-wu-md.html jeffrey wu m.d.] [http://percy.mooo.com/new/bulls-eye.html bulls eye credit union] [http://brisk.zyns.com/wiki/water-mocassin.html water mocassin] [http://surse.justdied.com/content/new-jersey-herald.html new jersey herald] [http://devil.4mydomain.com/articles/proposing-youre.html proposing youre] [http://brisk.zyns.com/wiki/inter-changeable.html inter changeable parts] [http://fathom.fadlan.com/view/northeast-fine.html northeast fine jeweler]
 
olotreltgett
 
 
{{Sections}} <!-- Template:Sections should be at the top of each section -->
 
{{Sections}} <!-- Template:Sections should be at the top of each section -->
  
Line 22: Line 20:
  
 
* [[Windows Development]]
 
* [[Windows Development]]
* Linux
+
* [[Linux Development]]
* Mac OS X
+
* [[macOS]]
 
 
todo: the linux and mac os x pages
 
  
 
== Other useful hacker documentation ==
 
== Other useful hacker documentation ==
  
 
* [[Windows Development System]]
 
* [[Windows Development System]]
* [[Working with SVN]]
 
 
* [[Cross-compiler]]
 
* [[Cross-compiler]]
 
* [[Used Libraries]]
 
* [[Used Libraries]]
 +
* [http://wrtlprnft.ath.cx/doxy/html/ Doxy]
 +
* [https://blueprints.launchpad.net/armagetronad Blueprints on launchpad]
 +
* [http://forums3.armagetronad.net/viewtopic.php?p=263866#p263866 Video tutorials on building sty+ct on Windows]
 +
 +
== Source Control ==
 +
 +
* [[Working with SVN]]
 +
* [[Bazaar]] and how we use it
 
* [[Working with SVK]]
 
* [[Working with SVK]]
* [http://wrtlprnft.ath.cx/doxy/html/ Doxy]
 
  
 
== Stuff That's Current ==
 
== Stuff That's Current ==
Line 45: Line 47:
 
* [[Adding a buildslave]]
 
* [[Adding a buildslave]]
  
== Stuff in SVN HEAD ==
+
== Stuff in SVN/BZR HEAD ==
  
 +
* [[Authentication]] -> [[Hash Based Authentication]]
 +
** [[Web Authentication]]
 
* [[Embedded Web Server]]
 
* [[Embedded Web Server]]
 
* [[Map/Config Rotation]]
 
* [[Map/Config Rotation]]
Line 54: Line 58:
 
* [[Spawn points]]
 
* [[Spawn points]]
 
* [[Zones v2]]
 
* [[Zones v2]]
 
 
* [[Cockpit Tutorial]] | [[Cockpits list]]
 
* [[Cockpit Tutorial]] | [[Cockpits list]]
 
* [[vValue]]
 
* [[vValue]]
 +
 +
== Stuff that's in branches ==
 +
 +
* [[Scripted GUI Notes]] -> [[eEvent]]
 +
** [[eEvent Resource]]
 +
* [[Modules]] (personal branch)
 +
* [[CMake]]
  
 
== Data File Handling ==
 
== Data File Handling ==
Line 63: Line 73:
 
* [[Resource System]]
 
* [[Resource System]]
 
* [[Statistical Collections Database]] (fancy way of saying "stat files")
 
* [[Statistical Collections Database]] (fancy way of saying "stat files")
 
== Source Control ==
 
 
* [[Bazaar]] and how we use it
 
  
 
== Stuff That's Real but doesn't fit above ==
 
== Stuff That's Real but doesn't fit above ==
Line 72: Line 78:
 
* [[Experimental Map Features]]
 
* [[Experimental Map Features]]
 
* [[Send DTD on the resource repository through ssh]]&mdash;only of interest for people on the development team
 
* [[Send DTD on the resource repository through ssh]]&mdash;only of interest for people on the development team
 +
* [[XML Network Message]]/protobuf
  
 
== Wishlist, or Stuff that's planned ==
 
== Wishlist, or Stuff that's planned ==
Line 78: Line 85:
  
 
* [[Goals]]
 
* [[Goals]]
* [[Scripted GUI Notes]]
+
* [[Chroot build environment]]
* [[Authentication]]
 
 
* [http://forums.armagetronad.net/viewtopic.php?t=986 Reshaping the Arena]
 
* [http://forums.armagetronad.net/viewtopic.php?t=986 Reshaping the Arena]
 
* [http://forums.armagetronad.net/viewtopic.php?t=1742 Map format]
 
* [http://forums.armagetronad.net/viewtopic.php?t=1742 Map format]

Revision as of 06:17, 14 February 2021


Sections: Installing the Game | Playing the Game | Competition Hub | Server Administration | Extending Armagetron Advanced | Development Docs


This is documentation for developers or for people who just want to hack on the code. It is not intended to replace the automatic API documentation generated by doxygen (we do have a doxyfile, right?), but is intended to supplement those documents with additional information that may not necessarily appear in the API docs. It is also not intended as a substitute for good commenting tactics. And finally, it is a place to put planning documentation (like the stuff Philippe writes), proposals, RFC-type material, and so forth. But not the roadmap, we use Sourceforge's tracker for that.

Documentation

Building the Game

Building Armagetron Advanced boils down to 4 basic steps. The steps themselves are each highly platform-dependent, but the four steps are the same everywhere. Each step differs further in whether or not you're building from a branch or the trunk, and each branch may differ. Finally, each step differs depending on if you're building a source release or from version control. Here we'll concern ourselves with building the trunk only. Releases should include their own build instructions.

  1. Install the development environment
  2. Satisfy dependencies
  3. Unpackage source/source checkout from version control
  4. Build a distribution

Platform-specific instructions (they should all follow the four step structure given, that's why it's there!):

Other useful hacker documentation

Source Control

Stuff That's Current

Stuff in SVN/BZR HEAD

Stuff that's in branches

Data File Handling

Stuff That's Real but doesn't fit above

Wishlist, or Stuff that's planned

(Might not be planned, but this is it)

History

This is stuff that's of historical significance to the project. It's very difficult to remember where you're going if you don't remember where you came from, right? This is technical stuff. Community history should have its own section.


Sections: Installing the Game | Playing the Game | Competition Hub | Server Administration | Extending Armagetron Advanced | Development Docs


Information about the current Armagetron Advanced Development. How to compile the game or current working in progress.