W3C home > Mailing lists > Public > public-web-http-desc@w3.org > August 2008

Re: WADL - resource path attribute and "WADL to HTML documentation stylesheet".

From: Marc Hadley <Marc.Hadley@Sun.COM>
Date: Tue, 19 Aug 2008 10:02:13 -0400
To: Thierry Boileau <thboileau@gmail.com>
Cc: Mark Nottingham <mnot@mnot.net>, public-web-http-desc@w3.org
Message-id: <CD89E448-49E0-4D67-A4E9-BAEB8794ABFF@Sun.COM>

The algorithm in section 2.5.1 of the spec appends a '/' character to  
the parent resource/resources URI if it doesn't end with one and then  
appends the value of the path. It doesn't cope with a path that  
contains a leading '/'. On the one hand this seems reasonable since a  
leading '/' implies an absolute path rather than a relative one but  
given the semantics of the path attribute a more accommodating  
algorithm might be in order. Is there a reason you want to put in a  
leading '/' in path values ?


On Aug 19, 2008, at 12:14 AM, Mark Nottingham wrote:

> I'm happy to update it if that's the intent; frankly I haven't  
> thought about WADL for a few months; Mark, what's your take?
> On 04/07/2008, at 7:20 PM, Thierry Boileau wrote:
>> Hello all,
>> I've a simple question about the "path" attribute. As written in  
>> the specification, this attribute provides a relative URI template,  
>> wich as far as I understand can either starts with a "/" character  
>> or not. Having said that, I notice that the "WADL to HTML  
>> documentation stylesheet" maintained by Mark Nottingham  
>> systematically appends a leading "/" character to the resource path  
>> atribute. And at the same time, it takes care of the "base"  
>> attribute of the "Resources" item in order to remove the ending "/"  
>> character.
>> Do I miss something? Is it possible to update the stylesheet in  
>> order to appends the leading "/" character of the "path" attribute  
>> only when required?
>> Best regards,
>> Thierry Boileau
> --
> Mark Nottingham     http://www.mnot.net/

Marc Hadley <marc.hadley at sun.com>
CTO Office, Sun Microsystems.
Received on Tuesday, 19 August 2008 14:03:45 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 19:47:20 UTC