diff options
Diffstat (limited to 'support/tlcockpit/README.md')
-rw-r--r-- | support/tlcockpit/README.md | 36 |
1 files changed, 25 insertions, 11 deletions
diff --git a/support/tlcockpit/README.md b/support/tlcockpit/README.md index c5b9bbd8d2..cdcf61d699 100644 --- a/support/tlcockpit/README.md +++ b/support/tlcockpit/README.md @@ -27,11 +27,15 @@ Debugging can be enabled by passing the option `-d` or, for more detailed debugg Requirements ------------ -You need at least `tlmgr` from after 2017-11-23, in TeX Live language at least -version 45888 or `texlive.infra`. +Currently TLCockpit is shipped with two jars, one for JDK8 and one for JDK9+. +The JDK8 version does *not* contain the JavaFX as it is normally shipped together +with the JDK. The JDK9+ version contains JavaFX modules and thus should work +without the need for additional installations. -A recent Java (at least Java 8) installation that includes JavaFX is required. If you see -errors like +The default for TLCockpit shell wrapper (used on Unix and Mac) is to check for the +version of Java (using `java -version`) and use the appropriate jar. + +If you are running Java 8 and see the following errors ``` Error: A JNI error has occurred, please check your installation and try again Exception in thread "main" java.lang.NoClassDefFoundError: javafx/event/EventTarget @@ -44,11 +48,19 @@ that means that the Java installation does not provides JavaFX. On Windows the latest JRE from Oracle include JavaFX. On Linux one might need to install some extra packages (Debian/Ubuntu: openjfx). -With recent release of Java 11 problems are getting worse, since JavaFX is now -separately packaged, and ScalaFX only supports (by now) JavaFX8. That means, for -now it is necessary to have a Java 8 installation. As soon as ScalaFX supports -JavaFX11 we will move to use it. +HiDPI support +------------- +Depending on your JDK version and operating system, Java might not correctly +detect the presence of a HiDPI screen. + +Upgrading to JDK14 should help in this case. +For other versions, you might be able to fix it by setting the environment +variable +``` +export GDK_SCALE=2 +``` +(or even `=3`) might help. Development ----------- @@ -110,10 +122,12 @@ The Tools menu, as well as the expert and debug panes open ![Menu, Expert, Debug](screenshots/tlcockpit-menu-debug-expert.jpg) -License -------- +Copyright and License +--------------------- -GPL3+ +Copyright 2017-2020 Norbert Preining +Licenced under the GNU General Public License, version 3 or any higher version +(GPL3+) Author |