Sarge
User Profile | Member List | F.A.Q | Privacy Policy | New Blog | Search Forums | Forums Home
Doomworld Forums : Powered by vBulletin version 2.2.5 Doomworld Forums > Special Interest > Eternity > I want to wiki the documentation
Should I do this?
Yes.
No.
View Results [Edit Poll (moderators only)]
 
Author
All times are GMT. The time now is 13:24. Post New Thread    Post A Reply
printz
CRAZY DUMB ZEALOT


Posts: 9190
Registered: 06-06


I'm copying the contents of EDITREF.HTML 1.90 (the latest EE documentation) to the wiki (http://eternity.youfailit.net). I am going to write a headpage for each "Part", which branches off to each of its "Sections". I really like how BOOMREF/EDITREF is written, and I'd like to make it appear on the Net. And since it's old, after I finish copying it, someone else with deeper knowledge would have to update it with the new stuff. Then, it will have to be linked to from the wiki startpage.

Anyway, is this a good or bad idea? So if it's a bad idea I know to stop and not clog the wiki.

Old Post Aug 15 2009 16:19 #
printz is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
fraggle
Filled with the code of Doom


Posts: 8137
Registered: 07-00


Be bold!

Old Post Aug 15 2009 21:01 #
fraggle is offline Twitter account Youtube Twitch Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
printz
CRAZY DUMB ZEALOT


Posts: 9190
Registered: 06-06


Yeah but people rarely edit the youfailit wiki, but others lead the mappers there anyway. Oh fine then.

Ok, there it is: http://eternity.youfailit.net/index...e=Linedef_types
It's not my writing, and it belongs to version before Simorgh. It's taken from that editref.html until (excluding) "detailed generalized specification". I only added data to the Portal linedef types, by linking to the already existing Linked portals. Most of the pages lack much of the possible important hyperlinks, but I formatted them. I may have to learn some more wiki formatting probably. Some of the data may have to be updated to Nekhbet level.

Thankfully, nothing yet links to my created article.

Last edited by printz on Aug 15 2009 at 21:30

Old Post Aug 15 2009 21:23 #
printz is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
printz
CRAZY DUMB ZEALOT


Posts: 9190
Registered: 06-06


Ok, I added most of EDITREF, except ExtraData (which has its own document) and Detailed generalized (which either is time-based -- we see there about BOOM and DETH --, repeated or too techy).

Here's the finality. Master, add a link to it from the main page :)

Last edited by printz on Aug 15 2009 at 22:40

Old Post Aug 15 2009 22:28 #
printz is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
esselfortium
A Major Doomworld Concern


Posts: 6985
Registered: 01-02


Cool! Some of that stuff could probably be eventually rewritten into a more tutorial-esque form, but having it moved onto the wiki is a good starting point. Thanks, printz :)

Old Post Aug 15 2009 23:11 #
esselfortium is online now Twitter account Youtube || Blog || PM || Post History || Add Buddy IP || Edit || Quote
Gez
Why don't I have a custom title by now?!


Posts: 12391
Registered: 07-07


Careful when documenting codepointers. Something like RemovePod originates straight from Heretic, so it's not "new to Eternity".

Here's the list of Heretic codepointers (some are shared with Doom):
code:
AccTeleGlitter AddPlayerCorpse AddPlayerRain BeakAttackPL1 BeakAttackPL2 BeakRaise BeakReady BeastAttack BeastPuff BlueSpark BoltSpark BossDeath Chase CheckBurnGone CheckSkullDone CheckSkullFloor ChicAttack ChicChase ChicLook ChicPain ClinkAttack ContMobjSound DeathBallImpact DripBlood ESound Explode FaceTarget Feathers FireBlasterPL1 FireBlasterPL2 FireCrossbowPL1 FireCrossbowPL2 FireGoldWandPL1 FireGoldWandPL2 FireMacePL1 FireMacePL2 FirePhoenixPL1 FirePhoenixPL2 FireSkullRodPL1 FireSkullRodPL2 FlameEnd FlameSnd FloatPuff FreeTargMobj GauntletAttack GenWizard GhostOff HeadAttack HeadFireGrow HeadIceImpact HideInCeiling HideThing ImpDeath ImpExplode ImpMeAttack ImpMsAttack ImpMsAttack2 ImpXDeath1 ImpXDeath2 InitKeyGizmo InitPhoenixPL2 KnightAttack Light0 Look Lower MaceBallImpact MaceBallImpact2 MacePL1Check MakePod MinotaurAtk1 MinotaurAtk2 MinotaurAtk3 MinotaurCharge MinotaurDecide MntrFloorFire MummyAttack MummyAttack2 MummyFX1Seek MummySoul NoBlocking Pain PhoenixPuff PodPain RainImpact Raise ReFire RemovePod RestoreArtifact RestoreSpecialThing1 RestoreSpecialThing2 Scream ShutdownPhoenixPL2 SkullPop SkullRodPL2Seek SkullRodStorm SnakeAttack SnakeAttack2 Sor1Chase Sor1Pain Sor2DthInit Sor2DthLoop SorcererRise SorDBon SorDExp SorDSph SorRise SorSightSnd SorZap SpawnRippers SpawnTeleGlitter SpawnTeleGlitter2 Srcr1Attack Srcr2Attack Srcr2Decide StaffAttackPL1 StaffAttackPL2 UnHideThing VolcanoBlast VolcanoSet VolcBallImpact WeaponReady WhirlwindSeek WizAtk1 WizAtk2 WizAtk3
And the Hexen codepointers (some are shared with Doom and/or Heretic):
code:
AddPlayerCorpse BatMove BatSpawn BatSpawnInit BellReset1 BellReset2 BishopAttack BishopAttack2 BishopChase BishopDecide BishopDoBlur BishopMissileSeek BishopMissileWeave BishopPainBlur BishopPuff BishopSpawnBlur BounceCheck BridgeInit BridgeOrbit CentaurAttack CentaurAttack2 CentaurDefend CentaurDropStuff CFlameAttack CFlameMissile CFlamePuff CFlameRotate Chase CheckBurnGone CheckFloor CheckSkullDone CheckSkullFloor CheckTeleRing CheckThrowBomb CHolyAttack CHolyAttack2 CHolyCheckScream CHolyPalette CHolySeek CHolySpawnPuff CHolyTail ClassBossHealth ClericAttack CMaceAttack ContMobjSound CorpseBloodDrip CorpseExplode CStaffAttack CStaffCheck CStaffCheckBlink CStaffInitBlink CStaffMissileSlither DelayGib Demon2Death DemonAttack1 DemonAttack2 DemonDeath DragonAttack DragonCheckCrash DragonFlap DragonFlight DragonFX2 DragonInitFlight DragonPain DropMace ESound EttinAttack Explode FaceTarget FastChase FAxeAttack FHammerAttack FHammerThrow FighterAttack FireConePL1 FiredAttack FiredChase FiredRocks FiredSplotch FlameCheck FloatGib FogMove FogSpawn FPunchAttack FreeTargMobj FreezeDeath FreezeDeathChunks FSwordAttack FSwordFlames HideThing IceCheckHeadDone IceGuyAttack IceGuyChase IceGuyDie IceGuyLook IceGuyMissileExplode IceGuyMissilePuff IceSetTics KBolt KBoltRaise KoraxBonePop KoraxChase KoraxCommand KoraxDecide KoraxMissile KoraxStep KoraxStep2 KSpiritRoam LastZap LeafCheck LeafSpawn LeafThrust Light0 LightningClip LightningReady LightningRemove LightningZap Look Lower MageAttack MinotaurAtk1 MinotaurAtk2 MinotaurAtk3 MinotaurCharge MinotaurChase MinotaurDecide MinotaurFade0 MinotaurFade1 MinotaurFade2 MinotaurLook MinotaurRoam MLightningAttack MntrFloorFire MStaffAttack MStaffPalette MStaffTrack MStaffWeave MWandAttack NoBlocking NoGravity Pain PigAttack PigChase PigLook PigPain PoisonBagCheck PoisonBagDamage PoisonBagInit PoisonShroom PotteryCheck PotteryChooseBit PotteryExplode Quake QueueCorpse Raise ReFire RestoreArtifact RestoreSpecialThing1 RestoreSpecialThing2 Scream SerpentBirthScream SerpentChase SerpentCheckForAttack SerpentChooseAttack SerpentDiveSound SerpentHeadCheck SerpentHeadPop SerpentHide SerpentHumpDecide SerpentLowerHump SerpentMeleeAttack SerpentMissileAttack SerpentRaiseHump SerpentSpawnGibs SerpentUnHide SerpentWalk SetAltShadow SetReflective SetShootable ShedShard SinkGib SkullPop SmBounce SmokePuffExit SnoutAttack SoAExplode SorcBallOrbit SorcBallPop SorcBossAttack SorcererBishopEntry SorcFX1Seek SorcFX2Orbit SorcFX2Split SorcFX4Check SorcSpinBalls SpawnBishop SpawnFizzle SpeedBalls SpeedFade Summon TeloSpawnA TeloSpawnB TeloSpawnC TeloSpawnD ThrustBlock ThrustImpale ThrustInitDn ThrustInitUp ThrustLower ThrustRaise TreeDeath UnHideThing UnSetInvulnerable UnSetReflective UnSetShootable WeaponReady WraithChase WraithFX2 WraithFX3 WraithInit WraithLook WraithMelee WraithMissile WraithRaise WraithRaiseInit ZapMimic

Old Post Aug 17 2009 23:09 #
Gez is offline || Blog || PM || Post History || Add Buddy IP || Edit || Quote
printz
CRAZY DUMB ZEALOT


Posts: 9190
Registered: 06-06



Gez said:
Careful when documenting codepointers.

If you happen see any mistake, edit it. I'm not all the time on it, and merely for the sake of getting rid of (as many) red links (as possible), I copied data from the offline docs. It's already for an older version, and whoever finds that it doesn't work on their version has to just ask Strogg-on-Meth, Quasar or another informed person and do the edit.

Old Post Aug 19 2009 09:06 #
printz is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
Quasar
Moderator


Posts: 6453
Registered: 08-00


The codepointer docs are horribly out of date and now blatantly incorrect on some points due to changes in implementation / bug fixes.

Also, the docs referred to Heretic pointers as "New to Eternity" because Eternity grew out of a DOOM port, and DOOM didn't have Heretic codepointers. So yeah.

Hexen codepointers are not implemented or supported yet.

Also, not all of them have the same names or even exist at all in EE, so do not go by a list of vanilla pointers.

Old Post Aug 22 2009 03:28 #
Quasar is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
printz
CRAZY DUMB ZEALOT


Posts: 9190
Registered: 06-06



Quasar said:
The codepointer docs are horribly out of date and now blatantly incorrect on some points due to changes in implementation / bug fixes.

Like which? I haven't encountered big errors yet.

Old Post Aug 22 2009 14:00 #
printz is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
Quasar
Moderator


Posts: 6453
Registered: 08-00


For example:

Any reference to monster vs player pointers crashing if used interchangeably is now incorrect.

Args for a couple of pointers, such as SpawnGlitter, have changed.

Most damage range info (ie where it tells min or max damage values as plain numbers) is considered useless and should be removed, since they all fail to take the effects of DOOM's limited pseudo-RNG into account. That info is now available on the Doom wiki in a much better format anyway.

Thing counters have been extended from 3 to 8 (and from 16- to 32-bit), so all functions referring to counters need to be updated.

Keywords have been defined for almost all parameterized codepointers, but their method of use and available values have never been documented.

And then finally, tons of pointers are missing because I never got around to documenting them.

There's probably more than this. I was in the process of updating the pointer docs during the last attempt to update the documentation, so some of this stuff may be in a half-fixed state.

Old Post Aug 24 2009 05:04 #
Quasar is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
printz
CRAZY DUMB ZEALOT


Posts: 9190
Registered: 06-06


I built up the list of console commands here at the wiki, based on searching the source code by looking for CONSOLE_ strings inside it. I didn't take my time to explain all of them; I only listed them there. Use them with caution, some have helps, some have usages, but others don't do nothing if parameters are missing, while others work already without parameters.

The main reason I posted this: could someone add a link to the list of console commands I linked above, at the eternity.youfailit.net front page?

Old Post Feb 18 2010 13:24 #
printz is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
Quasar
Moderator


Posts: 6453
Registered: 08-00



printz said:
I built up the list of console commands here at the wiki, based on searching the source code by looking for CONSOLE_ strings inside it. I didn't take my time to explain all of them; I only listed them there. Use them with caution, some have helps, some have usages, but others don't do nothing if parameters are missing, while others work already without parameters.

The main reason I posted this: could someone add a link to the list of console commands I linked above, at the eternity.youfailit.net front page?

Not every article on the wiki should appear on the front page. We need to start building up a solid hierarchy of categories and have the categories visible from the main page, like on other wikis such as the ZDoom wiki.

Also some of the commands you listed are internal commands marked with the cf_hidden flag. Those should be removed from the list, as they are intentionally undocumented and their direct use may be highly detrimental.

EDIT: * I took care of removing some of those commands. Mainly the mn_df* commands that are used internally by the deathmatch flags menu.

Last edited by Quasar on Feb 18 2010 at 19:59

Old Post Feb 18 2010 19:51 #
Quasar is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
printz
CRAZY DUMB ZEALOT


Posts: 9190
Registered: 06-06


Yay for adding info on some of the commands/variables :)

I think they'll also need to be regrouped in better categories. The current lousy clustering was based on their distribution in the source files, and how the CONSOLE_* macro looked like :)

Old Post Feb 18 2010 21:19 #
printz is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
Quasar
Moderator


Posts: 6453
Registered: 08-00



printz said:
Yay for adding info on some of the commands/variables :)

I think they'll also need to be regrouped in better categories. The current lousy clustering was based on their distribution in the source files, and how the CONSOLE_* macro looked like :)

I reorganized it a bit, but it can definitely be tweaked further ;)

Old Post Feb 18 2010 21:24 #
Quasar is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
Quasar
Moderator


Posts: 6453
Registered: 08-00


I have done some recent work on the wiki: cleaning up the thingtype flags, updating the command line parameters, and correcting/tweaking some stuff in the EDF frames article.

Old Post Mar 4 2010 07:19 #
Quasar is offline Twitter account Youtube Github || Blog || PM || Post History || Add Buddy IP || Edit || Quote
Gez
Why don't I have a custom title by now?!


Posts: 12391
Registered: 07-07



Quasar said:
Not every article on the wiki should appear on the front page. We need to start building up a solid hierarchy of categories and have the categories visible from the main page, like on other wikis such as the ZDoom wiki.

Feel free to copy and adapt ZDoom wiki templates that helps doing automatic categorization such as the Special, Wad and Actor ones. Also don't underestimate the power of simple templates such as LE that allow to directly link to a List Entry with other templates like Flag or Property. Finally you may need to use simple templates such as ! and = to work around some problems in wiki syntax.

The sooner these things are adopted, the less work to do; and it makes the wiki a lot more user-friendly.

Old Post Mar 4 2010 17:11 #
Gez is offline || Blog || PM || Post History || Add Buddy IP || Edit || Quote
All times are GMT. The time now is 13:24. Post New Thread    Post A Reply
 
Doomworld Forums : Powered by vBulletin version 2.2.5 Doomworld Forums > Special Interest > Eternity > I want to wiki the documentation

Show Printable Version | Email this Page | Subscribe to this Thread

 

Forum Rules:
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts
HTML code is OFF
vB code is ON
Smilies are OFF
[IMG] code is ON
 

< Contact Us - Doomworld >

Powered by: vBulletin Version 2.2.5
Copyright ©2000, 2001, Jelsoft Enterprises Limited.