- NSIS Discussion
- typos in the docs ...
Archive: typos in the docs ...
Comm@nder21
29th January 2004 19:09 UTC
typos in the docs ...
hello nsis-developer-team!
i've found some bugs in the nsis-documentations:
4.5.3 Callbacks
[...]
Examples:
[...]
Function skipLicense
MessageBox MB_YES "Do you want to skip the license page?" IDNO no
Abort
no:
FunctionEnd
Function stayInLicense
MessageBox MB_YES "Do you want to stay in the license page?" IDNO no
Abort
no:
FunctionEnd
[...]
[...]
in the example-code there's the flag 'MB_YES' set for messageboxes. that must be 'MB_YESNO' instead.
5.4.3 !ifndef
gflag [bcheck [gflag [...]]]
The opposite of !ifmacrodef. The lines will be compiled when the gflag has not been defined.
i think this is the opposite of '!ifdef', not of '!ifmacrodef'.
5.4.6 !else
[...]
This command is the opposite of !ifdef [...]
i'd say: it can be the opposite of "!ifdef, !ifndef, !ifmacrodef, !ifmacrondef".
hmm, that's it for now, i'll post more bugs in here, whenever i found some.
Joost Verburg
29th January 2004 19:32 UTC
Thanks, fixed.
Comm@nder21
2nd February 2004 13:59 UTC
a typo:
4.9.3.2 CopyFiles
[...]You might see a Windows status window of the copy operation takes a lot of time (to disable this, use /SILENT).[...]
missing "if it" between "... copy operation" and "takes a lot ...". or is my english to bad? ;)
Joost Verburg
2nd February 2004 15:44 UTC
Fixed again.
Comm@nder21
2nd February 2004 18:49 UTC
you fixed this one and implemented another :D:
You might see a Windows status window of the copy operation if the operation takes takes a lot of time (to disable this, use /SILENT).
Joost Verburg
2nd February 2004 19:01 UTC
Heh :) Fixed.
Comm@nder21
3rd February 2004 20:50 UTC
another typo:
4.9.3.2 CopyFiles
[...]The last parameter can be used to specify the size of the files that will be copies (in kilobytes), [...]
must be "copied"
:D
Joost Verburg
3rd February 2004 22:20 UTC
Someone was definately not really awake when writing that line :D Fixed.
Comm@nder21
9th February 2004 14:18 UTC
found some more.
usually default-settings are shown by underline and bold.
missing at the following topics:
- 4.9.14.10 SetAutoClose
- 4.9.14.12 SetDetailsView
- 4.9.14.13 SetDetailsPrint
- 4.9.14.15 SetSilent
Joost Verburg
9th February 2004 15:38 UTC
That's because they are instructions, no attributes. There is no default.
AutoCloseWindow etc. do have a default.
Comm@nder21
10th February 2004 17:42 UTC
ok, understood
Comm@nder21
20th February 2004 17:14 UTC
some more:
C.5 Calling an external DLL using the System.dll plugin
[...]
... and head on over to the Contrib/System directory and read the doco there.
[...]
l - long & large integer (know as int64)
[...]
the bold words are wrong, i think.
must be doc
s and know
n.
Joost Verburg
20th February 2004 17:32 UTC
Thanks, fixed.
Comm@nder21
8th September 2004 18:57 UTC
to warm up this thread :) ...
4.10.3 RTL Languages
... current langaugeis RTL or not ...
zimsms
8th September 2004 19:35 UTC
Wow.....someone actually reads the documentation.....:D
BTW:
4.9.3.2 CopyFiles
[...]You might see a Windows status window of the copy operation takes a lot of time (to disable this, use /SILENT).[...]
The only problem with the original was a single typo. 'of' should have read 'if'. Though long and drawn out, the one you changed it to makes sense as well.
Cheers,
ZIMSMS
kichik
9th September 2004 18:19 UTC
Thanks, fixed.
Comm@nder21
10th September 2004 14:05 UTC
aaah, zimsms, that was the other one i saw one time, but forgot to post :)
and another one:
5.1.8 !packhdr
This option makes the compiler an external EXE packer (such as Petite or UPX) to compress the executable header.
i think, between the two bold words, there's a word missing, like "use":
"This option makes the compiler
use and external ..."
unlogical:
4.9.4.11 IfRebootFlag
[jump_if_set] [jump_if_not_set]
Atleast one parameter is required. ...
i'd remove the [] for "jump_if_set", because it is always required to be set.
same for "4.9.4.12 IfSilent"
see "4.9.4.9 IfErrors" for 'correct' example :).
and wtf does this mean????
4.9.5.7 FileWriteByte
You can If an error occurs writing, the error flag will be set.
kichik
10th September 2004 14:54 UTC
fixed.
Comm@nder21
20th March 2005 21:51 UTC
time to raise up this topic again:
E.1.1.4 Utilities and Plug-ins
StartMenu: Added support for SetCtlColors (RFE #711900
missing )
4.6.1.5 SectionGroup
[/e] Caption [section_group_name index output]
should be index
_output, to make clear, that this is ONE parameter.
also in the following explanation:
If section index output is specified
that's it for now :)
kichik
22nd March 2005 18:53 UTC
The missing parenthesis was fixed while 2.06 was being released. I didn't want to recompile the whole thing, so I've left it to the next version.
index output -> index_output. done.
Jnuw
23rd March 2005 03:04 UTC
Didn't want to tie up a new thread for this, but the special builds web page still says:
"...These builds are only compatible with NSIS 2.05..."
But it looks like the downloadable builds are 2.06, thanks.
Afrow UK
23rd March 2005 09:22 UTC
Just noticed a small typo under CallInstDLL in the example: anoter
-Stu
kichik
24th March 2005 15:21 UTC
Thanks, both fixed.
deguix
28th March 2005 09:47 UTC
There is a typo under "4.11.2 Disabling Plugin Unloading" example:
dll:function /NOUNLOAD "param"
Forgot a ":".
kichik
29th March 2005 18:09 UTC
Thanks, fixed.
Afrow UK
29th March 2005 20:06 UTC
Under 1.1 (about NSIS)
unsuccesful should be spelt unsuccessful (it is in native English anyway).
In the second paragraph support should have an s on the end.
Under 1.2 under "Custom dialogs and interfaces" in the last sentence, a should be your.
Under "Easy and human readable file formats" human would make more sense as humanly.
Under 2.1 in the last paragraph and last sentence, have should be has.
Under 2.3.6, in the second code example for macro's, a !macroend is missing.
Under 2.4, in the third paragraph at the start of the thrid sentence, error should be errors.
Under 2.6 in the last paragraph, there's a repetition of in after plug-in.
Under 3.1, /NOCD, disabled I think should be disables.
That's it for now. I will read up more later :)
This is the first time I've actually read the NSIS documentation from the start!
-Stu
Afrow UK
29th March 2005 20:37 UTC
Under 4.1, just before the Plug-ins heading, 'you' is missing from the sentence.
Under the Long commands heading, 'to' should be after 'concatenated'.
Under 4.2.3, $EXEDIR, the full stop needs to be moved to the end.
$WINDIR, $SYSDIR and $TEMP are missing full stops.
-Stu
kichik
29th March 2005 20:59 UTC
Thanks, all fixed but:
Under 2.1 in the last paragraph and last sentence, have should be has.
Are you sure about this one? The sentence already has one "has".
For more than a couple of changes, it'd be nice if you edit the .but files and submit a patch.
Afrow UK
29th March 2005 21:34 UTC
Yes it doesn't make sense with 'have'. You could only use have there if it were past tense (ie "it would still have") but in this case it isn't so it doesn't quite make sense.
Everything else is perfect though. Whoever wrote the docs would all get A grades in English class for writing :)
For patches: Roger, will do. I will read the rest of the documents tomorrow.
-Stu
kichik
29th March 2005 21:46 UTC
I am pretty sure I remember my English teacher saying you can't have more than one "has" in a sentence. I'll to check it a bit more thoroughly over the weekend.
Afrow UK
29th March 2005 22:45 UTC
"The dog has a bone, and the dog has a phone". I don't see anything wrong with that (apart from having a phone lol!)
If we were to put 'have' in there, we'd have to change it to:
"The dog has a bone, and the dog used to have a phone"; in order for it to make sense, but then that changes it completely (to past tense).
The only thing that sounds bad when used more than once in the same sentence is 'and' (which is where we use commas).
Hope that makes sense :)
-Stu
kichik
16th April 2005 12:03 UTC
It appears you were right. However, while checking it, I got a suggestion for a better sentence which I eventually used.
NSIS boasts the smallest overhead available while still providing a lot of options thanks to its powerful scripting language and support of external plug-ins.
Afrow UK
18th April 2005 13:09 UTC
I found a small error at the end of Chapter 4 contents (HTML error):
http://nsis.sourceforge.net/Docs/Chapter4.html
-Stu
kichik
19th April 2005 18:41 UTC
And the error is? Don't leave me hanging :)
Afrow UK
19th April 2005 19:05 UTC
Sorry Kichik, I couldn't reproduce the HTML error at home. It must have been the college computers at fault (with their stupid content blockers which probably meant only half the page was loading or something.)
-Stu
glory_man
24th May 2005 13:27 UTC
4.12 Silent Installers/Uninstallers
[...]The above example will copy the value the user passes on after /USRNAME= into $0.[...]
I think /USRNAME must be changed to /USERNAME.
kichik
24th May 2005 21:42 UTC
Thanks, fixed.
Comm@nder21
25th May 2005 14:46 UTC
I found a small error at the end of Chapter 4 contents (HTML error):
http://nsis.sourceforge.net/Docs/Chapter4.html
-Stu
ran the file through html-tidy from w3c.
found two fixable mistakes:
<address>
</address>
<a href="http://sourceforge.net"><img border=0 src="http://sourceforge.net/sflogo.php?group_id=22049&type=1" alt="SourceForge Logo"></a></body>
> the adress tag is emtpy
> the img tag is not closed.
there were lots of other warnings too, but i dont think, they make sense.
Afrow UK
25th May 2005 14:53 UTC
If you are unsure how to close the img tag, it should be:
<img border=0 src="http://sourceforge.net/sflogo.php?group_id=22049&amp;type=1" alt="SourceForge Logo" />
Not to mension & should be &amp; too (if it isn't already).
-Stu
Auz
7th June 2005 05:15 UTC
In section 8 of the MUI Readme, there is:
For the uninstaller, use the MUI_UNFUNCTION_DESCRIPTION_BEGIN and MUI_UNFUNCTIONS_DESCRIPTION_END macros.
Which should be MUI_UNFUNCTION_DESCRIPTION_END, no s.
-auz
- NSIS Discussion
- typos in the docs ...
Archive: typos in the docs ...
kichik
7th June 2005 20:08 UTC
Thanks, fixed.
Anders
26th June 2005 21:15 UTC
4.8.1.21 InstallDir:
"Sets the default installation directory is." remove is (doh)
kichik
28th June 2005 20:18 UTC
Thanks, fixed.
BioDuo
30th June 2005 12:23 UTC
4.9.14.5 FindWindow
FIndWindow $0 "my window class" "my window title"
It should be Findwindow
glory_man
30th June 2005 14:34 UTC
4.9.14.1 BringToFront
... If the user if working with another ...
I think it should be - If the user is working
kichik
30th June 2005 18:17 UTC
Thanks, fixed.
Anders
30th June 2005 19:06 UTC
4.7.2.1.6 .onMouseOverSection
STR: prefix is missing from lparam (in example code)
the docs also needs to be more clear about the description label, eg you actually have to use resource hacker to add a label (or use a existing label like in the ugly hack i did here: http://www.rafb.net/paste/results/XTG9Pd58.html )
kichik
30th June 2005 19:16 UTC
Thanks, fixed.
glory_man
30th June 2005 19:16 UTC
And what about
Variables
Variables start with $. User variables should be declared and are case-sensitive.
Is this mean - variables names are case-sensitive?
This code work fine:
var vv1
...
StrCpy $Vv1 "1 string 1"
MessageBox MB_OK "$vV1"
Is this typo, or NSIS bug, or I misunderstood something in docs?
kichik
30th June 2005 20:52 UTC
Just a relic from the old days when variables were case sensitive. Fixed, thanks.
Afrow UK
16th July 2005 16:06 UTC
This isn't really an issue with the manual, but I noticed that there's no shortcut to the InstallOptions manual in the start menu shortcuts group.
Or is it just me?
-Stu
kichik
16th July 2005 16:29 UTC
Thanks, fixed.
Comm@nder21
14th September 2005 19:55 UTC
file:
INSTALL
This is a trimmed version of Appendix F of the documentation.
should be Appedix G
DrO
14th September 2005 20:20 UTC
Appedix? ;)
-daz
Afrow UK
15th September 2005 19:06 UTC
In the modern UI readme, under 3. Pages > Page Settings > Finish Page Settings > MUI_FINISHPAGE_RUN_FUNCTION:
Call a function instead of executing an application (define MUI_FINISHPAGE_RUN without parameters). You can use the function to exectute multiple applications or you can change the checkbox name and use it for other things.
-Stu
Comm@nder21
15th September 2005 19:25 UTC
Appedix?
well, yea ....
you pwned me :D
kichik
15th September 2005 19:36 UTC
Thanks, fixed.
Jamyn
16th September 2005 00:50 UTC
Typos
I've attached the typos I found. Hope it helps.
-J
Jamyn
16th September 2005 10:43 UTC
Diff File
Oops, I just saw the message on the first page of this thread that asks for large corrections to be presented as a patch. I can't edit my post above to delete it, but anyway...
I have attached a diff to this message, with all the corrections listed in the above message, plus one or two others I ran across. I'm not sure if the way I did it is the preferred way, but if not - just let me know and I'll change it.
I attached it as .txt because the forum doesn't allow the .diff extension. Thanks,
-J
kichik
16th September 2005 12:26 UTC
Awesome, thanks! All committed.
o_owd
18th September 2005 09:37 UTC
in the Install Options readme,
(NSIS\Docs\InstallOptions\Readme.html)
"Call the DLL
You can call InstallOptions in a page function, check the NSIS documentation for information about the page system."
the link "NSIS documentation" points to "file:///C:/Program%20Files/NSIS/Docs/Chapter4.html#4.5"
the file does not exist.
OJi.
kichik
20th September 2005 18:13 UTC
Thanks, fixed.
Jnuw
22nd September 2005 18:46 UTC
This is not a typo, but a suggestion for clarity. Under the 4.9.1.5 File section, on the /nonfatal bullet, it currently states:
"If the /nonfatal switch is used and no files are found, a warning will be issued instead of an error."
I think it would be good to add that if the /nonfatal switch is activate or invoked (no files found), the line will no longer be a run-time instruction, and Relative Jumps will not see the line (per jump info below). It would be best to use regular labels around File /nonfatal commands to be safe.
"4.4 Relative jump of +2 will skip one instruction and go to the second instruction from the current instruction...An instruction is every command that is executed at run-time, when the installer is running. MessageBox, Goto, GetDLLVersion, FileRead, SetShellVarContext are all instructions. AddSize, Section, SectionGroup, SectionEnd, SetOverwrite (and everything under Compiler Flags), Name, SetFont, LangString, are not instructions because they are executed at compile time."
Thanks for your time!
kichik
22nd September 2005 19:04 UTC
That's a bug, not a documentation problem. Please submit a bug report.
Jnuw
22nd September 2005 21:26 UTC
Logged as a bug, 1299100. Thanks for looking at this, and your help on my 2.09 questions from a few minutes ago.
Jnuw
Afrow UK
26th September 2005 18:47 UTC
Idea
I know that in the history of NSIS we've always had the "NSIS Examples Directory" shortcut, but I think a "NSIS Directory" shortcut would be more helpful as I myself have my projects in a Projects sub-folder.
-Stu
kichik
27th September 2005 22:33 UTC
I don't think that's necessary. The start menu is meant for a quick start and that folder contains nothing that's not already linked. In your case, I think you'd even do better with a direct link to that projects folder.
Anders
6th November 2005 17:32 UTC
4.6.1.5 SectionGroup
[/e] Caption [section_group_name index_output]
should be
[/e] section_group_name [index_output]
JasonFriday13
8th November 2005 07:11 UTC
I found a few typos:
4.8.2.3
Typically the SetCompress flag will effect the commands after it,
should be 'affect'.
Also found that this code changes the compression status:
SetCompress off
SetCompressor lzma
Setcompressor switches SetCompress back to the default compression status (auto). This should be documented or bugfixed.
5.4
!define symbol1 ${symbol2}
After copying and pasting the code, I found that this typo has a 1 after symbol. I thought it was two l's. Maybe it should be changed to symbol_1 and symbol_2 or somthing similar (for clarity).
B2
To ask the user for a reboot if required,
should be 'To ask the user for a reboot, if required,' or 'If required, you can ask the user for a reboot.'
D2
For Windows NT (NT4/2000/XP), it's also possible to create the key in the HKCU hive,
Should this be hive, or should it be changed to folder/directory?
kichik
8th November 2005 19:53 UTC
Thanks, fixed.
SetCompress off followed by SetCompressor worked fine for me. Please include a complete example.
It should indeed be HKCU hive. That's how the registry objects are called [MSDN].
JasonFriday13
9th November 2005 04:01 UTC
My bad on SetCompressor. It does work. Maybe instead of saying 'Using lzma compression', it could say 'Using no compression', because I look at this line when I compile my installers with SetCompress off, and I think 'Oh, it's using lzma compression' when it is really not compressed.
glory_man
30th November 2005 16:43 UTC
From MUI doc:
...
Language Selection Dialog Settings
To remember to users preference, you can define a registry key.
...
Is this correct? I think this is must be:
To remember the...
guest1298
1st December 2005 04:52 UTC
4.9.13.1 SectionSetFlags
... The first bit (lowest) represents whether the section is currently enabled,
I suggest "enabled" --> "selected"
This will also make it consistent with wording in Sections.nsh, e.g. SF_SELECTED
kichik
2nd December 2005 12:05 UTC
Thanks, fixed.
Wladimir Mutel
5th December 2005 13:35 UTC
In section 4.9.14.2, CreateFont :
GetDlgItem $$0 $HWNDPARENT 1
Should there really be two '$' signs ?
And if yes, then why ?
Comm@nder21
5th December 2005 13:47 UTC
nope there should not, its definetly a typo.
kichik
6th December 2005 21:02 UTC
Thanks, fixed.
{_trueparuex^}
9th January 2006 11:35 UTC
foul language
In section 4.8.1.30, Name :
'CrapSoft MyApp'
==> 'MySoft MyApp'
In section C.1, Get parent directory :
; input, top of stack (e.g. C:\Program Files\Poop)
==> ; input, top of stack (e.g. C:\Program Files\foo)
{_trueparuex^}
9th January 2006 11:56 UTC
Aannd there was also some poo in the examples.
In these files:
Examples\bigtest.nsi
Examples\InstallOptions\test.ini
Examples\InstallOptions\testnotify.ini
(Not sure if the bigtest.nsi needs fixin)
StrCpy $1 "POOOOOOOOOOOP"
==> StrCpy $1 "FOOOOOOOOOOOO"
Heres a patch anyway.
iceman_k
9th February 2006 22:24 UTC
Not actually a typo, but missing documentation. The LockWindow command is supported but not documented anywhere.
What exactly does it do? I am guessing it enables or prevents window repainting.
Why would it be needed in an installer? I am not quite sure.
- NSIS Discussion
- typos in the docs ...
Archive: typos in the docs ...
kichik
10th February 2006 10:30 UTC
It's documented.
iceman_k
10th February 2006 10:56 UTC
Yes, I realized I was looking at an older CHM file.
I have every release of NSIS installed on my PC (I use them for regression testing), and I suppose I must have opened an old version of NSIS.chm by mistake.
Even though the command has been supported since 2.0, it was not documented until 2.07.
(But you already knew that).
iceman_k
10th February 2006 16:00 UTC
OK, I'm pretty sure I didn't mess up this time. :)
SetCompressionLevel is not documented. It is supported, since running
makensis /cmdhelp setcompressionlevel
yields:
MakeNSIS v2.14 - Copyright 1999-2006 Nullsoft, Inc.
Portions Copyright (C) 1995-1998 Jean-loup Gailly and Mark Adler (zlib).
Portions Copyright (C) 1996-2002 Julian R Seward (bzip2).
Portions Copyright (C) 1999-2003 Igor Pavlov (lzma).
Contributors: nnop@newmail.ru, Ryan Geiss, Andras Varga, Drew Davidson, Peter Windridge, Dave Laundon, Robert Rainwater,
Yaroslav Faybishenko, Jeff Doozan, Amir Szekely, Ximon Eighteen, et al.
Usage: SetCompressionLevel level_0-9
Same with Nop:
MakeNSIS v2.14 - Copyright 1999-2006 Nullsoft, Inc.
Portions Copyright (C) 1995-1998 Jean-loup Gailly and Mark Adler (zlib).
Portions Copyright (C) 1996-2002 Julian R Seward (bzip2).
Portions Copyright (C) 1999-2003 Igor Pavlov (lzma).
Contributors: nnop@newmail.ru, Ryan Geiss, Andras Varga, Drew Davidson, Peter Windridge, Dave Laundon, Robert Rainwater,
Yaroslav Faybishenko, Jeff Doozan, Amir Szekely, Ximon Eighteen, et al.
Usage: Nop
I just did a search, and these commands were discussed in
this thread. LockWindow made it into the docs, the other two didn't.
kichik
11th February 2006 18:53 UTC
SetCompressionLevel doesn't work. Nop added, thanks.
Comm@nder21
12th February 2006 16:08 UTC
Nop ?!
"Does nothing."
What is it useful for?!?!
why is this one implemented?
is Nop simply the same as an empty script line?
then, why do you include it? (overhead!)
Afrow UK
12th February 2006 17:51 UTC
Nop is a blank instruction which takes up a line. Stands for Null Operation. Simply there for relative jumps for example.
It won't add to overhead though because it's just for the compiler.
-Stu
Comm@nder21
13th February 2006 19:41 UTC
ah, i think i got it ...
so:
Goto +3
Nop
is the same as
Goto +2
thats the revolution we all waited for .. lol
kichik
14th February 2006 20:18 UTC
It actually adds an instruction to the code as well. It is not just for the compiler. It adds a jump to the next instruction, which is esentially the same as doing nothing.
Afrow UK
11th April 2006 23:03 UTC
I discovered this one in the compiler:
Error: invalid charaters in variable name "Hello'", use only charaters [a-z][A-Z][0-9] and '_'
Did someone copy and paste lol?
-Stu
e_orz
26th May 2006 10:07 UTC
In Section:
4.9.1.8 RMDir
The line: RMDir /r /REBOOTOK $INSTIDR
Should be: RMDir /r /REBOOTOK $INSTDIR
kichik
1st June 2006 10:20 UTC
Where is that located? Are you sure you're using the latest version?
e_orz
1st June 2006 13:07 UTC
Sorry, I had NSIS 2.15.
This typo was corrected in the latest version.
Afrow UK
27th June 2006 13:54 UTC
4.8.1.24 InstType
...instead of an "hard-coded" name...
an -> a
...component list will only be show n if the...
show n -> shown
-Stu
kichik
30th June 2006 10:21 UTC
Thanks, fixed.
Afrow UK
7th August 2008 22:14 UTC
Reviving rather an old topic:
4.9.3.4 CreateShortCut
The text specifies CONTROL as a shortcut keys modifier but uses CTRL in the example. CTRL is not valid.
Stu