aboutsummaryrefslogtreecommitdiffstats
path: root/maintenance/mwdocgen.php
Commit message (Collapse)AuthorAgeFilesLines
* docs: Ignore extensions/ and skins/ in mwdocgen.php by defaultTimo Tijhof2019-09-141-9/+16
| | | | | | | | | | | | | | | | | | | | | | | The default was previously to index all of core and extensions, which is likely not the intent of someone running this for the first time (which can then easily take over half an hour). Even in CI, we never do this, and we never have afaik. Generally, local use is to replicate CI (all of core), or a subset of core by passing e.g. '--file includes/libs' or some such. Indexing an extension is still possible, same way as before, by passing '--file extensions/FooBar'. And, if one really wants to index all of core and all extensions, the new '--extensions' option allows one to opt back in to the old behaviour. Also: * Exclude all of 'resources/'. There are no PHP or Markdown files here that need to be indexed. Bug: T232104 Change-Id: I55617776ac86f3fdcb6c1ba1eebe892edcb5fafb
* docs: Ignore README.md by defaultTimo Tijhof2019-09-141-4/+0
| | | | | | | | | This makes it more future-proof so that when more files are added, they are excluded by default. If and when we do get a file that is intended for this, it's likely such commit will test it and find it doesn't work and then whitelist accordingly. Change-Id: I3b8e421724d45e6aaecea58238f430a87cbbe977
* docs: Exclude extra markdown files from Doxygenapaskulin2019-09-131-0/+7
| | | | | | | | | | | | | Cleans up the Doxygen file list by excluding markdown files other than the intro, main code of conduct, and /docs directory. docs: Add heading to code of conduct Adds an h1 heading to use as the file listing in Doxygen instead of the file name. Change-Id: Id13eec2670aa4b96275f1e688a29c22c3f38a859
* maintenance: Explicitly declare all used propertiesDaimona Eaytoy2019-09-091-0/+20
| | | | | | | All uses were checked with codesearch, and the visibility was chosen as strict as possible. Change-Id: I56666299cc04ccc418e05949422876583982eb3c
* docs: Remove GENERATE_MAN support from DoxyfileTimo Tijhof2019-09-061-4/+0
| | | | | | | | | | | | Also remove redundant sections from the config file that all relate to features that are unconditionally disabled for us and by default. They were all no-ops because the corresponding "GENERATE_"- config is NO by default as well. Per <http://www.doxygen.nl/manual/config.html>. Bug: T232104 Change-Id: Ibd81f23922f1994be6579fcd8e1ece5e9f995905
* docs: Ignore .md from resources/lib in DoxyfileTimo Tijhof2019-09-051-0/+1
| | | | | | | | | | Follows-up b7c5acd41954, which started indexing .md files anywhere in core. While these are harmless to analyse (they're not going to find any meaningful doc blocks), it just adds more noise to the file listing. Bug: T232104 Change-Id: Ibd2010010872d42dc3d52139305c87fcfc547477
* Replace deprecated function wfEscapeShellArg with Shell::escape()Derick Alangi2019-04-071-1/+3
| | | | Change-Id: I4046d593d1450cfffc489ca2abadba1084a540e4
* Use ::class to resolve class names in maintenance scriptsUmherirrender2018-01-231-1/+1
| | | | | | | This helps to find renamed or misspelled classes earlier. Phan will check the class names Change-Id: I1d4567f47f93eb1436cb98558388e48d35258666
* Maintenance: add fatalError() methodBryan Davis2017-11-211-4/+2
| | | | | | | | Deprecate the second argument to Maintenance::error() in favor of a new Maintenance::fatalError() method. This is intended to make it easier to review flow control in maintenance scripts. Change-Id: I75699008638f7e99b11210c7bb9e2e131fca7c9e
* Use shell_exec instead of backtickMatthew Flaschen2017-07-061-1/+1
| | | | | | | | | They are exactly equivalent, but shell_exec is more readable. We just imported a sniff to forbid backtick into mediawiki-codesniffer. It's not deployed here yet, but this will facilitate it. Change-Id: I4b58ed78e1792ff83e1bf99425f8f19123cfe911
* Revert "Convert mwdoc-filter.php to Maintenance", rm wfShellWikiCmdMatthew Flaschen2017-05-041-2/+8
| | | | | | | | | | Revert a58948d64 and instead remove wfShellWikiCmd and escape shell arguments directly. This should be fine since mwdoc-filter.php does not depend on per-wiki state. Change-Id: Id9c6ca84bab827675b71ca16bf688fd3f5c993a1
* Convert all array() syntax to []Kunal Mehta2016-02-171-5/+5
| | | | | | | | | | Per wikitech-l consensus: https://lists.wikimedia.org/pipermail/wikitech-l/2016-February/084821.html Notes: * Disabled CallTimePassByReference due to false positives (T127163) Change-Id: I2c8ce713ce6600a0bb7bf67537c87044c7a45c4b
* Use addDescription() instead of accessing mDescription directlyMax Semenik2016-01-301-1/+1
| | | | Change-Id: I0e2aa83024b8abf5298cfea4b21bf45722ad3103
* Doxygen: Disable verbose outputTimo Tijhof2015-11-231-2/+1
| | | | | | | | | | | | | | https://www.stack.nl/~dimitri/doxygen/manual/config.html#cfg_quiet * To make the standard output in Jenkins more useful, disable the verbose messages about "Loading file .." in between all the errors. * Remove obsolete config options XML_SCHEMA and XML_DTD that were producing warnings. We weren't using these anyway (set to their default blank value). Change-Id: I6876cf4d783f7795a12d99623c8ce3717e9a51f5
* mwdocgen: Exclude node_modules from DoxygenTimo Tijhof2015-04-011-0/+1
| | | | | | | So that local runs don't take forever and won't recurse into unrelated php files in some npm package. Change-Id: Ic8068fa048075584c9334d0c21fb4efd87eade02
* Update formatting in maintenance/ (3/4)Siebrand Mazeland2014-04-231-3/+1
| | | | Change-Id: I4390c4ea12a6a626b0e6817b6446635116ca9fe3
* Fix spacing and break some linesumherirrender2013-08-241-1/+1
| | | | Change-Id: Ia57685d8858e02e399ad5c75ce64d12609d340ac
* mwdocgen: support multiple --file valuesAntoine Musso2013-06-261-2/+10
| | | | | | | | | | It is sometimes useful to generate documentation for multiple files or directories. Doxygen INPUT statement supports multiple space separated paths. Example usage: php maintenance/mwdocgen.php --file docs,input Change-Id: I66a805d80307c6502e9b440df63a37bb13093d84
* Add vendor to mwdocgen's excludes list.Daniel Friesen2013-06-081-0/+1
| | | | | | | | Now that we support composer libraries we should exclude vendor/ so that our Doxygen script doesn't go generating documentation for 3rd party libraries we use. Change-Id: I40502015820f0b9b4b1ef5810bcddcc5970134c5
* overhaul maintenance/mwdocgen.phpAntoine Musso2013-05-291-238/+100
| | | | | | | | | | Now based on Maintenance class. Reinstate {{EXCLUDE}} which got removed by 8199984 This is roughly back compatible. bug: 34436 Change-Id: Ic1a2b2c29718054ec740b2ffb90350af700a6a58
* phpcs: More require/include is not a functionTimo Tijhof2013-05-211-1/+1
| | | | | | | | | | | | | Follows-up I1343872de7, Ia533aedf63 and I2df2f80b81. Also updated usage in text in documentation and the installer LocalSettingsGenerator. Most of them were handled by this regex: - find: (require|include|require_once|include_once)\s*\(\s*(.+?)\s*\)\s*;$ - replace: $1 $2; Change-Id: I6b38aad9a5149c9c43ce18bd8edbab14b8ce43fa
* Added space after switch/Removed spaces after unsetumherirrender2013-04-261-3/+3
| | | | | | While at it, added/removed some other spaces in the same files Change-Id: I84d8001aa123a008807ad5eb76f396aed7c899a4
* Fixed some spacing in maintenance folderumherirrender2013-04-181-21/+42
| | | | | | | Added spaces before if, foreach Added some braces for one line statements Change-Id: I9657f72996358f8c1c154cea1ea97970d973723c
* Merge "mwdocgen.php: Exit with exit code of passthru(doxygen)"jenkins-bot2013-03-151-1/+4
|\
| * mwdocgen.php: Exit with exit code of passthru(doxygen)Timo Tijhof2013-03-151-1/+4
| | | | | | | | | | | | | | | | Previously it just naturally exited which means even if the doxygen bin doesn't exist, it'll return "success". Bug: 46151 Change-Id: Ie1e3d956ce5d3e1f28c7c829bb57596113f07c4a
* | mwdocgen.php: Implement --version option.Timo Tijhof2013-03-151-5/+11
|/ | | | | | | | So that the job that runs it can pass along what it should display (e.g. branch, tag, hash etc. whatever is appropiate for the context of that run). Change-Id: I1d5b6266e49a71672b0a53069e6ea6bb4658c3d2
* style: fix up commas in function argumentsAntoine Musso2013-02-061-1/+1
| | | | | | | | | | | | Fix up spaces in our function calls, we do not want spaces before a comma and try to avoid multiple commas whenever possible. Errors: * No space found after comma in function call * Space found before comma in function call Change-Id: I51aec02016f742422fa60b92ad35ba3f0ef59ba3
* (Bug 37957) Replace php_sapi_name() with PHP_SAPIOri Livneh2013-02-041-1/+1
| | | | | | | | | | The PHP_SAPI constant has been available since PHP 4.2.0. It's more concise to use the constant and has less overhead than a function call. Furthermore, PHP_SAPI rhymes with "happy", whereas "php_sapi_name" rhymes with "lame". QED, etc. Change-Id: Ie8c121cb8fcef50536af8d3f66723b458f0bf9af
* Also pass $doxygenInputFilter as parameter instead of global.Platonides2012-12-061-3/+2
| | | | Change-Id: I63fa0125576c4694f63d271f9824d783869f25d1
* Remove svnstat stuff used in Doxygen generationReedy2012-09-271-33/+4
| | | | Change-Id: I9d8db5fae6e0c99d59fcb9a43d7ed4aab953c300
* Use __DIR__ instead of dirname( __FILE__ )jeroendedauw2012-08-271-1/+1
| | | | | | We can now do this since we finally switched to PHP 5.3 for MW 1.20 and get rid of the silly dirname(__FILE__) stuff :) Change-Id: Id9b2c9cd2e678197aa81c78adced5d1d31ff57b1
* doxygen filter need to use a full pathAntoine Musso2012-08-021-1/+5
| | | | | | | | | When running mwdocgen.php outside of maintenance, the input filter was not found. Giving the full path fix the issue. Issue introduced by I4ead1bd1 / ab59fad. Change-Id: I5e28209eba1afd24d60b2dc940b9f5dfb1b4f34c
* Big oops - merged to wrong branch.awjrichards2012-06-051-11/+10
| | | | | Revert "Revert to arbitrarily old point before initial remote branch creation to help clean up" This reverts commit ee0d3d330f76b97c451c168dc9b052ee84609b5b
* Revert to arbitrarily old point before initial remote branch creation to ↵awjrichards2012-06-021-10/+11
| | | | | | help clean up Change-Id: I41a3d1e55d3ea9dffa42451237fe065f9334361d
* Rename $exclude_patterns to $excludePatterns andPlatonides2012-06-031-11/+10
| | | | | | $wgDoxyGenerateMan to $doxyGenerateMan. Change-Id: Id6d7d8202c6bdfd31d2bba5603e0682d35c76ad4
* Fix switch fall throughSam Reed2012-03-191-25/+2
| | | | | | | Remove code for getting svn rev from SVN less than 1.4 - Ubuntu 8.04 LTS has 1.4.6 so should be pretty safe Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/114146
* always have $wgDoxyGenerateMan definedAntoine Musso2012-02-161-0/+2
| | | | | | | | r101807 introduced a new variable which was not always defined. Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/111628
* add usage for --no-extensionsAntoine Musso2011-11-231-0/+1
| | | | Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/104086
* man page help pages generationAntoine Musso2011-11-031-0/+7
| | | | | | | | | | | | | | | Tweaked mwdocgen.php to let us generates man pages. They will be saved to ./docs/man so make sure to update your MANPATH if you use this feature. Usage: php mwdocgen.php --all --generate-man or make man Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/101807
* using real identity for hasharAntoine Musso2011-10-241-1/+1
| | | | | | | | | Converting my pseudonym to use my real identity instead: Ashar Voultoiz -> Antoine Musso Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/100588
* Remove some unused getting of non existent argumentsSam Reed2011-10-181-0/+2
| | | | | | | Documentation Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/100130
* * (bug 30894) Add --output option to mwdocgen.php to override output directoryBrion Vibber2011-09-141-13/+44
| | | | | | | | Note that files go into the 'html' subdir of wherever you point. Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/97103
* Revert part of r97046 which was not intented to be committed.Niklas Laxström2011-09-141-1/+1
| | | | | | | As side note, would be nice to have this configurable someway. Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/97048
* Removed some more unused message made obsolete by r96847 (one was still ↵Niklas Laxström2011-09-141-1/+1
| | | | | | | referenced in r97044, but was already unused) Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/97046
* Use consistent notation for "@todo FIXME". Should update ↵Siebrand Mazeland2011-05-171-1/+2
| | | | | | | http://svn.wikimedia.org/doc/todo.html nicely. Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/88355
* Fix for r81787: add the parameter to the functionAlexandre Emsenhuber2011-03-251-1/+1
| | | | Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/84745
* Follow up r81562Platonides2011-02-081-7/+7
| | | | Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/81787
* doxygen: add support for EXCLUDE keywordAntoine Musso2011-02-051-6/+18
| | | | Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/81562
* *(bug 26404) Enable call graphs for doxygen-generated docSam Reed2010-12-271-8/+6
| | | | Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/79070
* Part of bug 26280: added license headers to PHP files in maintenanceAlexandre Emsenhuber2010-12-161-0/+14
| | | | Notes: http://mediawiki.org/wiki/Special:Code/MediaWiki/78508
generated by cgit v1.2.3 (git 2.25.1) at 2025-04-25 00:31:29 +0000