From b685eff548a96d2061b3cc521e0f85be577f3a33 Mon Sep 17 00:00:00 2001 From: flizebogen Date: Sun, 9 Feb 2003 10:35:04 +0000 Subject: [PATCH] basic addtions to the docs git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@2134 212acab6-be3b-0410-9dea-997c60f758d6 --- Docs/src/attributes.but | 4 ++-- Docs/src/file.but | 9 +++++++-- Docs/src/flowcontrol.but | 2 +- Docs/src/generalpurpose.but | 13 ++++++++++--- Docs/src/misc.but | 2 +- Docs/src/var.but | 17 ++++++++++++++--- 6 files changed, 35 insertions(+), 12 deletions(-) diff --git a/Docs/src/attributes.but b/Docs/src/attributes.but index e882a14e..ca74a60c 100644 --- a/Docs/src/attributes.but +++ b/Docs/src/attributes.but @@ -190,7 +190,7 @@ Sets the name of the installer. The name is usually simply the product name such \c path_to_icon.ico -Sets the icon of the installer. Every icon in the icon file will be included in the installer. +Sets the icon of the installer. Every icon in the icon file will be included in the installer. Note that if you use different icons for installer and uninstaller the file size and structure of the icons has to match otherwise the built of the installer will fail. \S2{aoutfile} OutFile @@ -286,4 +286,4 @@ Sets whether or not the installer's icon is being displayed. \c on|\\off\\ -Sets whether or not an XP manifest will be added to the installer. This affects the uninstaller too. +Sets whether or not an XP manifest will be added to the installer. This affects the uninstaller too. \ No newline at end of file diff --git a/Docs/src/file.but b/Docs/src/file.but index 5b9d274d..1f4f27b6 100644 --- a/Docs/src/file.but +++ b/Docs/src/file.but @@ -40,7 +40,12 @@ Writes a string to a file opened with FileOpen. If an error occurs writing, the \c handle string -Writes the integer interpretation of 'string' to a file opened with FileOpen. If an error occurs writing, the error flag will be set. Note that the low byte of the integer is used, i.e. writing 256 is the same as writing 0, etc. +Writes the integer interpretation of 'string' to a file opened with FileOpen. Of course you can enter the integer value directly. The following code writes an "Carriage Return / Line Feed" - Enter to the file. + +\c FileWriteByte file_handle "13" +\c FileWriteByte file_handle "10" + +You can If an error occurs writing, the error flag will be set. Note that the low byte of the integer is used, i.e. writing 256 is the same as writing 0, etc. \S2{FindClose} FindClose @@ -58,4 +63,4 @@ Performs a search for 'filespec', placing the first file found in filename_outpu \c handle user_var(filename_output) -Continues a search began with FindFirst. handle should be the handle_output_variable returned by FindFirst. If the search is completed (there are no more files), filename_output is set to empty, and the error flag is set. Note that the filename output is without path. +Continues a search began with FindFirst. handle should be the handle_output_variable returned by FindFirst. If the search is completed (there are no more files), filename_output is set to empty, and the error flag is set. Note that the filename output is without path. \ No newline at end of file diff --git a/Docs/src/flowcontrol.but b/Docs/src/flowcontrol.but index f61e2902..7ac71ba8 100644 --- a/Docs/src/flowcontrol.but +++ b/Docs/src/flowcontrol.but @@ -42,7 +42,7 @@ If label is specified, goto the label 'label_to_jump_to:'. If +offset or -offset is specified, jump is relative by offset instructions. Goto +1 goes to the next instruction, Goto -1 goes to the previous instruction, etc. -If a user variable is specified, jumps to absolute address (generally you will want to get this value from a function like GetLabelAddress. I Compiler flag commands and SectionIn aren't instructions so jumping over them has no effect. +If a user variable is specified, jumps to absolute address (generally you will want to get this value from a function like GetLabelAddress. Compiler flag commands and SectionIn aren't instructions so jumping over them has no effect. \S2{iferrors} IfErrors diff --git a/Docs/src/generalpurpose.but b/Docs/src/generalpurpose.but index a6f7dd51..1f4b5286 100644 --- a/Docs/src/generalpurpose.but +++ b/Docs/src/generalpurpose.but @@ -16,7 +16,7 @@ Copies files from the source to the destination on the installing system. Useful \c path_to_create -Creates (recursively if necessary) the specified directory. +Creates (recursively if necessary) the specified directory. The error flag is \\not\\ set if the directory couldn't be created. \S2{createshortcut} CreateShortCut @@ -33,7 +33,14 @@ The error flag is set if the shortcut cannot be created (i.e. the path does not \c filename user_var(high dword output) user_var(low dword output) -Gets the version information from the DLL in "filename". Sets the user output variables with the high and low dwords of version information on success; on failure the outputs are empty and the error flag is set. +Gets the version information from the DLL in "filename". Sets the user output variables with the high and low dwords of version information on success; on failure the outputs are empty and the error flag is set. The following example reads the DLLVersion and makes it readable. + +\c GetDllVersion "$EXEDIR\ScummVM.exe" $R0 $R1 +\c IntOp $R2 $R0 / 0x00010000 +\c IntOp $R3 $R0 & 0x0000FFFF +\c IntOp $R4 $R1 / 0x00010000 +\c IntOp $R5 $R1 & 0x0000FFFF +\c StrCpy $0 "$R2.$R3.$R4.$R5" \S2{getdllversionlocal} GetDLLVersionLocal @@ -103,4 +110,4 @@ Loads the specified DLL and calls DllRegisterServer (or entrypoint_name if speci \c dllfile -Loads the specified DLL and calls DllUnregisterServer. The error flag is set if an error occurs (i.e. it can't load the DLL, initialize OLE, find the entry point, or the function returned anything other than ERROR_SUCCESS (=0)). +Loads the specified DLL and calls DllUnregisterServer. The error flag is set if an error occurs (i.e. it can't load the DLL, initialize OLE, find the entry point, or the function returned anything other than ERROR_SUCCESS (=0)). \ No newline at end of file diff --git a/Docs/src/misc.but b/Docs/src/misc.but index e8a7f171..2b3d03db 100644 --- a/Docs/src/misc.but +++ b/Docs/src/misc.but @@ -8,7 +8,7 @@ Initializes the plugins dir ($PLUGINSDIR, see \k{var2}) if not initialized alrea \c \\current\\|all -Sets the context of $SMPROGRAMS and other shell folders. If set to 'current' (the default), the current user's shell folders are used. If set to 'all', the 'all users' shell folder is used. The all users folder may not be supported on all OSes. If the all users folder is not found, the current user folder will be used. +Sets the context of $SMPROGRAMS and other shell folders. If set to 'current' (the default), the current user's shell folders are used. If set to 'all', the 'all users' shell folder is used. The all users folder may not be supported on all OSes. If the all users folder is not found, the current user folder will be used. Please take into consideration that a "normal user" has no rights to write in the all users area. Only admins have full access rights to the all users area. You can check this by using the isadmin.dll Plugin. You can download it in the \W{http://nsis.sourceforge.net/archive/}{NSIS Archiv}. \S2{sleep} Sleep diff --git a/Docs/src/var.but b/Docs/src/var.but index a71805a2..8334c782 100644 --- a/Docs/src/var.but +++ b/Docs/src/var.but @@ -24,6 +24,8 @@ The command line of the installer. The format of the command line can be one of \b For parsing out the PARAMETER portion, see GetParameters on the utility functions page. It's worth noting that if /D= is specified on the command line (to override the install directory), it won't be in $CMDLINE. +If you want to deal with parameters you should take a look at the GetParameters Function (See \k{getparameters}). + \e{$LANGUAGE} The identifier of the language that is currently used. For example, English is 1033. You can change this variable in .onInit. @@ -44,7 +46,7 @@ The location of the installer executable. (technically you can modify this varia \e{$\{NSISDIR\}} -A symbol that contains the path where NSIS is installed. +A symbol that contains the path where NSIS is installed. Detected at compile time. Useful if you want to call resources that are in NSIS directory e.g. Icons, UI's... \e{$WINDIR} @@ -72,7 +74,7 @@ The start menu programs / startup folder. The context of this variable (All User \e{$QUICKLAUNCH} -The quick launch folder for IE4 active desktop and above. If quick launch is not available, simply returns the same as $TEMP. The context of this variable (All Users or Current user) depends on the SetShellVarContext setting. The default is the current user. +The quick launch folder for IE4 active desktop and above. If quick launch is not available, simply returns the same as $TEMP. It seems that there is no Quicklaunch for all users. Therefore current user is always used. \e{$HWNDPARENT} @@ -98,5 +100,14 @@ Use to represent a newline (\\n). \e{$\{SYMBOL\}} -Where SYMBOL is the name of something globally defined, this will be replaced with the value of that symbol. If the symbol is not defined, no replace occurs (i.e. if $\{POOP\} is encountered, and POOP is not defined, $\{POOP\} is output). +Where SYMBOL is the name of something globally defined, this will be replaced with the value of that symbol. The order of calling Symbols in the script is important. +\c Name "Test Program ${VERSION}" +\c !define VERSION "V.1.0" + +This code will set the name of the installer to "Test Program ${VERSION}". The Same happens if the Symbol has not been defined. + +\c !define VERSION "V.1.0" +\c Name "Test Program ${VERSION}" + +This code sets the name of the installer to "Test Program V.1.0"