Update man page for 1.0

The man page needs to be updated for Inkscape 1.0

(list by @Moini, moved from https://bugs.launchpad.net/inkscape-docs/+bug/1778078)

  • Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: --pdf-page N)
    inkscape/inkscape@045470cc
  • Additionally, the verbs syntax has changed. Not sure if both options are now there, or if some things are available as verbs and some as actions... No feedback from Tav, I asked a couple of times.
  • --pdf-poppler Use poppler when importing via commandline
  • --pipe (or -p) argument (see comment and inkscape/inkscape@465a6750...b2294c56
  • changed behavior of how to pass in verbs (as semicolon-separated list now)
  • exporting multiple file formats at once

Missing from both 0.92.x and master branches (list by @Moini, moved from https://bugs.launchpad.net/inkscape-docs/+bug/1810570)

  • --export-margin option missing:
    https://gitlab.com/inkscape/inkscape/blob/0.92.x/src/main.cpp#L356
  • --export-wmf and export-emf options missing:
    https://gitlab.com/inkscape/inkscape/blob/0.92.x/src/main.cpp#L440
  • --convert-dpi-method
    https://gitlab.com/inkscape/inkscape/blob/0.92.x/src/main.cpp#L542
  • And I just saw that piping could be used before, for output:
    https://gitlab.com/inkscape/inkscape-docs/documentation/blob/0.92.x/man/inkscape.pod.in#L245
    (but it was more complicated)

Compared man SYNOPSIS and OPTIONS (@gyuris)

  • delete --export-png option
    Someone deleted this option from the SYNOPSIS correctly, but continues to occur in OPTIONS (2×) and in EXAMPLES (6×).
  • add --export-ps-level option
    This option is present in the SYNOPSIS but description is missing from OPTIONS. It's an alive option: https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L569

Compared man to inkscape-application.cpp (@gyuris)

  • rename --export-filename to --export-file
    https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L549
  • modify --select to comma separated list
    https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L590
  • add --export-overwrite option
    https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L550
  • add --actions option
    https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L594
  • add --batch-process option
    https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L606
  • add --dbus-listen and --dbus-name option
    https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L612 https://gitlab.com/inkscape/inkscape/blob/0.92.x/src/main.cpp#L506 (who can use these? Is it compiled with dbus by default? What does this actually do?)
    Separated to #31 (closed)
  • delete old export options: --export-emf, --export-wmf, --export-ps, --export-eps, --export-pdf
    See --export-type=FILE_TYPE
  • reorganize order to inkscape-application.cpp

New tasks (@gyuris)

  • delete --g-fatal-warnings
    According to #2 (comment 264067613)
  • modify --export-id=ID[;ID] and --query-id=ID[,ID]
    https://gitlab.com/inkscape/inkscape/blob/master/src/inkscape-application.cpp#L566 https://wiki.inkscape.org/wiki/index.php/Using_the_Command_Line
Edited Mar 09, 2020 by Gyuris Gellért
Assignee Loading
Time tracking Loading