You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: changelog.txt
+1Lines changed: 1 addition & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,7 @@ Version 1.06.0
8
8
- boolean: don't allow NEG unary op '-' on boolean data types
9
9
- All fb RTL functions are checked for CONSTness, CONST qualifiers added to fb rtlib built-in prototypes (sf.net #727)
10
10
- WSTRING can be a return type, but only for prototypes (DECLARE) and function pointers, this allows getting PROCPTR() of all fb built-in run time functions
11
+
- multiline comments are parsed in -lang fblite|qb|deprecated as in -lang fb for consistency
11
12
12
13
[added]
13
14
- Name mangling of Long parameters on Win64 are mangled to C++ int by default and to C++ long with a modifier in the form 'as [u]long alias "long"'. The data type size is still 32bit but allows calling external C++ library expecting a C++ long.
Copy file name to clipboardExpand all lines: doc/manual/cache/CompilerOpts.wakka
+3Lines changed: 3 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -10,11 +10,14 @@ Sets the executable subsystem
10
10
11
11
{{fbdoc item="desc"}}
12
12
The ##-s## compiler option specifies the executable subsystem. Allowed subsystems are ##gui## and ##console## (by default, ##console## is used). Specifying a ##gui## subsystem prevents the console window from appearing behind the program window.
13
+
14
+
The intrinsic macro ##[[KeyPgDdfbgui|__FB_GUI__]]## is set to non-zero (-1) if the option with ##gui## as subsystem was specified, and set to zero (0) otherwise.
Copy file name to clipboardExpand all lines: doc/manual/cache/DevBootstrap.wakka
+18-1Lines changed: 18 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -6,12 +6,29 @@ fbc is written in FB itself, so you need a working fbc to build a new fbc. How t
6
6
7
7
The ""FreeBASIC-x.xx.x-source-bootstrap"" package contains the FB sources plus precompiled compiler sources, for multiple targets. After extracting, this can be built without requiring an existing fbc:
8
8
%%make bootstrap%%
9
-
10
9
(as long as the package contains the precompiled sources for the target system)
11
10
12
11
This package can be created by running:
13
12
%%make bootstrap-dist%%
14
13
14
+
{{fbdoc item="section" value="Bootstrapping by creating and using a bootstrap package"}}
15
+
16
+
1) On a system with a working fbc compiler, create the bootstrap package:
1) Take the bootstrap package to the new system and use it to build the bootstrap compiler:
21
+
%%cd ~
22
+
tar xf ~/FreeBASIC-x.xx.x-source-bootstrap.tar.xz
23
+
cd FreeBASIC-x.xx.x-source-bootstrap
24
+
make bootstrap
25
+
%%
26
+
27
+
1) On the new system, assuming sources are in ~/fbc, use the bootstrap compiler to build fbc for the new system
28
+
%%cd ~/fbc
29
+
make 'FBC=~/FreeBASIC-x.xx.x-source-bootstrap/bin/fbc -i ~/FreeBASIC-x.xx.x-source-bootstrap/inc'
30
+
%%
31
+
15
32
Doing ##make bootstrap-dist##, taking the package to the target system, and then doing ##make bootstrap## can replace the manual steps below, as long as the target is already supported by these commands in the FB makefile.
16
33
17
34
{{fbdoc item="section" value="Bootstrapping by precompiling the compiler sources"}}
@@ -23,6 +23,8 @@ Clause of the ##[[KeyPgSub|Sub]]## and ##[[KeyPgFunction|Function]]## statements
23
23
##Alias## is commonly used for procedures in libraries written in other languages when such procedure names are valid in the other language but invalid in BASIC. When using ##Alias## with ##[[KeyPgDeclare|Declare]]##, only the alternate name is used by the linker.
24
24
25
25
Differently from normal procedure names, ##Alias## does not change the case of the alternate name, so it is useful when external code requires an exported function with a particular name or with a particular case.
26
+
27
+
##Alias## can also be used as modifier that specifies an alternate mangling for procedure parameters. For example ##extern ""c+""""+"" : declare sub proc( byval as long **alias "long"** ) : end extern##. This form of ##Alias## can only be used as in //##[unsigned] [u]long alias "long"##//. The specific purpose is to allow FreeBASIC to call external ""c+""""+"" procedures (on win-64) requiring a 32-bit ##'long int'## type. Usage of ##Alias## in this way affects win-64 targets only, and is ignored on all other targets.
Intrinsic define (macro value) set by the compiler
3
+
4
+
{{fbdoc item="syntax"}}##
5
+
""__FB_GUI__""
6
+
##
7
+
{{fbdoc item="desc"}}
8
+
##""__FB_GUI__""## indicates if the executable subsystem option '-s gui' was specified on the command line at the time of compilation.
9
+
10
+
Returns non-zero (-1) if the executable subsystem option '-s gui' was specified. Returns zero (0) otherwise (no executable subsystem option specified, or executable subsystem option '-s console' specified).
Copy file name to clipboardExpand all lines: doc/manual/cache/KeyPgErase.wakka
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ Statement to erase arrays
15
15
Using ##**Erase**## on a fixed-length array resets all elements without freeing the allocated memory.
16
16
In case of objects, there is destruction then re-construction.
17
17
18
-
Using ##**Erase**## on a variable-length array (array already sized) frees the memory used by the element data (does not allow to after resize it with a different number of dimensions).
18
+
Using ##**Erase**## on a variable-length array (array already sized) frees the memory allocated for the array elements, but the array remains declared at its same scope level (with the same datatype and number of dimensions).
19
19
In case of objects, there is destruction before freeing memory.
Copy file name to clipboardExpand all lines: doc/manual/cache/KeyPgModuleConstructor.wakka
+11-3Lines changed: 11 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -11,15 +11,23 @@ Specifies execution of a procedure before module-level code
11
11
12
12
The procedure must have an empty parameter list. A compile-time error will be generated if the ##**Constructor**## keyword is used in a Sub definition having one or more parameters. In a set of overloaded procedures, only one (1) constructor may be defined because of the ambiguity of having multiple Subs which take no arguments.
13
13
14
-
In a single module, constructors normally execute in the reverse order in which they are defined.
14
+
In a single module, depending on the build and run-time environment of the target system:
15
+
- constructors may execute in which they are defined, or reverse order
16
+
- constructors may execute before or after global static variables having constructors
17
+
- constructors may execute before or after other module constructors having ##//priority//## attribute
18
+
- constructors with ##//priority//## attribute may execute before or after global static variables having constructors
15
19
16
-
The ##//priority//## attribute, an integer between 101 and 65535, can be used to force constructors to be executed in a certain order. The value of ##//priority//## has no specific meaning, only the relationship of the number with other constructor priorities. 101 is the highest priority and is executed first. All constructors having a ##//priority//## attribute are executed before constructors with no attribute. The priority value of 65535 is the same as not assigning a priority value.
20
+
The ##//priority//## attribute, an integer between 101 and 65535, can be used to force constructors to be executed in a certain order, relative to other constructors also having ##//priority//## attribute. The value of ##//priority//## has no specific meaning, only the relationship of the number with other constructor priorities. 101 is the highest priority and is executed first, relative to other constructors also having ##//priority//## attribute.
17
21
18
22
A module may define multiple constructor procedures, and multiple modules may define additional constructors provided no two ##[[KeyPgPublic|Public]]## constructors share the same //procedure_name//.
19
23
20
24
When linking with modules that also define constructors, the order of execution is not guaranteed at link-time unless the ##//priority//## attribute is used. Therefore, special care should be taken when using constructors that may call on a secondary module also defining a constructor. In such a case it is advisable to use a single constructor that explicitly calls initialization procedures in those modules.
21
25
22
-
**Note:** A public static member procedure (Sub having empty parameter list) can also be defined as module constructor (also with the ##**Constructor**## keyword only used in Sub definition).
26
+
Public static member procedures (a ##[[KeyPgMemberSub|Sub]]## having an empty parameter list), of user defined ##[[KeyPgType|type]]## can be defined as a module constructor, by adding the ##**Constructor**## keyword used in the sub procedure definition.
27
+
28
+
Initialization of static simple numeric type variables, that have a value that can be determined at compile time (for example, default zero, constants, pointers to static objects, pointers to functions, etc), are initialized before any code is executed. These values are part of the executable image and have an initial value when the executable is loaded in to memory. Trivial static globals where no code is needed to initialize, are guaranteed to be initialized and can be reliably used in all code, including global static object constructors and module constructors.
29
+
30
+
The module constructor feature exposes a low-level link-time feature of the build and run-time environment. Accessing global static objects having constructors from module constructors should be avoided due to variations in execution order on different build systems.
0 commit comments