Re: cvs: phpdoc /en/reference/filesystem/functions mkdir.xml
| From: | Gabor Hojtsy | Date: | Fri, 03 Jan 2003 20:05:06 +0000 |
| Subject: | Re: cvs: phpdoc /en/reference/filesystem/functions mkdir.xml | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969350620@lists.php.net to get a copy of this message | ||
> <methodsynopsis>
> <type>int</type><methodname>mkdir</methodname>
>
<methodparam><type>string</type><parameter>pathname</parameter></methodparam
>
> -
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
> +
<methodparam>[<type>int</type><parameter>mode</parameter>]</methodparam>
> </methodsynopsis>
This is not the way to specify optional parameters. Please at least
read the howto before adding new XML content...
http://www.php.net/manual/howto/chapter-skeletons.html
Hint: You should specify choice='opt' for the methodparam
instead of those [] chars...
> octal number, which means it should have a leading zero.
> The mode is also modified by the current umask, which you
> can change using <function>umask</function>.
> +
> + Mode is NOT needed on Windows.
> +
> + Please note also that mode is optional and that
> + it is by default '0777' (read, write and execution for EVERY
> + access). If you need more informations about mode under
> + UNIX systems, please read 'man 1 chmod' and 'man 2 chmod'.
You probably wanted to add <para>graphs. Adding enters does not mean
that it will be displayed in a new paragraph. Also add <emphasis> if
it is imporant, and do not shout (write it in capital letters). I think
you probably wanted to write 'Mode has no effect on Windows' or
something like this...
Goa