2 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5 <title>Jalopy - FAQ</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
6 <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer">
7 <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'>
8 </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> •
9 <a href="./download.html" class="navlink">Download</a> •
10 <a href="./docs.html" class="navlink">Documentation</a> •
11 <a href="./plugins.html" class="navlink">Plug-ins</a> •
12 <a href="./links.html" class="navlink">Links</a> •
13 <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table><table cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
14 <a href="./history.html" class="navlink2">History</a> |
15 <a href="./manual.html" class="navlink2">Manual</a> |
16 <a href="./faq.html" class="navlink2">FAQ</a> |
17 <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
18 This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div></div><div></div></div><div class="qandaset"><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="d21e76"></a><a name="report-bugs"></a><b>Q:</b></td><td align="left" valign="top"><p>
19 How do I report a bug I have found in Jalopy?
20 </p></td></tr><tr class="answer"><td align="left" valign="top"><b>A:</b></td><td align="left" valign="top"><p>
21 To be as helpful as possible to the Jalopy developer team and other users, you should use
22 the <a href="http://sf.net/tracker/?group_id=45216&atid=442212" target="_top">
23 bug tracker database</a> that the Jalopy project maintains on the
24 <a href="http://sf.net/" target="_top">SourceForge web site</a>. You do need to be a SourceForge
25 member to post a bug report.
27 Before posting a bug report, spend a few moments searching the bug database to see if a
28 similar report has already been made. The bug tracker has a search facility that will let
29 you search for bug reports using a variety of criteria. If you find a similar bug report,
30 and you have additional information to contribute, post a comment to the report. Only if
31 you do not find a similar bug report, submit a new one.
32 </p></td></tr><tr class="question"><td align="left" valign="top"><a name="d21e91"></a><a name="bug-report"></a><b>Q:</b></td><td align="left" valign="top"><p>
33 What information should I include in a bug report?
34 </p></td></tr><tr class="answer"><td align="left" valign="top"><b>A:</b></td><td align="left" valign="top"><p>
35 The web form in the bug tracker report provides several fields for
36 submitting information. If you are unsure about a particular
37 item, leave it at the default setting provided in the form.
39 The more important fields are “<span class="quote">Category</span>”,
40 “<span class="quote">Summary</span>” and the “<span class="quote">Initial comment</span>”.
42 When you write your initial comment describing the bug, you
43 should specify the versions of Jalopy, the Plug-in environment, the Java platform and
44 operating system you are using.
46 Be as specific as possible. If you encounter stack traces, attach them. If you have
47 problems formatting a specific file, locate the cause of the error and attach
48 the code section as a text file. Also attach your code convention as many errors only
49 occur with a certain settings combination.
51 A more typical example should look like:
52 </p><div class="informalexample"><a name="ex-bug-report"></a><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
53 I newly installed jalopy-1.0b9 on Windows NT with German locales, Sun JDK 1.3.1_05.
54 I upgraded property file from jalopy-1.0b7 via Import/Export.
56 When starting the jalopy settings dialog, I always have problems
57 when I am on the "Sorting" panel. No entries are shown. Maybe
58 this is a similar problem.
60 I tried with different files. Always the same result.
62 Using the Ant task (0.3.3 with Ant 1.4.1), I get a stack trace as attached. I attached
63 my code convention also.
64 </pre></td></tr></table></div><p>
65 The attached stack trace could read as follows:
66 </p><div class="informalexample"><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
67 [jalopy] Jalopy Java Source Code Formatter 1.0b9
68 [jalopy] Format 1 source file
69 [jalopy] X:\beans\booking\BookingService.java:0:0:
71 [jalopy] X:\beans\booking\BookingService.java:0:0:parsing took 170
72 [jalopy] X:\beans\booking\BookingService.java:0:0:transform
73 [jalopy] X:\beans\booking\BookingService.java:0:0:
74 java.lang.NullPointerException
75 [jalopy] java.lang.NullPointerException
76 at de.hunsicker.jalopy.lang.Transformation.addSiblings(Transformation.java:167)
77 at de.hunsicker.jalopy.lang.Transformation.sortDeclarations(Transformation.java:534)
78 at de.hunsicker.jalopy.lang.Transformation.sort(Transformation.java:104)
79 at de.hunsicker.jalopy.lang.Transformation.apply(Transformation.java:64)
80 at de.hunsicker.jalopy.lang.JavaRecognizer.transform(JavaRecognizer.java:451)
81 at de.hunsicker.jalopy.lang.JavaRecognizer.getParseTree(Java Recognizer.java:173)
82 </pre></td></tr></table></div><p>
83 The given information made it quite obvious that the auto-conversion of the code
84 convention format from 1.0b7 to 1.0b9 failed for some reason.
86 Looking further at the supplied code convention revealed that the value of the sorting
87 key was invalid and the actual cause was easy to spot.
88 </p></td></tr></tbody></table></div></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
89 Copyright © 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>