search

petr-panteleyev / jpackage-gradle-plugin

JPackage Gradle Plugin
https://codeberg.org/petr-panteleyev/jpackage-gradle-plugin
BSD 2-Clause "Simplified" License
97 stars 13 forks source link

Add Linux examples to README.md #6

Closed nikitalita closed 3 years ago

nikitalita commented 3 years ago

I added "installDir" to help clue people in that "installDir" is actually the prefix on Linux.

petr-panteleyev commented 3 years ago
  1. Users should read jpackage User's Guide for full information
  2. Using /usr as an install dir is not the right example anyway.
nikitalita commented 3 years ago

  1. jpackage's documentation is particularly unhelpful, at least when it comes to Linux packaging. This is undocumented in the official Oracle docs, there is no indication that --install-dir acts as the prefix on Linux, and I don't see any way to submit a patch to fix it. Users will look to modules like this for guidance on how to use the damned thing, and this will likely head off support requests.

  2. It is if you want your package to behave like pretty much every other Debian package. Libraries end up in /usr/lib, binaries end up in /usr/bin, statically-linked assets end up in /usr/share/APP_NAME, docs end up in /usr/docs. This is particularly necessary if you want your binary to end up on the PATH without additional configuration.