<?xml version="1.0"?>

<document xmlns="http://maven.apache.org/XDOC/2.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">

  <properties>
    <title>Bugs</title>
    <author email="lukas_theussl_AT_users_DOT_sourceforge_DOT_net">Lukas Theussl</author>
  </properties>

  <head>
    <link rel="icon" href="../images/favicon.ico" type="image/x-icon"/>
    <link rel="shortcut icon" href="../images/favicon.ico" type="image/x-icon"/>
  </head>

  <body>

    <section name="Known Issues">

      <p>
        <strong>JaxoDraw</strong> uses the
        <a href="../issue-tracking.html">issue tracking</a> system of SourceForge
        to manage its issues.
      </p>
      <p>
        There you can browse existing issues
        (bug reports and feature requests) and also submit new ones. You will have
        to register an account on SourceForge, if you don't want to do that,
        you should submit your bug reports via the
        <strong>JaxoDraw</strong> <a href="../mail-lists.html">mailing list</a>.
      </p>

      <p>
        A collection of generic issues can be found in a dedicated section
        of the <strong>JaxoDraw</strong> User Guide, see
        <a href="../UsrGuide/problems.html">Known problems and limitations</a>.
      </p>

<!--
    <subsection name="Bug list">

      <div class="error">
        <strong>DEPRECATED</strong>: this table is not being updated anymore,
        it is only kept for reference. Please use the SourceForge
        <a href="../issue-tracking.html">issue tracking</a>
        system to browse and submit new bugs and feature requests.
      </div>

      <p>
        The table below gives a list of bugs and limitations of
        <strong>JaxoDraw</strong> that are
        currently known (last update: 20.6.2005).
        Each bug has four entries:
      </p>
      <ul>
        <li> <em>Number</em>: the number associated to the bug</li>
        <li> <em>Synopsis</em>: a brief description of the bug</li>
        <li>
          <em>Classification</em>: a bug can be a true <strong>JaxoDraw</strong> bug or a
          Java/axodraw related one (i.e., independent from us);
          in parenthesis we also specify which operating system is affected
          by the bug
        </li>
        <li>
          <em>Status</em>: the current status of the bug;
          if the bug is closed (which is the case for most of them)
          the correponding version where it has been solved is indicated.
        </li>
      </ul>
      <p>
        Note that not all points are necessarily real bugs, we regard this
        just as a collection of features that do not work exactly the way we
        would like to.
      </p>

      <table>

        <tr>
          <th width="8%">Number</th>
          <th width="68%">Synopsis</th>
          <th width="14%">Classification</th>
          <th width="10%">Status</th>
        </tr>

        <tr>
          <td><a name="bug1">#1</a></td>
          <td>
            If a LaTeX text file is previewed with the Java internal
            previewer (i.e., without having set a custom previewer
            in the preferences), the page displays but cannot be scrolled.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.1-0)</td>
        </tr>

        <tr>
          <td><a name="bug2">#2</a></td>
          <td>
            Choosing a different Look and Feel in the Preferences dialog
            of the Options menu item and pressing the OK button, does not
            update the Look and Feel of the current session.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.0-1)</td>
        </tr>

        <tr>
          <td><a name="bug3">#3</a></td>
          <td>
            When using IBM's Runtime Environment, the program may be
            executed and works fine for most parts but presents some
            peculiarities: the layout of pop up windows is not always the
            same and XML output serializes the bounding
            boxes of objects that are explicitly marked as transient in
            the source code. This has been reported to us for version
            number 1.4.1 of IBM's SDK.
          </td>
          <td>Java bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug4">#4</a></td>
          <td>
            If your LaTeX compilations give errors complaining about
            unknown commands like \SetColor{}, or the postscript viewer
            goes boink complaining about unrecoverable errors when reading
            your ps files generated with <strong>JaxoDraw</strong> you have to update your
            axodraw.sty file to the one included in our distribution.
          </td>
          <td>Axodraw bug (all)</td>
          <td>Closed</td>
        </tr>

        <tr>
          <td><a name="bug5">#5</a></td>
          <td>
            The wiggles of a gluon loop do not close correctly when
            watching the ps file generated through a LaTeX compilation.
          </td>
          <td>Axodraw bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug6">#6</a></td>
          <td>
            Runnig an internal LaTeX compilation without axodraw installed,
            will hang the program.
            <p></p>
            <strong>Workaround</strong>: Run <strong>JaxoDraw</strong> from a directory where there is the
            style file of axodraw (such as the distribution home directory).
            <p></p>
            <strong>Solution</strong>: Install axodraw on your system (which is very easy,
            as explained in Appendix A of the <strong>JaxoDraw</strong>
            <a href="../userguide.html">user guide</a>).
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug7">#7</a></td>
          <td>
            The LaTeX-EPS export command save the file only in the
            directory <strong>JaxoDraw</strong> was started in and NOT in the directory
            chosen in the dialog.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.0-1)</td>
        </tr>

        <tr>
          <td><a name="bug8">#8</a></td>
          <td>
            If your locale settings are different from the english ones,
            you may get errors in your LaTeX files (a comma ","
            instead of a point "." could appear as decimal
            separator).
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.0-1)</td>
        </tr>

        <tr>
          <td><a name="bug9">#9</a></td>
          <td>
            If you switch to the various type of vertices, than it is
            not possible to get back again the default one (the dot).
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.0-1)</td>
        </tr>

        <tr>
          <td><a name="bug10">#10</a></td>
          <td>
            The Antialias On/Off preference does not get saved.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.0-1)</td>
        </tr>

        <tr>
          <td><a name="bug11">#11</a></td>
          <td>
            The GridSize preference does not get applied to the current
            session.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.0-1)</td>
        </tr>

        <tr>
          <td><a name="bug12">#12</a></td>
          <td>
            If you installed <strong>JaxoDraw</strong> globally
            using the install.bsh shell script (or the Redhat rpm) you
            can execute the program but it takes quite long to come up.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.1-0)</td>
        </tr>

        <tr>
          <td><a name="bug13">#13</a></td>
          <td>
            If by mistake the user creates a zero size object (which is
            possible when the grid is on) the postscript generated is
            corrupted.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.1-0)</td>
        </tr>

        <tr>
          <td><a name="bug14">#14</a></td>
          <td>
            Some swing internal components do not allow full
            internationalization (see Sun's bug
            <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4195173" class="newWindow" title="New Window" target="_blank">
              #4195173
            </a>
            ).
            For <strong>JaxoDraw</strong>, this effects only some text fields in the
            FileChooser, ColorChooser and
            Print dialogs, where the text will always be given in english.
          </td>
          <td>Java bug #4195173 (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug15">#15</a></td>
          <td>
            With the version 1.4.2 of Sun's SDK, the text field
            "This color is:" + colorName is not displayed in
            the ColorChooser menu. See SUN's
            bug
            <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5029286" class="newWindow" title="New Window" target="_blank">
              #5029286
            </a>
            , this seems not to have been solved.
            However, the color names are indicated in a pop-up menu when
            the color fields are rolled over.
          </td>
          <td>Java bug #5029286 (all)</td>
          <td>Closed (v.1.2-0)</td>
        </tr>

        <tr>
          <td><a name="bug16">#16</a></td>
          <td>
            The right-click pop-up menus (like on the vertex button and
            the tabs) do not change if
            a different Look and Feel is selected from the Options menu.
          </td>
          <td>Java bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug17">#17</a></td>
          <td>
            Choosing the color of a LaTeX label did not affect the final
            LaTeX output.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.1-0)</td>
        </tr>

        <tr>
          <td><a name="bug18">#18</a></td>
          <td>
            If you copy an arrowed line, the copied line may flip the
            arrow direction.
          </td><td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.1-0)</td>
        </tr>

        <tr>
          <td><a name="bug19">#19</a></td>
          <td>
            The color of a group cannot be changed directly from the
            Color button of the edit menu.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.2-0)</td>
        </tr>

        <tr>
          <td><a name="bug20">#20</a></td>
          <td>
            After editing a group with LaTeX labels, the size of the
            latter is always set to "tiny".
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.2-0)</td>
        </tr>

        <tr>
          <td><a name="bug21">#21</a></td>

          <td>
            When the grid is switched on and the canvas contains objects
            at an arbitrary position, if the latter are moved they get
            shifted by the grid size and not anchored to the grid points.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.2-0)</td>
        </tr>

        <tr>
          <td><a name="bug22">#22</a></td>
          <td>
            The use of colors is not consistent with the axodraw
            conventions: for example gray-scale lines are allowed,
            but axodraw allows gray-scales only as filling colors.
            This may cause problems when LaTeX compiling the diagram.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.2-0)</td>
        </tr>

        <tr>
          <td><a name="bug23">#23</a></td>
          <td>
            If a LaTeX text object is present at the edge of a graph then
            the bounding box of a "LaTeX -&gt; EPS" export is
            most probably not correct. This manifests itself by a "broken"
            text, ie, a thin white line is crossing the text. Basically,
            there is no way for us to
            estimate the extension of a text after latex compilation,
            so the only workaround is to adjust the bounding box by hand.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug24">#24</a></td>
          <td>
            If the program is executed via the jar file (which is the case
            for every binary distribution), then the User Guide can not be
            opened by most custom browsers. This is because some popular
            browsers do not support the jar protocol (among them Windows'
            Internet Explorer and Mac's Safari), i.e., they cannot open
            html files contained in a jar archive.
            <p></p>
            <strong>Workaround</strong>: leave the preference for a custom HTML browser
            empty (in which case the HTML files are rendered by Java
            internally) or use a browser that supports the jar protocol
            (like Mozilla).
          </td>
          <td>Browser limitation</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug25">#25</a></td>
          <td>
            Mac OS X only:
            Printing or exporting to postscript/EPS does not work if a
            postscript text is present in the graph. We believe that
            this is a bug in  Apple's Java implementation for MacOSX, or
            due to the fact that the Swing printing API is not fully
            implemented in J2SE 1.4.1 or 1.4.2 on Mac OS X
            (see Apple's
            <a href="http://developer.apple.com/java/faq/issues.html#anchor6"
              class="newWindow" title="New Window" target="_blank">
              Java issues
            </a> page).
            <strong>Update</strong>: apparently, this has been fixed in the new
            5.0 java release for MacOSX, however the spacing of texts is not
            correct.
          </td>
          <td>Java bug (Mac)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug26">#26</a></td>
          <td>
            Mac OS X only:
            Saving files only works if the Look &amp; Feel is different
            from the MacOSX native Aqua. This is only because the Aqua
            file chooser dialog does not provide a text field for typing a
            file name. If a file exists already, you can click on it and
            the graph will get saved correctly.
            <strong>Workaround</strong>: temporarily
            change to another Look &amp; Feel (Metal is recommended).
          </td>
          <td>Apple's Java bug (Mac)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug27">#27</a></td>
          <td>
            Mac OS X only:
            The visible grid points do not match the actual grid points.
          </td>
          <td>Apple's Java bug (Mac)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug28">#28</a></td>
          <td>
            Closing curly brackets } do not display in postscript texts.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.2-0)</td>
        </tr>

        <tr>
          <td><a name="bug29">#29</a></td>
          <td>
            Creating an empty Postscript label by editing a
            non-empty label and erasing its text results in an exception.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-0)</td>
        </tr>

        <tr>
          <td><a name="bug30">#30</a></td>
          <td>
            Dragging the mouse when choosing the last point defining an arc
            cause strange behavior of the arc objects (the arc may be
            drawn in red, or may not be drawn at all because the three
            points are collapsing to a line).
            <p><strong>Workaround</strong>:
            Avoid dragging (!); however notice that subsequent
            editing of the arc object is possible and in that case the arc
            will display normally.
            </p>
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-0)</td>
        </tr>

        <tr>
          <td><a name="bug31">#31</a></td>
          <td>
            If the arc is too small nothing will be drawn on screen.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-0)</td>
        </tr>

        <tr>
          <td><a name="bug32">#32</a></td>
          <td>
            <strong>JaxoDraw</strong> crashes on Debian Linux Systems (and maybe others
            if certain fonts are installed).
            <p><strong>Workaround</strong>:
              For a workaround read this
              <a href="../news.html#a20.10.2004">news entry</a>.
            </p>
          </td>
          <td>Java bug
          <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4994629" target="_blank">#4994629</a>
          </td>
          <td>Closed (v.1.3-0)</td>
        </tr>

        <tr>
          <td><a name="bug33">#33</a></td>
          <td>
            If you use  Java 5.0 to run <strong>JaxoDraw</strong> you will
            not be able to bring up the preference panel due to an
            <code>ArrayOutOfBounds</code>
            exception at run time (which is absent if you run it with
            <em>any</em> previous Java distribution).
            <p><strong>Workaround</strong>:
              For a workaround read this
              <a href="../news.html#a22.11.2004">news entry</a>.
            </p>
          </td>
          <td>Java 5.0 problem (all)</td>
          <td>Closed (v.1.3-0)</td>
        </tr>

        <tr>
          <td><a name="bug34">#34</a></td>
          <td>
            Arcs are messed up when re-opening saved files.
            <p><strong>Workaround</strong>:
              For a workaround read this
              <a href="../news.html#a07.02.2005">news entry</a>.
            </p>
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-0)</td>
        </tr>

        <tr>
          <td><a name="bug35">#35</a></td>
          <td>
            File operations (Open, Save, Import, ...)  do not work on Windows
            if the path to the file contains white spaces.
            <p><strong>Workaround</strong>:
              Use only file- and path names that do not contain white spaces.
            </p>
          </td>
          <td><strong>JaxoDraw</strong> bug (Windows)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug36">#36</a></td>
          <td>
            Opening several tabs on Windows freezes the program.
            This is apparently a memory problem, running
            <strong>JaxoDraw</strong> from a console gives an error message:
            "<code>AWT-EventQueue-0" Java.lang.OutOfMemoryError</code>".
            <p><strong>Workaround</strong>:
              Increase the size of the Java memory allocation pool
              (with the <code>-Xmx</code> option)
              or avoid opening too many tabs.
            </p>
          </td>
          <td>Java problem (Windows)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug37">#37</a></td>
          <td>
            Photon and gluon arcs are not correctly exported to LaTeX.
            For some combinations of arc points and symmetry parameter,
            the starting- and end angle of the LaTeX command for these arcs
            are ordered in the wrong way.
            <p><strong>Workaround</strong>:
              In the generated tex file, manually exchange the angle
              parameters and/or change the sign of the amplitude.
            </p>
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-0)</td>
        </tr>

        <tr>
          <td><a name="bug38">#38</a></td>
          <td>
            Editing the coordinates of a line object does not work.
            This bug was introduced in the <code>1.3-0</code> release.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-1)</td>
        </tr>

        <tr>
          <td><a name="bug39">#39</a></td>
          <td>
            No <strong>JaxoDraw</strong> executable is found after
            a local install on Linux using the ant script.
          </td>
          <td><strong>JaxoDraw</strong> bug (Linux)</td>
          <td>Closed (v.1.3-1)</td>
        </tr>

        <tr>
          <td><a name="bug40">#40</a></td>
          <td>
            Changing the fill color of a fill object to a gray scale
            and back to a non-gray scale always sets the line color
            to black in the edit panel.
            It should preserve the color that was set before
            (if it was not black), only when the user
            presses the final accept button of the edit dialog,
            should the line color be set to black.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-2)</td>
        </tr>

        <tr>
          <td><a name="bug41">#41</a></td>
          <td>
            When drawing a double line and making the
            double line separation bigger than the default one, the
            line is not drawn correctly.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-2)</td>
        </tr>

        <tr>
          <td><a name="bug42">#42</a></td>
          <td>
            Editing a postscript text does not work in a saved and
            re-opened graph.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-2)</td>
        </tr>

        <tr>
          <td><a name="bug43">#43</a></td>
          <td>
            When entering a new LaTeX/PS text, the panel does not have focus,
            i.e., one is obliged to click on the text field in order to
            enter some text.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-2)</td>
        </tr>

        <tr>
          <td><a name="bug44">#44</a></td>
          <td>
            Arc drawing bugs:
            <ul>
              <li>
                The faint box is not drawn when you are in Arc mode.
              </li>
              <li>
                If you are in Arc mode, arcs and right/center click +
                dragging 2 times + left click you will get an arc on
                the Canvas.
              </li>
            </ul>
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td>Closed (v.1.3-2)</td>
        </tr>

        <tr>
          <td><a name="bug45">#45</a></td>
          <td>
             Several latex import bugs:
             Lines and arcs with arrows at the end (axodraw commands
             \LongArrow,\LongArrowArc and \LongArrowArcn)
             are ignored when doing a latex import.
             A colored vertex always gets it's color reset to black.
             The latex command \CCirc is not imported.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug46">#46</a></td>
          <td>
            When setting the allignment property of a latex text to cc
            (center-center) and the rotation angle to a non-zero value,
            the resulting latex file cannot be
            compiled (error message: Unexpected empty argument).
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

        <tr>
          <td><a name="bug47">#47</a></td>
          <td>
            Trying to resize a triangular vertex from the point that
            was last clicked when it was drawn, doesn't do anything.
          </td>
          <td><strong>JaxoDraw</strong> bug (all)</td>
          <td><font class="rednote">Open</font></td>
        </tr>

      </table>
    </subsection>
    -->
    </section>

  </body>
</document>
