Q57502: LoadFont Function Example Documentation Error in BASIC 7.00

Article: Q57502
Product(s): See article
Version(s): 7.00 7.10
Operating System(s): MS-DOS
Keyword(s): ENDUSER | SR# S891211-4 docerr | mspl13_basic
Last Modified: 8-JAN-1991

Page 524 of the "Microsoft BASIC 7.0: Language Reference" for
Microsoft BASIC Professional Development System (PDS) Versions 7.00
and 7.10 shows an incorrect example of how to load a font by its order
in the font file. This documentation incorrectly states the following:

   Note that to load fonts according to their order in the font
   file, l% would take the form:

      l% = LoadFont%("n1,n3,n6")

The code above should read as follows (where l% means L%, not to be
confused with 1%):

   l% = LoadFont%("n1/n3/n6")

When loading multiple fonts, each font given in the fontspec$ argument
of LoadFont%(fontspec$) should be separated by forward slashes (the
"/" character), not by commas.

If the code in this documentation error is used, only the first font
is loaded (l% contains the number "1", indicating that only one font
is loaded).

Code Example
------------

The following code example demonstrates the documentation problem. To
use this code example, you must start QBX.EXE with /L FONTBEFR.QLB to
access the font routines.

REM $INCLUDE: 'fontb.bi'
'* Load a the Times Roman font.
SCREEN 9
PRINT "Registering Times Roman font."
FontNum% = RegisterFonts("D:\BC7\FONTS\TMSRB.FON")
PRINT "Number of fonts in the file: "; FontNum%
PRINT "Loading fonts 4,5,6 from the Times Roman file."
var1% = LoadFont%("N4,N5,N6")
PRINT "Number of fonts successfully loaded"; var1%
PRINT "value of FontErr", FontErr
a$ = "Hello world"
var1% = OutGText%(100, 100, a$)
END

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1986-2002.