[Libreoffice-bugs] [Bug 142417] New: Online Help: "File Conversion Filter Names" page should contain an "API Name" column

[bugzilla-daemon at bugs.documentfoundation.org]

https://bugs.documentfoundation.org/show_bug.cgi?id=142417

            Bug ID: 142417
           Summary: Online Help: "File Conversion Filter Names" page
                    should contain an "API Name" column
           Product: LibreOffice
           Version: 7.2.0.0.alpha0+ Master
          Hardware: All
                OS: All
            Status: UNCONFIRMED
          Severity: normal
          Priority: medium
         Component: Documentation
          Assignee: libreoffice-bugs at lists.freedesktop.org
          Reporter: suokunlong at 126.com
                CC: olivier.hallot at libreoffice.org

The following API documentation page:
https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1document_1_1MediaDescriptor.html#a777c03d61101090a1539aafc6ba1c4ca

says that the FilterName option passed using com.sun.star.beans.PropertyValue
should be an internal filter name and references to the following Online Help
page:
https://help.libreoffice.org/latest/en-US/text/shared/guide/convertfilters.html

However, the Filter Names as listed on this Online Help page are actually UI
Names (or Localized Names) of those filters, not API Names.

For instance:
* on the online help page the Filter Name for ODT is "Writer 8", but according
to filter/source/config/fragments/filters/writer8.xcu in the source code the
API name for ODT should be "writer8". The API name should be used in the
MediaDescriptor::FilterName rather than the UI name, otherwise the API calling
will be wrong and the API then falls back to the default fiter.
* Online help page says "Word 2007–365", but the API name should be "MS Word
2007 XML". 

The solution is not to revise those names on Online Help to those UI names, but
to add a new column indicating their corresponding API Names, just like the
OpenOffice wiki page did:
https://wiki.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0

-- 
You are receiving this mail because:
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/libreoffice-bugs/attachments/20210522/2573c540/attachment-0001.htm>