From b6705f2880b0993d285451da415136c702460b52 Mon Sep 17 00:00:00 2001 From: Fellippe Heitor Date: Sun, 25 Apr 2021 19:40:25 -0300 Subject: [PATCH] Updates help files. --- internal/help/$ASSERTS.txt | 4 +- internal/help/$CONSOLE.txt | 9 +-- internal/help/$LET.txt | 2 +- internal/help/$NOPREFIX.txt | 4 +- internal/help/$RESIZE.txt | 4 +- internal/help/$VERSIONINFO.txt | 4 +- internal/help/%2F.txt | 7 +-- internal/help/-.txt | 7 +-- internal/help/.txt | 7 +-- internal/help/ATN.txt | 58 +++++++++---------- internal/help/COLOR.txt | 2 + internal/help/Cavemen.txt | 2 +- internal/help/DECLARE_DYNAMIC_LIBRARY.txt | 9 ++- internal/help/EXIT.txt | 4 +- internal/help/INSTR.txt | 2 + .../help/Keyword_Reference_-_Alphabetical.txt | 32 +++++----- ...ywords_currently_not_supported_by_QB64.txt | 2 +- internal/help/LCASE$.txt | 2 +- internal/help/LET.txt | 5 +- internal/help/LOG.txt | 20 +++---- internal/help/MID$_(statement).txt | 22 +++---- internal/help/MOD.txt | 2 +- internal/help/PRINT_USING.txt | 31 +++++----- internal/help/SQR.txt | 40 +++++++------ internal/help/UCASE$.txt | 2 +- internal/help/Underscore.txt | 6 +- internal/help/VAL.txt | 18 +++--- internal/help/Variable.txt | 12 ++-- internal/help/^.txt | 13 ++--- internal/help/_ACCEPTFILEDROP.txt | 4 +- internal/help/_ACOS.txt | 4 +- internal/help/_ALLOWFULLSCREEN.txt | 4 +- internal/help/_ASIN.txt | 4 +- internal/help/_ASINH.txt | 2 +- internal/help/_ASSERT.txt | 4 +- internal/help/_AUTODISPLAY_(function).txt | 4 +- internal/help/_BLINK.txt | 4 +- internal/help/_BLINK_(function).txt | 4 +- internal/help/_CAPSLOCK.txt | 2 +- internal/help/_CAPSLOCK_(function).txt | 2 +- internal/help/_CEIL.txt | 4 +- internal/help/_CLIPBOARDIMAGE.txt | 4 +- internal/help/_CLIPBOARDIMAGE_(function).txt | 4 +- internal/help/_CONSOLEINPUT.txt | 1 + internal/help/_CONSOLETITLE.txt | 8 +-- internal/help/_CONTINUE.txt | 4 +- internal/help/_D2G.txt | 4 +- internal/help/_D2R.txt | 4 +- internal/help/_DEFLATE$.txt | 4 +- internal/help/_DELAY.txt | 9 ++- internal/help/_DESKTOPHEIGHT.txt | 4 +- internal/help/_DESKTOPWIDTH.txt | 4 +- internal/help/_DISPLAYORDER.txt | 4 +- internal/help/_DROPPEDFILE.txt | 4 +- internal/help/_ECHO.txt | 4 +- internal/help/_FINISHDROP.txt | 4 +- internal/help/_FONT_(function).txt | 4 +- internal/help/_G2D.txt | 4 +- internal/help/_G2R.txt | 4 +- internal/help/_INCLERRORFILE$.txt | 4 +- internal/help/_INCLERRORLINE.txt | 4 +- internal/help/_INFLATE$.txt | 4 +- internal/help/_MEMSOUND.txt | 2 +- internal/help/_MOUSEMOVE.txt | 6 +- internal/help/_NUMLOCK.txt | 2 +- internal/help/_NUMLOCK_(function).txt | 2 +- internal/help/_R2D.txt | 4 +- internal/help/_R2G.txt | 4 +- internal/help/_READBIT.txt | 4 +- internal/help/_RESETBIT.txt | 4 +- internal/help/_RESIZEHEIGHT.txt | 4 +- internal/help/_RESIZEWIDTH.txt | 4 +- internal/help/_RESIZE_(function).txt | 4 +- internal/help/_RGB32.txt | 4 +- internal/help/_SCREENEXISTS.txt | 2 +- internal/help/_SCREENICON.txt | 4 +- internal/help/_SCROLLLOCK.txt | 2 +- internal/help/_SCROLLLOCK_(function).txt | 2 +- internal/help/_SETBIT.txt | 4 +- internal/help/_SHL.txt | 4 +- internal/help/_SHR.txt | 4 +- internal/help/_SNDRAWDONE.txt | 4 +- internal/help/_STARTDIR$.txt | 4 +- internal/help/_TITLE$.txt | 8 +-- internal/help/_TITLE.txt | 49 ++++++++-------- internal/help/_TOGGLEBIT.txt | 4 +- internal/help/_TOTALDROPPEDFILES.txt | 4 +- internal/help/_WINDOWHANDLE.txt | 4 +- internal/help/_WINDOWHASFOCUS.txt | 4 +- 89 files changed, 308 insertions(+), 303 deletions(-) diff --git a/internal/help/$ASSERTS.txt b/internal/help/$ASSERTS.txt index 89546426b..f42ba38cf 100644 --- a/internal/help/$ASSERTS.txt +++ b/internal/help/$ASSERTS.txt @@ -10,8 +10,8 @@ The [[$ASSERTS]] metacommand enables debug tests with the [[_ASSERT]] macro. * If an error message is passed to the [[_ASSERT]] statement, it is displayed in the console window if [[$ASSERTS|$ASSERTS:CONSOLE]] is used. -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/$CONSOLE.txt b/internal/help/$CONSOLE.txt index 1bcfa38c8..104a0bf7e 100644 --- a/internal/help/$CONSOLE.txt +++ b/internal/help/$CONSOLE.txt @@ -1,19 +1,20 @@ -The [[$CONSOLE]] [[Metacommand]] creates a console window that can be used throughout a QB64 program module. +The [[$CONSOLE]] [[metacommand]] creates a console window that can be used throughout a QB64 program module. {{PageSyntax}} : [[$CONSOLE]][:ONLY] +{{Description}} * [[_CONSOLE]] '''ON''' or '''OFF''' may be used to show or hide the console window at run time. * The ''':ONLY''' option can be used when only a console window is desired without a program window. * [[_DEST]] [[_CONSOLE]] may be used to send screen output to the console window. * [[_SCREENHIDE]] and [[_SCREENSHOW]] can be used to hide or show the main program window. * [[_DELAY]] or [[SLEEP]] can be used to allow the console window to be set in front of the main program window. -* '''QB64 [[Metacommand]]s are not commented out with ' or REM, differently from QBasic metacommands''' -* Change the title of the [[$CONSOLE]] windows created using [[_CONSOLETITLE]] +* [[_CONSOLETITLE]] can be used to change the title of the console window. * '''Note:''' Text can be copied partially or totally from console screens in Windows by highlighting and using the title bar menu. -:: To copy console text output, right click the title bar and select ''Edit'' for ''Mark'' to highlight and repeat to ''Copy'' +:: To copy console text output, right click the title bar and select ''Edit'' for ''Mark'' to highlight and repeat to ''Copy'' +* QB64 [[Metacommand]]s are not commented out with ' or REM, differently from QBasic metacommands. {{PageExamples}} diff --git a/internal/help/$LET.txt b/internal/help/$LET.txt index 467b909ff..fad68affa 100644 --- a/internal/help/$LET.txt +++ b/internal/help/$LET.txt @@ -1,4 +1,4 @@ -[[$LET]] is precompiler command, which is now usable by modern day [[cavemen]] to help include and exclude which sections of code compiles in their program based on OS/bit-size or other predefined conditions. +[[$LET]] is a precompiler command, which is now usable by modern day [[cavemen]] to help include and exclude which sections of code compiles in their program based on OS/bit-size or other predefined conditions. {{PageSyntax}} diff --git a/internal/help/$NOPREFIX.txt b/internal/help/$NOPREFIX.txt index c61608c72..064fb6896 100644 --- a/internal/help/$NOPREFIX.txt +++ b/internal/help/$NOPREFIX.txt @@ -14,8 +14,8 @@ The [[$NOPREFIX]] metacommand allows all QB64 functions and statements to be use * [[$NOPREFIX]] must be the first non-comment and non-whitespace line in a program. -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageSeeAlso}} diff --git a/internal/help/$RESIZE.txt b/internal/help/$RESIZE.txt index 402ce497f..216446881 100644 --- a/internal/help/$RESIZE.txt +++ b/internal/help/$RESIZE.txt @@ -12,8 +12,8 @@ The [[$RESIZE]] [[Metacommand|metacommand]] determines if a program window can b * $RESIZE:SMOOTH the screen will be stretched also, but with linear filtering applied to the pixels. -==Availability== -* '''Version 1.000 and up'''. +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/$VERSIONINFO.txt b/internal/help/$VERSIONINFO.txt index b7552a370..fc520484b 100644 --- a/internal/help/$VERSIONINFO.txt +++ b/internal/help/$VERSIONINFO.txt @@ -17,8 +17,8 @@ The [[$VERSIONINFO]] [[Metacommand|metacommand]] adds text metadata to the resul * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. -==Availability== -* '''Build 20170429/52 and up'''. +{{PageAvailability}} +* Build 20170429/52 and up. {{PageExamples}} diff --git a/internal/help/%2F.txt b/internal/help/%2F.txt index d01c583b9..0a562e118 100644 --- a/internal/help/%2F.txt +++ b/internal/help/%2F.txt @@ -1,14 +1,11 @@ -The '''/''' mathematical operator performs decimal point division on a numerical value. - +The [[/]] mathematical operator performs decimal point division on a numerical value. {{PageSyntax}} -::: return_value = number '''/''' divisor - +:return_value = number [[/]] divisor {{PageDescription}} - * Number value can be any literal or variable numerical type. * Return values can be any literal or variable numerical type, but [[SINGLE]] or [[DOUBLE]] type decimal point returns are likely. * Values returned may be expressed using exponential or [[scientific notation]] using '''E''' for SINGLE or '''D''' for DOUBLE precision. diff --git a/internal/help/-.txt b/internal/help/-.txt index e84e1bd1e..38ac92435 100644 --- a/internal/help/-.txt +++ b/internal/help/-.txt @@ -1,13 +1,11 @@ -The '''-''' mathematical operator performs subtraction on two numerical values or [[negation|negates]] a single value. +The [[-]] mathematical operator performs subtraction on two numerical values or [[negation|negates]] a single value. {{PageSyntax}} - -return_value = number1 - number2 +:return_value = number1 [[-]] number2 {{PageDescription}} - * Numbers used can be any literal or variable numerical value type. * Subtracting a negative value will actually perform addition with the other value. * Subtracting a negative or [[negation|negated]] value will make the return value more positive. @@ -16,7 +14,6 @@ return_value = number1 - number2 {{PageSeeAlso}} - * [[+|+ positive]] (addition operator) * [[Mathematical Operations]] diff --git a/internal/help/.txt b/internal/help/.txt index cd6a01241..0e69fe2bf 100644 --- a/internal/help/.txt +++ b/internal/help/.txt @@ -1,14 +1,11 @@ -The '''\''' mathematical operator performs [[INTEGER]] division on a numerical value. - +The [[\]] mathematical operator performs [[INTEGER]] division on a numerical value. {{PageSyntax}} -::: return_value = number '''\''' divisor - +:return_value = number [[\]] divisor {{PageDescription}} - * Number value can be any literal or variable numerical type. * '''Divisor (second value) must not be a value of 0 to .5'''. This will create a [[ERROR Codes|"Division by zero" error!]] due to [[CINT]] rounding. * Return values will be [[INTEGER]] or [[LONG]] value types only. diff --git a/internal/help/ATN.txt b/internal/help/ATN.txt index b4421e0fd..a299716e3 100644 --- a/internal/help/ATN.txt +++ b/internal/help/ATN.txt @@ -30,7 +30,7 @@ y = 100 * {{Cl|SIN}}({{Cl|ATN}}(1)) {{CodeStart}} '' '' Pi = 4 * {{Cl|ATN}}(1) '{{Cl|SINGLE}} precision Pi# = 4 * {{Cl|ATN}}(1#) '{{Cl|DOUBLE}} precision -PRINT Pi, Pi# '' '' +{{Cl|PRINT}} Pi, Pi# '' '' {{CodeEnd}} :''Note:'' You can use QB64's native [[_PI]] function. @@ -41,38 +41,38 @@ PRINT Pi, Pi# '' '' x1! = 320 y1! = 240 -DO - {{Cl|PRESET}} (x1!, y1!), {{Cl|_RGB}}(255, 255, 255) - dummy% = {{Cl|_MOUSEINPUT}} - x2! = {{Cl|_MOUSEX}} - y2! = {{Cl|_MOUSEY}} - {{Cl|LINE}} (x1, y1)-(x2, y2), {{Cl|_RGB}}(255, 0, 0) - {{Cl|LOCATE}} 1, 1: {{Cl|PRINT}} getangle(x1!, y1!, x2!, y2!) - {{Cl|_DISPLAY}} - {{Cl|_LIMIT}} 200 - {{Cl|CLS}} +{{Cl|DO}} + {{Cl|PRESET}} (x1!, y1!), {{Cl|_RGB}}(255, 255, 255) + dummy% = {{Cl|_MOUSEINPUT}} + x2! = {{Cl|_MOUSEX}} + y2! = {{Cl|_MOUSEY}} + {{Cl|LINE}} (x1, y1)-(x2, y2), {{Cl|_RGB}}(255, 0, 0) + {{Cl|LOCATE}} 1, 1: {{Cl|PRINT}} getangle(x1!, y1!, x2!, y2!) + {{Cl|_DISPLAY}} + {{Cl|_LIMIT}} 200 + {{Cl|CLS}} {{Cl|LOOP}} {{Cl|UNTIL}} {{Cl|INKEY$}} <> "" {{Cl|END}} {{Cl|FUNCTION}} getangle# (x1#, y1#, x2#, y2#) 'returns 0-359.99... -{{Cl|IF...THEN|IF}} y2# = y1# {{Cl|THEN}} - {{Cl|IF...THEN|IF}} x1# = x2# {{Cl|THEN}} {{Cl|EXIT FUNCTION}} - {{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}} getangle# = 90 {{Cl|ELSE}} getangle# = 270 - {{Cl|EXIT FUNCTION}} -{{Cl|END IF}} -{{Cl|IF...THEN|IF}} x2# = x1# {{Cl|THEN}} - {{Cl|IF...THEN|IF}} y2# > y1# {{Cl|THEN}} getangle# = 180 - {{Cl|EXIT FUNCTION}} -{{Cl|END IF}} -{{Cl|IF...THEN|IF}} y2# < y1# {{Cl|THEN}} - {{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}} - getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 - {{Cl|ELSE}} - getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 360 - {{Cl|END IF}} -{{Cl|ELSE}} - getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 180 -{{Cl|END IF}} + {{Cl|IF...THEN|IF}} y2# = y1# {{Cl|THEN}} + {{Cl|IF...THEN|IF}} x1# = x2# {{Cl|THEN}} {{Cl|EXIT FUNCTION}} + {{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}} getangle# = 90 {{Cl|ELSE}} getangle# = 270 + {{Cl|EXIT FUNCTION}} + {{Cl|END IF}} + {{Cl|IF...THEN|IF}} x2# = x1# {{Cl|THEN}} + {{Cl|IF...THEN|IF}} y2# > y1# {{Cl|THEN}} getangle# = 180 + {{Cl|EXIT FUNCTION}} + {{Cl|END IF}} + {{Cl|IF...THEN|IF}} y2# < y1# {{Cl|THEN}} + {{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}} + getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + {{Cl|ELSE}} + getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 360 + {{Cl|END IF}} + {{Cl|ELSE}} + getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 180 + {{Cl|END IF}} {{Cl|END FUNCTION}} '' '' {{CodeEnd}}{{small|Function by Galleon}} diff --git a/internal/help/COLOR.txt b/internal/help/COLOR.txt index 43ceb520d..e61b64c4b 100644 --- a/internal/help/COLOR.txt +++ b/internal/help/COLOR.txt @@ -10,6 +10,8 @@ The [[COLOR]] statement is used to change the foreground and background colors f * To change the {{Parameter|background&}} color only, use a comma and the desired color. Ex: [[COLOR]] , {{Parameter|background&}} * Graphic drawing statements like [[PSET]], [[PRESET]], [[LINE]], etc, also use the colors set by the [[COLOR]] statement if no color is passed when they are called. * The [[$COLOR]] metacommand adds named color constants for both text and 32-bit modes. +* [[COLOR]] works when outputting text to [[$CONSOLE]]. +** On macOS, colors in console mode will not match the VGA palette. See [https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit 8-bit ANSI colors] ==Screen Mode Attributes== diff --git a/internal/help/Cavemen.txt b/internal/help/Cavemen.txt index 2bb901d03..cb3893926 100644 --- a/internal/help/Cavemen.txt +++ b/internal/help/Cavemen.txt @@ -7,7 +7,7 @@ * Why are you here? Did you look up '''LET'''? Too bad! Tell your teacher to actually teach you something! -''See also:'' +{{PageSeeAlso}} * [[LET]] there be light! * [[LET|Allow me to go back]] diff --git a/internal/help/DECLARE_DYNAMIC_LIBRARY.txt b/internal/help/DECLARE_DYNAMIC_LIBRARY.txt index 168b5a363..f58b715a9 100644 --- a/internal/help/DECLARE_DYNAMIC_LIBRARY.txt +++ b/internal/help/DECLARE_DYNAMIC_LIBRARY.txt @@ -18,7 +18,7 @@ * ''Procedure_name'' is any procedure name you want to designate by using [[ALIAS]] with the ''Library_procedure'' name following. * ''Parameters'' used by the Library procedure must be passed by value ([[BYVAL]]) except for [[STRING]] values. * '''''.h'' header files cannot be used with DECLARE DYNAMIC LIBRARY. Existence of any ''.h'' file of the same name as the ''.DLL'' file will cause DECLARE DYNAMIC LIBRARY to fail.''' -* '''IMPORTANT:''' [[DECLARE DYNAMIC LIBRARY]] let's you specify any SUB/FUNCTION calling format you wish, but '''if the size of the parameters does not match, the size expected within the library your code will probably cause a GPF (General Protection Fault).''' It is important to understand that you are creating a 32-bit program (even under 64-bit Windows) so '''pointers (if required) will be 32-bits in size, the equivalent of a [[LONG]].''' +* '''IMPORTANT:''' [[DECLARE DYNAMIC LIBRARY]] let's you specify any SUB/FUNCTION calling with the format you wish, but '''if the size of the parameter list does not match the size expected within the library, then your code will probably cause a GPF (General Protection Fault). * '''STATIC''' is the same as [[DECLARE LIBRARY]] except that it prioritizes linking to static libraries (*.a/*.o) over shared object (*.so) libraries, if both exist. As Windows doesn't really use shared libraries (DLLs are a bit different) this does not affect Windows users. * The [[_OFFSET]] in memory can be used in '''CUSTOMTYPE''', '''STATIC''' and '''DYNAMIC LIBRARY''' declarations. * [[SUB]] procedures using DECLARE CUSTOMTYPE LIBRARY API procedures '''may error'''. Try DYNAMIC with the DLL name. @@ -26,10 +26,9 @@ * '''NOTE: It is up to the user to document and determine the suitability of all Libraries and procedures they choose to use. QB64 cannot guarantee that any procedure will work and cannot quarantee any troubleshooting help.''' -==Availability== -* '''Version 0.923 and up (Windows)''' -* '''Version 0.94 and up (Linux and macOS)''' - +{{PageAvailability}} +* Version 0.923 and up (Windows). +* Version 0.94 and up (Linux and macOS). {{PageExamples}} diff --git a/internal/help/EXIT.txt b/internal/help/EXIT.txt index e9d1b1944..67d05e73c 100644 --- a/internal/help/EXIT.txt +++ b/internal/help/EXIT.txt @@ -19,8 +19,8 @@ The [[EXIT]] statement is used to exit certain QBasic procedures. * To exit the program immediately, use [[SYSTEM]]. -== Availability == -* '''EXIT SELECT/CASE''' available with v1.5. +{{PageAvailability}} +* '''EXIT SELECT/CASE''' available with version 1.5. * All other variants available in all versions of QB64. diff --git a/internal/help/INSTR.txt b/internal/help/INSTR.txt index 7157546ec..16ca10d21 100644 --- a/internal/help/INSTR.txt +++ b/internal/help/INSTR.txt @@ -19,6 +19,7 @@ The [[INSTR]] function searches for the first occurence of a search [[STRING]] w * The {{Parameter|searchString$}} should be smaller or equal in [[LEN|length]] to the {{Parameter|baseString$}}, or 0 is returned. * Non-zero {{Parameter|position%}} return values can be used as a new start position by adding 1 to re-search the base string. See the example below. * In a loop, INSTR can search an entire file for occurences of certain words. See the [[MID$ (statement)|MID$]] statement example. +* To search right to left, use [[_INSTRREV]] {{PageQBasic}} @@ -49,6 +50,7 @@ There is 'cats' in the string at position: 62 * [[LEFT$]], [[RIGHT$]] * [[LCASE$]], [[UCASE$]] * [[STRING]], [[INTEGER]] +* [[_INSTRREV]] {{PageNavigation}} diff --git a/internal/help/Keyword_Reference_-_Alphabetical.txt b/internal/help/Keyword_Reference_-_Alphabetical.txt index 89faa2a50..c19af8b46 100644 --- a/internal/help/Keyword_Reference_-_Alphabetical.txt +++ b/internal/help/Keyword_Reference_-_Alphabetical.txt @@ -30,19 +30,19 @@ __NOTOC__ <div id = "uA">_A</div> * [[_ACCEPTFILEDROP]] (statement) {{text|turns a program window into a valid drop destination for dragging files from Windows Explorer.}} * [[_ACOS]] (function) {{text|arccosine function returns the angle in radians based on an input [[COS]]ine value range from -1 to 1.}} -* [[_ACOSH]] (function) {{text|Returns the nonnegative arc hyperbolic cosine of x, expressed in radians.}} +* [[_ACOSH]] (function) {{text|returns the nonnegative arc hyperbolic cosine of x, expressed in radians.}} * [[_ALLOWFULLSCREEN]] (statement) {{text|allows setting the behavior of the ALT+ENTER combo.}} * [[_ALPHA]] (function) {{text|returns the alpha channel transparency level of a color value used on a screen page or image.}} * [[_ALPHA32]] (function) {{text|returns the alpha channel transparency level of a color value used on a 32 bit screen page or image.}} * [[Mathematical_Operations|_ARCCOT]] (function) {{text|is the inverse function of the cotangent. . http://mathworld.wolfram.com/InverseCosecant.html}} * [[Mathematical_Operations|_ARCCSC]] (function) {{text|is the inverse function of the cosecant. http://mathworld.wolfram.com/InverseCosecant.html}} * [[Mathematical_Operations|_ARCSEC]] (function) {{text|is the inverse function of the secant. http://mathworld.wolfram.com/InverseSecant.html}} -* [[_ASIN]] (function) {{text|Returns the principal value of the arc sine of x, expressed in radians.}} -* [[_ASINH]] (function) {{text|Returns the arc hyperbolic sine of x, expressed in radians.}} -* [[_ASSERT]] (statement) {{text|Performs debug tests.}} -* [[$ASSERTS]] ([[metacommand]]) {{text|Enables the [[_ASSERT]] macro}} -* [[_ATAN2]] (function) {{text|Returns the principal value of the [[ATN|arc tangent]] of y/x, expressed in radians.}} -* [[_ATANH]] (function) {{text|Returns the arc hyperbolic tangent of x, expressed in radians.}} +* [[_ASIN]] (function) {{text|returns the principal value of the arc sine of x, expressed in radians.}} +* [[_ASINH]] (function) {{text|returns the arc hyperbolic sine of x, expressed in radians.}} +* [[_ASSERT]] (statement) {{text|performs debug tests.}} +* [[$ASSERTS]] ([[metacommand]]) {{text|enables the [[_ASSERT]] macro}} +* [[_ATAN2]] (function) {{text|returns the principal value of the [[ATN|arc tangent]] of y/x, expressed in radians.}} +* [[_ATANH]] (function) {{text|returns the arc hyperbolic tangent of x, expressed in radians.}} * [[_AUTODISPLAY]] (statement) {{text|enables the automatic display of the screen image changes previously disabled by [[_DISPLAY]].}} * [[_AUTODISPLAY (function)]] {{text|returns the current display mode as true (-1) if automatic or false (0) if per request using [[_DISPLAY]].}} * [[_AXIS]] (function) {{text|returns a [[SINGLE]] value between -1 and 1 indicating the maximum distance from the device axis center, 0.}} @@ -72,8 +72,8 @@ __NOTOC__ * [[_CAPSLOCK (function)]] {{text|returns -1 when Caps Lock is on}} * [[_CAPSLOCK]] (statement) {{text|sets Caps Lock key state}} * [[$CHECKING]] ([[metacommand]]) {{text|turns event error checking OFF or ON.}} -* [[_CEIL]] (function) {{text|Rounds x upward, returning the smallest integral value that is not less than x.}} -* [[_CINP]] (function) {{text|Returns a key code from $CONSOLE input}} +* [[_CEIL]] (function) {{text|rounds x upward, returning the smallest integral value that is not less than x.}} +* [[_CINP]] (function) {{text|returns a key code from $CONSOLE input}} * [[_CLEARCOLOR (function)]] {{text|returns the current transparent color of an image.}} * [[_CLEARCOLOR]] (statement) {{text|sets a specific color index of an image to be transparent}} * [[_CLIP]] ([[PUT (graphics statement)|PUT]] graphics option) {{text|allows placement of an image partially off of the screen.}} @@ -95,10 +95,10 @@ __NOTOC__ * [[_COPYIMAGE]] (function) {{text|copies an image handle value to a new designated handle.}} * [[_COPYPALETTE]] (statement) {{text|copies the color palette intensities from one 4 or 8 BPP image to another image.}} * [[Mathematical_Operations|_COT]] (function) {{text| the mathematical function cotangent defined by 1/TAN. http://mathworld.wolfram.com/Cotangent.html}} -* [[Mathematical_Operations|_COTH]] (function) {{text|Returns the hyperbolic cotangent. http://mathworld.wolfram.com/HyperbolicCotangent.html}} -* [[Mathematical_Operations|_COSH]] (function) {{text|Returns the hyperbolic cosine of x radians. http://mathworld.wolfram.com/HyperbolicCosine.html}} +* [[Mathematical_Operations|_COTH]] (function) {{text|returns the hyperbolic cotangent. http://mathworld.wolfram.com/HyperbolicCotangent.html}} +* [[Mathematical_Operations|_COSH]] (function) {{text|returns the hyperbolic cosine of x radians. http://mathworld.wolfram.com/HyperbolicCosine.html}} * [[Mathematical_Operations|_CSC]] (function) {{text| the mathematical function cosecant defined by 1/SIN. http://mathworld.wolfram.com/Cosecant.html}} -* [[Mathematical_Operations|_CSCH]] (function) {{text|Returns the hyperbolic cosecant. http://mathworld.wolfram.com/HyperbolicCosecant.html}} +* [[Mathematical_Operations|_CSCH]] (function) {{text|returns the hyperbolic cosecant. http://mathworld.wolfram.com/HyperbolicCosecant.html}} * [[_CV]] (function) {{text|converts any [[_MK$]] [[STRING]] value to the designated numerical type value.}} * [[_CWD$]] (function) {{text|returns the current working directory as a [[STRING]] value.}} @@ -184,7 +184,7 @@ __NOTOC__ <div id = "uH">_H</div> * [[_HEIGHT]] (function) {{text|returns the height of a designated image handle.}} * [[_HIDE]] ([[SHELL]] action) {{text| hides the command line display during a shell.}} -* [[_HYPOT]] (function) {{text|Returns the hypotenuse of a right-angled triangle whose legs are x and y.}} +* [[_HYPOT]] (function) {{text|returns the hypotenuse of a right-angled triangle whose legs are x and y.}} ---- @@ -330,7 +330,7 @@ __NOTOC__ <div id = "uS">_S</div> * [[Mathematical_Operations#Derived_Mathematical_Functions|_SEC]] (function) {{text| the mathematical function secant defined by 1/COS. http://mathworld.wolfram.com/Secant.html}} -* [[Mathematical_Operations#Derived_Mathematical_Functions|_SECH]] (function) {{text|Returns the hyperbolic secant. http://mathworld.wolfram.com/HyperbolicSecant.html}} +* [[Mathematical_Operations#Derived_Mathematical_Functions|_SECH]] (function) {{text|returns the hyperbolic secant. http://mathworld.wolfram.com/HyperbolicSecant.html}} * [[_SCREENCLICK]] (statement) {{text|simulates clicking on a point on the desktop screen with the left mouse button.}} * [[_SCREENEXISTS]] (function) {{text|returns a -1 value once a screen has been created.}} * [[$SCREENHIDE]] ([[metacommand]]) {{text|hides the program window from view.}} @@ -352,7 +352,7 @@ __NOTOC__ * [[_SHELLHIDE]] (function) {{text|returns the code sent by a program exit using [[END]] or [[SYSTEM]] followed by an [[INTEGER]] value.}} * [[_SHL]] (function) {{text|used to shift the bits of a numerical value to the left}} * [[_SHR]] (function) {{text|used to shift the bits of a numerical value to the right.}} -* [[Mathematical_Operations|_SINH]] (function) {{text|Returns the hyperbolic sine of x radians.}} +* [[Mathematical_Operations|_SINH]] (function) {{text|returns the hyperbolic sine of x radians.}} * [[_SNDBAL]] (statement) {{text|attempts to set the balance or 3D position of a sound file.}} * [[_SNDCLOSE]] (statement) {{text|frees and unloads an open sound using the sound handle created by [[_SNDOPEN]].}} * [[_SNDCOPY]] (function) {{text|copies a sound handle value to a new designated handle.}} @@ -388,7 +388,7 @@ __NOTOC__ <div id = "uT">_T</div> -* [[Mathematical_Operations|_TANH]] (function) {{text|Returns the hyperbolic tangent of x radians.}} +* [[Mathematical_Operations|_TANH]] (function) {{text|returns the hyperbolic tangent of x radians.}} * [[_TITLE]] (statement) {{text|sets the program title [[STRING|string]] value.}} * [[_TITLE$]] (function) {{text|gets the program title [[STRING|string]] value.}} * [[_TOGGLEBIT]] (function) {{text|is used to toggle the specified bit of an integer variable from 1 to 0 or 0 to 1.}} diff --git a/internal/help/Keywords_currently_not_supported_by_QB64.txt b/internal/help/Keywords_currently_not_supported_by_QB64.txt index 816acbe14..b4a7a797d 100644 --- a/internal/help/Keywords_currently_not_supported_by_QB64.txt +++ b/internal/help/Keywords_currently_not_supported_by_QB64.txt @@ -20,7 +20,7 @@ The keywords listed here are not supported in QB64. QB64 is meant to be compatib * [[OPEN]] with devices like '''LPT, CON, KBRD''', and other devices is not supported. [[LPRINT]] and [[OPEN COM]] are supported. * ON PEN, PEN (statement), PEN (function) * ON PLAY(n), PLAY(n) ON/OFF/STOP. ([[PLAY]] music is supported.) -* ON UEVENT +* ON UEVENT, UEVENT (statement) * SETMEM * SIGNAL * TIME$ (statement) (reading the current [[TIME$]] is supported) diff --git a/internal/help/LCASE$.txt b/internal/help/LCASE$.txt index a3cb07570..35a9416af 100644 --- a/internal/help/LCASE$.txt +++ b/internal/help/LCASE$.txt @@ -1,4 +1,4 @@ -The [[LCASE$]] function outputs an all-lowercase version of a [[STRING]]. +The [[LCASE$]] function returns an all-lowercase version of a [[STRING]]. {{PageSyntax}} diff --git a/internal/help/LET.txt b/internal/help/LET.txt index 27d0e49a9..88913e4ea 100644 --- a/internal/help/LET.txt +++ b/internal/help/LET.txt @@ -2,13 +2,12 @@ The [[LET]] is a useless statement designed by [[cavemen]] when they started pro {{PageSyntax}} -: '''[LET]''' {{Parameter|variable}} = {{Parameter|expression}} +: ['''LET'''] {{Parameter|variable}} = {{Parameter|expression}} {{PageDescription}} * {{InlineCode}}LET a = 12{{InlineCodeEnd}} is the same as {{InlineCode}}a = 12{{InlineCodeEnd}}, but wastes 4 extra bytes of program space. - -''Notes:'' LET is '''optional''', it's the only keyword where the '''entire keyword''' is optional :-) +* [[LET]] is '''optional''', it's the only keyword where the '''entire keyword''' is optional :-) {{PageSeeAlso}} diff --git a/internal/help/LOG.txt b/internal/help/LOG.txt index 68baa2f13..45a2609d8 100644 --- a/internal/help/LOG.txt +++ b/internal/help/LOG.txt @@ -15,9 +15,9 @@ The [[LOG]] math function returns the natural logarithm of a specified numerical {{PageExamples}} ''Example 1:'' [[FUNCTION]] to find the base ten logarithm of a numerical value. {{CodeStart}} - FUNCTION Log10#(value AS DOUBLE) {{Cl|STATIC}} - Log10# = LOG(value) / LOG(10.#) - END FUNCTION '' '' +{{Cl|FUNCTION}} Log10#(value {{Cl|AS}} {{Cl|DOUBLE}}) {{Cl|STATIC}} + Log10# = {{Cl|LOG}}(value) / LOG(10.#) +{{Cl|END FUNCTION}} '' '' {{CodeEnd}} :''Explanation:'' The natural logarithm of the value is divided by the base 10 logarithm. The LOG of ten is designated as a DOUBLE precision return by using # after the Log10 value. The return tells you the number of times 10 goes into a value. @@ -25,13 +25,13 @@ The [[LOG]] math function returns the natural logarithm of a specified numerical ''Example 2:'' A binary FUNCTION to convert [[INTEGER]] values using LOG to find the number of digits the return will be. {{CodeStart}} '' '' -FUNCTION BIN$ (n&) - IF n& < 0 THEN EXIT FUNCTION 'positive numbers only! negative error! - FOR p% = 0 TO INT({{Cl|LOG}}(n& + .1) / {{Cl|LOG}}(2)) ' added +.1 to get 0 to work - IF n& {{Cl|AND}} 2 ^ p% THEN s$ = "1" + s$ ELSE s$ = "0" + s$ 'find bits on - NEXT p% - IF s$ = "" THEN BIN$ = "&B0" ELSE BIN$ = "&B" + s$ 'check for zero return '' '' -END FUNCTION +{{Cl|FUNCTION}} BIN$ (n&) + {{Cl|IF}} n& < 0 {{Cl|THEN}} {{Cl|EXIT FUNCTION}} 'positive numbers only! negative error! + {{Cl|FOR}} p% = 0 {{Cl|TO}} {{Cl|INT}}({{Cl|LOG}}(n& + .1) / {{Cl|LOG}}(2)) 'added +.1 to get 0 to work + {{Cl|IF}} n& {{Cl|AND}} 2 ^ p% {{Cl|THEN}} s$ = "1" + s$ {{Cl|ELSE}} s$ = "0" + s$ 'find bits on + {{Cl|NEXT}} p% + {{Cl|IF}} s$ = "" {{Cl|THEN}} BIN$ = "&B0" {{Cl|ELSE}} BIN$ = "&B" + s$ 'check for zero return '' '' +{{Cl|END FUNCTION}} {{CodeEnd}} : ''Explanation:'' The LOG of a '''positive''' [[INTEGER]] value is divided by the LOG of 2 to determine the number of binary digits that will be returned. The FOR loop compares the value with the exponents of two and determines if a bit is ON or OFF as "1" or "0". diff --git a/internal/help/MID$_(statement).txt b/internal/help/MID$_(statement).txt index 9a3efd087..06641c0c4 100644 --- a/internal/help/MID$_(statement).txt +++ b/internal/help/MID$_(statement).txt @@ -18,17 +18,17 @@ The [[MID$]] statement substitutes one or more new characters for existing chara ''Example:'' Using [[INSTR]] to locate the string positions and a [[MID$ (statement)|MID$]] statement to change the words. {{CodeStart}} - text$ = "The cats and dogs were playing, even though dogs don't like cats." - PRINT text$ - start% = 1 ' start cannot be 0 when used in the INSTR function! - {{Cl|DO...LOOP|DO}} - position% = {{Cl|INSTR}}(start%, text$, "dog") - IF position% THEN ' when position is a value greater than 0 - {{Cl|MID$}}(text$, position%, 3) = "rat" ' changes "dog" to "rat" when found - start% = position% + 1 ' advance one position to search rest of string - END IF - LOOP UNTIL position% = 0 ' no other matches found - PRINT text$ '' '' +text$ = "The cats and dogs were playing, even though dogs don't like cats." +{{Cl|PRINT}} text$ +start% = 1 ' start cannot be 0 when used in the INSTR function! +{{Cl|DO...LOOP|DO}} + position% = {{Cl|INSTR}}(start%, text$, "dog") + {{Cl|IF}} position% {{Cl|THEN}} ' when position is a value greater than 0 + {{Cl|MID$}}(text$, position%, 3) = "rat" ' change "dog" to "rat" when found + start% = position% + 1 ' advance one position to search rest of string + {{Cl|END IF}} +{{Cl|LOOP}} {{Cl|UNTIL}} position% = 0 ' no other matches found +{{Cl|PRINT}} text$ '' '' {{CodeEnd}} {{OutputStart}} The cats and dogs were playing, even though dogs don't like cats. diff --git a/internal/help/MOD.txt b/internal/help/MOD.txt index 075582b84..fda1996e2 100644 --- a/internal/help/MOD.txt +++ b/internal/help/MOD.txt @@ -2,7 +2,7 @@ The [[MOD]] operator gives the remainder after division of one number by another {{PageSyntax}} -: {{Parameter|remainder}} = {{Parameter|numerator}} [[MOD]] {{Parameter|divisor}} +:{{Parameter|remainder}} = {{Parameter|numerator}} [[MOD]] {{Parameter|divisor}} {{PageParameters}} diff --git a/internal/help/PRINT_USING.txt b/internal/help/PRINT_USING.txt index 5341fbcb3..a21fd2900 100644 --- a/internal/help/PRINT_USING.txt +++ b/internal/help/PRINT_USING.txt @@ -1,4 +1,4 @@ -The '''PRINT USING''' statement is used to [[PRINT]] formatted data to the Screen or a file using a [[STRING]] template. +The [[PRINT USING]] statement is used to [[PRINT]] formatted data to the Screen or a file using a [[STRING]] template. {{PageSyntax}} @@ -9,22 +9,25 @@ The '''PRINT USING''' statement is used to [[PRINT]] formatted data to the Scree * Literal or variable [[STRING]] ''text$'' can be placed between PRINT and USING or it can be included in the ''template''. * A [[semicolon]] or [[comma]] may follow the ''text'' to stop or tab the print cursor before the ''template'' [[PRINT]]. * The literal or variable [[STRING]] ''template'' should use the template symbols to display each variable [[Variable Types|type]] in the list following it. -* The list of data ''variables'' used in the ''template'' are '''separated by semicolons''' after the template string value. -* In '''QB64''' ONE [[semicolon]] or [[comma]] may follow the variable list to stop the print cursor for pending prints. QB only allowed a semicolon. +* The list of data ''variables'' used in the ''template'' are separated by semicolons after the template string value. +* In QB64 one [[semicolon]] or [[comma]] may follow the variable list to stop the print cursor for pending prints. QB only allowed a semicolon. {{PageDescription}} * The ''variables'' should be listed in the order that they are used in the template from left to right. -* '''If the ''template'' string is omitted or symbols don't match the ''variable(s)'' an "Illegal Function Call" [[ERROR Codes|ERROR]] will occur!''' -* No more than 25 # digit places are allowed in a template number or an [[ERROR Codes|error]] will occur. +* If the ''template'' string is omitted or symbols don't match the ''variable(s)'' an "Illegal Function Call" [[ERROR Codes|ERROR]] will occur. * Can convert numerical exponential or [[scientific notation]] values to normal decimal point values using less digits. -* '''NOTE:''' If the numerical value exceeds the template's digit range a % symbol will appear in the leftmost digit area. -* '''WARNING: The numbers displayed are rounded so the actual values are never changed and are actually more accurate.''' +* NOTE: If the numerical value exceeds the template's digit range a % symbol will appear in the leftmost digit area. +* WARNING: The numbers displayed are rounded so the actual values are never changed and are actually more accurate. {{PrintUsing}} +{{PageQBasic}} +* QBasic limited the number of specified digit positions to 24; QB64 has no such restriction. + + {{PageExamples}} ''Example 1:'' Printing formatted data using a predefined [[STRING|string]] template variable. {{CodeStart}} '' '' @@ -40,15 +43,14 @@ tmp$ = "Salesperson: & & #####,. $$#####,.##" ''Example 2:'' How to display formatting symbols as normal text using underscores in a PRINT USING template. -{{CodeStart}} '' '' +{{CodeStart}} errcode = 35 -{{Cl|PRINT USING}} "Error ## occurred!!"; errcode -'now there are the !! at the end of the printed string -{{Cl|PRINT USING}} "Error ## occurred_!_!"; errcode -{{Cl|END}} '' +{{Cl|PRINT USING}} "Error ## occurred!"; errcode +'the ! is now displayed at the end of the printed string +{{Cl|PRINT USING}} "Error ## occurred_!"; errcode {{CodeEnd}} {{OutputStart}}Error 35 occurred -Error 35 occurred!! +Error 35 occurred! {{OutputEnd}} : ''Explanation:'' The first template will not print the exclamation points or error when the requested text parameters are omitted. @@ -75,6 +77,9 @@ tmp$ = "$$#######,.##" {{Cl|PRINT}} "I have this much money!"; {{Cl|PRINT USING|USING}} tmp$; money '' '' {{CodeEnd}} +{{OutputStart}} +I have this much money! $12,345.45 +{{OutputEnd}} : ''Note:'' This can also be used to print the USING formatting characters outside of the template. diff --git a/internal/help/SQR.txt b/internal/help/SQR.txt index 3539177c2..1038e4793 100644 --- a/internal/help/SQR.txt +++ b/internal/help/SQR.txt @@ -1,19 +1,21 @@ -The '''SQR''' function returns the square root of a numerical value. +The [[SQR]] function returns the square root of a numerical value. {{PageSyntax}} -:: square_root = '''SQR('''value''')''' +:square_root = [[SQR]](value) +{{PageDescription}} * The ''square root'' returned is normally a [[SINGLE]] or [[DOUBLE]] numerical value. * The ''value'' parameter can be any '''positive''' numerical type. '''Negative parameter values will not work!''' * Other exponential root functions can use fractional exponents([[^]]) enclosed in '''parenthesis only'''. EX: {{text|root <nowiki> = </nowiki> c ^ (a / b)|green}} +{{PageExamples}} ''Example 1:'' Finding the hypotenuse of a right triangle: {{CodeStart}} '' '' A% = 3: B% = 4 - PRINT "hypotenuse! ="; SQR((A% ^ 2) + (B% ^ 2)) '' '' + {{Cl|PRINT}} "hypotenuse! ="; {{Cl|SQR}}((A% ^ 2) + (B% ^ 2)) '' '' {{CodeEnd}} {{OutputStart}} hypotenuse = 5 @@ -24,7 +26,7 @@ The '''SQR''' function returns the square root of a numerical value. {{CodeStart}} '' '' number = 8 cuberoot = number {{Cl|^}} (1/3) - PRINT cuberoot '' '' + {{Cl|PRINT}} cuberoot '' '' {{CodeEnd}} {{OutputStart}} 2 @@ -35,7 +37,7 @@ The '''SQR''' function returns the square root of a numerical value. {{CodeStart}} '' '' number = 8 negroot = number {{Cl|^}} -2 - PRINT negroot '' '' + {{Cl|PRINT}} negroot '' '' {{CodeEnd}} {{OutputStart}} .015625 @@ -45,21 +47,21 @@ The '''SQR''' function returns the square root of a numerical value. ''Example 4:'' Fast Prime number checker limits the numbers checked to the square root (half way). {{CodeStart}} -DEFLNG P -DO +{{Cl|DEFLNG}} P +{{Cl|DO}} PRIME = -1 'set PRIME as True -INPUT "Enter any number to check up to 2 million (Enter quits): ", guess$ +{{Cl|INPUT}} "Enter any number to check up to 2 million (Enter quits): ", guess$ PR = {{Cl|VAL}}(guess$) -IF PR {{Cl|MOD}} 2 THEN 'check for even number - FOR P = 3 TO {{Cl|SQR}}(PR) STEP 2 'largest number that could be a multiple is the SQR - IF PR {{Cl|MOD}} P = 0 THEN PRIME = 0: EXIT FOR 'MOD = 0 when evenly divisible by another - NEXT -ELSE : PRIME = 0 'number to be checked is even so it cannot be a prime -END IF -IF PR = 2 THEN PRIME = -1 '2 is the ONLY even prime -IF PR = 1 THEN PRIME = 0 'MOD returns true but 1 is not a prime by definition -IF PRIME THEN PRINT "PRIME! How'd you find me? " ELSE PRINT "Not a prime, you lose!" -LOOP UNTIL PR = 0 '' '' +{{Cl|IF}} PR {{Cl|MOD}} 2 {{Cl|THEN}} 'check for even number + {{Cl|FOR}} P = 3 {{Cl|TO}} {{Cl|SQR}}(PR) {{Cl|STEP}} 2 'largest number that could be a multiple is the SQR + {{Cl|IF}} PR {{Cl|MOD}} P = 0 {{Cl|THEN}} PRIME = 0: {{Cl|EXIT FOR}} 'MOD = 0 when evenly divisible by another + {{Cl|NEXT}} +{{Cl|ELSE}} : PRIME = 0 'number to be checked is even so it cannot be a prime +{{Cl|END IF}} +{{Cl|IF}} PR = 2 {{Cl|THEN}} PRIME = -1 '2 is the ONLY even prime +{{Cl|IF}} PR = 1 {{Cl|THEN}} PRIME = 0 'MOD returns true but 1 is not a prime by definition +{{Cl|IF}} PRIME {{Cl|THEN}} {{Cl|PRINT}} "PRIME! How'd you find me? " {{Cl|ELSE}} {{Cl|PRINT}} "Not a prime, you lose!" +{{Cl|LOOP}} {{Cl|UNTIL}} PR = 0 '' '' {{CodeEnd}} {{OutputStart}} Enter any number to check up to 2 million (Enter quits): 12379 @@ -68,7 +70,7 @@ PRIME! How'd you find me? <center>''Note:'' Prime numbers cannot be evenly divided by any other number except one.</center> -''See also:'' +{{PageSeeAlso}} *[[MOD]] {{text|(integer remainder division)}} *[[^]] {{text|(exponential operator)}} *[[Mathematical Operations]] diff --git a/internal/help/UCASE$.txt b/internal/help/UCASE$.txt index 9ec2c3508..20359032b 100644 --- a/internal/help/UCASE$.txt +++ b/internal/help/UCASE$.txt @@ -1,4 +1,4 @@ -The [[UCASE$]] function outputs an all-uppercase version of a [[STRING]]. +The [[UCASE$]] function returns an all-uppercase version of a [[STRING]]. {{PageSyntax}} diff --git a/internal/help/Underscore.txt b/internal/help/Underscore.txt index 4100d60d7..0c9fb49db 100644 --- a/internal/help/Underscore.txt +++ b/internal/help/Underscore.txt @@ -1,13 +1,17 @@ An '''underscore''' can be used at the end of a line of code to continue a code line to the next line. +{{PageSyntax}} -''Usage:'' IF x + y > 500 AND x + y < 600 THEN_ +::IF x + y > 500 AND x + y < 600 THEN_ :::PRINT x + y +{{PageDescription}} + * The underscore can be anywhere after the code on that line to continue the code to the next line in QB64. * Multiple underscores can be used for the same line of code. +* Comments cannot follow an underscore and are not continued on the next line if they end in an underscore. * Modern QB64 keywords are preceded by an underscore, unless [[$NOPREFIX]] is used. Variables and user procedures names cannot start with a single underscore. ** Variables and user procedures names can be preceded by double underscores if necessary. * Underscores can be used in the middle of variable, sub procedure or [[CONST|constant]] names. diff --git a/internal/help/VAL.txt b/internal/help/VAL.txt index e1cc2d13d..a15b1e91b 100644 --- a/internal/help/VAL.txt +++ b/internal/help/VAL.txt @@ -1,10 +1,11 @@ -The '''VAL''' Function returns the decimal numerical equivalent value of a [[STRING]] numerical value. +The [[VAL]] Function returns the decimal numerical equivalent value of a [[STRING]] numerical value. {{PageSyntax}} -:: value = VAL(string_value$) +:: value = [[VAL]](string_value$) +{{PageDescription}} * VAL converts string numbers to numerical values including decimal point values and prefixed "[[&H]]" hexadecimal, "[[&O]]" octal. * VAL conversion stops at non-numeric characters except for letter "D" or "E" exponential notation values. :String values with "D" and "E" letters between numbers may be converted also! EX: '''{{text|VAL("9D4") <nowiki>=</nowiki> 90000|green}}''' @@ -16,6 +17,7 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR * In QB64 use an [[INTEGER]] return variable to hold integer values returned by VAL [[HEX$|Hex]] strings: '''{{text|value% <nowiki>= VAL("&HFFFF") =</nowiki> -1|green}}''' +{{PageExamples}} ''Example 1:'' Differences in values returned with QBasic and QB64: {{CodeStart}} '' '' {{Cl|PRINT}} {{Cl|VAL}}("{{Cl|&H}}") '203 in QB, 0 in QB64 @@ -28,8 +30,8 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR ''Example 2:'' Converting a string with some number characters {{CodeStart}} '' '' text$ = "1.23Hello" - number! = VAL(text$) - PRINT number! '' '' + number! = {{Cl|VAL}}(text$) + {{Cl|PRINT}} number! '' '' {{CodeEnd}} {{OutputStart}} 1.23 @@ -39,7 +41,7 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR ''Example 3:'' Converting literal and variable [[STRING|string]] values to numerical values. {{CodeStart}} '' '' a$ = "33" - PRINT VAL("10") + VAL(a$) + 1 '' '' + {{Cl|PRINT}} {{Cl|VAL}}("10") + {{Cl|VAL}}(a$) + 1 '' '' {{CodeEnd}} {{OutputStart}} 44 @@ -55,9 +57,9 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR {{CodeStart}} decnumber% = 96 hexnumber$ = "&H" + {{Cl|HEX$}}(decnumber%) 'convert decimal value to hex and add hex prefix - PRINT hexnumber$ + {{Cl|PRINT}} hexnumber$ decimal% = {{Cl|VAL}}(hexnumber$) - PRINT decimal% '' '' + {{Cl|PRINT}} decimal% '' '' {{CodeEnd}} {{OutputStart}} &H60 @@ -66,7 +68,7 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR : ''Explanation:'' [[HEX$]] converts a decimal number to hexadecimal, but [[VAL]] will only recognize it as a valid value with the "&H" prefix. Especially since hexadecimal numbers can use "A" through "F" in them. Create a converter function from this code! -''See also:'' +{{PageSeeAlso}} * [[STR$]], [[HEX$]] * [[OCT$]], [[ASC]] diff --git a/internal/help/Variable.txt b/internal/help/Variable.txt index 121fa2222..bb99504ff 100644 --- a/internal/help/Variable.txt +++ b/internal/help/Variable.txt @@ -1,8 +1,8 @@ -A '''variable''' is a "container" name that can hold a numerical or string value which can be referenced or changed by the program (as opposed to [[CONST]]ant values which never change). +A '''variable''' is a named "container" that can hold a numerical or string value and which can be referenced or changed by the program (as opposed to [[CONST]]ant values which never change). <center>'''Variable names'''</center> -Variables in QB64 can be any name except the names of QB64 or QBasic keywords and may not contain spaces or non-alphabetical/non-numerical characters (except "." and "_"). Numerical characters cannot be used as the first character of a variable or array name! '''QB64 reserves the use of a leading underscore to QB64 procedural or variable type names only!''' +Variables in QB64 can be any name except the names of QB64 or QBasic keywords and may not contain spaces or non-alphabetical/non-numerical characters (except "." and "_"). Numerical characters cannot be used as the first character of a variable or array name. QB64 reserves the use of a single leading underscore for QB64 procedural or variable type names. Variable values can be passed to sub-procedures by using the name as a [[SUB]] or [[FUNCTION]] parameter in a [[CALL]]. Variable names in the main program module can be passed to sub-procedures by using [[DIM]] [[SHARED]] without using them as [[CALL]] parameters. @@ -28,15 +28,15 @@ Groups of variable names can be type defined by the first letter or list of lett <center>'''Variable values'''</center> -All numerical variables default to 0 and all string variables default to "" at the start of a program and when first referenced inside of a [[SUB]] or [[FUNCTION]] procedure except when the variable is defined as a [[STATIC]] value. +Variables are initialized to empty values (0 for numerical values, and "" for strings) at the start of a program, or when first referenced inside of a [[SUB]] or [[FUNCTION]] call. + + +[[STATIC]] variables are also initialized to empty values, however, STATIC variables will retain their values in between SUB or FUNCTION calls, and exist for the life of the program. [[Arrays]] variable names can hold many values in one variable name by specifying a reference index enclosed in parentheses. -[[STATIC]] sub-procedure values keep their value after the sub-procedure is exited. They will hold an empty value when first used. - - Variables are used to hold program data information that is attained through the program flow, either by user input, calculations or by other ways of communicaton (as with I/O, memory, TCP/IP or files). diff --git a/internal/help/^.txt b/internal/help/^.txt index 5596b091d..c6694aff3 100644 --- a/internal/help/^.txt +++ b/internal/help/^.txt @@ -1,12 +1,11 @@ -The '''^''' operation raises a numerical value to an exponential value expressing how many times the value is multiplied by itself. +The [[^]] operation raises a numerical value to an exponential value expressing how many times the value is multiplied by itself. {{PageSyntax}} -::'' return_value = number '''^''' {whole_exponent|(fractional_exponent)} +:return_value = number [[^]] {whole_exponent|(fractional_exponent)} {{PageDescription}} - * The number value can be any type literal or variable numerical value. * Exponents can be any positive or negative integer or fractional numerical value inside of parenthesis brackets. * If the exponent is zero, the value returned is 1. @@ -38,12 +37,8 @@ Enter a number to calculate it's cube root: 144 {{OutputEnd}} - - -''See also:'' - -[[SQR]], [[Mathematical Operations]] - +{{PageSeeAlso}} +* [[SQR]], [[Mathematical Operations]] {{PageNavigation}} diff --git a/internal/help/_ACCEPTFILEDROP.txt b/internal/help/_ACCEPTFILEDROP.txt index 0b0c86158..c0d6805fd 100644 --- a/internal/help/_ACCEPTFILEDROP.txt +++ b/internal/help/_ACCEPTFILEDROP.txt @@ -14,8 +14,8 @@ The [[_ACCEPTFILEDROP]] statement prepares a program window to receive files dro * '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_ACOS.txt b/internal/help/_ACOS.txt index 5dae84feb..4b3268fe8 100644 --- a/internal/help/_ACOS.txt +++ b/internal/help/_ACOS.txt @@ -11,8 +11,8 @@ The [[_ACOS]] function returns the angle measured in radians based on an input [ * Note: Due to rounding with floating point math, the _ACOS may not always give a perfect match for the COS angle which generated this. You can reduce the number of rounding errors by increasing the precision of your calculations by using [[DOUBLE]] or [[_FLOAT]] precision variables instead of [[SINGLE]]. -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_ALLOWFULLSCREEN.txt b/internal/help/_ALLOWFULLSCREEN.txt index d4ce2b4dc..33c761975 100644 --- a/internal/help/_ALLOWFULLSCREEN.txt +++ b/internal/help/_ALLOWFULLSCREEN.txt @@ -16,8 +16,8 @@ The [[_ALLOWFULLSCREEN]] statement allows setting the behavior of the ALT+ENTER * With [[_ALLOWFULLSCREEN]] _OFF you can trap Alt+Enter manually in your program and reassign it. See example 2 below. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_ASIN.txt b/internal/help/_ASIN.txt index b6baf6a4f..df8657713 100644 --- a/internal/help/_ASIN.txt +++ b/internal/help/_ASIN.txt @@ -12,8 +12,8 @@ The [[_ASIN]] function returns the angle measured in radians based on an input [ * Note: Due to rounding with floating point math, the [[_ASIN]] may not always give a perfect match for the [[SIN]] angle which generated this. You can reduce the number of rounding errors by increasing the precision of your calculations by using [[DOUBLE]] or [[_FLOAT]] precision variables instead of [[SINGLE]]. -==Availability== -* '''Version 1.000 and up''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_ASINH.txt b/internal/help/_ASINH.txt index 6de06a22d..abf3b6234 100644 --- a/internal/help/_ASINH.txt +++ b/internal/help/_ASINH.txt @@ -1,5 +1,5 @@ {{DISPLAYTITLE:_ASINH}} -The [[_ASINH]] returns the arc hyperbolic sine of x, expressed in radians. +The [[_ASINH]] function returns the arc hyperbolic sine of x, expressed in radians. {{PageSyntax}} diff --git a/internal/help/_ASSERT.txt b/internal/help/_ASSERT.txt index 15e0ec5bd..43bb9e546 100644 --- a/internal/help/_ASSERT.txt +++ b/internal/help/_ASSERT.txt @@ -12,8 +12,8 @@ The [[_ASSERT]] statement can be used to perform tests in code that's in develop * If the condition is not met (that is, if it evaluates to 0), an error occurs ("_ASSERT failed on line #") and program execution stops. -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/_AUTODISPLAY_(function).txt b/internal/help/_AUTODISPLAY_(function).txt index 9e4b81360..917c37ad5 100644 --- a/internal/help/_AUTODISPLAY_(function).txt +++ b/internal/help/_AUTODISPLAY_(function).txt @@ -11,8 +11,8 @@ The [[_AUTODISPLAY (function)|_AUTODISPLAY]] function returns the current displa * If [[_DISPLAY]] is used, then [[_AUTODISPLAY (function)|_AUTODISPLAY]] returns 0, to indicate that screen changes (text or graphics) are only displayed per request, by calling [[_DISPLAY]] again to refresh the screen. -==Availability== -* '''Build 20170924/69'''. +{{PageAvailability}} +* Build 20170924/69 and up. {{PageSeeAlso}} diff --git a/internal/help/_BLINK.txt b/internal/help/_BLINK.txt index e45d9c199..c9bbd3561 100644 --- a/internal/help/_BLINK.txt +++ b/internal/help/_BLINK.txt @@ -13,8 +13,8 @@ The [[_BLINK]] statement toggles blinking colors in text mode (SCREEN 0). Defaul * IF [[_DISPLAY]] is used, blinking is disabled, even if _BLINK is ON, but high intensity backgrounds aren't enabled in this case. -==Availability:== -* Build 20170816/61 up (August 16, 2017). +{{PageAvailability}} +* Build 20170816/61 and up). {{PageExamples}} diff --git a/internal/help/_BLINK_(function).txt b/internal/help/_BLINK_(function).txt index 2ab2155cf..4dc8f69c0 100644 --- a/internal/help/_BLINK_(function).txt +++ b/internal/help/_BLINK_(function).txt @@ -6,8 +6,8 @@ The [[_BLINK]] function returns the current blink setting for SCREEN 0 colors. I : {{Parameter|blinkState%%}} = [[_BLINK]] -==Availability== -* Build 20170816/61 up (August 16, 2017). +{{PageAvailability}} +* Build 20170816/61 and up. {{PageExamples}} diff --git a/internal/help/_CAPSLOCK.txt b/internal/help/_CAPSLOCK.txt index c4487e9e2..80b3613d7 100644 --- a/internal/help/_CAPSLOCK.txt +++ b/internal/help/_CAPSLOCK.txt @@ -6,7 +6,7 @@ The [[_CAPSLOCK]] statement sets the state of the Caps Lock key. : [[_CAPSLOCK]] {ON|OFF|_TOGGLE} -==Availability== +{{PageAvailability}} * Version 1.4 and up. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. diff --git a/internal/help/_CAPSLOCK_(function).txt b/internal/help/_CAPSLOCK_(function).txt index b80f898d6..d0c860392 100644 --- a/internal/help/_CAPSLOCK_(function).txt +++ b/internal/help/_CAPSLOCK_(function).txt @@ -6,7 +6,7 @@ The [[_CAPSLOCK (function)| _CAPSLOCK]] function returns the current state of th : {{Parameter|keyStatus%%}} = [[_CAPSLOCK (function)| _CAPSLOCK]] -==Availability== +{{PageAvailability}} * Version 1.4 and up. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. diff --git a/internal/help/_CEIL.txt b/internal/help/_CEIL.txt index f751bdb95..f4bbafe27 100644 --- a/internal/help/_CEIL.txt +++ b/internal/help/_CEIL.txt @@ -10,8 +10,8 @@ The [[_CEIL]] function rounds a numeric value up to the next whole number or [[I * This means that [[_CEIL]] rounds up for both positive and negative numbers. -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_CLIPBOARDIMAGE.txt b/internal/help/_CLIPBOARDIMAGE.txt index aad95f44a..907499a93 100644 --- a/internal/help/_CLIPBOARDIMAGE.txt +++ b/internal/help/_CLIPBOARDIMAGE.txt @@ -13,8 +13,8 @@ The [[_CLIPBOARDIMAGE]] statement copies a valid QB64 image to the clipboard. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. -==Availability== -* '''Build 20170906/64''' onward. +{{PageAvailability}} +* Build 20170906/64 and up. {{PageExamples}} diff --git a/internal/help/_CLIPBOARDIMAGE_(function).txt b/internal/help/_CLIPBOARDIMAGE_(function).txt index 911910f5b..076a9d375 100644 --- a/internal/help/_CLIPBOARDIMAGE_(function).txt +++ b/internal/help/_CLIPBOARDIMAGE_(function).txt @@ -12,8 +12,8 @@ The [[_CLIPBOARDIMAGE (function)|_CLIPBOARDIMAGE]] function pastes an image from * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. -==Availability== -* '''Build 20170906/64''' onward. +{{PageAvailability}} +* Build 20170906/64 and up. {{PageExamples}} diff --git a/internal/help/_CONSOLEINPUT.txt b/internal/help/_CONSOLEINPUT.txt index bc63424aa..c660d5a07 100644 --- a/internal/help/_CONSOLEINPUT.txt +++ b/internal/help/_CONSOLEINPUT.txt @@ -10,6 +10,7 @@ The [[_CONSOLEINPUT]] function is used to monitor any new mouse or keyboard inpu * Returns 1 if new keyboard information is available, 2 if mouse information is available, otherwise it returns 0. * Must be called before reading any of the other mouse functions and before reading [[_CINP]]. * To clear all previous input data, read [[_CONSOLEINPUT]] in a loop until it returns 0. +* To capture mouse input, turn off Quick Edit in the settings of command prompt and use [[_SOURCE]] [[_CONSOLE]]. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. diff --git a/internal/help/_CONSOLETITLE.txt b/internal/help/_CONSOLETITLE.txt index 8477798d5..81c15031c 100644 --- a/internal/help/_CONSOLETITLE.txt +++ b/internal/help/_CONSOLETITLE.txt @@ -1,13 +1,13 @@ {{DISPLAYTITLE:_CONSOLETITLE}} -The [[_CONSOLETITLE]] statement creates the title of the console window using a literal or variable [[STRING|string]]. +The [[_CONSOLETITLE]] statement sets the console window's title-bar text. {{PageSyntax}} : [[_CONSOLETITLE]] {{Parameter|text$}} -{{PageDescription}} -* The ''text$'' used can be a literal or variable [[STRING]] value. +{{Parameters}} +* ''text$'' can be any literal or variable [[STRING]] value. {{PageExamples}} @@ -23,7 +23,7 @@ The [[_CONSOLETITLE]] statement creates the title of the console window using a {{Cl|END}} {{CodeEnd}} -:''Note:'' You can also use [[SHELL]] "title consoletitle" to set the title of the console window. However, '''the recommended practice is to use [[_CONSOLETITLE]]'''. +:''Note:'' You can also use [[SHELL]] "title consoletitle" to set the title of the console window. However, the recommended practice is to use [[_CONSOLETITLE]]. ''See also:'' diff --git a/internal/help/_CONTINUE.txt b/internal/help/_CONTINUE.txt index 866452537..9b8ef832a 100644 --- a/internal/help/_CONTINUE.txt +++ b/internal/help/_CONTINUE.txt @@ -7,8 +7,8 @@ The [[_CONTINUE]] statement is used in a [[DO...LOOP]], [[WHILE...WEND]] or [[FO : [[_CONTINUE]] -==Availability== -* Build 20170628/55 up. +{{PageAvailability}} +* Build 20170628/55 and up. {{PageExamples}} diff --git a/internal/help/_D2G.txt b/internal/help/_D2G.txt index 79b6e41a0..e0d2eb744 100644 --- a/internal/help/_D2G.txt +++ b/internal/help/_D2G.txt @@ -6,8 +6,8 @@ The [[_D2G]] function converts a '''degree''' value into a '''gradient''' value. : {{Parameter|result}} = [[_D2G]]({{Parameter|num}}) -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_D2R.txt b/internal/help/_D2R.txt index e24c68524..dec1c060b 100644 --- a/internal/help/_D2R.txt +++ b/internal/help/_D2R.txt @@ -6,8 +6,8 @@ The [[_D2R]] function converts a '''degree''' value into a '''radian''' value. :: {{Parameter|result}} = [[_D2R]]({{Parameter|num}}) -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_DEFLATE$.txt b/internal/help/_DEFLATE$.txt index dc552c079..74beac176 100644 --- a/internal/help/_DEFLATE$.txt +++ b/internal/help/_DEFLATE$.txt @@ -11,8 +11,8 @@ The [[_DEFLATE$]] function compresses a [[STRING|string]]. * To decompress the resulting string, use [[_INFLATE$]]. -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/_DELAY.txt b/internal/help/_DELAY.txt index 112b18137..29ebea9da 100644 --- a/internal/help/_DELAY.txt +++ b/internal/help/_DELAY.txt @@ -1,14 +1,17 @@ {{DISPLAYTITLE:_DELAY}} -The [[_DELAY]] statement suspends program execution for a [[SINGLE]] value of seconds. +The [[_DELAY]] statement suspends program execution for the specified number of seconds. {{PageSyntax}} :[[_DELAY]] {{Parameter|seconds!}} -{{PageDescription}} +{{Parameters}} * {{Parameter|seconds!}} is the time to wait, accurate to nearest millisecond (.001). -* While waiting, cpu cycles are relinquished to other applications. + + +{{PageDescription}} +* While waiting, CPU cycles are relinquished to other applications. * Delays are not affected by midnight timer corrections. diff --git a/internal/help/_DESKTOPHEIGHT.txt b/internal/help/_DESKTOPHEIGHT.txt index ac35ef595..13ab7bf3c 100644 --- a/internal/help/_DESKTOPHEIGHT.txt +++ b/internal/help/_DESKTOPHEIGHT.txt @@ -11,8 +11,8 @@ The [[_DESKTOPHEIGHT]] function returns the height of the users current desktop. * This returns the height of the user's desktop, not the size of any screen or window which might be open on that desktop. -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_DESKTOPWIDTH.txt b/internal/help/_DESKTOPWIDTH.txt index a7fc6d2a1..6ee2d47be 100644 --- a/internal/help/_DESKTOPWIDTH.txt +++ b/internal/help/_DESKTOPWIDTH.txt @@ -11,8 +11,8 @@ The [[_DESKTOPWIDTH]] function returns the width of the users current desktop. * This returns the width of the user's desktop, not the size of any screen or window which might be open on that desktop. -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_DISPLAYORDER.txt b/internal/help/_DISPLAYORDER.txt index 27b9bda25..9d869e9ea 100644 --- a/internal/help/_DISPLAYORDER.txt +++ b/internal/help/_DISPLAYORDER.txt @@ -25,8 +25,8 @@ The [[_DISPLAYORDER]] statement defines the order to render software, hardware a * Rendering the same content twice consecutively in a combination is not allowed. -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageSeeAlso}} diff --git a/internal/help/_DROPPEDFILE.txt b/internal/help/_DROPPEDFILE.txt index 89bb727b4..6c8187f85 100644 --- a/internal/help/_DROPPEDFILE.txt +++ b/internal/help/_DROPPEDFILE.txt @@ -17,8 +17,8 @@ The [[_DROPPEDFILE]] function returns the list of items (files or folders) dropp * '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_ECHO.txt b/internal/help/_ECHO.txt index 82ab7beae..7b354d899 100644 --- a/internal/help/_ECHO.txt +++ b/internal/help/_ECHO.txt @@ -11,8 +11,8 @@ The [[_ECHO]] statement allows outputting text to a [[$CONSOLE]] window without * To output numbers, use the [[STR$]] function. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_FINISHDROP.txt b/internal/help/_FINISHDROP.txt index a16e07c59..b34083c85 100644 --- a/internal/help/_FINISHDROP.txt +++ b/internal/help/_FINISHDROP.txt @@ -10,8 +10,8 @@ The [[_FINISHDROP]] statement resets [[_TOTALDROPPEDFILES]] and clears the [[_DR * '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_FONT_(function).txt b/internal/help/_FONT_(function).txt index 48478bd66..f281fb6c4 100644 --- a/internal/help/_FONT_(function).txt +++ b/internal/help/_FONT_(function).txt @@ -1,9 +1,9 @@ {{DISPLAYTITLE:_FONT (function)}} -The [[_FONT]] function retrieves the font handle from the specified image handle or the current [[_DEST]]ination page's font. +The [[_FONT (function)|_FONT]] function retrieves the font handle from the specified image handle or the current [[_DEST]]ination page's font. {{PageSyntax}} -:{{Parameter|fontHandle&}} = [[_FONT]][({{Parameter|imageHandle&}})] +:{{Parameter|fontHandle&}} = [[_FONT (function)|_FONT]][({{Parameter|imageHandle&}})] {{PageDescription}} diff --git a/internal/help/_G2D.txt b/internal/help/_G2D.txt index d04674ddb..30d74c16e 100644 --- a/internal/help/_G2D.txt +++ b/internal/help/_G2D.txt @@ -6,8 +6,8 @@ The [[_G2D]] function converts a '''gradient''' value into a '''degree''' value. : {{Parameter|result}} = [[_G2D]]({{Parameter|num}}) -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_G2R.txt b/internal/help/_G2R.txt index c534ed60e..fdd78b13e 100644 --- a/internal/help/_G2R.txt +++ b/internal/help/_G2R.txt @@ -6,8 +6,8 @@ The [[_G2R]] function converts a '''gradient''' value into a '''radian''' value. : {{Parameter|result}} = [[_G2R]]({{Parameter|num}}) -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_INCLERRORFILE$.txt b/internal/help/_INCLERRORFILE$.txt index cdc21b2cb..8cdafb977 100644 --- a/internal/help/_INCLERRORFILE$.txt +++ b/internal/help/_INCLERRORFILE$.txt @@ -11,8 +11,8 @@ The [[_INCLERRORFILE$]] function returns the name of the original source code [[ If the last error occurred in the main module, [[_INCLERRORFILE$]] returns an empty string. -==Availability== -* '''Version 1.1 and up'''. +{{PageAvailability}} +* Version 1.1 and up. {{PageExamples}} diff --git a/internal/help/_INCLERRORLINE.txt b/internal/help/_INCLERRORLINE.txt index a46190bcc..b2978348a 100644 --- a/internal/help/_INCLERRORLINE.txt +++ b/internal/help/_INCLERRORLINE.txt @@ -12,8 +12,8 @@ The [[_INCLERRORLINE]] function returns the line number in an [[$INCLUDE]] file * By checking _INCLERRORLINE you can report exactly what line inside an included module caused the last error. -==Availability== -* '''Version 1.1 and up'''. +{{PageAvailability}} +* Version 1.1 and up. {{PageExamples}} diff --git a/internal/help/_INFLATE$.txt b/internal/help/_INFLATE$.txt index 1347f5ccc..f559d3d3c 100644 --- a/internal/help/_INFLATE$.txt +++ b/internal/help/_INFLATE$.txt @@ -12,8 +12,8 @@ The [[_INFLATE$]] function decompresses a [[STRING|string]] compressed by the [[ ** If unspecified, decompression still works as expected, but may use more steps and need to allocate more memory internally. -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/_MEMSOUND.txt b/internal/help/_MEMSOUND.txt index f1a19efbd..8eee43e02 100644 --- a/internal/help/_MEMSOUND.txt +++ b/internal/help/_MEMSOUND.txt @@ -19,7 +19,7 @@ The [[_MEMSOUND]] function returns a [[_MEM]] value referring to a sound's raw d * If .SIZE returns 0, that means the data could not be accessed. It may happen if you try to access the right channel in a mono file, for example. -==Availability== +{{PageAvailability}} * Version 1.5 and up. diff --git a/internal/help/_MOUSEMOVE.txt b/internal/help/_MOUSEMOVE.txt index 2a7d6087b..421c0e3ac 100644 --- a/internal/help/_MOUSEMOVE.txt +++ b/internal/help/_MOUSEMOVE.txt @@ -18,9 +18,9 @@ The [[_MOUSEMOVE]] statement moves the mouse pointer to a new position on the sc * Does not require [[_MOUSEINPUT]] to be used, but all moves will be remembered and can be read by mouse functions. -==Availability== -* '''Versions prior to 1.000''' (Version 1.000 had this function disabled for compatibility reasons.) -* '''Version 1.1 and up''' +{{PageAvailability}} +* Versions prior to 1.000 (Version 1.000 had this function disabled for compatibility reasons). +* Version 1.1 and up. {{PageExamples}} diff --git a/internal/help/_NUMLOCK.txt b/internal/help/_NUMLOCK.txt index fc8cbbbbe..601fc0795 100644 --- a/internal/help/_NUMLOCK.txt +++ b/internal/help/_NUMLOCK.txt @@ -6,7 +6,7 @@ The [[_NUMLOCK]] statement sets the state of the Num Lock key. : [[_NUMLOCK]] {ON|OFF|_TOGGLE} -==Availability== +{{PageAvailability}} * Version 1.4 and up. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. diff --git a/internal/help/_NUMLOCK_(function).txt b/internal/help/_NUMLOCK_(function).txt index 8849a5862..91b26a67b 100644 --- a/internal/help/_NUMLOCK_(function).txt +++ b/internal/help/_NUMLOCK_(function).txt @@ -6,7 +6,7 @@ The [[_NUMLOCK (function)| _NUMLOCK]] function returns the current state of the : {{Parameter|keyStatus%%}} = [[_NUMLOCK (function)| _NUMLOCK]] -==Availability== +{{PageAvailability}} * Version 1.4 and up. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. diff --git a/internal/help/_R2D.txt b/internal/help/_R2D.txt index 74eac36b2..ef3e1247d 100644 --- a/internal/help/_R2D.txt +++ b/internal/help/_R2D.txt @@ -6,8 +6,8 @@ The [[_R2D]] function converts a '''radian''' value into a '''degree''' value. : {{Parameter|result!}} = [[_R2D]]({{Parameter|num}}) -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_R2G.txt b/internal/help/_R2G.txt index b27177b0d..2198b0141 100644 --- a/internal/help/_R2G.txt +++ b/internal/help/_R2G.txt @@ -6,8 +6,8 @@ The [[_R2G]] function converts a '''radian''' value into a '''gradient''' value. : {{Parameter|result!}} = [[_R2G]]({{Parameter|num}}) -==Availability== -* '''Version 1.000 and up.''' +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_READBIT.txt b/internal/help/_READBIT.txt index 333adc65a..db325776c 100644 --- a/internal/help/_READBIT.txt +++ b/internal/help/_READBIT.txt @@ -17,8 +17,8 @@ The [[_READBIT]] function is used to check the state of a specified bit of a int * Returns -1 if the bit is set(1), otherwise returns 0 if the bit is not set(0) * Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on) -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/_RESETBIT.txt b/internal/help/_RESETBIT.txt index 830e19422..aef5a44c1 100644 --- a/internal/help/_RESETBIT.txt +++ b/internal/help/_RESETBIT.txt @@ -17,8 +17,8 @@ The [[_RESETBIT]] function is used to set a specified bit of a numerical value t * Resetting a bit that is already set to 0 will have no effect. * Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on) -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/_RESIZEHEIGHT.txt b/internal/help/_RESIZEHEIGHT.txt index 69db5114b..3e28944f8 100644 --- a/internal/help/_RESIZEHEIGHT.txt +++ b/internal/help/_RESIZEHEIGHT.txt @@ -11,8 +11,8 @@ The [[_RESIZEHEIGHT]] function returns the user resized screen pixel height if [ * The program should decide if the request is allowable for proper program interaction. -==Availability== -* '''Version 1.000 and up'''. +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_RESIZEWIDTH.txt b/internal/help/_RESIZEWIDTH.txt index 772ed6298..95d01a7b6 100644 --- a/internal/help/_RESIZEWIDTH.txt +++ b/internal/help/_RESIZEWIDTH.txt @@ -11,8 +11,8 @@ The [[_RESIZEWIDTH]] function returns the user resized screen pixel width if [[$ * The program should decide if the request is allowable for proper program interaction. -==Availability== -* '''Version 1.000 and up'''. +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_RESIZE_(function).txt b/internal/help/_RESIZE_(function).txt index 5691e3548..e8c3d33ad 100644 --- a/internal/help/_RESIZE_(function).txt +++ b/internal/help/_RESIZE_(function).txt @@ -12,8 +12,8 @@ The [[_RESIZE]] function returns true (-1) when a user has attempted to resize t * The [[$RESIZE]]:ON [[metacommand]] must be used so the program is created with a user resizable window. -==Availability== -* '''Version 1.000 and up'''. +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_RGB32.txt b/internal/help/_RGB32.txt index 8db3a222a..62bd81f32 100644 --- a/internal/help/_RGB32.txt +++ b/internal/help/_RGB32.txt @@ -32,8 +32,8 @@ The [[_RGB32]] function returns the 32-bit ''RGBA'' color value with specified r * '''NOTE: Default 32-bit backgrounds are clear black or [[_RGB32]](0, 0). Use [[CLS]] to make the black opaque.''' -==Availability== -* Alternative syntaxes available with '''version 1.3 and up'''. +{{PageAvailability}} +* Alternative syntax available with version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_SCREENEXISTS.txt b/internal/help/_SCREENEXISTS.txt index ff79651d3..4e8e2beb5 100644 --- a/internal/help/_SCREENEXISTS.txt +++ b/internal/help/_SCREENEXISTS.txt @@ -13,7 +13,7 @@ The [[_SCREENEXISTS]] function returns true (-1) once a screen has been created. {{PageExamples}} -''Example:'' The loop waits until the screen exists to add the title. +''Example:'' The loop busy-waits until the screen exists to add the title. {{CodeStart}} '' '' {{Cl|SCREEN}} 12 {{Cl|DO}}: {{Cl|LOOP}} {{Cl|UNTIL}} _{{Cl|SCREENEXISTS}} diff --git a/internal/help/_SCREENICON.txt b/internal/help/_SCREENICON.txt index 8cd4302a2..0758d4a34 100644 --- a/internal/help/_SCREENICON.txt +++ b/internal/help/_SCREENICON.txt @@ -10,8 +10,8 @@ The [[_SCREENICON]] statement can be used to minimize the main program window to * Use [[_SCREENICON]] to minimize the main program window to the taskbar. -==Availability== -* '''Version 1.000 and up'''. +{{PageAvailability}} +* Version 1.000 and up. {{PageSeeAlso}} diff --git a/internal/help/_SCROLLLOCK.txt b/internal/help/_SCROLLLOCK.txt index 518b28d73..f553c1df2 100644 --- a/internal/help/_SCROLLLOCK.txt +++ b/internal/help/_SCROLLLOCK.txt @@ -6,7 +6,7 @@ The [[_SCROLLLOCK]] statement sets the state of the Scroll Lock key. : [[_SCROLLLOCK]] {ON|OFF|_TOGGLE} -==Availability== +{{PageAvailability}} * Version 1.4 and up. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. diff --git a/internal/help/_SCROLLLOCK_(function).txt b/internal/help/_SCROLLLOCK_(function).txt index 512880cb8..4723d1c32 100644 --- a/internal/help/_SCROLLLOCK_(function).txt +++ b/internal/help/_SCROLLLOCK_(function).txt @@ -6,7 +6,7 @@ The [[_SCROLLLOCK (function)| _SCROLLLOCK]] function returns the current state o : {{Parameter|keyStatus%%}} = [[_SCROLLLOCK (function)| _SCROLLLOCK]] -==Availability== +{{PageAvailability}} * Version 1.4 and up. * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. diff --git a/internal/help/_SETBIT.txt b/internal/help/_SETBIT.txt index 8b2bd8561..1ec976572 100644 --- a/internal/help/_SETBIT.txt +++ b/internal/help/_SETBIT.txt @@ -17,8 +17,8 @@ The [[_SETBIT]] function is used to set a specified bit of a numerical value to * Setting a bit that is already set to 1 will have no effect. * Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on) -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/_SHL.txt b/internal/help/_SHL.txt index 4fdb80469..22817309d 100644 --- a/internal/help/_SHL.txt +++ b/internal/help/_SHL.txt @@ -19,8 +19,8 @@ The [[_SHL]] function is used to shift the bits of a numerical value to the left * The type of variable used to store the results should match the type of the variable being shifted. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_SHR.txt b/internal/help/_SHR.txt index 36dc30bfc..f5faecd93 100644 --- a/internal/help/_SHR.txt +++ b/internal/help/_SHR.txt @@ -19,8 +19,8 @@ The [[_SHR]] function is used to shift the bits of a numerical value to the righ * The type of variable used to store the results should match the type of the variable being shifted. * NOTE: When dealing with SIGNED variables, shifting the bits right will leave the sign bit set. This is due to how C++ deals with bit shifting under the hood. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_SNDRAWDONE.txt b/internal/help/_SNDRAWDONE.txt index c7c11853e..2931dc556 100644 --- a/internal/help/_SNDRAWDONE.txt +++ b/internal/help/_SNDRAWDONE.txt @@ -10,8 +10,8 @@ * Use to force playing small buffers of [[_SNDRAW]] data. -==Availability== -* '''Version 1.000 and up''' +{{PageAvailability}} +* Version 1.000 and up. {{PageSeeAlso}} diff --git a/internal/help/_STARTDIR$.txt b/internal/help/_STARTDIR$.txt index 0b10ff757..b8679e097 100644 --- a/internal/help/_STARTDIR$.txt +++ b/internal/help/_STARTDIR$.txt @@ -9,8 +9,8 @@ The [[_STARTDIR$]] function returns the path a user called a QB64 program from. * Returns a [[STRING]] representing the user's program calling path. -==Availability== -* '''Version 1.000 and up'''. +{{PageAvailability}} +* Version 1.000 and up. {{PageExamples}} diff --git a/internal/help/_TITLE$.txt b/internal/help/_TITLE$.txt index 52efefd33..d27eb7853 100644 --- a/internal/help/_TITLE$.txt +++ b/internal/help/_TITLE$.txt @@ -1,5 +1,5 @@ {{DISPLAYTITLE:_TITLE$}} -The [[_TITLE$]] function returns the program title last set by the [[_TITLE]] statement. +The [[_TITLE$]] function returns the program window's title-bar text as last set by the [[_TITLE]] statement. {{PageSyntax}} @@ -7,11 +7,11 @@ The [[_TITLE$]] function returns the program title last set by the [[_TITLE]] st {{PageDescription}} -* If no title has been set, the title bar will say "Untitled" and this function will return an empty [[STRING|string]] (""). +* The title bar will display "Untitled" if no title has been set and this function will return an empty [[STRING|string]] (""). -==Availability== -* '''Build 20170924/68.''' +{{PageAvailability}} +* Build 20170924/68 and up. {{PageSeeAlso}} diff --git a/internal/help/_TITLE.txt b/internal/help/_TITLE.txt index 2545965e9..1f1c2e1d0 100644 --- a/internal/help/_TITLE.txt +++ b/internal/help/_TITLE.txt @@ -1,5 +1,5 @@ {{DISPLAYTITLE:_TITLE}} -The [[_TITLE]] statement provides the program name in the title bar of the program window. +The [[_TITLE]] statement sets the program window's title-bar text. {{PageSyntax}} @@ -7,18 +7,17 @@ The [[_TITLE]] statement provides the program name in the title bar of the progr {{PageParameters}} -* {{Parameter|text$}} can be any literal or variable [[STRING]] or [[ASCII]] character value. +* {{Parameter|text$}} can be any literal or variable [[STRING]] value. {{PageDescription}} -* The title can be changed anywhere in a program procedure. -* The title bar will say "Untitled" if a title is not set. -* Change the title of the [[$CONSOLE]] windows created using [[_CONSOLETITLE]] -* '''Note: A [[_DELAY|delay]] may be required before the title can be set.''' See [[_SCREENEXISTS]]. +* The title bar will display "Untitled" if a title is not set with this statement. +* The title of created [[$CONSOLE]] windows can be set using [[_CONSOLETITLE]]. +* Note: A [[_DELAY|delay]] may be required before the title can be set. See [[_SCREENEXISTS]]. {{PageExamples}} -''Example 1:'' How to create the window title bar. +''Example 1:'' How to set the program window's title-bar text. {{CodeStart}} '' '' {{Cl|_TITLE}} "My New Program" '' '' {{CodeEnd}} @@ -35,25 +34,25 @@ The [[_TITLE]] statement provides the program name in the title bar of the progr {{Cl|FUNCTION}} TITLE$ '=== SHOW CURRENT PROGRAM -{{Cl|SHARED}} PATH$ -{{Cl|DECLARE LIBRARY}} 'Directory Information using KERNEL32 provided by Dav - {{Cl|FUNCTION}} GetModuleFileNameA ({{Cl|BYVAL}} Module {{Cl|AS}} {{Cl|LONG}}, FileName {{Cl|AS}} {{Cl|STRING}}, {{Cl|BYVAL}} nSize {{Cl|AS}} {{Cl|LONG}}) -{{Cl|DECLARE LIBRARY|END DECLARE}} + {{Cl|SHARED}} PATH$ + {{Cl|DECLARE LIBRARY}} 'Directory Information using KERNEL32 provided by Dav + {{Cl|FUNCTION}} GetModuleFileNameA ({{Cl|BYVAL}} Module {{Cl|AS}} {{Cl|LONG}}, FileName {{Cl|AS}} {{Cl|STRING}}, {{Cl|BYVAL}} nSize {{Cl|AS}} {{Cl|LONG}}) + {{Cl|DECLARE LIBRARY|END DECLARE}} -FileName$ = {{Cl|SPACE$}}(256) -Result = GetModuleFileNameA(0, FileName$, {{Cl|LEN}}(FileName$)) -{{Cl|IF...THEN|IF}} Result {{Cl|THEN}} - PATH$ = {{Cl|LEFT$}}(FileName$, Result) - start = 1 - DO - posit = {{Cl|INSTR}}(start, PATH$, "\") - {{Cl|IF...THEN|IF}} posit {{Cl|THEN}} last = posit - start = posit + 1 - {{Cl|LOOP}} {{Cl|UNTIL}} posit = 0 - TITLE$ = {{Cl|MID$}}(PATH$, last + 1) - PATH$ = {{Cl|LEFT$}}(PATH$, last) -{{Cl|ELSE}} TITLE$ = "": PATH$ = "" -{{Cl|END IF}} + FileName$ = {{Cl|SPACE$}}(256) + Result = GetModuleFileNameA(0, FileName$, {{Cl|LEN}}(FileName$)) + {{Cl|IF...THEN|IF}} Result {{Cl|THEN}} + PATH$ = {{Cl|LEFT$}}(FileName$, Result) + start = 1 + {{Cl|DO}} + posit = {{Cl|INSTR}}(start, PATH$, "\") + {{Cl|IF...THEN|IF}} posit {{Cl|THEN}} last = posit + start = posit + 1 + {{Cl|LOOP}} {{Cl|UNTIL}} posit = 0 + TITLE$ = {{Cl|MID$}}(PATH$, last + 1) + PATH$ = {{Cl|LEFT$}}(PATH$, last) + {{Cl|ELSE}} TITLE$ = "": PATH$ = "" + {{Cl|END IF}} {{Cl|END FUNCTION}} '' '' {{CodeEnd}} : ''Note:'' The actual module file name is returned. Not necessarily the Title value. The value returned can be used however. diff --git a/internal/help/_TOGGLEBIT.txt b/internal/help/_TOGGLEBIT.txt index b036c0547..2cee60c6f 100644 --- a/internal/help/_TOGGLEBIT.txt +++ b/internal/help/_TOGGLEBIT.txt @@ -17,8 +17,8 @@ The [[_TOGGLEBIT]] function is used to toggle a specified bit of a numerical val * A bit set to 1 is changed to 0 and a bit set to 0 is changed to 1. * Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on) -==Availability== -* '''Version 1.4 and up'''. +{{PageAvailability}} +* Version 1.4 and up. {{PageExamples}} diff --git a/internal/help/_TOTALDROPPEDFILES.txt b/internal/help/_TOTALDROPPEDFILES.txt index 1e3165a0f..4e5ae6089 100644 --- a/internal/help/_TOTALDROPPEDFILES.txt +++ b/internal/help/_TOTALDROPPEDFILES.txt @@ -14,8 +14,8 @@ The [[_TOTALDROPPEDFILES]] function returns the number of items (files or folder * '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''. -==Availability== -* '''Version 1.3 and up'''. +{{PageAvailability}} +* Version 1.3 and up. {{PageExamples}} diff --git a/internal/help/_WINDOWHANDLE.txt b/internal/help/_WINDOWHANDLE.txt index cfc11b0c9..b81562be8 100644 --- a/internal/help/_WINDOWHANDLE.txt +++ b/internal/help/_WINDOWHANDLE.txt @@ -12,8 +12,8 @@ The [[_WINDOWHANDLE]] function returns the window handle assigned to the current * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]]. -==Availability== -* '''Build 20170924/68'''. +{{PageAvailability}} +* Build 20170924/68 and up. {{PageExamples}} diff --git a/internal/help/_WINDOWHASFOCUS.txt b/internal/help/_WINDOWHASFOCUS.txt index 517e6defa..02401178d 100644 --- a/internal/help/_WINDOWHASFOCUS.txt +++ b/internal/help/_WINDOWHASFOCUS.txt @@ -11,8 +11,8 @@ The [[_WINDOWHASFOCUS]] function returns true (-1) if the current program's wind * [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in macOS]]. -==Availability== -* '''Build 20170924/68'''. +{{PageAvailability}} +* Build 20170924/68 and up. {{PageExamples}}