T.P.Format: add new function `formatFromFilePaths` [API Change] (#8710)

* T.P.Format: export `formatFromFilePaths` [API change]
* Lua: add function `pandoc.format.from_path`
* Update lua-filters.md
* The old T.P.App.FormatHeuristics module has been removed.

This is an alternative to #8693.

1 files changed, 18 insertions, 0 deletions

diff --git a/doc/lua-filters.md b/doc/lua-filters.md
index bc99fce27..70670dbe4 100644
--- a/doc/lua-filters.md
+++ b/doc/lua-filters.md
@@ -3703,6 +3703,9 @@ are explicitly passed via the `env` parameter; e.g.
       return pandoc.cli.repl{ doc = doc }
     end
 
+**Note**: it seems that the function exits immediately on
+Windows, without prompting for user input.
+
 Parameters:
 
 `env`
@@ -4582,6 +4585,21 @@ Returns:
 
 *Since: 3.0*
 
+### from_path {#pandoc.format.from_path}
+
+`from_path (path)`
+
+Parameters:
+
+`path`
+:   file path, or list of paths (string\|{string,\...})
+
+Returns:
+
+-   format determined by heuristic (string\|nil)
+
+*Since: 3.1.2*
+
 <!-- END: AUTOGENERATED CONTENT -->
 
 <!-- BEGIN: AUTOGENERATED CONTENT for module pandoc.json -->