Manual:Mwdoc-filter.php/nl

This page is a translated version of the page Manual:Mwdoc-filter.php and the translation is 100% complete.

MediaWiki-versie:

≥ 1.20

MediaWiki bestand: mwdoc-filter.php
Locatie:	maintenance/
Broncode:	master • 1.42.3 • 1.41.4 • 1.39.10
Classes:	Code zoeken • Documentatie zoeken

Details

Bestand mwdoc-filter.php is een Doxygen filter om de goede variabele types in de documentatie te tonen.

It has been adapted for MediaWiki to resolve various bugs we experienced from using Doxygen with our coding conventions:

We want to allow documenting class members on a single line by documenting them as /** @var SomeType Description here., and in long-form as ‎
```
/** 
 * Description here.
 * @var SomeType
```
PHP does not support native type-hinting of class members. Instead, we document that using @var in the doc blocks above it. However, Doxygen only supports parsing this from executable code. We achieve this by having the this script filter take the typehint from the doc block and insert it into the source code in front of $myvar, like protected SomeType $myvar. This result is technically invalid PHP code, but Doxygen understands it this way.

Opties/Argumenten

Dit script accepteert het pad van een PHP-bestand als argument.

Gebruik

php maintenance/mwdoc-filter.php file

ABC.php

<?php

class ABC {
    /** @var array[] Description 1 */
    private $a = [];

    /** @var int Description 2 */
    private $b;

    /** @var ActorStoreFactory Description 3 */
    private $c;
}

Terminal

$ php maintenance/mwdoc-filter.php ABC.php

<?php

class ABC {
    /**  Description 1 */
    private array[] $a = [];

    /**  Description 2 */
    private int $b;

    /**  Description 3 */
    private ActorStoreFactory $c;
}

Zie ook