2002-09-02 23:50:08 +00:00
\C{usage} MakeNSIS Usage
2002-09-02 18:05:40 +00:00
2002-10-28 16:32:30 +00:00
NSIS installers are generated by using the 'MakeNSIS' program to compile a NSIS script (.NSI) into an installer executable.
2003-02-12 18:04:17 +00:00
The NSIS development kit installer sets up your computer so that you can compile a .nsi file by simply right-clicking on it in explorer, and selecting 'compile'.
2002-10-28 16:32:30 +00:00
If you want to use MakeNSIS on the command line, the syntax of the makensis command is:
2002-09-02 18:05:40 +00:00
2004-11-19 14:38:33 +00:00
\c makensis [option | script.nsi | - [...]]
\H{usagereference} Options
2002-09-02 18:05:40 +00:00
\b /LICENSE displays a keen license page.
\b The /V switch followed by a number between 0 and 4 will set the verbosity of output accordingly. 0=no output, 1=errors only, 2=warnings and errors, 3=info, warnings, and errors, 4=all output.
\b The /O switch followed by a filename tells the compiler to print its log to that file (instead of the screen)
2004-11-19 14:38:33 +00:00
\b /PAUSE makes makensis pause before quitting, which is useful when executing directly from Windows.
2002-09-02 18:05:40 +00:00
2004-11-19 14:38:33 +00:00
\b /NOCONFIG disables inclusion of <path to makensis.exe>\\nsisconf.nsh. Without this parameter, installer defaults are set from nsisconf.nsh.
2002-09-02 18:05:40 +00:00
\b /CMDHELP prints basic usage information for command (if specified), or all commands (if command is not specified).
2004-11-19 14:38:33 +00:00
\b /HDRINFO prints out information on what options were used to compile makensis was compiled with.
2002-09-02 18:05:40 +00:00
2005-03-29 20:57:16 +00:00
\b /NOCD disables the current directory change to that of the .nsi file
2002-09-02 18:05:40 +00:00
\b Using the /D switch one or more times will add to symbols to the globally defined list (See !define).
\b Using the /X switch one or more times will execute the code you specify following it. Example: "/XAutoCloseWindow false"
2004-11-19 14:38:33 +00:00
\b Specifying a dash (-) for the script name will tell makensis to use the standard input as a source.
\H{usagenotes} Notes
\b Parameters are processed by order. \c{makensis /Ddef script.nsi} is not the same as \c{makensis script.nsi /Ddef}.
2002-09-02 18:05:40 +00:00
2004-10-10 18:41:43 +00:00
\b If multiple scripts are specified, they are treated as one concatenated script.
2004-11-19 14:38:33 +00:00
\H{usageexamples} Examples
2004-10-10 18:41:43 +00:00
Basic usage:
\c makensis.exe myscript.nsi
Quiet mode:
\c makensis.exe /V1 myscript.nsi
Force compressor:
\c makensis.exe /X"SetCompressor /FINAL lzma" myscript.nsi
Change script behavior:
\c makensis.exe /DUSE_UPX /DVERSION=1.337 /DNO_IMAGES myscript.nsi
2004-11-19 14:38:33 +00:00
Parameters order:
\c makensis /XSection sectioncontents.nsi /XSectionEnd