73.234.73.94.ip.orionnet.ru/73.234.73.94.ip.orionnet.ru.tar/73.234.73.94.ip.orionnet.ru/Far30b3000.x86.20121208.msi/FARCmdsEng.hlf

Text File | 2012-12-08 | 15KB | 424 lines

.Language=English,English (English)
.PluginContents=FAR Commands
.Options CtrlStartPosChar=^<wrap>

@Contents
$^#FAR Commands#
   The FAR Commands plugin (FARCmds) provides a number of additional commands.

   Except command ~"Same Folder"~@TheSameCatalogue@, all the rest have to be
invoked via command line prefixes.

   Besides ~command line~@:CmdLineCmd@, prefixes may be used in ~User Menu~@:UserMenu@,
in ~file associations~@:FileAssoc@, as well as in dialog ~Apply Command~@:ApplyCmd@ (#Ctrl-G#)


  #Command Line Syntax#

   #command:#[#options#] #object#

   #command# - one of the following:
             ~view~@View@     - viewer
             ~edit~@Edit@     - editor
             ~goto~@Goto@     - jump to a file or folder
             ~clip~@Clip@     - put data in the clipboard
             ~whereis~@WhereIs@  - locate and jump to an object
             ~macro~@Macro@    - macros
             ~link~@Link@     - create links
             ~run~@Run@      - execute commands
             ~load~@Load@     - load plugin
             ~unload~@Unload@   - unload plugin

   #options# - optional parameters, see corresponding commands descriptions.

   #object#  - one of the following:
             #filename# - name of the file to be viewed, edited or jumped to.
             #path#     - file or directory path to jump to.
             #<command# - ~intercept output~@Direction@ of operation system command.
                        Symbol #<# is obligatory.


   See also: ~Configuring FAR Commands~@Config@ | ~Notes~@Remark@

@Load
$ #The Load command#
   Command #load# allows you to load the plugin #DLL_module_name#.

   #load:DLL_module_name#


   See also: ~unload~@Unload@ | ~Notes~@Remark@ | ~Contents~@Contents@

@Unload
$ #The Unload command#
   Command #unload# allows you to unload the plugin #DLL_module_name#.

   #unload:DLL_module_name#


   See also: ~load~@Load@ | ~Notes~@Remark@ | ~Contents~@Contents@

@Clip
$^#The Clip command#
   The #clip# command puts data into the Windows clipboard.
The data can be the contents of a file or the output of a program.
The clipboard will contain all the data up to the character with the
code #0x00#.
Размер помещаемых данных можно задавать в диалоге конфигурации плагина. По
умолчанию - 1 Mb.

   #clip:filename#

   Передаваемые команде данные нулевого размера очищают буфер обмена.

   See also: ~Output Redirection~@Direction@ | ~Notes~@Remark@ | ~Contents~@Contents@

@Run
$ #The Run command#
   The #run# command executes an operating system #command# redirecting
its output to the specified file #"filename"#. Output can also be displayed
on the screen or hidden from the user using ~Output Redirection~@Direction@ modifiers.

   #run:filename<command#


   See also: ~Output Redirection~@Direction@ | ~Remarks~@Remark@ | ~Contents~@Contents@


@View
$^#The View command#
   The #view# command opens the file "#filename#" in the FAR
built-in ~viewer~@:Viewer@:

   #view:filename#


   See also: ~edit~@Edit@ | ~Output Redirection~@Direction@ | ~Notes~@Remark@ | ~Contents~@Contents@

@Edit
$^#The Edit command#
   The #edit# command opens the file "#filename#" for editing
in the FAR built-in ~editor~@:Editor@.

      #edit:filename#

   If the file "#filename#" does not exist, it will be created.
   If the newly created file is not changed before leaving the editor, it will
be deleted (same behaviour as #Shift-F4#).

   When opening a file, you can go directly to a given position. To do this, specify the row and, optionally, the column.
   The square brackets are mandatory!

      #edit:[line] filename#

      #edit:[line,column] filename#

   If the filename contains square brackets (for example: "[1].txt"), then for
the correct opening of the file in the editor you must provide at least one delimiter
(e.g. a space) before the filename, or enclose it in quotation marks:

   edit: [1].txt
   edit:"[1].txt"


   See also: ~view~@View@ | ~Output Redirection~@Direction@ | ~Notes~@Remark@ | ~Contents~@Contents@

@Goto
$^#The Goto command#
   The #goto# command jumps to a file or a folder. The path can be
   specified in two ways:

   1. Directly as a parameter of the command

      #goto:path#

   2. The path is taken from the file "#filename#"

      #goto: <filename#

   If the parameter "#path#" specifies a folder and is terminated with
a backslash ('#\#'), the plugin jumps to the specified folder. If the
path to the folder is not terminated with a backslash, the cursor on the
panels is positioned to the specified folder.

   At most 1299 bytes are read from the file "#filename#" to specify
the path to a directory or file.

   When panels are turned off, the cursor is not positioned on the requested object,
only the switching to the required folder occurs.


   See also: ~whereis~@WhereIs@ | ~Notes~@Remark@ | ~Contents~@Contents@

@Link
$ #The Link command#

   The #link# command creates ~links~@:HardSymLink@ to files and folders.
It also allows to mount local disks on file system.


   #link:#[#/msg#] [#/n#] [#/s#] #source destination#

   Depending on the type of source are those types of links:

     #file#   : #hard link# is created
     #folder# : #junction# is created
     #drive#  : drive is mounted (#volume mount point# is created)
              "drive" should be a sequence "#drive_letter:\#", e.g. "#C:\#"

   Switch #/msg# turns on the output of error messages

   Switch #/n# disables automatic update of panels after creation of link

   Switch #/s# allows to make symbolic links (#symlinks#).
   It's possible to create a file symlink (instead of a hardlink)
or a folder symlink (instead of folder junction).
   The switch is relevant to Windows Vista or higher.
Ignored when mounting drives.

   Mounted drives (or volume mount points) is a Windows 2000/XP feature,
that allows to display specified disks as folders. Example:

   #link: E:\ C:\cdrom#

    After this command the folder C:\cdrom will display the contents of drive E:


   See also: ~Remarks~@Remark@ | ~Contents~@Contents@

@WhereIs
$ #The WhereIs command#
   The #whereis# command locates the given object and jumps to it if the search was
successful.

   #whereis:object#

   Второй способ - имя объекта поиска берётся из заданного файла "#имяфайла#"

      #whereis: <имяфайла#

   The search is performed in the following order:

   1. Current folder
   2. The directory pointed to by the environment variable %FARHOME%
   3. Folders in the system environment variable #PATH#
   4. Windows 95: Windows' system folder (SYSTEM)
      Windows NT: 32 bit Windows' system folder (SYSTEM32)
   5. Windows NT: 16 bit Windows' system folder (SYSTEM)
   6. Windows folder.
   7. Contents of the registry key:
      #HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\App Paths#
   8. Contents of the registry key:
      #HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths#

   When panels are turned off, the cursor is not positioned on the requested object,
only the switching to the required folder occurs.


   See also: ~goto~@Goto@ | ~Notes~@Remark@ | ~Contents~@Contents@

@Macro
$ #The Macro command#
   The #macro# command loads macros from the registry or saves macros in the
registry. Also it can post the key sequence to FAR Manager as if they were
typed from the keyboard.

   1. Load macros from the registry:

      #macro:load#

   2. Save macros to the registry:

      #macro:save#

   3. Post a key sequence:

      #macro:post sequence#

      "sequence" is a sequence of key names as they are stored in
      the registry by FAR Manager. For example:

      macro:post F4 F12 0 Tab F4 F12 0

      The sequence is executed only after return the FAR Manager receives control.

   4. Check macrosequence syntax

      #macro:check sequence#

      In case of error in the "sequence" you receive a message
      indicating the error type and its position in the sequence.

   Команды #post# и #check# так же могут брать последовательность из #имяфайла#:

      #macro:post <имяфайла#
      #macro:check <имяфайла#

   Command #check# is only available in Unicode-version (in FAR 2.x)


   See also: ~Macro~@:KeyMacro@, ~Notes~@Remark@ | ~Contents~@Contents@

@Direction
$ #Output Redirection#
   The plugin can redirect the output of the specified #"<command"# or #"<<command"#.

    #command# - #[#stream#][#mode#][#|path|#]#command#.

    #stream# - controls which output stream(s) to redirect.
             #1# - redirect only standard output stream #stdout#.
             #2# - redirect only standard output stream #stderr#.
             #*# - redirect #stderr# and #stdout# as one stream.
             #?# - redirect #stderr# and #stdout# as different streams.
                 For commands ~view~@View@ and ~edit~@Edit@ the streams will be opened
                 in separate windows. For other commands same behavior as #*#.
             Default value of this parameter can be defined in ~config~@Config@.

    #mode#   - controls direct console output (not via standard streams)
             #># - ignore the console output of the program
                 and display only message about its execution.
             #<# - save console output and make it available
                 for viewing with #Ctrl-O#.
             #+# - same as #<#, but displays on the screen redirected output
                 of the program along with console output.
             Default value of this parameter can be defined in ~config~@Config@.

    #|path|# - command can be executed in the folder different from the
             current one. To do this specify the path (enclosed in pipes '#|#')
             For example: #edit:<|%TEMP%|dir#

   Program output can be opened in viewer: #~view~@View@:<command#
     or in editor:                         #~edit~@Edit@:<command#
     or can be placed into clipboard:      #~clip~@Clip@:<command#
     or saved to a user-defined file:      #~run~@Run@:filename<command#


  #Notes:#

   #1#. The entire string after the symbol '#<#' and optional modifiers
is sent to the command processor (%COMSPEC%)

   #2#. Program output is placed in a temporary file, which is deleted automatically when FAR Manager
doesn't need it.

   #3#. Some programs do not use standard output stream(s), but
print directly to the console. To store console output
and make it available for viewing with #Ctrl-O#
use modifiers '#<#' and '#+#'. To ignore it - use '#>#'
      You can change default behavior in the ~configuration~@Config@.

   #4#. If the #stream# parameter equals #1# or #2# then the start of the
command text must be separated from it by some symbol.


  #Examples:#

   Execute the command "#command#" and redirect its output to the editor:
     #edit:<command#

   Possible cases with the parameter #stream#=#1#:
     #edit:<1 command#
     #edit:<1"command"#
     #edit:<1+command#
     #edit:<1|%TEMP%|command#


   See also: ~Notes~@Remark@ | ~Contents~@Contents@

@TheSameFolder
$^#Same Folder
   To set the current folder of the passive panel to the same as
in the active one, choose the item "#Same Directory#" in the ~plugins menu~@:PluginCommands@
or in the ~drives menu~@:DriveDlg@.


   See also: ~Configuration~@Config@ | ~Contents~@Contents@

@Remark
$^#Notes#

   1. It is possible to enclose parameters #filename#,
      #path# and #command# in quotes.

   2. You can use environment variables.

   3. If you make a syntax error, the help will pop up.

   4. You can use console aliases as #command#
      (Console aliases - macros defined by command DOSKEY)

   5. Before each command it's allowed to additionally specify the prefix #far:#

      #command:#[#options#] #object#
      #far:command# [#options#] #object#

      Both notation forms are equivalent.


   See also: ~Contents~@Contents@

@Config
$^#Configuring FAR Commands#

 #Add "Same Folder"#            Adds the ~Same Folder~@TheSameFolder@ command
 #to the Plugins menu#          to the ~Plugins menu~@:PluginCommands@.

 #Add "Same Folder"#            Adds the ~Same Folder~@TheSameFolder@ command
 #to the Disks menu#            to the ~Disks menu~@:DriveDlg@.

 #External commands screen output# Control program screen ~output~@Direction@:

   #Hide external command#       Hides program output. Only a message
   #output#                      with the size of intercepted output
                               will be displayed. Same as using #<>#
                               instead of #<#.

   #Keep external command#       Saves the text output by programs
   #output#                      directly to the console for viewing
                               by #Ctrl-O#.
                               Same as using #<<# instead of #<#.

   #Duplicate intercepted#       Saves for viewing by #Ctrl-O# both the
   #output to screen#            direct console output and intercepted
                               output.
                               Same as using #<+# instead of #<#.


 #Intercepting output#           Controlling of program ~output~@Direction@
                               interception:

   #Intercept both#              Intercept standard output stream
   #stdout and stderr#           #stdout# and standard error stream
                               #stderr# as one stream.
                               Same as using #<*# instead of #<#.


   #Intercept stdout only#       Intercept only #stdout#.
   #(Standard output stream)#    Same as using #<1# instead of #<#.

   #Intercept stderr only#       Intercept only #stderr#.
   #(Standard errors stream)#    Same as using #<2# instead of #<#.


   #Intercept stdout and #       Intercept stdout and #stderr#
   #stderr separately#           separately. It has sense only in
                               commands #far:view <# and #far:edit <#.
                               In other cases same as #<*#.
                               Can't be used with #<+#.
                               Same as using  #<?# instead of #<#.

 #View/edit empty files#         With this options off, zero sized
                               files will not be opened for viewing
                               or editing.

 #Edit new files#                Allows to open the editor with non
                               existing files.

 #The size of read data#         ^<wrap>Позволяет задавать максимальный размер
считываемых из файла данных в командах ~clip~@clip@, ~goto~@goto@, ~whereis~@whereis@,
~macro:post~@macro@ ╨╕ ~macro:check~@macro@.
                               По умолчанию - 1 Mb.
                               Максимальное значение - 4Gb.

   See also: ~Contents~@Contents@