doc: Update wiki cache

Author: dkl

doc/manual/cache/CatPgFullIndex.wakka

@@ -231,6 +231,7 @@ Alphabetical listing of keywords, macros and procedures.
 	- {{fbdoc item="keyword" value="KeyPgErmn|ERMN"}}
 	- {{fbdoc item="keyword" value="KeyPgErr|ERR"}}
 	- {{fbdoc item="keyword" value="KeyPgError|ERROR"}}
+	- {{fbdoc item="keyword" value="KeyPgEvent|EVENT (message data from ScreenEvent)"}}
 	- {{fbdoc item="keyword" value="KeyPgExec|EXEC"}}
 	- {{fbdoc item="keyword" value="KeyPgExepath|EXEPATH"}}
 	- {{fbdoc item="keyword" value="KeyPgExit|EXIT"}}

doc/manual/cache/CatPgFunctIndex.wakka

@@ -178,6 +178,7 @@ List of ""FreeBASIC"" keywords sorted by the function they perform.
 	- {{fbdoc item="keyword" value="KeyPgCustomgfx|CUSTOM (Graphics PUT)"}}
 	- {{fbdoc item="keyword" value="KeyPgDraw|DRAW"}}
 	- {{fbdoc item="keyword" value="KeyPgDrawString|DRAW STRING"}}
+	- {{fbdoc item="keyword" value="KeyPgEvent|EVENT (message data from ScreenEvent)"}}
 	- {{fbdoc item="keyword" value="KeyPgFlip|FLIP"}}
 	- {{fbdoc item="keyword" value="KeyPgGetgraphics|GET (Graphics)"}}
 	- {{fbdoc item="keyword" value="KeyPgImageConvertRow|IMAGECONVERTROW"}}

doc/manual/cache/CatPgGfx.wakka

@@ -12,6 +12,7 @@ A list of the keywords and procedures of ""FreeBASIC""'s graphics library.
 	- {{fbdoc item="keyword" value="KeyPgCustomgfx|CUSTOM"}}
 	- {{fbdoc item="keyword" value="KeyPgDraw|DRAW"}}
 	- {{fbdoc item="keyword" value="KeyPgDrawString|DRAW STRING"}}
+	- {{fbdoc item="keyword" value="KeyPgEvent|EVENT (message data from ScreenEvent)"}}
 	- {{fbdoc item="keyword" value="KeyPgFlip|FLIP"}}
 	- {{fbdoc item="keyword" value="KeyPgImageConvertRow|IMAGECONVERTROW"}}
 	- {{fbdoc item="keyword" value="KeyPgImagecreate|IMAGECREATE"}}

doc/manual/cache/CompilerCredits.wakka

@@ -102,4 +102,4 @@
 		http://www.freebasic.net/wiki/wikka.php?wakka=ContributorList
 	- All users that reported bugs, requested features and as such helped improving the compiler, language and run-time libraries.
 
-{{fbdoc item="back" value="FBWiki|Main Page"}}
+{{fbdoc item="back" value="FBWiki|Main Page"}}

doc/manual/cache/CompilerDialects.wakka

@@ -30,7 +30,7 @@
 		- All variables must be explicitly declared, using ##[[KeyPgDim Dim]]##, ##[[KeyPgRedim Redim]]##, ##[[KeyPgVar Var]]##, ##[[KeyPgConst Const]]##, ##[[KeyPgExtern Extern]]## or ##[[KeyPgCommon Common]]##.
 
 	""2"") type suffixes (##!, #, $, %, &##)
-		- They are only allowed for numeric literals, but it's recommended to use ##[[KeyPgCast Cast]]## or the ##f## (##single##), ##d## (##double##), ##ll## (##longint##), ##ul## (##uinteger##), ##ull## (##ulongint##) numeric literal suffixes to resolve overloading.
+		- They are only allowed for numeric literals, but it's recommended to use ##[[KeyPgCast Cast]]## or the ##f## (##single##), ##d## (##double##), ##ll## (##longint##), ##ul## (##ulong##), ##ull## (##ulongint##) numeric literal suffixes to resolve overloading.
 
 	""3"") ##[[KeyPgDefbyte Defbyte]]##, ##[[KeyPgDefubyte Defubyte]]##, ##[[KeyPgDefshort Defshort]]##, ##[[KeyPgDefushort Defushort]]##, ##[[KeyPgDefint Defint]]##, ##[[KeyPgDefuint Defuint]]##, ##[[KeyPgDeflng Deflng]]##, ##[[KeyPgDeflongint Deflongint]]##, ##[[KeyPgDefulongint Defulongint]]##, ##[[KeyPgDefsng Defsng]]##, ##[[KeyPgDefdbl Defdbl]]##, ##[[KeyPgDefstr Defstr]]##
 		- An explicit type ("##As //T//##") is needed when declaring variables using ##[[KeyPgDim Dim]]##, ##[[KeyPgRedim Redim]]##, ##[[KeyPgExtern Extern]]## or ##[[KeyPgCommon Common]]##. Variables declared using ##[[KeyPgVar Var]]## or ##[[KeyPgConst Const]]## have their types inferred from an initialization value (an explicit type is optional using ##[[KeyPgConst Const]]##).

doc/manual/cache/CompilerFAQ.wakka

@@ -23,7 +23,8 @@
 	==- {{anchor name="item21|Why doesn't the QB GUI open when I start FreeBASIC?"}}==
 	==- {{anchor name="item22|Can I have an offline version of the documentation?"}}==
 	==- {{anchor name="item23|What's the idea behind the FB dialects?"}}==
-	==- {{anchor name="item24|Why does my program crash when I define an array larger than xx ?"}}==
+	==- {{anchor name="item24|Why does my program crash when I define an array larger than xx?"}}==
+	==- {{anchor name="item25|Why does my program fail to compile with the message 'cannot find -llibname'"?}}==
 
 **Advanced ""FreeBASIC""**
 
@@ -104,7 +105,7 @@
 {{anchor name="item0|Back to top"}}
 
 {{anchor name="item8"}}==Does ""FreeBASIC"" support Object Oriented Programming?==
-	""FreeBASIC"" (as of version 0.90) supports classes (user-defined types) with member functions (methods), static methods, static member variables, constructors, destructors, properties, operator overloading, single inheritance, virtual and abstract methods (polymorphism) and run-time type information. Future plans regarding OOP functionality include adding support for multiple inheritance and/or interfaces. For more information see: [[TutBeginnersGuideToTypesAsObjects A Beginners Guide to Types as Objects]].
+	""FreeBASIC"" (since version 0.90) supports classes (user-defined types) with member functions (methods), static methods, static member variables, constructors, destructors, properties, operator overloading, single inheritance, virtual and abstract methods (polymorphism) and run-time type information. Future plans regarding OOP functionality include adding support for multiple inheritance and/or interfaces. For more information see: [[TutBeginnersGuideToTypesAsObjects A Beginners Guide to Types as Objects]].
 
 {{anchor name="item0|Back to top"}}
 
@@ -145,7 +146,7 @@
 {{anchor name="item20"}}==Where can I find more information about ""FreeBASIC""?==
 	The ""FreeBASIC"" Wiki is the most up-to-date manual for using ""FreeBASIC"", available [[http://www.freebasic.net/wiki/ here]].
 
-	Active ""FreeBASIC"" related forums, besides the [[http://www.freebasic.net/forum official one]], can be found at [[http://www.qbasicnews.com/ qbasicnews]], [[http://www.petesqbsite.com/forum/ Pete's QB Site]] , [[http://games.freebasic.net/forum/index.php the FB Games directory]]  or  [[http://www.freebasic-portal.de freebasic-portal.de (in German)]]. 
+	Active ""FreeBASIC"" related forums, besides the [[http://www.freebasic.net/forum official one]], can be found at [[http://www.qbasicnews.com/ qbasicnews]], [[http://www.petesqbsite.com/phpBB3/ Pete's QB Site]] , [[http://games.freebasic.net/forum/index.php the FB Games directory]]  or  [[http://www.freebasic-portal.de freebasic-portal.de (in German)]].
 
 	Active magazines which regularly have ""FreeBASIC"" related articles are [[http://www.petesqbsite.com/sections/express/express.shtml QB Express]] and [[http://www.qbxl.net/ QBXL Magazine]]. These magazines are always looking for new articles, so if you think you've got a good idea for an article about ""FreeBASIC"", submit it!
 
@@ -192,6 +193,9 @@
 
 	//Static// and //variable-length// arrays don't use the program stack for their element data, so do not have the problem associated with //automatic// fixed-length arrays. See [[ProPgStorageClasses Storage Classes]] for more information. Note that storing huge buffers as //static// or increasing the stack size far above the default is not a very good idea, since it increases the fixed amount of memory needed to load and start you program, even if most of it is not used later, and can result in performance degrade, or even refusing your program to load at all.    
 
+{{anchor name="item25"}}==Why does my program fail to compile with the message 'cannot find -llibname'"?==
+	This is an error raised by the linker.  The program is supposed to link to an external library, designated in the program code with ##[[KeyPgInclib #Inclib]]## or on the compiler command line with ##[[CompilerOptL -l]]##.  However, the linker has been unable to find a matching file in any of the library paths.  Check the homepage of the library you want to compile with to find out how to download it, or check [[ExtLibTOC]] to see if information about the library can be found there.
+
 {{anchor name="item0|Back to top"}}
 
 ----
@@ -241,7 +245,7 @@ Depends. If your OS at least egalizes the functionality of DOS with DPMI32 (cons
 
 {{anchor name="item37"}}==Does ""FreeBASIC"" support returning references from Functions, like in ""C++""?==
 
-In version 0.24.0b and earlier, this is not possible.  However, functionality for this now exists from version 0.90.0. Procedures can now return references using ##[[KeyPgByrefFunction byref]] as //datatype//## for the return type.
+Yes, this functionality exists since version 0.90.0. Procedures can now return references using ##[[KeyPgByrefFunction byref]] as //datatype//## for the return type.
 
 {{anchor name="item0|Back to top"}}
 

doc/manual/cache/CompilerInstalling.wakka

@@ -1,75 +1,84 @@
 {{fbdoc item="title" value="Installing"}}----
 Installing ""FreeBASIC"", any additionally needed packages, and perhaps a text editor or IDE.
 
-{{fbdoc item="section" value="Windows"}}
+{{fbdoc item="section" value="Windows 32bit"}}
 
 	1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Windows/ FreeBASIC-x.xx.x-win32.exe]] installer
 	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.
-	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"":
+	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"":
 		- [[http://fbide.freebasic.net/ FBIDE]]
 		- [[http://radasm.cherrytree.at/fbedit/ FBEdit]]
-	
+
 	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]]).
 
+{{fbdoc item="section" value="Windows x64"}}
+
+	1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Windows/ FreeBASIC-x.xx.x-win64.zip]] package
+	1) Extract it where you like, for example at ##""C:\%ProgramFiles%\FreeBASIC""## (no further installation required to use fbc).
+	1) You may want to install a source code editor or IDE; also see the **Windows 32bit** section.
+
+	To uninstall ""FreeBASIC"", simply deleted the directory where you extracted it.
+
 {{fbdoc item="section" value="Linux"}}
 
-	1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Linux/ FreeBASIC-x.xx.x-linux.tar.gz]] package
+	1) Download the latest [[https://sourceforge.net/projects/fbc/files/Binaries%20-%20Linux/ FreeBASIC-x.xx.x-linux-x86.tar.gz (32bit) or FreeBASIC-x.xx.x-linux-x86_64.tar.gz (64bit)]] package
 	1) Extract the archive, for example by doing right-click -> Extract Here, or manually in a terminal:
 
 		%%$ cd Downloads
-$ tar xzf FreeBASIC-x.xx.x-linux.tar.gz%%
+$ tar xzf FreeBASIC-x.xx.x-linux-x86.tar.gz%%
 
-	1) The ""FreeBASIC"" setup can be used from where it was extracted. Usually it is installed into the /usr/local system directory though, so that the ##fbc## program is available through-out the whole system. To do that, run the included installation script:
+	1) The ""FreeBASIC"" compiler can be used from where it was extracted. Usually it is installed into the ##/usr/local## system directory though, so that the ##fbc## program is available through-out the whole system. To do that, run the included installation script:
 
-		%%$ cd FreeBASIC-x.xx.x-linux
+		%%$ cd FreeBASIC-x.xx.x-linux-x86
 $ sudo ./install.sh -i%%
 
 		The ##install.sh## script can also be given a path as in ##./install.sh -i /usr## if you prefer to install into a directory other than the default ##/usr/local##. This default is a good choice though, as it avoids mixing with the content of ##/usr## which is usually managed by the distribution's packaging tool.
-	
+		
 	1) ""FreeBASIC"" requires several additional packages to be installed before it can be used to compile executables. In general, these are:
 
 			- binutils
-			- libc development files
+			- libc development files (installing gcc will typically install these too)
 			- gcc
-			- ""g++ (or rather, libsupc++, part of libstdc++)""
 			- libncurses development files
 			- X11 development files (for FB graphics programs)
 			- libffi development files (for the [[KeyPgThreadCall ThreadCall]] keyword)
+			- gpm (general purpose mouse) daemon and libgpm (only needed for GetMouse support in the Linux console)
 
 		The actual package names to install vary depending on the GNU/Linux distribution.
 
-		Debian/Ubuntu x86 (32bit):
-			- gcc, ""g++""
-			- libncurses5-dev
-			- libx11-dev, libxext-dev, libxrender-dev, libxrandr-dev, libxpm-dev
-			- libffi-dev
-		
-		Debian/Ubuntu amd64 (64bit):
-			- gcc-multilib, ""g++-multilib""
-			- lib32ncurses5-dev
-			- libx11-dev:i386, libxext-dev:i386, libxrender-dev:i386, libxrandr-dev:i386, libxpm-dev:i386
-		
-		older Debian/Ubuntu amd64 (64bit), before the switch to multiarch:
-			- gcc-multilib, ""g++-multilib""
-			- lib32ncurses5-dev
-			- ia32-libs
-			- lib32ffi-dev
-		
-		""OpenSUSE"" x86 (32bit):
-			- gcc, ""gcc-c++""
-			- ncurses-devel
-			- xorg-x11-devel
-			- libffi46-devel
+		For native development (32bit FB on 32bit system, or 64bit FB on 64bit system):
+			- Debian/Ubuntu:
+				- gcc
+				- libncurses5-dev
+				- libffi-dev
+				- libgl1-mesa-dev
+				- libx11-dev libxext-dev libxrender-dev libxrandr-dev libxpm-dev
+			- Fedora:
+				- gcc
+				- ncurses-devel
+				- libffi-devel
+				- mesa-libGL-devel
+				- libX11-devel libXext-devel libXrender-devel libXrandr-devel libXpm-devel
+			- ""OpenSUSE"":
+				- gcc
+				- ncurses-devel
+				- libffi46-devel
+				- xorg-x11-devel
 
-		""OpenSUSE"" x86_64 (64bit):
-			- gcc-32bit, ""gcc-c++-32bit""
-			- ncurses-devel-32bit
-			- xorg-x11-devel-32bit
-			- xorg-x11-libX11-devel-32bit
-			- xorg-x11-libXext-devel-32bit
-			- xorg-x11-libXrender-devel-32bit
-			- xorg-x11-libXpm-devel-32bit
-			- libffi46-devel-32bit
+		For 32bit development on a 64bit system:
+			- Debian/Ubuntu:
+				- gcc-multilib
+				- lib32ncurses5-dev
+				- libx11-dev:i386 libxext-dev:i386 libxrender-dev:i386 libxrandr-dev:i386 libxpm-dev:i386
+			- ""OpenSUSE"":
+				- gcc-32bit
+				- ncurses-devel-32bit
+				- xorg-x11-devel-32bit
+				- xorg-x11-libX11-devel-32bit
+				- xorg-x11-libXext-devel-32bit
+				- xorg-x11-libXrender-devel-32bit
+				- xorg-x11-libXpm-devel-32bit
+				- libffi46-devel-32bit
 
 	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"":
 		- [[http://www.geany.org/ Geany]]

doc/manual/cache/CompilerOptoptfile.wakka

@@ -6,10 +6,29 @@ Read (additional) command-line options from the file
 ##
 {{fbdoc item="param"}}
 	##//file//##
-		Name of a text file containing command line options. It's possible to use multiple lines in the file. The options in a line must be separated by SPACEs and support Double-quoted strings (like the real command line). This file can contain more @file options.
+		Name of a text file containing command line options. It's possible to use multiple lines in the file. The options may be separated by spaces or line breaks, and support double-quoted strings to allow spaces in parameters (like the real command line). This file can itself contain additional ##@//file//## options.
 
 {{fbdoc item="desc"}}
-	The ##@file## compiler option tells the compiler to parse the specified file to find more command line options. The options found in the file are treated as if they were found on the command line. This can be useful to pass very long command lines to the compiler, for example on DOS, where command lines are limited in length.
+	The ##@//file//## compiler option tells the compiler to parse the specified file to find more command line options. The options found in the file are treated as if they were found on the command line. This can be useful to pass very long command lines to the compiler, for example on DOS, where command lines are limited in length.
+
+{{fbdoc item="ex"}}
+##options.txt##:
+{{fbdoc item="filename" value="examples/manual/module/options.txt"}}%%
+-d TEST=123
+%%
+
+##opts.bas##:
+{{fbdoc item="filename" value="examples/manual/module/opts.bas"}}%%(freebasic)
+Print "TEST=" & TEST
+%%
+	Compile with:
+
+		##fbc @options.txt opts.bas##
+
+Output:
+%%
+TEST=123
+%%
 
 {{fbdoc item="see"}}
 	- [[CompilerCmdLine Using the Command Line]]