Skip to content
Pauta4.5.0

Command line and launch

Rules on this page 10
IDLevelRule
Flags
CLI-01MUST
--help and --version print before the GUI starts, in plain English, not translated.
CLI-02MUST
--config-dir <dir> uses another config folder, and --dev uses ~/.<app>-dev.
CLI-03SHOULD
--new-instance starts a second process instead of handing off to the running one.
CLI-04SHOULD
--no-session does not restore the last session.
CLI-05MUST
--report writes a redacted problem report and opens the GitHub issue, without starting the GUI.
CLI-06SHOULD
[files…] opens these items.
Launch
CLI-07MUST
One instance runs per config folder. A second launch hands its arguments to the running app over a local endpoint and exits; on macOS, openFiles Apple Events reach the running app.
CLI-08SHOULD
An advisory lock tells two processes on one config folder about each other.
CLI-09SHOULD
main sets java.awt.headless=true before any AWT class loads.
CLI-10SHOULD
External tools are resolved through the login shell’s PATH.
  • CLI-01 MUST --help and --version print before the GUI starts, in plain English, not translated.
    • Check (code): main handles both and exits before launch, printing fixed English text rather than catalog messages.
    • Reference: Editora App.main, App.helpText; AppArgsTest.
  • CLI-02 MUST --config-dir <dir> uses another config folder, and --dev uses ~/.<app>-dev.
  • CLI-03 SHOULD --new-instance starts a second process instead of handing off to the running one.
    • Check (code): the flag skips the single-instance hand-off.
    • Reference: Editora App.newInstanceFlag.
  • CLI-04 SHOULD --no-session does not restore the last session.
    • Check (by hand): launch with --no-session and find only the items given on the command line.
    • Reference: Editora App.helpText.
  • CLI-05 MUST --report writes a redacted problem report and opens the GitHub issue, without starting the GUI.
  • CLI-06 SHOULD [files…] opens these items.
    • Check (by hand): launch with two files and find both open.
    • Reference: Editora App.fileTargets.
  • CLI-07 MUST One instance runs per config folder. A second launch hands its arguments to the running app over a local endpoint and exits; on macOS, openFiles Apple Events reach the running app.
  • CLI-08 SHOULD An advisory lock tells two processes on one config folder about each other.
  • CLI-09 SHOULD main sets java.awt.headless=true before any AWT class loads.
    • Why: on macOS, AWT’s native toolkit and JavaFX contend for the one AppKit run loop and can hang; headless Java2D still draws to images.
    • Check (code): System.setProperty("java.awt.headless", "true") is among the first statements of main.
    • Reference: Editora App.main.
  • CLI-10 SHOULD External tools are resolved through the login shell’s PATH.
    • Why: a .app launched from Finder inherits a stripped PATH.
    • Check (code): every process the app starts gets a PATH that includes the login shell’s.
    • Reference: Editora process/ProcessRunner.java (augmentedPath).

Pauta 4.5.0 · · Changelog · This page in the latest edition