From: "A. Costa" <firstname.lastname@example.org>
To: Debian Bug Tracking System <email@example.com>
Subject: wishlist: '--convert-to help' command line feature wanted.
Date: Fri, 2 Mar 2012 21:33:23 -0500
Spun off from #661654.
Please consider adding a '--convert-to help' feature that
would work like "-vo help" in 'mplayer'. Used from the
command line, the switch would print to STDOUT a list of the system's
currently installed conversion filters.
valid request -> NEW.
*** Bug 98156 has been marked as a duplicate of this bug. ***
I would propose something like --help-filters, to be able not only getting output filters for --convert-to, but also input filters, that can be specified in --infilter switch.
Things could have changed in LO, though.
(In reply to Mike Kaganski from comment #4)
> Things could have changed in LO, though.
E.g., in LibreOffice Calc, there are two more tokens available for CSV export: token 10 for "export formulas", and token 11 for "remove space". Source code: ScImportOptions::ScImportOptions in sc/source/ui/dbgui/imoptdlg.cxx.
A pointer to available filters for --convert-to and --infilter names:
The name to use for a filter is the node element's oor:name property in a .xcu, e.g.
"Text - txt - csv (StarCalc)"
in https://git.libreoffice.org/core/+/refs/heads/master/filter/source/config/fragments/filters/Text___txt___csv__StarCalc_.xcu for the Calc Text and CSV filter.
First step could be to augment existing help pages:
The former should mention the latter not only in "--convert-to" section, but also in "--infilter"; the latter should have links to separate new "filter options" pages specific to filters, where the filter options would be explained (starting point could be the documentation linked in comment 4), with samples of command lines for import and export of respective files.
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":
tdf#98153 add mention and link to document filters
(In reply to Mike Kaganski from comment #7)
> The former should mention the latter not only in "--convert-to" section, but
> also in "--infilter";
> the latter should have links to separate new "filter
> options" pages specific to filters
afaik, these "new" pages do not exist. Maybe better to open a new ticket for that.
(In reply to sdc.blanco from comment #9)
> (In reply to Mike Kaganski from comment #7)
> > the latter should have links to separate new "filter
> > options" pages specific to filters
> afaik, these "new" pages do not exist. Maybe better to open a new ticket for
No. This is exactly the bug *asking* for the help pages for documenting the --convert-to parameter, and creation of those pages is part of the task.
Also https://help.libreoffice.org/7.2/en-US/text/shared/guide/convertfilters.html needs correcting: it does not clarify which of the columns should be used in the command line (it is named "File Conversion Filter Names", and has "Filter Name" column - so it would be natural for user to assume that this column has the wanted string - while in fact, the correct value is in the "API Name" column).