Re: <initializer>
| From: | Thomas Schöfbeck | Date: | Sun, 29 Jun 2003 20:01:08 +0000 |
| Subject: | Re: <initializer> | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969354945@lists.php.net to get a copy of this message | ||
Hartmut Holzgraefe wrote:
DocBook 4 has an <initializer> tag that may be used to add default
values to a <methodparam> function parameter
A parameter that has a default / initializer value is now considered
optional and the default value is shown in italics.
Example:
<methodsynopsis>
<void/>
<methodname>Ask</methodname>
<methodparam>
<type>string</type>
<parameter>query_str</parameter>
</methodparam>
<methodparam>
<type>bool</type>
<parameter>single_step</parameter>
<initializer>false</initializer>
</methodparam>
</methodsynopsis>
is now rendered as
void Ask (string query_str [, bool single_step=false])
without the changes it was
void Ask (string query_str, bool single_stepfalse)
without []s, = and with false in red (DSSSL)
or wouldn't render at all (XSLT)
TODO: i didn't touch the FO/print stuff yet,
so in XSL/print builds the default value won't be
italics ...
The FO-stuff is ready now,
Thomas