Jarnal - Troubleshooting

Home
Downloads
Documentation
FAQ
Release Notes

Known Problems and Limitations:
  • Pdf backgrounds do not work properly in applets.
  • If you save a pdf file overwriting a pdf file you are currently annotating, Jarnal will crash.
  • When you paste text from an external app (via clipboard), the doc 'jumps' to the top of page.
  • If you zoom in too much you will run out of memory.
  • If you modify jarnalshell.conf while jarnal is open, it will overwrite your changes when it exits.
  • IRS pdf tax forms have a strange "non-printing" segment at the top. This appears when you open the pdf, but disappears when you print to pdf, causing whatever annotations you made to be improperly aligned with the form. There is a work-around. Open the form in Jarnal; print it to pdf without annotating. This removes the "non-printing" segment. If you now annotate the new pdf you created everything will work normally.
  • You may need to install the JAI for additional image support. You will need to do this to view TIFF files or to use pdftoppm as an external renderer.  

    Sun provides the JAI addon with support for additional graphical formats including multi-page tiff for faxes and ppm files used with xpdf for pdf support on unix systems. For Linux and Windows go to http://java.sun.com/products/java-media/jai/ and download and install JAI for your platform. For the Mac go to http://www.apple.com/downloads/macosx/apple/java3dandjavaadvancedimagingupdate.html. Note: there seem to be two JAI's to install - the connection between them is not clear to me. Make sure to install the "JAI Image I/O API" along with the JAI itself.

  • Java 1.5/1.6 are broken when used with the composition managers in Linux (compiz or beryl). You will just get grey boxes. Turn them off (sometimes called "desktop effects") or download a test version of 1.6 that fixes the problem. It is nearly impossible to find - but it is at http://download.java.net/jdk6/6u1. I also have a report (I have not tested it personally) that setting the AWT_TOOLKIT variable thusly injarnal.sh prior to running jarnal: export AWT_TOOLKIT=MToolkit resolves the problem.
  • Sun Java build 1.5.0-b64 is broken and issues a mouse-click at the end of each stroke, leading to blobby looking strokes. To fix, upgrade to a more recent version of Sun Java. Build 1.5.0_04-b05 works fine, for example. To check your version run java -version at the command line.
  • Loading fonts can crash some Sun VMs causing you to lose all your work. This is a Java error over which I have no control. I have tested all the fonts on my machine with the most recent 1.4.2 and none cause a crash, so it appears to be fixed. You should regardless upgrade for security reasons.
  • Html cut and paste does not work prior to Java 1.5.
  • Java support for additional image formats (bmp, png, pnm and tif) will not work with an unsigned applet loaded with a browser due to security restrictions. The solution is to convert image formats to .jbg (zipfile of jpg images) on the server. Here is source code for an (untested) java class with a single static method that reads an inputstream on an arbitrary java supported image file, and writes the corresponding jbg file on an outputstream. 


Jarnal screenshot