* @since 1.24
*
* @param Title $title Context title for parsing
- * @param int|null $revId Revision ID (for {{REVISIONID}})
+ * @param int|null $revId Revision ID being rendered
* @param ParserOptions|null $options
* @param bool $generateHtml Whether or not to generate HTML
*
* @since 1.24
*
* @param Title $title Context title for parsing
- * @param int|null $revId Revision ID (for {{REVISIONID}})
+ * @param int|null $revId ID of the revision being rendered.
+ * See Parser::parse() for the ramifications.
* @param ParserOptions $options
* @param bool $generateHtml Whether or not to generate HTML
* @param ParserOutput &$output The output object to fill (reference).
* may call ParserOutput::recordOption() on the output object.
*
* @param Title $title The page title to use as a context for rendering.
- * @param int|null $revId Optional revision ID being rendered.
+ * @param int|null $revId ID of the revision being rendered.
+ * See Parser::parse() for the ramifications. (default: null)
* @param ParserOptions|null $options Any parser options.
* @param bool $generateHtml Whether to generate HTML (default: true). If false,
* the result of calling getText() on the ParserOutput object returned by
* using the global Parser service.
*
* @param Title $title
- * @param int|null $revId Revision to pass to the parser (default: null)
+ * @param int|null $revId ID of the revision being rendered.
+ * See Parser::parse() for the ramifications. (default: null)
* @param ParserOptions $options (default: null)
* @param bool $generateHtml (default: true)
* @param ParserOutput &$output ParserOutput representing the HTML form of the text,
* @param ParserOptions $options
* @param bool $linestart
* @param bool $clearState
- * @param int|null $revid Number to pass in {{REVISIONID}}
+ * @param int|null $revid ID of the revision being rendered. This is used to render
+ * REVISION* magic words. 0 means that any current revision will be used. Null means
+ * that {{REVISIONID}}/{{REVISIONUSER}} will be empty and {{REVISIONTIMESTAMP}} will
+ * use the current timestamp.
* @return ParserOutput A ParserOutput
* @return-taint escaped
*/
$po = new ParserOptions( $frank );
yield 'current' => [ $text, $po, 0, 'user:CurrentAuthor;id:200;time:20160606000000;' ];
+ yield 'current' => [ $text, $po, null, 'user:;id:;time:' ];
yield 'current with ID' => [ $text, $po, 200, 'user:CurrentAuthor;id:200;time:20160606000000;' ];
$text = '* user:{{REVISIONUSER}};id:{{REVISIONID}};time:{{REVISIONTIMESTAMP}};';