Bug 98153 - "--convert-to help" command line feature wanted.
Summary: "--convert-to help" command line feature wanted.
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: LibreOffice (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium enhancement
Assignee: Not Assigned
URL:
Whiteboard: target:7.2.0
Keywords:
: 98156 (view as bug list)
Depends on:
Blocks: Commandline
  Show dependency treegraph
 
Reported: 2016-02-24 18:50 UTC by Stéphane Aulery
Modified: 2021-06-19 11:26 UTC (History)
2 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Stéphane Aulery 2016-02-24 18:50:35 UTC
From: "A. Costa" <agcosta@gis.net>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: wishlist: '--convert-to help' command line feature wanted.
Date: Fri, 2 Mar 2012 21:33:23 -0500

Package: libreoffice-common
Version: 1:3.4.5-2
Severity: wishlist

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.

HTH...
Comment 1 Maxim Monastirsky 2016-03-06 11:45:15 UTC
valid request -> NEW.
Comment 2 Maxim Monastirsky 2016-03-08 09:32:09 UTC
*** Bug 98156 has been marked as a duplicate of this bug. ***
Comment 3 Mike Kaganski 2016-11-27 16:44:09 UTC
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.
Comment 4 Mike Kaganski 2016-11-28 14:10:10 UTC
https://wiki.openoffice.org/wiki/Documentation/DevGuide/Spreadsheets/Filter_Options

Things could have changed in LO, though.
Comment 5 Mike Kaganski 2021-02-22 11:32:50 UTC
(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.
Comment 6 Eike Rathke 2021-03-03 13:07:30 UTC
A pointer to available filters for --convert-to and --infilter names:
https://git.libreoffice.org/core/+/refs/heads/master/filter/source/config/fragments/filters/

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.
Comment 7 Mike Kaganski 2021-03-03 13:33:38 UTC
First step could be to augment existing help pages:

https://help.libreoffice.org/latest/en-US/text/shared/guide/start_parameters.html

https://help.libreoffice.org/latest/en-US/text/shared/guide/convertfilters.html

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.
Comment 8 Commit Notification 2021-03-03 14:01:33 UTC
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/46e4473935c7274fecd883b71cfb7a59e3b29cf2

tdf#98153  add mention and link to document filters
Comment 9 sdc.blanco 2021-03-03 14:09:01 UTC
(In reply to Mike Kaganski from comment #7)
> The former should mention the latter not only in "--convert-to" section, but
> also in "--infilter"; 
Done.

> 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.
Comment 10 Mike Kaganski 2021-06-19 11:26:30 UTC
(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
> that.

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).