Submitting Bugs about the Wurfl API and WALL
by Luca Passani
passani at eunet dot no
If you think you have found a bug in the Wurfl Java API or WALL taglib,
I would love to hear from you.
Having said this, I hope you understand the fact that this is an open-source
project and time is a very precious resource for me. The practical implications
of these two facts is that, before you submit a bug report, you
should spend a little bit of time to build a self-contained
example that reproduces the problem.
Your example should contain the following things:
- complete, self-contained WALL JSP file, servlet or Java program
- User-agent String of a devices which exposes the bug
- the char string,WML code,XHTML code or CHTML code you are getting
- the char string,WML code,XHTML code or CHTML code you think you should
be getting
- Any data that may be helpful to make me understand the problem
A complete example of what such a bug report should look like follows. Please note
that there are several rationales behind this:
- Makes me save time (helps me).
- Makes me want to look at your problem sooner (helps you)
- You may fix the problem yourself, while in the process of building the
report (helps you)
- You may get a deeper understanding of the problem (helps both you and me)
Here is an example inspired by real life:
---------------------------------------------------------------------------
From: Good Boy
Hello Luca,
I think I have found a problem with the way WALL renders the
align="center" attribute for WML devices.
The attribute align="middle" is not supported by wml 1.1.Here is
a WALL JSP page that shows the problem:
<%@ taglib uri="/WEB-INF/tld/wall.tld" prefix="wall"%>
<wall:document disable_cache="true"><wall:xmlpidtd />
<wall:head>
<wall:title>FOO</wall:title>
</wall:head>
<wall:body>
<wall:block align="center">
<wall:b>DATACREDITO</wall:b>
</wall:block>
</wall:body>
</wall:document>
given the following user-agent (among others):
NOKIA-RH-17/V,
SIE-SL45/3.1
UP/4.1.19i UP.Browser/4.1.19i-XXXX
WALL returns:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
<meta forua="true" http-equiv="Cache-Control" content="max-age=0"/>
<meta name="taglib" content="WALL" />
</head>
<card id="w" title="a title">
<p align="middle"><b>test attribute</b></p>
</card>
</wml>
But this is not good. Here is what I think should be returned
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
<meta forua="true" http-equiv="Cache-Control" content="max-age=0"/>
<meta name="taglib" content="WALL" />
</head>
<card id="w" title="a title">
<p align="center"><b>test attribute</b></p>
</card>
</wml>
---------------------------------------------------------------------------
This kind of messages are likely to receive an answer like the following very soon:
---------------------------------------------------------------------------
Thanks Good Boy
that was in fact a bug. Thanks for pointing it out.
Attached you'll find a new version of wurfltags.jar and wall.tld
(in case you are using tomcat5, let me know because you need
a different TLD file).
Luca
---------------------------------------------------------------------------
Happy Hacking!
Luca
|
|
