[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Namespace vs Prefix in error message: friendly versus correct?


prefix with friendly
Jeff Lowery:

> c) Batik Squiggle 1.5b noted that "the attribute xlink:href of the element
> <image> is required", which is kind of a curious error since 1) xlink is a
> prefix, not a namespace; 2) the namespace declaration itself was invalid,
> yet didn't cause an error (in any of the programs)

This brought up a side thought for me.  When I write error messages in 4Suite 
(and all other software), I prefer to say something such as:

"Element (http://www.w3.org/1999/XSL/Transform, when) cannot appear here"

Several of the other core developers have argued for

"Element xsl:when cannot appear here"

Arguing that it's more user friendly.  I concede this point, but I think the 
fact that it gives false prominence to the prefix and could thus be misleading 
is more important than the fact that URIs are hard to read.

We did settle on a compromise:

"Element xsl:when, in namespace http://www.w3.org/1999/XSL/Transform, cannot 
appear here"

but no one has had the time to go back and retrofit all the error messages, 
and I find it a tad clumsy.

I've actually thought that I should switch from Python tuple notation to 
Clark's notation:

"Element {http://www.w3.org/1999/XSL/Transform}when cannot appear here"

Anyway, I wanted to get the perspective of othr XML-DEVvers on this trade-off.



-- 
Uche Ogbuji                                    Fourthought, Inc.
http://uche.ogbuji.net    http://4Suite.org    http://fourthought.com
Gems From the [Python/XML] Archives - http://www.xml.com/pub/a/2003/04/09/py-xm
l.html
Introducing N-Triples - http://www-106.ibm.com/developerworks/xml/library/x-thi
nk17/index.html
Use internal references in XML vocabularies - http://www-106.ibm.com/developerw
orks/xml/library/x-tipvocab.html
EXSLT by example - http://www-106.ibm.com/developerworks/library/x-exslt.html
The worry about program wizards - http://www.adtmag.com/article.asp?id=7238
Use rdf:about and rdf:ID effectively in RDF/XML - http://www-106.ibm.com/develo
perworks/xml/library/x-tiprdfai.html



PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
 

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.


Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.