Outdated docs information RE running exports from the command line on Linux #3446

wolfboyft posted onGitHub

https://doc.mapeditor.org/en/stable/manual/export/ says

"When exporting on the command-line on Linux, Tiled will still need an X server to run. To automate exports in a headless environment, you can use a headless X server such as Xvfb. In this case you would run Tiled from the command-line as follows:

xvfb-run tiled --export-map ..."

But someone was able to use such a command on Linux without any X server command, so the docs are outdated.

Also, I had to discover the source/destination format for --export-map by guessing, that should be written down.

Was that someone definitely running in an environment without X running? If X was already running, the command would not be needed.

The formats for --export-map available on your install (they vary based on what plugins and extensions you have available) are available via --export-formats, which in turn you can see in the --help.

posted by eishiya over 2 years ago

They were actually running X, but I have since figured out a project-specific solution where I say "if [it's not working] then run xvfb-make (or equivalent)"

And by export format I didn't mean the file formats Tiled is capable of exporting, I meant the format of the export command itself (which I now know to be "tiled --export-map source destination" (as one might expect), but that should be documented (unless it is?)).

posted by wolfboyft over 2 years ago

And by export format I didn't mean the file formats Tiled is capable of exporting, I meant the format of the export command itself (which I now know to be "tiled --export-map source destination" (as one might expect), but that should be documented (unless it is?)).

The command-line usage of Tiled is currently missing from the manual. Tiled does give instructions itself when you run it with invalid parameters:

bjorn@thor:~$ tiled --export-map
Export syntax is --export-map [format] <source> <target>

posted by bjorn over 2 years ago

Fund this Issue

$0.00

Funded

Only logged in users can fund an issue

Pull requests

Do you want to work on this issue?

Outdated docs information RE running exports from the command line on Linux #3446

Company

Community

Support

Connect