README for:  JaTeX
Written by:  Joseph A. Huwaldt <jhuwaldt@mac.com>
Version:  1.0.2b
Date:  February 5, 2025
Web site:  http://thehuwaldtfamily.org/java/Applications/JaTeX/JaTeX.html


JaTeX is a cross-platform Java program that works with the LaTeX system to provide a graphical user interface for typesetting equations.  JaTeX is a tool that allows LaTeX users to type equations without needing to remember all the many commands required.  However, JaTeX is not an "equation editor" per say, but is largely a graphical interface above the LaTeX engine.  The user must have at least some familiarity with how TeX equation code is structured to use JaTeX well. JaTeX saves the user a lot of the overhead burden of working with LaTeX and provides a reference to most of the equation related commands that are possible. You can drag and drop the resulting equation into other applications such as word processors or presentation software or you can save it to a PNG file.  In addition, images created by JaTeX can be dropped back onto the JaTeX window and turned back into editable equations for revision.

JaTeX requires a working TeX or LaTeX distribution in order to function. It does not come with one imbedded. This allows you to use whatever LaTeX distribution you want and leaves JaTeX as a lightweight, cross-platform tool.  The "TeX Live" distribution is a good general distribution of LaTeX that will work for most people on Windows, MacOS and Linux (https://www.tug.org/texlive/).  But other distributions are available as well.  The 1st time you run JaTeX, you may have to tell it where the "latex" and "diving" executables are located in your distribution by setting those in the application preferences.

Note that the JaTeX interface is designed for working with equations, not for multi-page documents.  For that, you should consider one of the myriad of other TeX editors (http://en.wikipedia.org/wiki/Comparison_of_TeX_editors).


If you are a MacOS X user, you may want to check out LaTeXiT (http://www.chachatelier.fr/latexit/) which is a fuller featured, very well designed program that does the same thing as JaTeX, but is available only on MacOS X.


Revision History:
Version 1.0.2b	05-FEB-2025
* Fixed an issue with running on MacOS 15.1. Other OS versions are unchanged. 

Version 1.0.2	20-DEC-2023
* Modified to remove the seriously out of date MRJAdapter and Bare Bones Browser Launcher libraries and replaced them with the now standard java.awt.Desktop class.
* Modified MacOS application bundle to work better on modern versions of MacOS.
* The MacOS version has a Java 11 compatible JRE bundled with the application (you do not need to have Java installed to run this version).

Version 1.0.1 	10-OCT-2020
* Fixed a bug where sometimes the type setting of equations would fail because Tex needed to first created bitmapped fonts at the size requested but it couldn't find the utility that defined the bitmapped font.
* Fixed a bug with an underlying library (MRJAdapter) that wasn't compatible with recent versions of Java (Java 15 in particular).

Version 1.0.0	10-JAN-2015
* Initial public release of the JaTeX program.


Legal notice:
JaTeX -- The TeX equation typesetting program.
Copyright (C) 2013-2025  Joseph A. Huwaldt <jhuwaldt@mac.com>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.  Or visit the Free Software Foundation's web site:
    http://www.gnu.org/copyleft/gpl.html

Some of the code for this program is protected by the GNU Lesser General Public License.  You can find a copy of this license included with the program and with the source code.

Some of the code for this program is protected by the Apache License (http://ant.apache.org/license.html).  You can find a copy of this license included with the program and with the source code.

The source code for this program is available for download here:
http://thehuwaldtfamily.org/java/Applications/TableReader/TableReader.html

Feel free to contact me if you have any problems or questions about this program.

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
