ISPP: Using #pragma verboselevel now automatically turns on verbose mode.

Also move verbose level information into the help file + a documentation tweak.

Examples/ISPPExample1.iss

@@ -3,7 +3,6 @@
 ; This script shows various basic things you can achieve using Inno Setup Preprocessor (ISPP).
 ; To enable commented #define's, either remove the ';' or use ISCC with the /D switch.
 
-#pragma option -v+
 #pragma verboselevel 9
 
 ;#define Debug

Files/ISPPBuiltins.iss

@@ -14,21 +14,6 @@
 //
 #define _BUILTINS_ISS_
 //
-// Verbose levels: 
-// 0 - #include and #file acknowledgements
-// 1 - information about any temp files created by #file
-// 2 - #insert and #append acknowledgements
-// 3 - reserved
-// 4 - #dim, #define and #undef acknowledgements
-// 5 - reserved
-// 6 - conditional inclusion acknowledgements
-// 7 - reserved
-// 8 - show strings emitted with #emit directive
-// 9 - macro and functions successful call acknowledgements
-//10 - Local macro array allocation acknowledgements
-//
-//#pragma verboselevel 0
-//
 #ifndef __POPT_P__
 # define private CStrings
 #else

Projects/ISPP/Help/ispp.xml

@@ -597,10 +597,10 @@
 					<para>First syntax of &pragma; directive controls the options, which ISPP uses to read the source. There are two groups of options. Each group consists of 26 flags (not all of them are meaningful and used by ISPP, though). Each flag has an assigned latin letter. You specify options by typing group name (<synel>option</synel> or <synel>parseroption</synel>),
 then the letter following the dash. After a letter, a plus or minus sign shall be specified. Plus sign to turn the option on, minus to turn it off. Unrestricted number of options can be specified at once (see syntax).
 The list of options is provided at the end of this topic.</para>
-					<para>First group of options (<synel>option</synel>) controls the options of the whole ISPP engine, while second group (<synel>parseroption</synel>) controls options specific to parser. The list of options is provided at the end of this topic.</para>
+					<para>The first group of options (<synel>option</synel>) controls the general options, while the second group (<synel>parseroption</synel>) controls options specific to parser. The list of options is provided at the end of this topic.</para>
 					<para>Second syntax is used to specify inline directive terminators: starting and ending, respectively. After the token description keyword (<synel>inlinestart</synel> or <synel>inlineend</synel>) a string type expression must follow. It must not evaluate to an empty string. Only first seven symbols from the string are taken. It is allowed to specify the same token for both starting and ending terminators. By default, <synel>&ob;#</synel> (opening brace and a number sign) and <synel>&cb;</synel> (closing brace) are assumed.</para>
 					<para>Third syntax of &pragma; directive issues a message of the type specified by the keyword following the directive name. Messages and warnings are sent to the messages window of the compiler. Errors are shown (by the compiler) using message boxes. Expression must be of type string. Also see the &error; directive.</para>
-					<para>Fourth syntax sets the level of verbosity. When the verbose mode is on (see below), this syntax controls the level of importance of messages. Least important messages will show up only when highest verbose level (9) is set.</para>
+					<para>Fourth syntax turns on verbose mode and sets the level of verbosity which controls the importance of messages (see below). Least important messages will show up only when highest verbose level is set.</para>
 					<para>Fifth syntax sets the include path. Expression may specify multiple paths delimited with semicolons. The list of these directories is used when ISPP tries to find a file, mentioned in &include; directive.</para>
 					<para>The last syntax sets the symbol used to span multiple lines together. Expression must not evaluate to an empty string. Only first symbol in string is taken.</para>
 				</description>
@@ -619,6 +619,18 @@ The list of options is provided at the end of this topic.</para>
 						<tr><td>u</td><td>Allow undeclared identifiers. If an undefined identifier is encountered, ISPP will raise an error unless this option is turned on, in which case a standalone identifier (the one that does not look like a function call) will be considered void value. Default state: off.</td></tr>
 					</table>
 				</section>
+				<section title="Verbose levels">
+					<table>
+						<tr><td>0</td><td>#include and #file messages</td></tr>
+						<tr><td>1</td><td>messages about any temporary files created by #file</td></tr>
+						<tr><td>2</td><td>#insert and #append messages</td></tr>
+						<tr><td>4</td><td>#dim, #define and #undef messages</td></tr>
+						<tr><td>6</td><td>conditional inclusion messages</td></tr>
+						<tr><td>8</td><td>#emit messages</td></tr>
+						<tr><td>9</td><td>macro and functions call messages</td></tr>
+						<tr><td>10</td><td><code>Local</code> macro array allocation messages</td></tr>
+					</table>
+				</section>
 				<section title="Examples">
 					<pre>
 						<line>#pragma parseroption -b- -u+</line>

Projects/ISPP/IsppTranslate.pas

@@ -837,6 +837,7 @@ function TPreprocessor.ProcessPreprocCommand(Command: TPreprocessorCommand;
           OptionPragma(FOptions.Options)
         else if P = 'verboselevel' then
         begin
+          Include(FOptions.Options, optVerbose);
           FOptions.VerboseLevel := IntExpr(True);
           EndOfExpr;
         end

whatsnew.htm

@@ -97,7 +97,11 @@ For conditions of distribution and use, see <a href="https://jrsoftware.org/file
     <li><i>Fix:</i> Support function <tt>WizardSelectComponents</tt> now also updates component sizes and the current selection's required disk space.</li>
   </ul>
   </li>
-  <li>ISPP change: Added new <tt>Message</tt>, <tt>Warning</tt>, and <tt>Error</tt> support functions.</li>
+  <li>ISPP changes:
+  <ul>
+    <li>Using <tt>#pragma verboselevel</tt> now automatically turns on verbose mode.</li>
+    <li>Added new <tt>Message</tt>, <tt>Warning</tt>, and <tt>Error</tt> support functions.</li>
+  </ul>
   <li>Various documentation improvements.</li>
   <li>Minor tweaks.</li>
 </ul>