jassdoc
jassdoc copied to clipboard
Incorporate info from wc3jass.com?
The website disappeared in 2008. Some of it remains on the Wayback Machine: https://web.archive.org/web/20080911204136/http://wc3jass.com/
Moyack recreated the website in 2012 but it has been erased since.
Apparently some of the tips described there made it verbatim to current day, like Jass: Known bugs says:
GroupEnumUnitsInRectCounted and GroupEnumUnitsInRangeCounted Those two natives seems to show irregular behaviour when used on large numbers of units.
I remember seeing that exact wording not too long ago (until I described these functions).
The plan:
- Read notable forum topics, write down (possibly historic) information from there. Especially the totally undocumented and unintuitive natives will be helpful // UPD: DONE. All of them.
- Optional: go back and recreate test cases for affected warcraft versions. // UPD: NOT NEEDED.
Do we need to do this?
Most info on Jass will still be relevant. Some info is not, because various bugs have been fixed. Still, the community is pretty much split between 1.24 (old maps with return bug), 1.26 (maps making use of memhack), 1.30/1.31 (our reforged-less brothers and sisters), 1.32 (due to buggy 1.33), and the latest official 1.33. While nobody's gonna develop for 1.24; 1.26 and others are still somewhat relevant.
The priority should be undocumented natives first and if anyone has the motivation, separately note 1.26+ bugs and quirks.
How?
You can freely* browse the website on archive.org. *But not really freely. Because some topics are not saved (example #2373) and others will be saved under a different URL.
For example,
-
http://wc3jass.com/viewtopic.php?p=9396
and -
http://wc3jass.com/viewtopic.php?p=9396&sid=1e01ceb19fe171c30c697b63a6bf9713#9396
are different.
If you have the latter URL, you can easily try its short version, but if you have the short URL then you have to search/filter all of the archived URLs. It's possible, but limited and buggy: https://web.archive.org/web/*/http://wc3jass.com/*
(takes a long time to load, don't open unless you intend to work on it)
Progress tracking
If multiple people will work on this, I suggest each person to create a single comment and add to it the topic you've read and processed to organize the effort between multiple people. Example:
[x] https://web.archive.org/web/20080113045551/http://www.wc3jass.com:80/viewtopic.php?t=2039
= Jass tutorial by Vexorian
[ ] https://web.archive.org/web/20080607065301/http://www.wc3jass.com:80/viewtopic.php?t=1999&sid=bbe8304984c3779b4fd9c7c6d19ded6a
= Tutorial, "Using Timers and Handle Vars"
// Update: Not needed, there were 800 saved post links total with many duplicates.