[Helma-user] New helmadoc/jsdoc based reference

[Chris Zumbrunn]

On Feb 19, 2007, at 12:28 , Chris Zumbrunn wrote:

> On Feb 19, 2007, at 11:08 , Robert Gaggl wrote:
>
>> and the return type of getServletRequest() is prefixed with
>> "Packages.", shouldn't that be unprefixed?
>
> My thinking was that it's best to always prefix any references to
> java classes with the Packages prefix, just for consistency, even if
> it is not necessary. In the case of
> javax.servlet.http.HttpServletRequest we anyway definitely need the
> prefix, since javax is not directly accessible like the java
> namespace would be.

I think I need to elaborate on this...

The real reason why I'm thinking that always prefixing the java  
namespaces is a good idea, is because things would otherwise get  
confusing when referring to java classes in the helma namespace. For  
example, when pointing users to helma.framework.RequestBean, they  
could confuse the helma namespace in javascript as it is used in the  
helmaLib with the java one.

Chris