Re: [PEAR-DOC] svn: /pear/peardoc/trunk/en/package/mail/mail-mime/ example.xml get.xml mail-mime.xml

On 8 April 2011 13:09, Aleksander Machniak <[email protected]> wrote:
> alec                                     Fri, 08 Apr 2011 12:09:59 +0000
>
> Revision: http://svn.php.net/viewvc?view=revision&revision=310064
>
> Log:
> Updated Mail_Mime documentation
>
> Changed paths:
>    U   pear/peardoc/trunk/en/package/mail/mail-mime/example.xml
>    U   pear/peardoc/trunk/en/package/mail/mail-mime/get.xml
>    U   pear/peardoc/trunk/en/package/mail/mail-mime/mail-mime.xml

[SNIP]

> Modified: pear/peardoc/trunk/en/package/mail/mail-mime/mail-mime.xml
> ===================================================================
> --- pear/peardoc/trunk/en/package/mail/mail-mime/mail-mime.xml  2011-04-08 12:04:03 UTC (rev 310063)
> +++ pear/peardoc/trunk/en/package/mail/mail-mime/mail-mime.xml  2011-04-08 12:09:59 UTC (rev 310064)
> @@ -27,26 +25,82 @@
>    </refsection>
>    <refsection xml:id="package.mail.mail-mime.mail-mime.parameter">
>     &title.param;
> -    <para>
> -     <itemizedlist>
> -      <listitem>
>        <para>
> -        <parameter>string $crlf</parameter> - the type of
> -        line end to use.
> +        array <parameter>$params</parameter> - An associative array of parameters.
> +        These parameters affect the way the message is built. Use
> +       <link linkend="package.mail.mail-mime.setparam"><function>Mail_Mime::setParam</function></link>
> +       to set them later.

The above <link> is currently breaking the documentation build process
due to a missing id ...

"Warning: DOMDocument::validate(): Element listitem content does not
follow the DTD, expecting (itemizedlist | orderedlist | procedure |
simplelist | variablelist | segmentedlist | glosslist | bibliolist |
calloutlist | qandaset | caution | important | note | tip | warning |
example | figure | table | equation | informalexample | informalfigure
| informaltable | informalequation | sidebar | blockquote | address |
epigraph | mediaobject | screenshot | task | productionset |
constraintdef | msgset | programlisting | screen | literallayout |
synopsis | programlistingco | screenco | cmdsynopsis | funcsynopsis |
classsynopsis | methodsynopsis | constructorsynopsis |
destructorsynopsis | fieldsynopsis | bridgehead | remark | revhistory
| indexterm | anchor | para | formalpara | simpara | annotation |
phd:toc)+, got (para listitem listitem listitem listitem listitem
listitem listitem listitem ) in D:\Manual\PEAR\peardoc\configure.php
on line 300

Warning: DOMDocument::validate(): IDREF attribute linkend references
an unknown ID "package.mail.mail-mime.setparam" in
D:\Manual\PEAR\peardoc\configure.php on line 300
  Manual has errors. Use
   xmllint --valid --noout manual.xml
   xmllint --valid --noout D:\Manual\PEAR\peardoc\.manual-en.xml
  to get detailled error messages."

The method exists in code
(http://svn.php.net/viewvc?view=revision&revision=293544), but no
documentation for it exists and this is killing the build.




-- 
Richard Quadling
Twitter : EE : Zend
@RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY