home *** CD-ROM | disk | FTP | other *** search
/ Maximum CD 2010 January / maximum-cd-2010-01.iso / DiscContents / npp.5.5.1.Installer.exe / plugins / doc / NppExec.txt < prev    next >
Encoding:
Text File  |  2009-08-31  |  14.7 KB  |  324 lines
  1.  
  2.  ****************************************************************************
  3.  * NppExec plugin ver. 0.3.2 for Notepad++ 5.1 (and above)
  4.  * by DV, December 2006 - September 2009
  5.  * Co-developers: Nicolas Babled & Geert Vancompernolle (since July 2007)
  6.  ****************************************************************************
  7.  *
  8.  * Possibilities:
  9.  *   1) Run multiple commands from the "Execute..." dialog
  10.  *   2) Run stand-alone command from the Console Dlg
  11.  *   3) Separate console for each NppExec.dll (e.g. NppExec1.dll, NppExec2.dll)
  12.  *   4) Additional commands:
  13.  *        cls - clear Console screen
  14.  *        cd - shows current path
  15.  *        cd <path> - changes current directory (absolute or relative)
  16.  *        cd <drive:\path> - changes current drive and directory
  17.  *        dir - lists subdirs and files
  18.  *        dir <mask> - lists subdirs and files matched the mask
  19.  *        dir <path\mask> - lists subdirs and files matched the mask
  20.  *        echo <text> - prints a text in the Console 
  21.  *        set - shows all user's variables
  22.  *        set <var> - shows the value of user's variable <var>
  23.  *        set <var> = <value> - sets the value of user's variable <var>
  24.  *        unset <var> - removes user's variable <var>
  25.  *        env_set <var> - shows the value of environment variable <var>
  26.  *        env_set <var> = <value> - sets the value of environment variable <var>
  27.  *        env_unset <var> - removes/restores the environment variable <var>
  28.  *        inputbox "message" - shows InputBox, sets $(INPUT)
  29.  *        inputbox "message" : initial_value - InputBox, sets $(INPUT)
  30.  *        con_loadfrom <file> - loads a file's content to the Console
  31.  *        con_load <file> - see "con_loadfrom"
  32.  *        con_saveto <file> - saves the Console's content to a file
  33.  *        con_save - see "con_saveto"
  34.  *        sel_loadfrom <file> - replace current selection with a file's content
  35.  *        sel_load <file> - see "sel_loadfrom"
  36.  *        sel_saveto <file> - save the selected text to a file
  37.  *        sel_saveto <file> : <encoding> - save the selected text to a file
  38.  *        sel_save <file> : <encoding> - see "sel_saveto"
  39.  *        sel_settext <text> - replace current selection with the text specified
  40.  *        sel_settext+ <text> - replace current selection with the text specified
  41.  *        npp_exec <script> - execute commands from specified script
  42.  *        npp_exec <file> - execute commands from specified file           (*)
  43.  *        npp_close - close current file in Notepad++
  44.  *        npp_close <file> - close specified file opened in Notepad++      (*)
  45.  *        npp_console <on/off/keep> - show/hide the Console window
  46.  *        npp_console <1/0/?> - show/hide the Console window
  47.  *        npp_open <file> - open a file in Notepad++
  48.  *        npp_open <mask> - open files matched the mask
  49.  *        npp_open <path\mask> - open files matched the mask
  50.  *        npp_run <command> - run external process/command
  51.  *        npp_save - save current file in Notepad++
  52.  *        npp_save <file> - save a file in Notepad++ (if it's opened)      (*)
  53.  *        npp_saveall - save all modified files
  54.  *        npp_switch <file> - switch to specified opened file              (*)
  55.  *        npe_cmdalias - show all command aliases
  56.  *        npe_cmdalias <alias> - shows the value of command alias
  57.  *        npe_cmdalias <alias> = - removes the command alias
  58.  *        npe_cmdalias <alias> = <command> - sets the command alias
  59.  *        npe_console <options> - set/modify Console options/mode
  60.  *        npe_debuglog <on/off> - enable/disable Debug Log
  61.  *        (*) these commands work with a partial file path/name also
  62.  *            i.e.  npp_save c:\dir\f.txt  is the same as  npp_save f.txt
  63.  *   5) Additional console commands (Console Dlg only):
  64.  *        help       - show available commands
  65.  *        ver        - show plugin's version
  66.  *        CTRL+C     - terminate current child process
  67.  *        CTRL+BREAK - terminate current child process
  68.  *   6) All Notepad++ environment variables are supported:
  69.  *        $(FULL_CURRENT_PATH)  : E:\my Web\main\welcome.html 
  70.  *        $(CURRENT_DIRECTORY)  : E:\my Web\main
  71.  *        $(FILE_NAME)          : welcome.html 
  72.  *        $(NAME_PART)          : welcome 
  73.  *        $(EXT_PART)           : .html
  74.  *        $(NPP_DIRECTORY)      : the full path of notepad++'s directory
  75.  *        $(CURRENT_WORD)       : word(s) you selected in Notepad++
  76.  *        $(CURRENT_LINE)       : current line number
  77.  *        $(CURRENT_COLUMN)     : current column number
  78.  *   7) Additional environment variables:
  79.  *        $(#0)                 : C:\Program Files\Notepad++\notepad++.exe
  80.  *        $(#N), N=1,2,3...     : full path of the Nth opened document
  81.  *        $(LEFT_VIEW_FILE)     : current file path-name in primary (left) view
  82.  *        $(RIGHT_VIEW_FILE)    : current file path-name in second (right) view
  83.  *        $(PLUGINS_CONFIG_DIR) : full path of the plugins configuration directory
  84.  *        $(CWD)                : current working directory of NppExec (use "cd" to change it)
  85.  *        $(ARGC)               : number of arguments passed to the NPP_EXEC command
  86.  *        $(ARGV)               : all arguments passed to the NPP_EXEC command after the script name
  87.  *        $(ARGV[0])            : script name - first parameter of the NPP_EXEC command
  88.  *        $(ARGV[N])            : Nth argument (N=1,2,3...)
  89.  *        $(RARGV)              : all arguments in reverse order (except the script name)
  90.  *        $(RARGV[N])           : Nth argument in reverse order (N=1,2,3...)
  91.  *        $(INPUT)              : this value is set by the 'inputbox' command
  92.  *        $(INPUT[N])           : Nth field of the $(INPUT) value (N=1,2,3...)
  93.  *        $(OUTPUT)             : this value can be set by the child process, see npe_console v+
  94.  *        $(OUTPUT1)            : first line in $(OUTPUT)
  95.  *        $(OUTPUTL)            : last line in $(OUTPUT)
  96.  *        $(SYS.<var>)          : system's environment variable, e.g. $(SYS.PATH)
  97.  *
  98.  ****************************************************************************
  99.  
  100.  
  101.  *************
  102.  *  HISTORY  *
  103.  *************
  104.  
  105.  
  106.  v0.3.2 - September 2009
  107.  -----------------------
  108.  + new feature: TAB autocompletes file paths (in the Console)
  109.    (* thanks to ILme for initial implementation)
  110.  + new feature: Shift+Tab (in the Console, the same as TAB but backwards)
  111.  - fixed: 'cd \path', 'dir \path' did not jump to the root of current drive
  112.  - fixed: on-exit script was not executed
  113.  + new command: NPE_CMDALIAS
  114.  + new menu item: Disable command aliases
  115.  + new option in NPE_CONSOLE: q+/q-
  116.  
  117.  
  118.  v0.3.1 - June 2009
  119.  ------------------
  120.  + new command: SEL_LOADFROM
  121.  + new command: SEL_SETTEXT, SEL_SETTEXT+
  122.  + new variable: $(OUTPUT), $(OUTPUTL), $(OUTPUT1), see NPE_CONSOLE V+
  123.  + several small improvements
  124.  
  125.  
  126.  v0.3 final - April 2009
  127.  -----------------------
  128.  * thanks to Greg Webb for the .chm help file (manual)
  129.  + several small fixes
  130.  + new command: NPE_CONSOLE 
  131.  
  132.  
  133.  v0.3 RC1 - January 2009
  134.  -----------------------
  135.  * thanks to John LaCasse for useful suggestions
  136.  + new environment variable: $(CWD)
  137.  + new commands: ENV_SET/ENV_UNSET
  138.  + new menu item: Toggle Console Dialog (Ctrl+~)
  139.  + now NPE_DEBUGLOG reports on Console double-clicked line's Highlight Filter
  140.  + NppExecPluginMsgTester has been re-designed and updated
  141.  + both Unicode and ANSI builds are supported
  142.  + now the "Execute..." dialog is resizable
  143.  + now NppExec supports remapped shortcut keys (requires Notepad++ >= 5.1.4)
  144.  + other improvements
  145.  + now NppExec has the manual (yes!)
  146.  
  147.  
  148.  v0.3 beta1 - November 2008
  149.  --------------------------
  150.  + full Unicode compatibility (for Unicode version of Notepad++)
  151.  + additional functionality
  152.  + improvements in the script engine (architecture re-design)
  153.  + improvements in the warning analyzer (spaces/tabs can be omitted)
  154.  + other improvements and fixes
  155.  + now NppExec gets its configuration directory from Notepad++
  156.  + now you can exit a console process or interrupt current script at any time
  157.  + now both Console Output and Input can be ANSI, OEM or UTF-8
  158.  + now each copy of NppExec.dll has its own Console History
  159.  + new option: Follow $(CURRENT_DIRECTORY)
  160.  + new command: NPP_CONSOLE
  161.  + new environment variable: $(PLUGINS_CONFIG_DIR)
  162.  
  163.  
  164.  v0.2.5 release 2 - September 2008
  165.  ---------------------------------
  166.  - fixed: (potential) bug in CNppExec::DoExecScript()
  167.  - fixed: several (potential) bugs, thanks to Patrick Corwin
  168.  
  169.  
  170.  v0.2.5 - August 2008
  171.  --------------------
  172.  + added: word wrap in the Console dialog (Ctrl+W)
  173.  * changed: Advanced Options dialog - SaveCmdHistory added, 
  174.    RichEdit_MaxTextLength removed
  175.  - fixed: script with spaces in its name was not started using
  176.    associated menu item
  177.  + some improvements
  178.  + new command: NPP_CLOSE
  179.  + new command: INPUTBOX
  180.  * now NppExec uses Rich Edit 2.0 (instead of 1.0) in its Console window
  181.  + added Notepad++'s variables: $(CURRENT_LINE), $(CURRENT_COLUMN)
  182.  + external plugin interface messages:
  183.    NPEM_GETVERDWORD [returns version as DWORD]
  184.    NPEM_GETVERSTR [returns version as string]
  185.    NPEM_GETSTATE [returns state: ready/busy]
  186.    NPEM_PRINT [prints text which can be highlighted by the Highlight Filters]
  187.    NPEM_EXECUTE [executes given commands]
  188.    NPEM_NPPEXEC [executes script/file]
  189.    NPEN_RESULT [as a result of NPEM_EXECUTE or NPEM_NPPEXEC]
  190.  
  191.  
  192.  v0.2.4 - June 2008
  193.  ------------------
  194.  + added: "Replace" tab in the Console Filters dialog
  195.  * improved: the code of the DlgConsoleOutputFilter has been rewritten
  196.  + added: Console text and background colours can be changed
  197.  + new command: SEL_SAVETO - saves the selected text to a file
  198.  - fixed: CON_SAVETO did not work under Windows 9x
  199.  + added: ability to execute specified script when Notepad++ starts/exits
  200.  + added: ability to assign a menu item to specified script
  201.    (then you can assign a shortcut key to this menu item in Notepad++)
  202.  + added: Advanced Options dialog
  203.  + other improvements
  204.  
  205.  
  206.  v0.2 RC3.2 - February 2008
  207.  --------------------------
  208.  - fixed: NPP_RUN (ShellExecute) did not work with several arguments
  209.  
  210.  
  211.  v0.2 RC3.1 - February 2008
  212.  --------------------------
  213.  - fixed: buffer overflow in the Warning Analyzer
  214.  * changed: now NPP_RUN calls ShellExecute() instead of WinExec()
  215.  
  216.  
  217.  v0.2 RC3 - January 2008
  218.  -----------------------
  219.  + search in the Console
  220.  + history in the Console Filters dialog
  221.  + several issues fixed
  222.  + several cosmetic improvements
  223.  
  224.  
  225.  v0.2 RC2 - December 2007
  226.  ------------------------
  227.  + speeding up the console output
  228.  + watching for changes in "npes_saved.txt"
  229.  + TAB-key in the console auto-completes current command
  230.  + several cosmetic improvements
  231.  
  232.  
  233.  v0.2 RC1 - December 2007
  234.  ------------------------
  235.  1. A lot of internal changes/improvements.
  236.  In particular, now all plugin's options are stored, read and written by the
  237.  Options Manager component.
  238.  The Warning Analyzer component, developed by Nicolas Babled, allows to filter
  239.  and recognize different compiler/interpretter error and warning messages - and
  240.  extract useful information from these messages (such as file name and line 
  241.  number).
  242.  The Simple Logger component stores detailed information about last executed
  243.  command (can be usefull for "debugging").
  244.  * The console redirecting engine has been improved.
  245.  * Now the plugin identifies itself by its dll-file name. Each copy of the 
  246.  plugin (each dll-file) stores its options in corresponding ini-file.
  247.  * Now plugin's environment variables (e.g. "$(FILE_NAME)") are available for
  248.  child console process. For example, start "cmd.exe" and type "echo $(#1)".
  249.  * Now system's environment variables are available in a form of "$(SYS.<var>)"
  250.  e.g. "$(SYS.WINDIR)", "$(SYS.TEMP)" etc.
  251.  * Now the NPP_EXEC command can pass arguments to the script. These arguments 
  252.  can be accessed in the script through the following macro-variables:
  253.  $(ARGC), $(ARGV), $(ARGV[n]).
  254.  Example:  npp_exec "script name" param_1 "param 2".
  255.  This example sets the following values for the script:
  256.  $(ARGC) = 3;  $(ARGV) = param_1 "param 2";  $(ARGV[0]) = script name;
  257.  $(ARGV[1]) = param_1;  $(ARGV[2]) = param 2.
  258.  * Each command now have detailed help information. Type "help" or "help help" 
  259.  in the NppExec's Console.
  260.  * Now the console commands history is restored when you restart Notepad++.
  261.  
  262.  2. New menu items:
  263.  Direct Execute Previous - directly executes previous script.
  264.  No internal messages - do not show such messages as "Process started >>>", etc.
  265.  Save all files on execute - saves all files before executing a script.
  266.  Also NppExec's toolbar icon has been added.
  267.  
  268.  3. New dialog:  Console Output Filter -> Highlight.
  269.  This dialog allows you to specify a string mask for compiler/interpretter error 
  270.  and warning messages with such keywords as %FILE%, %ABSFILE% and %LINE%.
  271.  These messages can be highlighted with different colours and allow you to go
  272.  to certain line in certain file when double-clicked in the Console window.
  273.  
  274.  4. New messages:
  275.  NPP_SAVEALL - saves all modified files.
  276.  CON_LOADFROM - loads a file's content to the Console.
  277.  CON_SAVETO - saves the Console's content to a file.
  278.  ECHO - prints a text in the Console (supports internal env. variables)
  279.  SET - sets the value of user's variable
  280.  UNSET - removes user's variable
  281.  
  282.  
  283.  v0.2 beta4 - July 2007
  284.  ----------------------
  285.  - fixed: buffer size was not checked before calling OemToChar() 
  286.  - fixed/added: '\b' and '\r' handling
  287.  + a lot of changes in plugin's internals (basic cpp-classes and NppExecEngine)
  288.  + new command: cd, cd <path>, cd <drive:\path>
  289.  + new command: dir, dir <mask>, dir <path\mask>
  290.  + new feature: npp_open <mask>, npp_open <path\mask>
  291.  + new environment variables: $(LEFT_VIEW_FILE) and $(RIGHT_VIEW_FILE)
  292.  * thanks to all who wait for this version
  293.  
  294.  
  295.  v0.2 beta3 - April 2007
  296.  -----------------------
  297.  - fixed: Delete button (Script name dialog) was not enabled sometimes
  298.  + Menu: Show Console Dialog
  299.  + Console Output Filter: Exclude all empty lines
  300.  + Comment delimiter can be user-defined, // in :// is no more comment
  301.  
  302.  
  303.  v0.2 beta2 - March 2007
  304.  -----------------------
  305.  + Menu: Console Commands History.
  306.      When enabled, previous commands can be scrolled by pressing 
  307.      arrow keys Up and Down.
  308.  + Menu: Console Output Filter.
  309.      When enabled, output messages from running console process
  310.      can be filtered (i.e. particular lines can be excluded)
  311.  - ConsoleDlg: Ctrl+A is unlocked
  312.  - ConsoleDlg: Quotes "" are no more added automatically for paths
  313.      with spaces (because of a bug with executables w/o extension
  314.      such as "cmd /c calc.exe")
  315.  - Several internal fixes
  316.  - Several additional internal fixes :-)
  317.  * Thanks to Jim Granville for his suggestions
  318.       
  319.  
  320.  v0.1 - March 2007
  321.  -----------------
  322.  * initial version
  323.  
  324.