Skip to content

Commit d166021

Browse files
committed
fbdocs: wiki snapshot 2025.04.26
1 parent aabe1b6 commit d166021

39 files changed

+1391
-210
lines changed

doc/manual/cache/CatPgCompOpt.wakka

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ Command line compiler options for the fbc compiler:
2626
- Add error checking
2727
{{fbdoc item="keyword" value="CompilerOptearray|-earray"}}
2828
- Enable array bounds checking
29+
{{fbdoc item="keyword" value="CompilerOptearraydims|-earraydims"}}
30+
- Enable array dimensions checking
2931
{{fbdoc item="keyword" value="CompilerOpteassert|-eassert"}}
3032
- Enable assert() and assertwarn() checking
3133
{{fbdoc item="keyword" value="CompilerOptedebug|-edebug"}}
@@ -43,15 +45,15 @@ Command line compiler options for the fbc compiler:
4345
{{fbdoc item="keyword" value="CompilerOptex|-ex"}}
4446
- Add error checking with RESUME support
4547
{{fbdoc item="keyword" value="CompilerOptexx|-exx"}}
46-
- Same as -ex, plus array bounds, null-pointer, and error location reporting
48+
- Same as -ex, plus array bounds and dimensions, null-pointer, and error location reporting
4749
{{fbdoc item="keyword" value="CompilerOptexport|-export"}}
4850
- Export symbols for dynamic linkage
4951
{{fbdoc item="keyword" value="CompilerOptforcelang|-forcelang <name>"}}
5052
- Select language compatibility, overriding #lang/$lang in code
5153
{{fbdoc item="keyword" value="CompilerOptfpmode|-fpmode < type >"}}
5254
- Select between fast and accurate floating-point operations (default: PRECISE)
5355
{{fbdoc item="keyword" value="CompilerOptfpu|-fpu < type >"}}
54-
- Set the floating point arithmetics unit (default: FPU)
56+
- Set the floating point arithmetics unit (default: X87)
5557
{{fbdoc item="keyword" value="CompilerOptg|-g"}}
5658
- Add debug info, enable""##__FB_DEBUG__##"", and enable asserts
5759
{{fbdoc item="keyword" value="CompilerOptgen|-gen < backend >"}}

doc/manual/cache/CatPgDddefines.wakka

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,8 @@ Preprocessor symbols defined by the compiler.
161161
Returns nth argument from an argument list.
162162
=={{fbdoc item="keyword" value="KeyPgDdfbargleftof|__FB_ARG_LEFTOF__"}}==
163163
Returns left token based on separator.
164+
=={{fbdoc item="keyword" value="KeyPgDdfbarglistexpand|__FB_ARG_LISTEXPAND__"}}==
165+
Expands a macro one or more time on an argument list
164166
=={{fbdoc item="keyword" value="KeyPgDdfbargrightof|__FB_ARG_RIGHTOF__"}}==
165167
Returns right token based on separator.
166168
=={{fbdoc item="keyword" value="KeyPgDdfbeval|__FB_EVAL__"}}==

doc/manual/cache/CatPgFullIndex.wakka

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ Alphabetical listing of keywords, macros and procedures.
2121
- {{fbdoc item="keyword" value="KeyPgDdfbargcount|__FB_ARG_COUNT__"}}
2222
- {{fbdoc item="keyword" value="KeyPgDdfbargextract|__FB_ARG_EXTRACT__"}}
2323
- {{fbdoc item="keyword" value="KeyPgDdfbargleftof|__FB_ARG_LEFTOF__"}}
24+
- {{fbdoc item="keyword" value="KeyPgDdfbarglistexpand|__FB_ARG_LISTEXPAND__"}}
2425
- {{fbdoc item="keyword" value="KeyPgDdfbargrightof|__FB_ARG_RIGHTOF__"}}
2526
- {{fbdoc item="keyword" value="KeyPgDdfbargc|__FB_ARGC__"}}
2627
- {{fbdoc item="keyword" value="KeyPgDdfbargv|__FB_ARGV__"}}

doc/manual/cache/CatPgFunctIndex.wakka

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -414,6 +414,7 @@ List of ""FreeBASIC"" keywords sorted by the function they perform.
414414
- {{fbdoc item="keyword" value="KeyPgDdfbargcount|__FB_ARG_COUNT__"}}
415415
- {{fbdoc item="keyword" value="KeyPgDdfbargextract|__FB_ARG_EXTRACT__"}}
416416
- {{fbdoc item="keyword" value="KeyPgDdfbargleftof|__FB_ARG_LEFTOF__"}}
417+
- {{fbdoc item="keyword" value="KeyPgDdfbarglistexpand|__FB_ARG_LISTEXPAND__"}}
417418
- {{fbdoc item="keyword" value="KeyPgDdfbargrightof|__FB_ARG_RIGHTOF__"}}
418419
- {{fbdoc item="keyword" value="KeyPgDdfbargc|__FB_ARGC__"}}
419420
- {{fbdoc item="keyword" value="KeyPgDdfbargv|__FB_ARGV__"}}

doc/manual/cache/CompilerCmdLine.wakka

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Using the **fbc** command-line.
5252
=={{fbdoc item="keyword" value="CompilerOptvec|-vec < level >"}}==
5353
Set level of vector optimizations enabled by the compiler (default: ##0##)
5454
=={{fbdoc item="keyword" value="CompilerOptfpu|-fpu < type >"}}==
55-
Set the floating point arithmetics unit (default: ##FPU##)
55+
Set the floating point arithmetics unit (default: ##X87##)
5656
=={{fbdoc item="keyword" value="CompilerOptfpmode|-fpmode < type >"}}==
5757
Select between fast and accurate floating-point operations (default: ##PRECISE##)
5858
=={{fbdoc item="keyword" value="CompilerOptz|-z < value >"}}==
@@ -76,7 +76,7 @@ Using the **fbc** command-line.
7676
=={{fbdoc item="keyword" value="CompilerOptex|-ex"}}==
7777
Add error checking with RESUME support
7878
=={{fbdoc item="keyword" value="CompilerOptexx|-exx"}}==
79-
Same as ##-ex##, plus array bounds, null-pointer, and error location reporting
79+
Same as ##-ex##, plus array bounds and dimensions, null-pointer, and error location reporting
8080
=={{fbdoc item="keyword" value="CompilerOpteunwind|-eunwind"}}==
8181
Enable stack unwind information
8282
=={{fbdoc item="keyword" value="CompilerOptWa|-Wa < opt >"}}==
@@ -87,6 +87,8 @@ Using the **fbc** command-line.
8787
Set object file path/name (must be passed after the .bas file)
8888
=={{fbdoc item="keyword" value="CompilerOptearray|-earray"}}==
8989
Enable array bounds checking
90+
=={{fbdoc item="keyword" value="CompilerOptearraydims|-earraydims"}}==
91+
Enable array dimensions checking
9092
=={{fbdoc item="keyword" value="CompilerOpteassert|-eassert"}}==
9193
Enable assert() and assertwarn() checking
9294
=={{fbdoc item="keyword" value="CompilerOptedebug|-edebug"}}==

doc/manual/cache/CompilerErrMsg.wakka

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -391,6 +391,7 @@ During the program compilation three types of errors can arise:
391391
- //329 Graphics routines were used, but the gfxlib has not been ported to this target//
392392
- //330 -fpu sse option can only be used on x86 and x86_64 architectures//
393393
- //331 -fpu neon option can only be used on arm architectures//
394+
- //332 Undefined built-in symbol//
394395

395396

396397
==Third party programs errors==
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{{fbdoc item="title" value="Compiler Option: -earraydims"}}----
2+
Enable array dimensions checking.
3+
4+
{{fbdoc item="syntax"}}##
5+
**-earraydims**
6+
##
7+
{{fbdoc item="desc"}}
8+
The ##**-earraydims**## compiler option enables the array dimensions checking. Enabled by default with '-exx' command line option.
9+
10+
{{fbdoc item="ver"}}
11+
- Since fbc 1.20.0
12+
13+
{{fbdoc item="see"}}
14+
- ##[[KeyPgDdfberr|__FB_ERR__]]##
15+
- [[CompilerCmdLine|Using the Command Line]]
16+
17+
{{fbdoc item="back" value="CatPgCompOpt|Compiler Options"}}

doc/manual/cache/CompilerOptexx.wakka

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,23 @@
11
{{fbdoc item="title" value="Compiler Option: -exx"}}----
2-
Add error checking with ##[[KeyPgResume|Resume]]## support and array bounds and null-pointer checking, plus stack overflow checking with gas64 backend
2+
Add error checking with ##[[KeyPgResume|Resume]]## support and array bounds/dimensions and null-pointer checking, plus stack overflow checking with gas64 backend
33

44
{{fbdoc item="syntax"}}##
55
**-exx**
66
##
77
{{fbdoc item="desc"}}
8-
The ##**-exx**## compiler option adds error checking with ##[[KeyPgResume|Resume]]## support, array bounds and null-pointer checking (including the procedure pointers), plus stack overflow checking with gas64 backend.
8+
The ##**-exx**## compiler option adds error checking with ##[[KeyPgResume|Resume]]## support, array bounds and dimensions, and null-pointer checking (including the procedure pointers), plus stack overflow checking with gas64 backend.
99

10-
Use of the ##**-exx**## option automatically implies ##-e##, ##-exx##, ##-earray##, ##-elocation##, and ##-enullptr##, error checking and code generation options.
10+
Use of the ##**-exx**## option automatically implies ##-e##, ##-exx##, ##-earray##, ##-earraydims##, ##-elocation##, and ##-enullptr##, error checking and code generation options.
1111

1212
{{fbdoc item="ver"}}
13+
- Before fbc 1.20.0, array dimensions were never checked.
1314
- Before fbc 1.10.0, stack overflow was never checked.
1415

1516
{{fbdoc item="see"}}
1617
- ##[[KeyPgDdfberr|__FB_ERR__]]##
1718
- [[CompilerOpte|Compiler Option: -e]]
1819
- [[CompilerOptearray|Compiler Option: -earray]]
20+
- [[CompilerOptearraydims|Compiler Option: -earraydims]]
1921
- [[CompilerOptelocation|Compiler Option: -elocation]]
2022
- [[CompilerOptenullptr|Compiler Option: -enullptr]]
2123
- [[CompilerOptex|Compiler Option: -ex]]

doc/manual/cache/CompilerOptfpmode.wakka

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Selects faster, less accurate or slower, more precise floating-point math.
1717

1818
Currently, the only floating point operations that behave differently when using ##-fpmode FAST## are: ##[[KeyPgSin|sin]]()##, ##[[KeyPgCos|cos]]()##, reciprocal, and reciprocal [[KeyPgSqr|square root]], all of which must operate on ##[[KeyPgSingle|Single]]## precision values.
1919

20-
Using ##-fpmode PRECISE## is dependent on the ##[[CompilerOptfpu|-fpu SSE]]## command line option. Using ##-fpmode PRECISE## without using ##[[CompilerOptfpu|-fpu SSE]]## will generate an error.
20+
Using ##-fpmode FAST## is dependent on the ##[[CompilerOptfpu|-fpu SSE]]## command line option: Using ##-fpmode FAST## without using ##[[CompilerOptfpu|-fpu SSE]]## will generate an error.
2121

2222
{{fbdoc item="see"}}
2323
- [[CompilerCmdLine|Using the Command Line]]

doc/manual/cache/CompilerOptprofgen.wakka

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,10 @@ Enable function profiling by selecting a specific profiler
1010
{{fbdoc item="subsect" value="-profgen fb"}}
1111
Enable function call profiling using fb's profiler. After running an executable compiled with this option, a ##<filename[.exe]>.prf## file containing the profiling report will be created in the program directory.
1212

13+
{{fbdoc item="subsect" value="-profgen cycles"}}
14+
Enable cycle count profiling on some targets using fb's profiler. After running an executable compiled with this option, it can generate a basic report of cycle counts.
15+
(currently a work in progress on ##-gen gas64## only)
16+
1317
{{fbdoc item="subsect" value="-profgen gmon"}}
1418
Enable profiling code generation for gmon/gprof. After running an executable compiled with this option, a ##gmon.out## file will be created in the program directory, allowing use of GPROF for analysis of the program's execution.
1519

0 commit comments

Comments
 (0)