fbdocs: wiki snapshot 2021.12.31

Author: jayrm

doc/manual/cache/DevBindingCreation.wakka

@@ -9,7 +9,7 @@ In general, FB and ""C/C++"" are very similar. FB follows the same ABI as GCC wh
 
 {{fbdoc item="section" value="Data types"}}
 
-	{{table columns="3" cellpadding="1" cells=" C/C++ type ; Size in bytes (GCC on Linux/Windows) ; Corresponding FreeBASIC type ; char ; 1 ; Byte ; short [int] ; 2 ; Short ; int ; 4 ; Long ; enum (underlying type int) ; 4 ; Long ; long long [int] ; 8 ; LongInt ; float ; 4 ; Single ; double ; 8 ; Double ; long double ; 12 on 32bit, 16 on 64bit ; CLongDouble from crt/longdouble.bi ; _Bool/bool ; 1 ; Byte / Boolean ; * (pointer) ; 4 on 32bit, 8 on 64bit ; Ptr/Pointer ; ssize_t, intptr_t ; 4 on 32bit, 8 on 64bit ; Integer ; size_t, uintptr_t ; 4 on 32bit, 8 on 64bit ; UInteger ; long [int] ; 4 on 32bit systems and Win64 (!), 8 on 64bit Linux/BSD ; CLong from crt/long.bi "}}
+	{{table columns="3" cellpadding="1" cells=" C/C++ type ; Size in bytes (GCC on Linux/Windows) ; Corresponding FreeBASIC type (on 32bit or 64bit) ; char ; 1 ; Byte ; short [int] ; 2 ; Short ; int ; 4 ; Long ; enum (underlying type int) ; 4 ; Long ; long long [int] ; 8 ; LongInt ; float ; 4 ; Single ; double ; 8 ; Double ; long double ; 12 on 32bit, 16 on 64bit ; CLongDouble from crt/longdouble.bi ; _Bool/bool ; 1 ; Byte / Boolean ; * (pointer) ; 4 on 32bit, 8 on 64bit ; Ptr/Pointer ; ssize_t, intptr_t ; 4 on 32bit, 8 on 64bit ; Integer ; size_t, uintptr_t ; 4 on 32bit, 8 on 64bit ; UInteger ; long [int] ; 4 on 32bit systems and Win64 (!), 8 on 64bit Linux/BSD ; CLong from crt/long.bi "}}
 
 	- Caveat: ##int##/##long## is not ##Integer##/##Long##. In FB, ##Integer## corresponds to ##Pointer## - it's 32bit on 32bit and 64bit on 64bit (on all operating systems). ##Long## stays 32bit everywhere. In C, ##int## stays 32bit everywhere, and ##long## only corresponds to pointers on Linux/BSD systems, but not on ""Win64"", where ##long## is still 32bit. On ""Win64"", ##long long## is the only 64bit integer type in C. Thus, neither C's ##int## nor C's ##long## are compatible to FB's ##Integer##.
 	- Caveat: ##long int## is not ##""LongInt""##. FB's ##""LongInt""## corresponds to C's ##long long##, not C's ##long##.

doc/manual/cache/KeyPgDdfbargleftof.wakka

@@ -14,6 +14,7 @@ Intrinsic define (macro) performed by the compiler.
 
 {{fbdoc item="desc"}}
 	Returns the left token of the argument (##//arg//##), based on the separator (##//sep//##).
+	(in the expression of the argument, the tokens and the separator must be spaced)
 
 	By default, if the default return (##//ret//##) is not given, the macro returns nothing (empty token) if the separator (##//sep//##) is not found.
 	Otherwise, if the default return (##//ret//##) is given, the macro returns the default return (##//ret//##) if the separator (##//sep//##) is not found.
@@ -38,7 +39,8 @@ Sleep
 left-side
 Not found 'versus'
 '/
-	%%
+%%
+
 	See also ##[[KeyPgDdfbargrightof|__FB_ARG_RIGHTOF__]]## example.
 
 {{fbdoc item="ver"}}

doc/manual/cache/KeyPgDdfbargrightof.wakka

@@ -14,6 +14,7 @@ Intrinsic define (macro) performed by the compiler.
 
 {{fbdoc item="desc"}}
 	Returns the right token of the argument (##//arg//##), based on the separator (##//sep//##).
+	(in the expression of the argument, the tokens and the separator must be spaced)
 
 	By default, if the default return (##//ret//##) is not given, the macro returns nothing (empty token) if the separator (##//sep//##) is not found.
 	Otherwise, if the default return (##//ret//##) is given, the macro returns the default return (##//ret//##) if the separator (##//sep//##) is not found.
@@ -38,7 +39,8 @@ Sleep
 right-side
 Not found 'versus'
 '/
- 	%%
+%%
+
 	{{fbdoc item="filename" value="examples/manual/defines/fbargrightof2.bas"}}%%(freebasic)
 #macro count( range )
 	Scope
@@ -75,7 +77,7 @@ Counting 7 to 2
  3
  2
 '/
-	%%
+%%
 {{fbdoc item="ver"}}
 	- Since fbc 1.08.0
 

doc/manual/cache/KeyPgPpPragma.wakka

@@ -11,14 +11,15 @@ Preprocessor directive
 {{fbdoc item="param"}}
 	Possible values for ##//option//## and related ##//value//##s:
 
-	{{table columns="3" cellpadding="1" cells="Option; Value; Description; msbitfields; 0; Use bitfields compatible with gcc (default);###; -1 (or any other non-zero value); Use bitfields compatible with those used in Microsoft C compilers; once; N/A; cause the source file in which the pragma appears to behave as though it was included with #include once ...; constness; 0; cause the source file in which the pragma appears to disable 'CONST qualifier discarded' warning;###; -1 (or any other non-zero value); cause the source file in which the pragma appears to enable 'CONST qualifier discarded' warning"}}
+	{{table columns="3" cellpadding="1" cells="Option; Value; Description; msbitfields; false; Use bitfields compatible with gcc (default); msbitfields; true ; Use bitfields compatible with those used in Microsoft C compilers; once; N/A; cause the source file in which the pragma ppears to behave as though it was included with #include once ...; constness; false; disable 'CONST qualifier discarded' warning in current source; constness; true; enable 'CONST qualifier discarded' warning in current source; lookup108; false; use normal symbol lookups for unqualified symbol names; lookup108; true; use fbc-1.08.x or earlier symbol lookups for unqualified symbol names;"
+}}
 
-	If //value// is not given, the compiler assumes //-1// (//TRUE//).
+	If //value// is not given, the compiler assumes //True// (//-1//).  A zero (//0//) value may be used in place of //False//.  A non-zero (for example, //-1//) value may be used in place of //True//.
 
 {{fbdoc item="desc"}}
 	Allows the setting of compiler options inside the source code.
 
-	**Push** saves the current value of the //option// onto a stack, then assigns the new //value// (or //-1//) to it. **Pop** restores the //option// to its previous value, and removes it from the stack. This mechanism allows options to be changed for a certain part of source code, regardless of the setting used by the context, which is especially useful inside #include header files.
+	**Push** saves the current value of the //option// onto a stack, then assigns the new //value// (or //True//) to it. **Pop** restores the //option// to its previous value, and removes it from the stack. This mechanism allows options to be changed for a certain part of source code, regardless of the setting used by the context, which is especially useful inside #include header files.
 
 	**##constness##** pragma is added for testing fbc compiler.  It will be removed in future at should not be relied upon.
 
@@ -33,6 +34,9 @@ Preprocessor directive
 #pragma pop(msbitfields)
 %%
 
+{{fbdoc item="ver"}}
+	- //#pragma lookup108// added in version 1.09.0, and to be removed in next minor release
+
 {{fbdoc item="diff"}}
 	- New to ""FreeBASIC""
 

doc/manual/cache/KeyPgUsing.wakka

@@ -9,10 +9,13 @@ Brings namespace symbols into the current scope
 
 {{fbdoc item="desc"}}
 	The ##**Using**## command allows all symbols from a given namespace to be accessed without the namespace's name prefix. Unlike ""C++"" but like C#, the ##[[KeyPgNamespace|Namespace]]## keyword is not needed after ##**Using**##, because individual symbols cannot be inherited from a namespace.
-	Inheriting a whole namespace can save typing, but sometimes some meaning of the code can be lost, and conflicts with other symbols could be created. For example, if there is duplicated symbol in the global namespace (unnamed namespace), access to local symbol is captured by duplicated global symbol (in that case, full prefixing is required to access local symbol).
+	
+	##**Using**## is allowed in namespaces and procedures only (not in type or union or enum declarations).
+	
+	Inheriting a whole namespace can save typing, but sometimes some meaning of the code can be lost, and conflicts with other symbols could be created.
 
 {{fbdoc item="ex"}}
-{{fbdoc item="filename" value="examples/manual/module/using.bas"}}%%(freebasic)
+	{{fbdoc item="filename" value="examples/manual/module/using.bas"}}%%(freebasic)
 Namespace Sample
 	Type T
 		x As Integer
@@ -31,6 +34,8 @@ Using Sample
 '' without the "Sample." prefix.
 Dim OtherVariable As T 
 %%
+{{fbdoc item="ver"}}
+	- Before fbc 1.09.0, if there is duplicated symbol in the global namespace (unnamed namespace), access to local symbol is captured by duplicated global symbol (in that case, full prefixing is required to access local symbol).
 
 {{fbdoc item="diff"}}
 	- QB had the ##**Using**## keyword, but for other purposes. Namespaces did not exist in QB.