[NSIS-Bugs] [ nsis-Feature Requests-1820488 ] more complete documentation and examples

[SourceForge.net <no...@so...>]

Feature Requests item #1820488, was opened at 2007-10-26 00:23
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373088&aid=1820488&group_id=22049

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: None
Group: None
Status: Open
Priority: 5
Private: No
Submitted By: Jim Michaels (jmichae3)
Assigned to: Nobody/Anonymous (nobody)
Summary: more complete documentation and examples

Initial Comment:
the examples are missing key elements. for example, MUI examples are missing the core installer piece, the part that *always* gets executed no matter what options you pick. and I can't grey out any options and leave them checked either, because there is no documentation.  

a manual section on "assignment" (at least in the index) would be helpful to language junkies.  after all, there is no assignment operator. so be nice and show someone how its done.  I had to find out the hard way you can't do it with a register (you must use a Var), and you have to use StrCpy $var 0.  I was pulling my hair out to figure this out.

have section on branching. and in it discuss the C-looking way with StrCmp, Goto, and then bring in 
!include "LogicLib.nsh"
and the ${If},  statement and the related statements.

MUI is insufficiently documented.  a beginner can't make anything out of it without getting help from a forum from an expert (and getting chastised).

with MUI there is no "main" installer section that gets executed before the options sections. There are only options.  this is unacceptable.

document the controls we get to work with.
we are supposed to be able to feed in an .INI file to give all the parameters for a checkbbox and all the other controls on a page.  but there is no documentation for this that I could find.  so what is left, right, top, bottom relative to?  what values can I use for State for which controls?  what are the available  settings for Flags and what do they mean?
what kind of output do these controls generate and how do I interpret those values?

document that fact that in .INI files the Fields must be [Field 1] [Field 2] [Field 3]  they must always be numbers starting with 1.  if you use text, the page will not display.

document nsdialogs.  The examples are missing important pieces.

etc.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373088&aid=1820488&group_id=22049