Command line operations

Command line operations

• macro: load [path] (Re)load macrofiles. An optional parameter path has the same meaning as the field Path in struct FarMacroLoad.
• macro: save
  Save the created or modified keyboard macros.
• macro: unload
  Unload macros (except those created with operation MCTL_ADDMACRO) and event handlers.
• macro: about
  Show versions of the plugin and the libraries it is using.
• lua: [=] <code>
• moon: [=] <code>
  Execute the code <code> written correspondingly in Lua or MoonScript.
  If <code> is preceded with a character = then far.Show() is called, e.g.:
  lua:=5+2,6,"foo" is equivalent to lua:far.Show(5+2,6,"foo").
• lua: [=] @<filename> [<args>]
• moon: [=] @<filename> [<args>]
  Execute the script <filename> written correspondingly in Lua or MoonScript.
  
  • For passing arguments to the script they should be specified after the file name, separated with whitespace.
  • Arguments are a sequence of expressions delimited with commas.
  • The expressions must be written in the same programming language as the script.
  • The global (within the environment of the script) variable _filename contains the file name.

Note 1:
Prefix lm: can be used instead of prefix macro: – they are equivalent.

Note 2:
There are also luas: and moons: prefixes that can be used instead of respectively lua: and moon:. In that case no macro is created and the code is executed immediately (“synchronously”). If the code terminates in a normal way then CmdLine.Result is a table containing an array of returned values and the field n of the table is the number of returned values. If the code execution is interrupted by an error the value of CmdLine.Result is nil.

Note 3:
Additional command line prefixes can be defined and loaded from macrofiles.