PHPDocumentor [en.wikipedia.org/wiki/PhpDocumentor] documentation tweaking stuff.

Minor doc tweaks to prevent some PHPDocumentor warnings or errors when run on the includes/ directory. PHPDocumentor uses a syntax very similar to javadoc - mostly we already use this, but there were a few scattered places that were adjusted to make them consistent with the rest of the code. In practical terms, these changes were made:
* @url becomes @link
* @fixme becomes @todo
* HTML tags in descriptions must be closed / balanced.
* @bug was removed (where the bug was long fixed), or changed into a @todo (in the few situations where the bug was still pending)
* @obsolete becomes @deprecated
* Things like "/**@{{" and "/**@}}*/" which cause "unknown tag" warnings were removed
* @access must be a valid access level.
* @desc tag not needed, removed.
* Doesn't seem to like @licence, will accept @license however.
* Use full comment block notation in a few places (i.e. open block with "/**", start each line with " *", and end block with " */")

Then additional to this, to get some class docs associated with their respective classes:
* Moved some docs to right above those classes (deleting blank lines, or moving descriptions from the file headers)
* Marked some classes without docs as "@todo document"
* (done up to "class MIMEsearchPage" on the "classtrees_MediaWiki.html" page for the includes/ directory)

Don't show rev_deleted usernames

* (bug 9430) Update Cantonese translations
  Patch by Shinjiman

*Fix isInRange(), remove cruft, add "ipv-6" prefix to toHex() and parseRange6(), actually show hidename option for blocks

*Use intval() to stop $ns from becoming '' which breaks query

*Don't embed $ns from string, for NS 0 it becomes '' and can break the query

Improve documentation for $wgMaxUploadSize

Revert r20426 which added an unused $isvalid parameter on Title::newFromURL()
It gives me the willies...

Revert r20317 for the moment; incompatible changes to URL parameters for undo

(bug 8421) Expose current action in JavaScript globals (as 'wgAction')

Better mention that in release notes, since it fixes a regression...

(bug 8933) User::loadFromDatabase() doesn't exist; use User::load()

* (bug 8975) Use "Maintenance script" as the username for importTextFile.php, not "MediaWiki default" as it could cause pages to be overwritten
* Use "Maintenance script" as the username for importImages.php, too
* Clarified reserved username comment

* Update German translations
* adding new messages to messageTypes.inc
* fix RELEASE-NOTES

Revert $wgDBtimezone commits: r20688, 20689, 20690, 20691.
Alters behavior of wfTimestamp() and wfTimestampNow() in clearly broken ways, such that current time would not return current time anymore.

good thing we're not actually using this fallback func, huh

Beef up the Special:Log search form so it's laid out a bit clearer; clarified English text for the prefix/wildcard thing

another miser-mode target...

*Add IF EXISTS clause so tables.sql can be ran to create a db without errors

in misermode enforce maximum offset of 10000, people should use search fields, probably.
TODO: rewrite to use indexpager

don't allow search for new images in miser mode

Give the username field an identifier so the label is "linked" to it again

* (bug 7859) Update Kazahk translations
  Patches by AlefZet

parenthesis

While I'm at it, why not pseudo-initialize to null instead of ''?  No difference in behavior, due to behavior of the receiving function, but who knows, it makes more sense.  More semantic-y, kinda.

Use the variable I introduced, maybe?

Don't mess with system variables, sry brion

(bug 9397) Introduce "sp-contributions-footer" and "sp-contributions-footer-anon" messages, shown at the end of Special:Contributions as appropriate for the target

Move note for Aaron's hooks into correct section

more idiot mistakes from me. whee

duh

quickie script to move ES blob tables from one wiki name to another, leaving fresh tables at the old name
should be generalized

Remove useless parameter/uninitialized variable.
Thanks to Nikerabbit

* (bug 4756) Add user tool links for self created accounts at special:log
  instead of sometimes broken block links from newuserlog extension
  Furthermore the block link from newuserlog was shown to users w/o block
  allowance too.

Fix E_NOTICE on line 76 if $_SERVER['HTTP_ACCEPT'] not set

* (bug 9411) Fix for shared image descriptions using query-string titles
Extracted URL-query-append logic from Title to wfAppendQuery(), using this in two places now.

Begin simple tests to catch invalid search queries.

* (bug 9384) Update French translations
  Patches by Rémi Kaupp

Account for wgDBtimezone if set. DBs not using it (mysql) will have it = 0 and return same time as always.

Do not do timezone adjustment if tz is not set - unlogged in users thus see the "local" timezone

Find out the local db timezone

Allow user timezone adjustments to work when using Postgres - fixed bug 9299

Account for pre-existing test table, commit only if setup completes.

Another pesky comma where it shouldn't be.

Mild formatting, fix missing '$'

Errant comma restored.

* Update release notes for r20680
* Typos in hook documentation

Please remember to document hook additions in both places in future.

*Document PageHistoryBeforeList and PageHistoryLineEnding and remove cruft variable from former

*Add some cute hooks; possible flaggedrevs use

* The very beginning of Luganda (lg)

Typo.

oops

define querygroup

specify offset for Job::pop(), yay for efficient job queue runs (unless there's a bug somewhere in there :)

allow to specify offset at which to pop a Job.
needed for efficiency of really large sites (ok, single site :)

* Update to Slovak (sk) from helix84

*Use mRevision if available for permanent link. This id can easily be overrode by rev flagging extensions.

*Typo

*If a page is protected and cascade protected, use regular edit page notice (bug 9401)

Added parser hook InternalParseBeforeLinks, closes Bug#8578. The hook is relevant for all parser extensions that want templates, nowiki, etc. to
be taken care of before they do their magic.

Split mega section "changes since..." into more proper subsections:
"Configuration changes", "New features since 1.9", "Bugfixes since 1.9",
"Maintenance" and "Languages updated" as discussed on wikitech-l
Please sort your coming updates into the appropriate section.

* Update to Low Saxon (nds) from Slomox

Updates for Indonesian (id) localization.

Update.

Typo.

Suspect $dbr was undefined in this scope.

* (bug 9384) Update Cantonese translations
  Patch by Shinjiman

Merge approximately 15 missing Wikipedia language codes into wikipedia-interwiki.sql
based on Jeff Merkey's mediawiki-1.9.3.WG-20070316.tar.gz.bz2 archive, and then
resorted Wikipedias into alphabetical order.

Fixed static member invocation, was broken since inception.

* Cleanup some more

*Fix comment typo, remove some redundant conversions

fix for r20616. Thanks to Brion whispering to me ;-)

Fix.

Update.

Show a notice about unknown messages when rebuilding files.

* (bug 8870) Update Hungarian localizations
Based on a file of Bence Damokos
reworked and reformatted, extension messages transfered to extensions

* (bug 4624) Namespace selection for Special:Whatlinkshere
  Based on a patch of Suisui
Found another bug: scrolling backwards at Special:Whatlinkshere was broken since ?
'previous' shows always the first page in reversed order but not the real previous page.
Fixed now by changing backwards scrolling mechanism.

* (bug 4777) Separate prev/next messages for Special:Whatlinkshere

updated release notes

fixed bug in call of hook ArticleViewHeader

*Fix row count bug causing log extracts to show "no results"

9363: Specia:Recentchangeslinked Postgres error

More GROUP BY fun, fixes bug #9363, thanks to Mathias Behrie

use MyISAM by default instead of InnoDB

*Minimumsize message

*Instead of sorting on size, add a min size option to preserves the time-order

*Default selected type to 'edit'

Add all terms to group by, although I'm not sure about the previous commit as it kind of negates the whole purpose of adding the pr_id column.

*Show page_len and sort on that index (descending). This should improve the signal:noise ratio on large wikis.

Remove variables when we can simply override accessors instead.

Use the expanded text (e.g. anonymous users only, account creation disabled instead of anononly,nocreate) in the block log items of the recent changes (i.e. don't check for the variable translate when translating the second parameter - it was a workaround for the block expiry to prevent ugly HTML from appearing, it is not needed for the block flags).

Update.

Updates for Indonesian (id) localization.

Fix.

Update.

Allow checking for changes in the file without actually writing into it.

Fix.

Update German translations
Update English due to extended Special:Protectedpages
language tweak for RELEASE-NOTES

*Use is_null() for namespace

*Add namespace filter to protectpages (bug 9326), type and level added too

Reverting SpecialRevisiondelete.php back to r17880, to fix bug 9336 ( "Special:Revisiondelete broken in SVN head" )
The problem is that includes/SpecialRevisiondelete.php was in an inconsistent state - it was updated in r20446
(merge of rev_deleted branch), and then partially reverted in r20525 (i.e. there was some unintentional cruft left
over, including the change in the constructor params), and as a result stuff like
http://Hostname-Of-Wiki/wiki/index.php?title=Special:Revisiondelete&target=Main_Page&oldid=X would die with fatal
errors. (The diff between the before and after is shown here:
http://svn.wikimedia.org/viewvc/mediawiki/trunk/phase3/includes/SpecialRevisiondelete.php?r1=17880&r2=20525 ,
or from the command line, try: svn diff --revision 17880:20525 includes/SpecialRevisiondelete.php | less     )

I'm unsure whether I should be updating RELEASE-NOTES, but I'm leaning towards 'no', on the basis that no end-user
encountered this (cluster is on r20145), and that (hopefully) there should be are no user-visible changes as
a result of this revert.