[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: svn commit: r18932 - trunk/subversion/include

From: Peter N. Lundblad <peter_at_famlundblad.se>
Date: 2006-03-17 20:32:52 CET

malcolm@tigris.org writes:
> Author: malcolm
> Date: Fri Mar 17 10:12:56 2006
> New Revision: 18932
>
> Modified: trunk/subversion/include/svn_xml.h
> URL: http://svn.collab.net/viewvc/svn/trunk/subversion/include/svn_xml.h?pathrev=18932&r1=18931&r2=18932
> ==============================================================================
> --- trunk/subversion/include/svn_xml.h (original)
> +++ trunk/subversion/include/svn_xml.h Fri Mar 17 10:12:56 2006
> @@ -67,8 +67,10 @@
> svn_boolean_t svn_xml_is_xml_safe(const char *data,
> apr_size_t len);
>
> -/** Check whether the UTF8 NAME is a the ASCII subset of an XML "Name".
> - * XML "Name" is defined at http://www.w3.org/TR/REC-xml#sec-common-syn
> +/** Determine whether the UTF-8 string @a name is both a valid XML "Name",
> + * and one that uses only ASCII characters.
> + *
> + * The XML Name production is defined at http://www.w3.org/TR/REC-xml/#dt-name
> *
> * @since New in 1.4.
> */
>

Hmmm, would it be better to document the ASCII part as a @todo or @bug?
That would allow us to extend this function to cover the whole Name
production when someone gets around to it.

Regards,
//Peter

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Mar 17 20:33:29 2006

This is an archived mail posted to the Subversion Dev mailing list.