Skip to content

Commit 2f7d004

Browse files
committed
fbdoc: wiki snapshot 2018-06-27
1 parent 4f0d505 commit 2f7d004

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

56 files changed

+384
-231
lines changed

doc/manual/cache/CatPgCompOpt.wakka

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ Command line compiler options for the fbc compiler:
6161
- Do not include the default libraries
6262
{{fbdoc item="keyword" value="CompilerOptnoerrline|-noerrline"}}
6363
- Do not show source line where error occurred
64+
{{fbdoc item="keyword" value="CompilerOptnoobjinfo|-noobjinfo"}}
65+
- Do not read/write compile-time info from/to .o and .a files
6466
{{fbdoc item="keyword" value="CompilerOpto|-o < name >"}}
6567
- Set object file path/name (must be passed after the .bas file)
6668
{{fbdoc item="keyword" value="CompilerOptoptimization|-O < level >"}}
@@ -74,7 +76,7 @@ Command line compiler options for the fbc compiler:
7476
{{fbdoc item="keyword" value="CompilerOptprefix|-prefix < path >"}}
7577
- Set the compiler prefix path
7678
{{fbdoc item="keyword" value="CompilerOptprint|-print < option >"}}
77-
- Let the compiler display certain information (##host##, ##target##, ##x##)
79+
- Let the compiler display certain information (##fblibdir##, ##host##, ##target##, ##x##)
7880
{{fbdoc item="keyword" value="CompilerOptprofile|-profile"}}
7981
- Enable function profiling
8082
{{fbdoc item="keyword" value="CompilerOptr|-r"}}
@@ -91,10 +93,10 @@ Command line compiler options for the fbc compiler:
9193
- Display a tree of file names of ""#included"" files
9294
{{fbdoc item="keyword" value="CompilerOptstatic|-static"}}
9395
- Prefer static libraries over dynamic ones when linking
94-
{{fbdoc item="keyword" value="CompilerOpttarget|-target < platform >"}}
95-
- Set the target platform for cross compilation
9696
{{fbdoc item="keyword" value="CompilerOptt|-t < value >"}}
9797
- Set stack size in kbytes (default: 1M)
98+
{{fbdoc item="keyword" value="CompilerOpttarget|-target < platform >"}}
99+
- Set the target platform for cross compilation
98100
{{fbdoc item="keyword" value="CompilerOptv|-v"}}
99101
- Be verbose
100102
{{fbdoc item="keyword" value="CompilerOptvec|-vec < level >"}}

doc/manual/cache/CatPgStdDataTypes.wakka

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,5 +58,6 @@ Built-in data types
5858

5959
{{fbdoc item="see"}}
6060
- [[TblVarTypes|Variable types and limits]]
61+
- [[ProPgProcedurePointers|Pointers to Procedures]]
6162

6263
{{fbdoc item="back" value="DocToc|Table of Contents"}}

doc/manual/cache/CompilerCmdLine.wakka

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ Using the **fbc** command-line.
116116
=={{fbdoc item="keyword" value="CompilerOptv|-v"}}==
117117
Be verbose
118118
=={{fbdoc item="keyword" value="CompilerOptprint|-print < option >"}}==
119-
Display certain information (##host##, ##target##, etc.)
119+
Display certain information (##fblibdir##, ##host##, ##target##, ##x##)
120120
=={{fbdoc item="keyword" value="CompilerOptpp|-pp"}}==
121121
Emit the preprocessed input file only, do not compile
122122
=={{fbdoc item="keyword" value="CompilerOptr|-r"}}==
@@ -137,6 +137,8 @@ Using the **fbc** command-line.
137137
Only stop parsing if <val> errors occurred
138138
=={{fbdoc item="keyword" value="CompilerOptnoerrline|-noerrline"}}==
139139
Do not show source line where error occurred
140+
=={{fbdoc item="keyword" value="CompilerOptnoobjinfo|-noobjinfo"}}==
141+
Do not read/write compile-time info from/to .o and .a files
140142
=={{fbdoc item="keyword" value="CompilerOptshowincludes|-showincludes"}}==
141143
Display a tree of file names of #included files
142144

doc/manual/cache/CompilerInstalling.wakka

Lines changed: 19 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,26 @@
11
{{fbdoc item="title" value="Installing"}}----
22
Installing ""FreeBASIC"", any additionally needed packages, and perhaps a text editor or IDE.
33

4+
//Note: If the user specifies directory names during the installation of the different components, it is recommended in the chosen names to use only alphanumeric ASCII characters without accent and preferably not any space, otherwise some paths might not work as expected.//
5+
46
{{fbdoc item="section" value="Windows 32bit"}}
57

6-
1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Windows/|FreeBASIC-x.xx.x-win32.exe]] installer
7-
1) Run it and click through it. The installer will install ""FreeBASIC"" at ##""C:\%ProgramFiles%\FreeBASIC""##, or if you chose a different installation directory, in your chosen directory. Start Menu shortcuts to the website will be installed as well.
8+
1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Windows/|FreeBASIC-x.xx.x-win32.zip]] package, or the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Windows/|FreeBASIC-x.xx.x-win32.exe]] installer (not recommended for Windows 7 and later versions).
9+
1) Depending on the chosen method:
10+
- Zip package: Extract it where you like, for example at ##""...\FreeBASIC""## (no further installation required to use fbc).
11+
- Installer (not recommended for Windows 7 and later versions): Run it and click through it. The installer will install ""FreeBASIC"" at ##""C:\%ProgramFiles%\FreeBASIC""##, or if you chose a different installation directory, in your chosen directory. Start Menu shortcuts to the website will be installed as well.
812
1) Unless you already have a source code editor or IDE, you should install one too, as ""FreeBASIC"" itself does not include one. An IDE can be used to write and save .bas files and to launch the ""FreeBASIC"" Compiler to compile them. The following IDEs are known to explicitly support ""FreeBASIC"":
913
- [[http://fbide.freebasic.net/|FBIDE]]
1014
- [[http://radasm.cherrytree.at/fbedit/|FBEdit]]
11-
12-
To uninstall ""FreeBASIC"", remove it from the system's list of installed software ([[http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/win_addprog_window_component.mspx|Add/remove programs]], [[http://windows.microsoft.com/en-US/windows-vista/Uninstall-or-change-a-program|Uninstall or change a program]]).
15+
16+
To uninstall ""FreeBASIC"":
17+
- If previously installed using zip package: simply deleted the directory where you extracted it.
18+
- If previously installed using installer: remove it from the system's list of installed software ([[http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/win_addprog_window_component.mspx|Add/remove programs]], [[http://windows.microsoft.com/en-US/windows-vista/Uninstall-or-change-a-program|Uninstall or change a program]]).
1319

14-
{{fbdoc item="section" value="Windows x64"}}
20+
{{fbdoc item="section" value="Windows 64bit"}}
1521

16-
1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Windows/|FreeBASIC-x.xx.x-win64.zip]] package
17-
1) Extract it where you like, for example at ##""C:\%ProgramFiles%\FreeBASIC""## (no further installation required to use fbc).
22+
1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Windows/|FreeBASIC-x.xx.x-win64.zip]] package.
23+
1) Extract it where you like, for example at ##""...\FreeBASIC""## (no further installation required to use fbc).
1824
1) You may want to install a source code editor or IDE; also see the **Windows 32bit** section.
1925

2026
To uninstall ""FreeBASIC"", simply deleted the directory where you extracted it.
@@ -64,7 +70,8 @@ $ sudo ./install.sh -i%%
6470
- ncurses-devel
6571
- libffi46-devel
6672
- xorg-x11-devel
67-
73+
74+
6875
For 32bit development on a 64bit system:
6976
- Debian/Ubuntu:
7077
- gcc-multilib
@@ -80,10 +87,12 @@ $ sudo ./install.sh -i%%
8087
- xorg-x11-libXrender-devel-32bit
8188
- xorg-x11-libXpm-devel-32bit
8289
- libffi46-devel-32bit
83-
90+
91+
8492
1) Unless you already have a text editor or IDE, you should install one too, as ""FreeBASIC"" itself does not include one. An IDE can be used to write and save .bas files and to launch the ""FreeBASIC"" Compiler to compile them. The following IDEs are known to explicitly support ""FreeBASIC"":
8593
- [[http://www.geany.org/|Geany]]
86-
94+
95+
8796
To uninstall ""FreeBASIC"" from ##/usr/local##, you can run the install.sh script again, but with the -u option: ##sudo ./install.sh -u##
8897

8998
{{fbdoc item="section" value="DOS"}}
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
{{fbdoc item="title" value="Compiler Option: -noobjinfo"}}----
2+
Do not read/write compile-time info from/to .o and .a files
3+
4+
{{fbdoc item="syntax"}}##
5+
**-noobjinfo**
6+
##
7+
{{fbdoc item="desc"}}
8+
The ##-noobjinfo## compiler option disables the writing/reading of compile-time library and other linking options from/to .o and .a files. This also disables the use of fbextra.x (the supplemental linker script) for discarding the .fbctinf sections, which is useful when using the gold linker that doesn't support this kind of linker script.
9+
10+
{{fbdoc item="see"}}
11+
- [[CompilerCmdLine|Using the Command Line]]
12+
13+
{{fbdoc item="back" value="CatPgCompOpt|Compiler Options"}}

doc/manual/cache/CompilerOptprint.wakka

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Print out information
99

1010
Currently, the following -print options are recognized:
1111

12-
{{table columns="2" cellpadding="1" cells="option;effect;host;Prints the host system on which fbc is running;target;Prints the target system for which fbc is compiling (can be affected by the -target option);x;Prints the file name of the output executable or library that fbc will or would generate (named after the -x option), depending on other command line options"}}
12+
{{table columns="2" cellpadding="1" cells="option;effect;fblibdir;Prints the compiler's lib/ path;host;Prints the host system on which fbc is running;target;Prints the target system for which fbc is compiling (can be affected by the -target option);x;Prints the file name of the output executable or library that fbc will or would generate (named after the -x option), depending on other command line options"}}
1313

1414
{{fbdoc item="ex"}}
1515
A [[http://en.wikipedia.org/wiki/Make_(software)|makefile]] could use ##target := $(shell $(FBC) -print target)## to find out the compilation target, which would even work when cross-compiling, with ##FBC## set to something like ##fbc -target foo##.

doc/manual/cache/ExtLibcairo.wakka

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Const SCREEN_H = 300
1818
ScreenRes SCREEN_W, SCREEN_H, 32
1919

2020
'' Create a cairo drawing context, using the FB screen as surface.
21-
var surface = cairo_image_surface_create_for_data(ScreenPtr(), CAIRO_FORMAT_ARGB32, SCREEN_W, SCREEN_H, SCREEN_W * SizeOf(Integer))
21+
var surface = cairo_image_surface_create_for_data(ScreenPtr(), CAIRO_FORMAT_ARGB32, SCREEN_W, SCREEN_H, SCREEN_W * SizeOf(ULong))
2222

2323
var c = cairo_create(surface)
2424

@@ -43,4 +43,6 @@ sleep
4343
cairo_destroy(c)
4444
%%
4545

46-
{{fbdoc item="back" value="ExtLibTOC|External Library Table of Contents"}}
46+
{{fbdoc item="back" value="ExtLibTOC|External Library Table of Contents"}}
47+
48+
// last reviewed: ""MrSwiss"", 2018-05-05 -- changed: ""SizeOf""(Integer) to ""SizeOf""(ULong) reason: 32/64 compatibility //

doc/manual/cache/IkkeJw.wakka

Lines changed: 0 additions & 1 deletion
This file was deleted.

doc/manual/cache/KeyPgAcos.wakka

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,9 @@ Finds the arccosine of an angle
1515
The arccosine of ##//number//##, in radians, in the range [0..Pi].
1616

1717
{{fbdoc item="desc"}}
18-
##Acos## returns the arccosine of the argument ##//number//## as a ##[[KeyPgDouble|Double]]## within the range of 0 to [[TutMathAngles|Pi]]. The arccosine is the inverse of the ##[[KeyPgCos|Cos]]## function. The returned angle is measured in [[TutMathAngles|radians]] (not [[TutMathAngles|degrees]]).
18+
##**Acos**## returns the arccosine of the argument ##//number//## as a ##[[KeyPgDouble|Double]]## within the range of 0 to [[TutMathAngles|Pi]]. The arccosine is the inverse of the ##[[KeyPgCos|Cos]]## function. The returned angle is measured in [[TutMathAngles|radians]] (not [[TutMathAngles|degrees]]).
19+
20+
##**Acos**## can be overloaded as operator to accept user-defined types.
1921

2022
{{fbdoc item="ex"}}
2123
{{fbdoc item="filename" value="examples/manual/math/acos.bas"}}%%(freebasic)

doc/manual/cache/KeyPgAsin.wakka

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,8 @@ Finds the arcsine of a number
1616

1717
{{fbdoc item="desc"}}
1818
##**Asin**## returns the arcsine of the argument ##//number//## as a ##[[KeyPgDouble|Double]]## within the range of -[[TutMathAngles|Pi]]/2 to [[TutMathAngles|Pi]]/2. The arcsine is the inverse of the ##[[KeyPgSin|Sin]]## function. The returned angle is measured in [[TutMathAngles|radians]] (not [[TutMathAngles|degrees]]).
19-
19+
20+
##**Asin**## can be overloaded as operator to accept user-defined types.
2021

2122
{{fbdoc item="ex"}}
2223
{{fbdoc item="filename" value="examples/manual/math/asin.bas"}}%%(freebasic)

0 commit comments

Comments
 (0)