On 5/13/05, Cornelia Boenigk <[EMAIL PROTECTED]> wrote:
> Hi all
> 
> Just to be sure.
> Which one is the right way to do it?
> 
> ...
> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam>
> ...
>    <para>
>     <function>xy</function> does something with
>     <literal>assoc_array</literal> ...
>    </para>
> 
> ...
> <methodparam><type>array</type><parameter>assoc_array</parameter></methodparam>
> ...
>    <para>
>     <function>xy</function> does something with
>     <parameter>assoc_array</parameter> ...
>    </para>
> 
> Regards
> Conni
> 

Hi Conni:

http://doc.php.net/php/dochowto/chapter-skeletons.php shows the use of
<parameter> in the <variablelist> that contains the parameter
descriptions, so I have been using <parameter> whenever I have
referred to a parameter somewhere else in the doc page. <parameter> is
more specific than <literal>, and I always prefer to be explicit where
possible -- but I'm willing to be corrected by some of the php-doc
folks that have been around a lot longer than me.

Dan

Reply via email to