fbdoc Update Aug 2018

doc/fbchkdoc/mkerrlst.bas

@@ -31,8 +31,14 @@ end sub
 ''
 sub WriteFooterCode( byval h as integer )
 	print #h, !"print"
+	print #h, !"dim msg as string"
 	print #h, !"for i as integer = 1 to FB_WARNINGMSGS-1"
-	print #h, !"print chr(9) + \"- //\" + ltrim(str(i)) + \" \" + *warningMsgs(i).text + \"//\""
+	print #h, !"if i = FB_WARNINGMSG_AMBIGIOUSLENSIZEOF then"
+	print #h, !"msg = ""Ambiguous LEN or SIZEOF"""
+	print #h, !"else"
+	print #h, !"msg = *warningMsgs(i).text"
+	print #h, !"end if"
+	print #h, !"print chr(9) + \"- //\" + ltrim(str(i)) + \" \" + msg + \"//\""
 	print #h, !"next"
 	print #h, !"print: print: print"
 	print #h, !"for i as integer = 1 to FB_ERRMSGS-1"

doc/manual/cache/CatPgFullIndex.wakka

@@ -213,7 +213,7 @@ Alphabetical listing of keywords, macros and procedures.
 	- {{fbdoc item="keyword" value="KeyPgDefuint|DEFUINT"}}
 	- {{fbdoc item="keyword" value="KeyPgDefulongint|DEFULONGINT"}}
 	- {{fbdoc item="keyword" value="KeyPgDefushort|DEFUSHORT"}}
-	- {{fbdoc item="keyword" value="KeyPgOpDelete|DELETE"}}
+	- {{fbdoc item="keyword" value="KeyPgOpDelete|DELETE (Statement)"}}
 	- {{fbdoc item="keyword" value="KeyPgDestructor|DESTRUCTOR"}}
 	- {{fbdoc item="keyword" value="KeyPgModuleDestructor|DESTRUCTOR (Module)"}}
 	- {{fbdoc item="keyword" value="KeyPgDim|DIM"}}
@@ -273,6 +273,7 @@ Alphabetical listing of keywords, macros and procedures.
 	- {{fbdoc item="keyword" value="KeyPgFreefile|FREEFILE"}}
 	- {{fbdoc item="keyword" value="KeyPgFunction|FUNCTION"}}
 	- {{fbdoc item="keyword" value="KeyPgMemberFunction|FUNCTION (Member)"}}
+	- {{fbdoc item="keyword" value="KeyPgFunctionPtr|FUNCTION (Pointer)"}}
 
 {{fbdoc item="section" value="G"}}{{anchor name="g"}}
 	- {{fbdoc item="keyword" value="KeyPgGetgraphics|GET (Graphics)"}}
@@ -367,7 +368,7 @@ Alphabetical listing of keywords, macros and procedures.
 	- {{fbdoc item="keyword" value="KeyPgNaked|NAKED"}}
 	- {{fbdoc item="keyword" value="KeyPgName|NAME"}}
 	- {{fbdoc item="keyword" value="KeyPgNamespace|NAMESPACE"}}
-	- {{fbdoc item="keyword" value="KeyPgOpNew|NEW"}}
+	- {{fbdoc item="keyword" value="KeyPgOpNew|NEW (Expression)"}}
 	- {{fbdoc item="keyword" value="KeyPgOpPlacementNew|NEW (Placement)"}}
 	- {{fbdoc item="keyword" value="KeyPgNext|NEXT"}}
 	- {{fbdoc item="keyword" value="KeyPgResumenext|NEXT (RESUME)"}}
@@ -516,6 +517,7 @@ Alphabetical listing of keywords, macros and procedures.
 	- {{fbdoc item="keyword" value="KeyPgOpStrptr|STRPTR"}}
 	- {{fbdoc item="keyword" value="KeyPgSub|SUB"}}
 	- {{fbdoc item="keyword" value="KeyPgMemberSub|SUB (Member)"}}
+	- {{fbdoc item="keyword" value="KeyPgSubPtr|SUB (Pointer)"}}
 	- {{fbdoc item="keyword" value="KeyPgSwap|SWAP"}}
 	- {{fbdoc item="keyword" value="KeyPgSystem|SYSTEM"}}
 

doc/manual/cache/CatPgFunctIndex.wakka

@@ -74,6 +74,7 @@ List of ""FreeBASIC"" keywords sorted by the function they perform.
 	- {{fbdoc item="keyword" value="KeyPgDouble|DOUBLE"}}
 	- {{fbdoc item="keyword" value="KeyPgEnum|ENUM"}}
 	- {{fbdoc item="keyword" value="KeyPgExtends|EXTENDS"}}
+	- {{fbdoc item="keyword" value="KeyPgFunctionPtr|FUNCTION (Pointer)"}}
 	- {{fbdoc item="keyword" value="KeyPgImplements|IMPLEMENTS"}}
 	- {{fbdoc item="keyword" value="KeyPgInteger|INTEGER"}}
 	- {{fbdoc item="keyword" value="KeyPgLong|LONG"}}
@@ -85,6 +86,7 @@ List of ""FreeBASIC"" keywords sorted by the function they perform.
 	- {{fbdoc item="keyword" value="KeyPgSingle|SINGLE"}}
 	- {{fbdoc item="keyword" value="KeyPgStatic|STATIC"}}
 	- {{fbdoc item="keyword" value="KeyPgString|STRING"}}
+	- {{fbdoc item="keyword" value="KeyPgSubPtr|SUB (Pointer)"}}
 	- {{fbdoc item="keyword" value="KeyPgType|TYPE"}}
 	- {{fbdoc item="keyword" value="KeyPgTypeAlias|TYPE (Alias)"}}
 	- {{fbdoc item="keyword" value="KeyPgTypeTemp|TYPE (Temporary)"}}

doc/manual/cache/CatPgMemory.wakka

@@ -28,7 +28,9 @@ Procedures that work with static and dynamic memory.
 	=={{fbdoc item="keyword" value="KeyPgSwap|SWAP"}}==
 		Exchange the contents of two variables.
 	=={{fbdoc item="keyword" value="KeyPgSadd|SADD"}}==
-		Returns the address for the data in a string variable.
+		Returns the address for the data in a zstring variable.
 >>::c::
+{{fbdoc item="see"}}
+	- [[CatPgOpMemory|Memory Operators]]
 
 {{fbdoc item="back" value="DocToc|Table of Contents"}}

doc/manual/cache/CatPgOpIndex.wakka

@@ -84,9 +84,11 @@ List of operators used in FreeBASIC.
 	- {{fbdoc item="keyword" value="KeyPgOpIs|IS (Run-time type information operator)"}}
 
 {{fbdoc item="section" value="Memory Operators"}}
-	- {{fbdoc item="keyword" value="KeyPgOpNew|New"}}
+	- {{fbdoc item="keyword" value="KeyPgOpNew|New Expression"}}
+		- {{fbdoc item="keyword" value="KeyPgOpNewOverload|New Overload"}}
 	- {{fbdoc item="keyword" value="KeyPgOpPlacementNew|Placement New"}}
-	- {{fbdoc item="keyword" value="KeyPgOpDelete|Delete"}}
+	- {{fbdoc item="keyword" value="KeyPgOpDelete|Delete Statement"}}
+		- {{fbdoc item="keyword" value="KeyPgOpDeleteOverload|Delete Overload"}}
 
 {{fbdoc item="section" value="Iteration Operators"}}
 	- {{fbdoc item="keyword" value="KeyPgOpFor|For"}}, [[KeyPgOpNext|Next]], and [[KeyPgOpStep|Step]]

doc/manual/cache/CatPgOpMemory.wakka

@@ -3,12 +3,15 @@ Operators that work with memory
 
 The memory operators provide a way to dynamically allocate and deallocate variables and objects.
 
-<<=={{fbdoc item="keyword" value="KeyPgOpNew|Operator New"}}==
+<<=={{fbdoc item="keyword" value="KeyPgOpNew|Operator New Expression"}}==
 	Allocates memory for and constructs objects.
+	=={{fbdoc item="keyword" value="KeyPgOpNewOverload|Operator New Overload"}}==
+		Overloads memory allocation process of Operator New Expression when applying to UDT.
 =={{fbdoc item="keyword" value="KeyPgOpPlacementNew|Operator Placement New"}}==
 	Constructs objects at a specified memory location.
-<<>>=={{fbdoc item="keyword" value="KeyPgOpDelete|Operator Delete"}}==
+<<>>=={{fbdoc item="keyword" value="KeyPgOpDelete|Operator Delete Statement"}}==
 	Destroys and deallocates memory for objects.
->>::c::
+	=={{fbdoc item="keyword" value="KeyPgOpDeleteOverload|Operator Delete Overload"}}==
+		Overloads memory deallocation process of Operator Delete Statement when applying to UDT.>>::c::
 
 {{fbdoc item="back" value="CatPgOperators|Operators"}}

doc/manual/cache/CatPgStdDataTypes.wakka

@@ -7,6 +7,8 @@ Built-in data types
 	Types that store real number values, whose range and precision is determined by the size of the data type.
 **{{anchor name="BOOLEAN|Boolean types"}}**
 	Types that store boolean values.
+**{{anchor name="PROCTYPES|Procedure Types"}}**
+	Types that store pointers to procedures
 **{{anchor name="MODIFIERS|Data Type Modifiers"}}**
 	Specifies additional characteristics of a standard or user-defined data type.
 **{{anchor name="STRING|String types"}}**
@@ -35,6 +37,12 @@ Built-in data types
 {{anchor name="BOOLEAN"}}{{fbdoc item="section" value="Boolean types"}}
 	=={{fbdoc item="keyword" value="KeyPgBoolean|BOOLEAN"}}==
 		1-bit wide data types that store boolean values.
+
+{{anchor name="PROCTYPES"}}{{fbdoc item="section" value="Procedure Types"}}
+	=={{fbdoc item="keyword" value="KeyPgFunctionPtr|FUNCTION Pointer"}}==
+		Types that store a pointer to a function procedure
+	=={{fbdoc item="keyword" value="KeyPgSubPtr|SUB Pointer"}}==
+		Types that store a pointer to a sub procedure
 <<>>{{anchor name="MODIFIERS"}}{{fbdoc item="section" value="Data Type Modifiers"}}
 	=={{fbdoc item="keyword" value="KeyPgConstQualifier|CONST"}}==
 		Specifies a read only type.

doc/manual/cache/CatPgUserDefTypes.wakka

@@ -1,45 +1,79 @@
 {{fbdoc item="title" value="User Defined Types"}}----
 
-<<{{fbdoc item="section" value="Declaration"}}
-	- {{fbdoc item="keyword" value="KeyPgEnum|ENUM...END ENUM"}}
-	- {{fbdoc item="keyword" value="KeyPgType|TYPE...END TYPE"}}
-	- {{fbdoc item="keyword" value="KeyPgClass|CLASS...END CLASS"}}
-	- {{fbdoc item="keyword" value="KeyPgUnion|UNION...END UNION"}}
-	- {{fbdoc item="keyword" value="KeyPgExtends|EXTENDS"}}
-	- {{fbdoc item="keyword" value="KeyPgImplements|IMPLEMENTS"}}
-	- {{fbdoc item="keyword" value="KeyPgField|FIELD"}}
-	- {{fbdoc item="keyword" value="KeyPgObject|OBJECT"}}
+**{{anchor name="DECLARATION|Declaration"}}**
+	Declaring and describing user defined types
+**{{anchor name="REFERENCING|Referencing"}}**
+	Accessing data in a user defined type
+**{{anchor name="MEMBERPROC|Member Procedures"}}**
+	Declaring and defining methods related to a user defined type
+**{{anchor name="MEMBERACCESS|Member Access Control"}}**
+	Controlling when data and member procedures are accessed
 
-{{fbdoc item="section" value="Referencing"}}
-	- {{fbdoc item="keyword" value="KeyPgTypeTemp|Temporary Types"}}
-	- {{fbdoc item="keyword" value="KeyPgThis|THIS"}}
-	- {{fbdoc item="keyword" value="KeyPgBase|BASE (member access)"}}
-	- {{fbdoc item="keyword" value="KeyPgTypeAlias|Type Alias"}}
-	- {{fbdoc item="keyword" value="KeyPgWith|WITH"}}
-<<>>{{fbdoc item="section" value="Member Procedures"}}
-	- {{fbdoc item="keyword" value="KeyPgBaseInit|BASE (initialization)"}}
-	- {{fbdoc item="keyword" value="KeyPgConstructor|CONSTRUCTOR"}}
-	- {{fbdoc item="keyword" value="KeyPgDestructor|DESTRUCTOR"}}
-	- {{fbdoc item="keyword" value="KeyPgMemberFunction|FUNCTION"}}
-	- {{fbdoc item="keyword" value="KeyPgOperator|OPERATOR"}}
-	- {{fbdoc item="keyword" value="KeyPgOverride|OVERRIDE"}}
-	- {{fbdoc item="keyword" value="KeyPgProperty|PROPERTY"}}
-	- {{fbdoc item="keyword" value="KeyPgMemberSub|SUB"}}
-	- {{fbdoc item="keyword" value="KeyPgStaticMember|STATIC (Member)"}}
-	- {{fbdoc item="keyword" value="KeyPgVirtual|VIRTUAL"}}
-	- {{fbdoc item="keyword" value="KeyPgAbstract|ABSTRACT"}}
-	- {{fbdoc item="keyword" value="KeyPgConstMember|CONST (Member)"}}
+<<{{anchor name="DECLARATION"}}{{fbdoc item="section" value="Declarations"}}
+	=={{fbdoc item="keyword" value="KeyPgEnum|ENUM...END ENUM"}}==
+		User defined enumeration of values
+	=={{fbdoc item="keyword" value="KeyPgType|TYPE...END TYPE"}}==
+		User defined structure of non overlapping data and member procedures
+	=={{fbdoc item="keyword" value="KeyPgClass|CLASS...END CLASS"}}==
+		Not implemented.  Keyword reserved.
+	=={{fbdoc item="keyword" value="KeyPgUnion|UNION...END UNION"}}==
+		User defined structure of overlapping data
+	=={{fbdoc item="keyword" value="KeyPgExtends|EXTENDS"}}==
+		Extends an user defined type to derive another
+	=={{fbdoc item="keyword" value="KeyPgImplements|IMPLEMENTS"}}==
+		Not implemented.  Keyword reserved.
+	=={{fbdoc item="keyword" value="KeyPgField|FIELD"}}==
+		Specifies field alignment within a user defined type
+	=={{fbdoc item="keyword" value="KeyPgObject|OBJECT"}}==
+		Built-in type providing run-time type information
 
-{{fbdoc item="section" value="Member Access Control"}}
-	- {{fbdoc item="keyword" value="KeyPgVisPublic|PUBLIC: (Access Control)"}}
-	- {{fbdoc item="keyword" value="KeyPgVisPrivate|PRIVATE: (Access Control)"}}
-	- {{fbdoc item="keyword" value="KeyPgVisProtected|PROTECTED: (Access Control)"}}
+{{anchor name="REFERENCING"}}{{fbdoc item="section" value="Referencing"}}
+	=={{fbdoc item="keyword" value="KeyPgTypeTemp|Temporary Types"}}==
+		Creates a temporary copy of a user defined type
+	=={{fbdoc item="keyword" value="KeyPgThis|THIS"}}==
+		Built-in, hidden, parameter passed to non-static member procedures to access the user defined type instance
+	=={{fbdoc item="keyword" value="KeyPgBase|BASE (member access)"}}==
+		Built-in, hidden, variable to access the base user defined type instance in derived user defined types
+	=={{fbdoc item="keyword" value="KeyPgTypeAlias|Type Alias"}}==
+		Declares a user defined type from other user defined or standard data types
+	=={{fbdoc item="keyword" value="KeyPgWith|WITH"}}==
+		Compound statement to access the data and members of a user defined type
+
+<<>>{{anchor name="MEMBERPROC"}}{{fbdoc item="section" value="Member Procedures"}}
+	=={{fbdoc item="keyword" value="KeyPgBaseInit|BASE (initialization)"}}==
+		Specifies an initializer for the base user defined type in derived user defined type constructors
+	=={{fbdoc item="keyword" value="KeyPgConstructor|CONSTRUCTOR"}}==
+		Declares or defines a member procedure that is automatically called when a user defined type is created
+	=={{fbdoc item="keyword" value="KeyPgDestructor|DESTRUCTOR"}}==
+		Declares or defines a member procedure that is automatically called when a user defined type is destroyed or goes out of scope
+	=={{fbdoc item="keyword" value="KeyPgMemberFunction|FUNCTION"}}==
+		Declares or defines a member procedure returning a value
+	=={{fbdoc item="keyword" value="KeyPgOperator|OPERATOR"}}==
+		Declares or defines an overloaded operator
+	=={{fbdoc item="keyword" value="KeyPgOverride|OVERRIDE"}}==
+		Member method attribute that specifies that the method is expected to override a virtual method in the base user defined type
+	=={{fbdoc item="keyword" value="KeyPgProperty|PROPERTY"}}==
+		Declares or defines property member procedures for a user defined type
+	=={{fbdoc item="keyword" value="KeyPgMemberSub|SUB"}}==
+		Declare or defines a member procedure
+	=={{fbdoc item="keyword" value="KeyPgStaticMember|STATIC (Member)"}}==
+		Declares or defines a member procedure or variable is static
+	=={{fbdoc item="keyword" value="KeyPgVirtual|VIRTUAL"}}==
+		Member method attribute that declares that a member must have an implementation
+	=={{fbdoc item="keyword" value="KeyPgAbstract|ABSTRACT"}}==
+		Member method attribute that declares that a member must be implemented in a derived user defined type
+	=={{fbdoc item="keyword" value="KeyPgConstMember|CONST (Member)"}}==
+		Member method attribute that declares or defines that the method is readonly and does not modify the user defined types's data
+
+{{anchor name="MEMBERACCESS"}}{{fbdoc item="section" value="Member Access Control"}}
+	=={{fbdoc item="keyword" value="KeyPgVisPublic|PUBLIC: (Access Control)"}}==
+		Data and members in a user defined type have public visibility
+	=={{fbdoc item="keyword" value="KeyPgVisPrivate|PRIVATE: (Access Control)"}}==
+		Data and members in a user defined type have private visibility
+	=={{fbdoc item="keyword" value="KeyPgVisProtected|PROTECTED: (Access Control)"}}==
+		Data and members in a user defined type have protected visibility
 >>
 
 ::c::
 
-{{fbdoc item="back" value="DocToc|Table of Contents"}}
-
-
-
-
+{{fbdoc item="back" value="DocToc|Table of Contents"}}

doc/manual/cache/CompilerCmdLine.wakka

@@ -132,7 +132,7 @@ Using the **fbc** command-line.
 	=={{fbdoc item="keyword" value="CompilerOptcupp|-C"}}==
 		Do not delete the object file(s)
 	=={{fbdoc item="keyword" value="CompilerOptw|-w < value >"}}==
-		Set min warning level: ##all##, ##pedantic##, ##next## or a value
+		Set min warning level: ##all##, ##param##, ##escape##, ##pedantic##, ##next##, ##constness## or a value
 	=={{fbdoc item="keyword" value="CompilerOptmaxerr|-maxerr < val >"}}==
 		Only stop parsing if <val> errors occurred
 	=={{fbdoc item="keyword" value="CompilerOptnoerrline|-noerrline"}}==