fbdocs: wiki snapshot 2020.12.31

jayrm · jayrm · commit 16b5664bc71d · 2020-12-31T17:21:42.000-05:00
diff --git a/doc/manual/cache/ExtLibCRT.wakka b/doc/manual/cache/ExtLibCRT.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="CRT, the C Runtime Library"}}----
 Standard C language functions. On Windows, this is implemented in msvcrt.dll (however, there also are version-specific msvcrXX.dlls, the ""Microsoft Visual C++"" runtimes). On Linux, the C runtime is typically implemented by glibc. For DOS, ""FreeBASIC"" uses DJGPP, which provides a libc library.
 
-Websites: http://msdn.microsoft.com/en-us/library/59ey50w6.aspx, http://www.gnu.org/software/libc/, http://www.delorie.com/djgpp/
+Websites: http://msdn.microsoft.com/en-us/library/59ey50w6.aspx, https://www.gnu.org/software/libc/, http://www.delorie.com/djgpp/
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: crt.bi
 Function reference: [[ProPgCruntime|C Runtime Functions]]
diff --git a/doc/manual/cache/ExtLibChipmunk.wakka b/doc/manual/cache/ExtLibChipmunk.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="Chipmunk Physics"}}----
 Chipmunk is a physics library designed specifically for 2D games.
 
-Website: http://chipmunk-physics.net/
+Website: https://chipmunk-physics.net
 Platforms supported: ""Win32"", Linux
 Headers to include: chipmunk/chipmunk.bi
 Header version: 4.1.0
diff --git a/doc/manual/cache/ExtLibFastCGI.wakka b/doc/manual/cache/ExtLibFastCGI.wakka
@@ -1,7 +1,9 @@
 {{fbdoc item="title" value="FastCGI"}}----
 Open extension to CGI that provides high performance without the limitations of server specific APIs.
 
-Website: http://www.fastcgi.com (link dead, but see: https://freebasic.net/forum/viewtopic.php?f=14&t=28126)
+Website: [[https://web.archive.org/web/20080213023105/http://www.fastcgi.com:80/ http://www.fastcgi.com]] (archived copy from 2006)
+Github: https://github.com/FastCGI-Archives
+See also Forum: https://freebasic.net/forum/viewtopic.php?f=14&t=28126
 Platforms supported: ""Win32"", Linux
 Headers to include: fastcgi/fastcgi.bi, fastcgi/fcgiapp.bi, fastcgi/fcgi_stdio.bi
 Header version: 2.4.1-SNAP-0311112127
diff --git a/doc/manual/cache/ExtLibFfi.wakka b/doc/manual/cache/ExtLibFfi.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="libffi"}}----
 ""LibFFI"" is a foreign function interface library allowing programs to arbitrarily call native function without pointers and to bind function pointers to generic functions which take variable arguments via closures. It is used to bind native code in modern scripting languages.
 
-Website: http://sourceware.org/libffi/
+Website: https://sourceware.org/libffi/
 Platforms supported: Windows, Linux, DOS
 Headers to include: ffi.bi
 Header version: 3.1
diff --git a/doc/manual/cache/ExtLibJit.wakka b/doc/manual/cache/ExtLibJit.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="libjit"}}----
 ""LibJIT"" is a fairly straightforward, lightweight library for runtime compilation with a simple and stable ABI.
 
-Website: [[http://www.gnu.org/software/libjit/]]
+Website: [[https://www.gnu.org/software/libjit/]]
 Platforms supported: Windows, Linux, DOS
 Headers to include: jit.bi
 Header version: git a8293e141b79c28734a3633a81a43f92f29fc2d7
diff --git a/doc/manual/cache/ExtLibLua.wakka b/doc/manual/cache/ExtLibLua.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="Lua"}}----
 Lightweight, embeddable scripting engine using the Lua language.
 
-Website: http://www.lua.org/
+Website: https://www.lua.org
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: Lua/lua.bi
 Header version: 5.2.3
diff --git a/doc/manual/cache/ExtLibLzma.wakka b/doc/manual/cache/ExtLibLzma.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="liblzma"}}----
 Configurable compression library based around the LZMA algorithm with zlib-like API. liblzma is the heart of the xz-utils used to handle the .lzma and .xz file formats. It is based on 7-Zip's LZMA SDK.
 
-Website: http://tukaani.org/xz/
+Website: https://tukaani.org/xz/
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: lzma.bi
 Header version: 5.0.2
diff --git a/doc/manual/cache/ExtLibLzo.wakka b/doc/manual/cache/ExtLibLzo.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="LZO"}}----
 LZO is a compression library offering fast compression and very fast decompression.
 
-Website: [[http://www.oberhumer.com/opensource/lzo/]]
+Website: [[https://www.oberhumer.com/opensource/lzo/]]
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: lzo/lzo.bi
 Header version: 2.02
diff --git a/doc/manual/cache/ExtLibZeroMQ.wakka b/doc/manual/cache/ExtLibZeroMQ.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="ZeroMQ"}}----
 High-performance asynchronous messaging library
 
-Website: http://www.zeromq.org/
+Website: https://www.zeromq.org
 Platforms supported: ""Win32"", Linux
 Headers to include: zmq/zmq.bi
 Header version: 2.1.10
diff --git a/doc/manual/cache/ExtLibZip.wakka b/doc/manual/cache/ExtLibZip.wakka
@@ -1,7 +1,8 @@
 {{fbdoc item="title" value="libzip"}}----
 Easy-to-use library for creating, reading out or modifying .zip archives.
 
-Website: http://www.nih.at/libzip/
+Website: https://libzip.org
+Github: https://github.com/nih-at/libzip
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: zip.bi
 Header version: 0.11.2
diff --git a/doc/manual/cache/ExtLibbigint.wakka b/doc/manual/cache/ExtLibbigint.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="big_int"}}----
 Library for using arbitrarily large integers. Note: This library seems to be dead, a possible alternative is [[ExtLibgmp|gmp]].
 
-Website: http://valyala.narod.ru/big_int/ (Russian) [the site apparently is gone]
+Website: [[https://web.archive.org/web/20060112164857/http://valyala.narod.ru/big_int/ http://valyala.narod.ru/big_int/]] (archived copy)
 Github: https://github.com/valyala/big_int
 Platforms supported: ""Win32"", Linux
 Headers to include: big_int/big_int.bi
diff --git a/doc/manual/cache/ExtLibcurl.wakka b/doc/manual/cache/ExtLibcurl.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="curl"}}----
 Free and easy-to-use client-side URL transfer library supporting almost every protocol.
 
-Website: http://curl.haxx.se/libcurl/
+Website: https://curl.haxx.se/libcurl/
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: curl.bi
 Header version: 7.44.0
diff --git a/doc/manual/cache/ExtLibexpat.wakka b/doc/manual/cache/ExtLibexpat.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="Expat"}}----
 Stream oriented XML parser library with several useful features.
 
-Website: http://expat.sourceforge.net/
+Website: https://libexpat.github.io
 Platforms supported: ""Win32"", Linux
 Headers to include: expat.bi
 Header version: 1.95.8
diff --git a/doc/manual/cache/ExtLibfmod.wakka b/doc/manual/cache/ExtLibfmod.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="FMOD"}}----
 Audio library supporting just about any format.
 
-Website: http://www.fmod.org/index.php/products#FMOD3ProgrammersAPI
+Website: https://www.fmod.com/core
 Platforms supported: ""Win32"", Linux
 Headers to include: fmod.bi
 Header version: 3.75
diff --git a/doc/manual/cache/ExtLibgdsl.wakka b/doc/manual/cache/ExtLibgdsl.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="GDSL, The Generic Data Structures Library"}}----
 The Generic Data Structures Library is a collection of routines for generic data structures.
 
-Website: http://home.gna.org/gdsl/
+Website: [[https://web.archive.org/web/20170502005430/http://home.gna.org:80/gdsl/ http://home.gna.org/gdsl/]] (archived copy)
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: gdsl/gdsl.bi
 Header version: from 2005
diff --git a/doc/manual/cache/ExtLibgmp.wakka b/doc/manual/cache/ExtLibgmp.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="gmp, The GNU Multiple Precision Arithmetic Library"}}----
 Free library for arbitrary precision arithmetic, operating on signed integers, rational numbers, and floating point numbers.
 
-Website: http://www.gmplib.org
+Website: https://www.gmplib.org
 Platforms supported: ""Win32"", Linux
 Headers to include: gmp.bi
 Header version: 4.1.4
diff --git a/doc/manual/cache/ExtLibgsl.wakka b/doc/manual/cache/ExtLibgsl.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="gsl, The GNU Scientific Library"}}----
 Provides a wide range of mathematical routines such as random number generators, special functions and least-squares fitting.
 
-Website: http://www.gnu.org/software/gsl/, Windows port: http://gnuwin32.sourceforge.net/packages/gsl.htm 
+Website: https://www.gnu.org/software/gsl/, Windows port: http://gnuwin32.sourceforge.net/packages/gsl.htm 
 Platforms supported: ""Win32"", Linux
 Headers to include: gsl/*.bi
 Header version: 1.6
diff --git a/doc/manual/cache/ExtLibjsonc.wakka b/doc/manual/cache/ExtLibjsonc.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="json-c"}}----
 A JSON implementation in C
 
-Website: http://oss.metaparadigm.com/json-c/
+Website: https://github.com/json-c/json-c
 Platforms supported: ""Win32"", Linux
 Headers to include: json-c/json.bi
 Header version: 0.9 (not sure)
diff --git a/doc/manual/cache/ExtLibmxml.wakka b/doc/manual/cache/ExtLibmxml.wakka
@@ -1,7 +1,8 @@
 {{fbdoc item="title" value="mxml, Mini-XML"}}----
 Mini-XML is a small XML parsing library that you can use to read XML and XML-like data files in your application without requiring large non-standard libraries.
 
-Website: http://www.minixml.org/
+Website: https://www.msweet.org/mxml/
+Github: https://github.com/michaelrsweet/mxml
 Platforms supported: ""Win32"", Linux
 Headers to include: mxml.bi
 Header version: 2.7
diff --git a/doc/manual/cache/ExtLibnewton.wakka b/doc/manual/cache/ExtLibnewton.wakka
@@ -2,6 +2,7 @@
 The Newton Physics Engine is an integrated solution for real time simulation of physics environments. 
 
 Website: http://newtondynamics.com/
+Github: https://github.com/MADEAPPS/newton-dynamics/
 Platforms supported: ""Win32"", Linux
 Headers to include: Newton.bi
 Header version: from 2005
diff --git a/doc/manual/cache/ExtLibpcre.wakka b/doc/manual/cache/ExtLibpcre.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="PCRE, Perl Compatible Regular Expressions"}}----
 Consists of a set of functions that implement regular expression pattern matching using the same syntax and semantics as Perl 5.
 
-Website: http://www.pcre.org
+Website: https://www.pcre.org
 Platforms supported: ""Win32"", Linux
 Headers to include: pcre.bi, pcre16.bi, prceposix.bi
 Version: 8.31
diff --git a/doc/manual/cache/ExtLibquicklz.wakka b/doc/manual/cache/ExtLibquicklz.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="QuickLZ"}}----
 Cross-platform fast compression library
 
-Website: http://www.quicklz.com
+Website: https://www.quicklz.com
 Platforms supported: ""Win32"", Linux, DOS
 Headers to include: quicklz.bi
 Header version: 1.5.0
diff --git a/doc/manual/cache/ExtLibspidermonkey.wakka b/doc/manual/cache/ExtLibspidermonkey.wakka
@@ -1,7 +1,7 @@
 {{fbdoc item="title" value="SpiderMonkey"}}----
 Embeddable javascript engine.
 
-Website: http://www.mozilla.org/js/spidermonkey/
+Website: https://developer.mozilla.org/en-US/docs/Mozilla/Projects/SpiderMonkey
 Platforms supported: ""Win32"", Linux
 Headers to include: spidermonkey/jsapi.bi
 Header version: from 2006
diff --git a/doc/manual/cache/ExtLibtre.wakka b/doc/manual/cache/ExtLibtre.wakka
@@ -1,7 +1,8 @@
 {{fbdoc item="title" value="TRE (regex matching library)"}}----
 Lightweight, robust, and efficient POSIX compliant regexp matching library
 
-Website: http://laurikari.net/tre/
+Website: https://laurikari.net/tre/
+Github: https://github.com/laurikari/tre/
 Platforms supported: ""Win32"", Linux
 Headers to include: tre/tre.bi, tre/regex.bi
 Header version: 0.8.0
diff --git a/doc/manual/cache/KeyPgFreefile.wakka b/doc/manual/cache/KeyPgFreefile.wakka
@@ -15,7 +15,9 @@ Returns a free file number
 	
 	Make sure to always close files when no longer needed, otherwise you will get a file number leak, and won't be able to open any files anymore after 255 filenumbers are exhausted while your program is running.
 	
-	##**Freefile**## will always return the smallest free file number.  The file number returned by ##**Freefile**## will not change until that file number is ##[[KeyPgOpen|Open]]##ed, or until a smaller file number is ##[[KeyPgClose|Close]]##d.  For this reason, it is wise to use ##**Freefile**## immediately before its corresponding ##[[KeyPgOpen|Open]]##, to ensure that the file number is not returned and opened elsewhere first.
+	##**Freefile**## will always return the smallest free file number. The file number returned by ##**Freefile**## will not change until that file number is ##[[KeyPgOpen|Open]]##ed, or until a smaller file number is ##[[KeyPgClose|Close]]##d:
+		**""-""** For this reason, it is wise to use ##**Freefile**## immediately before its corresponding ##[[KeyPgOpen|Open]]##, to ensure that the same file number is not returned and opened elsewhere first.
+		**""-""** In case of potential conflict with other threads, this non-breaking '##**Freefile**...[[KeyPgOpen|Open]]##' sequence must additionally be considered as a critical section of code and therefore must be protected by mutual exclusion (using a mutex locking).
 
 {{fbdoc item="ex"}}
 {{fbdoc item="filename" value="examples/manual/fileio/freefile.bas"}}%%(freebasic)
