<?xml version="1.0" encoding="ISO-8859-1"?>

<faqs xmlns="http://maven.apache.org/FML/1.0.1"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
  title="Frequently Asked Questions">

  <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>

  <part id="general">
    <title>General</title>

    <faq id="what-is-jaxodraw">
      <question>
        What is <strong>JaxoDraw</strong>?
      </question>
      <answer>
        <strong>JaxoDraw</strong> is a Feynman diagram drawing tool.
      </answer>
    </faq>

    <faq id="why-is-it-called-jaxodraw">
      <question>
        Why is it called <strong>JaxoDraw</strong>?
      </question>
      <answer>
        <strong>JaxoDraw</strong> was initially meant to be a
        graphical user interface for J. Vermaseren's
        <a href="http://www.nikhef.nl/~form/maindir/others/axodraw/axodraw.html">axodraw</a>
        LaTeX package. Since it is written in Java, we prepended the J.
      </answer>
    </faq>

    <faq id="why-use-it">
      <question>
        Why should I use <strong>JaxoDraw</strong> rather than
        program XYZ to draw Feynman diagrams?
      </question>
      <answer>
        The main feature of <strong>JaxoDraw</strong> that distinguishes it from
        similar programs is that it offers a complete graphical user interface
        (GUI) for drawing diagrams. That means that you can draw your diagrams
        with just some mouse point &amp; click &amp; drag operations, like
        with a modern drawing program. For other features, please check the
        <a href="overview.html">Overview</a> document.
      </answer>
    </faq>

    <faq id="on-which-platform">
      <question>
        On which platform does it run?
      </question>
      <answer>
        We provide some pre-compiled
        <a href="download/special.html">binaries</a>
        for the Windows, Linux and MacOSX platforms but
        <strong>JaxoDraw</strong> will run anywhere if there is a Java
        environment installed.
        Check the <a href="quick/download.html">Download</a> page of the
        <a href="quick/index.html">Quick Start</a> guide for instructions.
      </answer>
    </faq>

    <faq id="does-it-run-on-mac">
      <question>
        Does it run on Mac OS X?
      </question>
      <answer>
        Yes it does.
        On MacOSX, you don't even have to install a Java environment, since it
        comes with the operating system, so you can start using
        <strong>JaxoDraw</strong> right away! You should however check this
        <a href="reference/MacIssues.html"><code>README</code></a>
        file for some special documentation on <strong>JaxoDraw</strong>
        on Mac OS X.
      </answer>
    </faq>

    <faq id="where-get-help">
      <question>
        Where do I get help on <strong>JaxoDraw</strong>?
      </question>
      <answer>
          This FAQ answers some frequent questions already, please read the
          <a href="quick/index.html">Getting Started</a>
          for a quick start guide.
        <p></p>
          The <a href="reference/index.html">Reference</a> section
          and the <a href="userguide.html">user guide</a>
          contain some detailed and comprehensive documentation about
          <strong>JaxoDraw</strong>.
        <p></p>
          If these resources don't help you with your problem,
          or if you think that you found a bug that is not yet documented,
          you should <a href="contacts.html">contact</a> us.
      </answer>
    </faq>

    <faq id="question-not-addressed">
      <question>
        I have a question that is not addressed here.
        Where can I ask?
      </question>
      <answer>
         See our <a href="contacts.html">Contacts</a> page.
      </answer>
    </faq>

  </part>

  <part id="building">
    <title>Building JaxoDraw</title>

    <faq id="how-build">
      <question>
        How do I build <strong>JaxoDraw</strong>?
      </question>
      <answer>
         This is described in the <a href="download/src.html">Instructions</a>
         section of the source download document.
      </answer>
    </faq>

    <faq id="java5">
      <question>
        Can I build (and use) <strong>JaxoDraw</strong> with Java 5?
      </question>
      <answer>
         From version 2.1 on, building <strong>JaxoDraw</strong> even requires java 5.
         Older versions were written and maintained
         with Java version 1.4.2, but all later Java versions should be
         backward compatible. For Java 5 there are a few minor points to notice,
         see this <a href="news.html#a01.12.2004">news</a> entry.
      </answer>
    </faq>

    <faq id="web-site-build">
      <question>
        How is the <strong>JaxoDraw</strong> web site built?
      </question>
      <answer>
         We use <a href="http://maven.apache.org/">maven</a> to build our
         web site. If you have maven installed, you can just run
         '<code>mvn site</code>' to build the whole site.
      </answer>
    </faq>

  </part>

  <part id="using">
    <title>Using JaxoDraw</title>

    <faq id="what-are-prereqs">
      <question>
         What are the prerequisites for using <strong>JaxoDraw</strong>?
      </question>
      <answer>
         Please see the <a href="quick/prereq.html">Prerequisites</a> document.
      </answer>
    </faq>

    <faq id="powerpoint">
      <question>
         How can I use <strong>JaxoDraw</strong> for a PowerPoint presentation?
      </question>
      <answer>
         There is a description in this
         <a href="news.html#a27.10.2004">news</a> entry.
      </answer>
    </faq>

    <faq id="how-do-i">
      <question>
         How do I do this and that with <strong>JaxoDraw</strong>?
      </question>
      <answer>
         Please check the <a href="userguide.html">user guide</a> for general
         usage instructions.
      </answer>
    </faq>

    <faq id="undo">
      <question>
         Is there an 'Undo' button?
      </question>
      <answer>
         Yes, there is an undo and re-do functionality (since version 2.0).
         The number of undo steps can be configured in the Preferences.
      </answer>
    </faq>

  </part>

  <part id="errors">
    <title>Errors - Unexpected Behaviour</title>
<!--
    <faq id="question">
      <question>
         Question
      </question>
      <answer>
         Answer
      </answer>
    </faq>
-->
    <faq id="text-in-PS">
      <question>
          Why does my text not appear in the output generated by <strong>JaxoDraw</strong>?
      </question>
      <answer>
          As we explained in the
          <a href="userguide.html">user guide</a>,
          LaTeX- and Postscript
          texts appear mutually exclusive in LaTeX- and direct postscript
          output. If you want to generate output via the direct postscript
          export menu of <strong>JaxoDraw</strong>, you should use the postscript text
          button to create a text, if you want to use the LaTeX - EPS
          export, use LaTeX text button. From version 1.1-0 on,
          a warning message is displayed each time a postscript export is
          attempted with a LaTeX text present, and vice-versa.
      </answer>
    </faq>

    <faq id="fcolorbox">
      <question>
          Why is there this funny <code>\fcolorbox</code> command in the
          Latex text file generated by <strong>JaxoDraw</strong>?
      </question>
      <answer>
          The <code>\fcolorbox</code> command was introduced because
          otherwise <code>dvips</code> does not recognize the bounding box
          coordinates correctly for the conversion to EPS.
          This is a workaround that we used ourselves when working with
          <code>axodraw.sty</code>, if you cut and paste
          the Latex output into your own documents, or if you don't
          want an EPS, you may erase the <code>\fcolobox</code> command.
      </answer>
    </faq>

    <faq id="latex-eps-export">
      <question>
          Latex-EPS export or preview does not work.
      </question>
      <answer>
         There may be several reasons for that. Internal latex compilation
         is quite a vulnerable operation since it employs the execution
         of external commands, which means it dependends on your system and
         set-up.
         <p></p>
         The first thing to check is whether you have indicated the correct
         paths for the latex and dvips executables in the Preferences panel
         (you may have to give the absolute paths).
         Then try to do a latex export and run latex manually. Check for
         any error messages.
         <p></p>
         Check that latex finds the axodraw.sty file, you may have to install
         it first. Refer to the appendix
         of the <a href="./userguide.html">User Guide</a> for more
         information. See also <a href="reference/bugs.html">Bug #6</a>.
         <p></p>
         On Unix like systems, make sure that you have write permission
         to the directory where <strong>JaxoDraw</strong> creates temporary files
         (usually the <strong>JaxoDraw</strong> home directory).
         <p></p>
         On Mac OS X there is an issue if you are using the z-shell or tcsh as
         your default shell. Refer to the
         <a href="reference/MacIssues.html">Mac OS X README</a>
         for more information.
         <p></p>
         If you are running cygwin on Windows, see this separate
         <a href="#cygwin">faq</a>.
      </answer>
    </faq>

    <faq id="location">
      <question>
        How can I run <strong>JaxoDraw</strong> from any location I like?
      </question>
      <answer>
        If you are not using the jar executable and would like to
        run <strong>JaxoDraw</strong> from a different location than the program's
        home directory, you have to tell the java interpreter where
        it can find the executable <code>.class</code> files.
        This is done with the <code>-classpath</code>
        (or <code>-cp</code>) option.
        <p></p>
        Example: Suppose you have put the <strong>JaxoDraw</strong> home directory
        <code>JaxoDraw-1.0</code> into your home directory <code>$HOME</code>.
        Going into <code>JaxoDraw-1.0/</code> and typing
        <source>java JaxoDraw/JaxoDraw</source>
        will work as expected, but typing
        <p>
          <source>java JaxoDraw-1.0/JaxoDraw/JaxoDraw</source>
        </p>
        gives you a <code>NoClassDefFoundError</code> error.
        What you need to type instead is:
        <source>java -cp JaxoDraw-1.0 JaxoDraw/JaxoDraw</source>
        (note the space between the classpath variable and the
        executable). An alternative is to create the jar executable
        (see the <a href="./userguide.html">user guide</a>)
        which may be executed from everywhere with the <code>-jar</code>
        option:
        <source>java -jar JaxoDraw-1.0/JaxoDraw.jar</source>
        Note that all binary distributions of <strong>JaxoDraw</strong> use the jar executable,
        so this FAQ only applies to the source distribution.
      </answer>
    </faq>

    <faq id="fedora">
      <question>
         I cannot run <strong>JaxoDraw</strong> on Fedora Core 3/4!
      </question>
      <answer>
         Fedora Core 3 and 4 ship with a complete Java installation by default.
         This Java environment (gcj) is completely free and open source
         (as opposed to the proprietary versions from Sun, IBM and BEA),
         but unfortunately still incomplete.
         <strong>JaxoDraw</strong> will not compile nor execute with gcj.
         You will either have to uninstall all gcj-related stuff and
         install one of the proprietary Java versions, or at least make
         sure that the two stay cleanly separated.
         <p></p>
         Note that there are <strong>JaxoDraw</strong>
         <a href="download/rpm.html">rpms</a> available that
         were built and tested on Fedora Core 3.
      </answer>
    </faq>

    <faq id="cygwin">
      <question>
         Export to eps does not work when using windows+cygwin (instead of miktex)!
      </question>
      <answer>
         Set the LaTeX path in the Preferences to the following
         (thanks to Anjishnu Sarkar):
          <source>pdfetex -progname=latex</source>
      </answer>
    </faq>

  </part>

  <part id="development">
    <title>Development</title>

    <faq id="can-i-contribute">
      <question>
        Can I contribute?
      </question>
      <answer>
        Yes, please! Check this <a href="contributing/help.html">document</a>
        and <a href="contacts.html">contact</a> us!
      </answer>
    </faq>

    <faq id="i-found-a-bug">
      <question>
        I think I found a bug in <strong>JaxoDraw</strong>.
        What should I do?
      </question>
      <answer>
        First check our <a href="reference/bugs.html">bug list</a> if the
        problem is already documented. Then you should try to identify the
        problem, whether it is really a <strong>JaxoDraw</strong> bug, or
        a limitation of some third-party software (latex, axodraw, java)
        or your operating system.
        If you are not sure, you should post a question to the
        <strong>JaxoDraw</strong> discussion
        <a href="mail-lists.html">mailing list</a>.
        Finally, if you are sure that you have really found a bug that is not
        yet documented, you can directly open a new bug report at our SourceForge
        <a href="http://sourceforge.net/tracker/?group_id=142124&amp;atid=751521">bug database</a>
        (you need a SourceForge account for that), or post it to our
        <a href="mail-lists.html">mailing list</a>.
      </answer>
    </faq>

    <faq id="when-will-feature">
      <question>
        When will feature XYZ be implemented?
      </question>
      <answer>
        Depends. If it is something you really sorely need, you could (politely)
        try to exert some pressure on us. You can also try to pay us.
        Or try to implement your feature yourself and send us some patches.
        In any case, you should check this
        <a href="contributing/help.html">document</a>
        and <a href="contacts.html">contact</a> us about your problem.
      </answer>
    </faq>

  </part>

</faqs>
