From svn@openbios.org Sat Jul 12 01:21:45 2008 From: svn@openbios.org To: openbios@openbios.org Subject: [OpenBIOS] r197 - fcode-utils/documentation Date: Sat, 12 Jul 2008 01:21:44 +0200 Message-ID: <154570864611.2635.15080165207410552993.generated@e1831fe80046> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============4442617798301998441==" --===============4442617798301998441== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Author: stepan Date: 2008-07-12 01:21:43 +0200 (Sat, 12 Jul 2008) New Revision: 197 Modified: fcode-utils/documentation/localvalues.html fcode-utils/documentation/toke.html Log: some documentation fixes in the fcode suite documentation Modified: fcode-utils/documentation/localvalues.html =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- fcode-utils/documentation/localvalues.html 2008-07-08 16:02:43 UTC (rev 1= 96) +++ fcode-utils/documentation/localvalues.html 2008-07-11 23:21:43 UTC (rev 1= 97) @@ -185,7 +185,7 @@ body of the word is not recommended, but is permitted.  A Local Values Declaration that occurs inside a Flow-Control Structure will be -reported as an Error.
+reported as an Error.

A Local Values Declaration may include comments and may continue across @@ -225,18 +225,18 @@ Vertical-Bar.

The User may suppress this message by means of a Command-line + href=3D"toke.html#Command-Line_options_">Command-line switch, known as the -Special-Feature -Flag named Special-Feature +Flag named No= LV-Legacy-Message -, which is described in the Tokenizer +, which is described in the Tokenizer User's Guide.

Conversely, the User who wishes to disallow the use of Semicolon as an alternative separator may do so by means of the Special-Feature Flag named No= LV-Legacy-Separator .  When the Legacy Local Values Separator is thus disallowed, occurrences will be treated as an @@ -757,9 +757,9 @@ style=3D"font-family: courier new,courier,monospace; font-weight: bold;">in= stance data.

-The consequence +The consequence of this is that, in device-drivers that are configured -with multiple +with multiple device-nodes, the Local Values Support Functions file must be re-floaded for each device-node that uses Local Values.  That is to say, every @@ -770,18 +770,18 @@ Functions file must be floaded again.

The Tokenizer is sophisticated enough to keep a separate + href=3D"toke.html#device-node_vocabularies">separate vocabulary for each device-node, and will flag an Error= if Local Values are used in a device-node for which the Local Values Support Functions file has not been floaded.

However, should the user so choose, a means is available + href=3D"toke.html#Example_4">means is available whereby a single floading of the Local Values Support Functions can become accessible to all + href=3D"toke.html#Global_Definitions">accessible to all Device Nodes in a driver, trading off economy of System-memory for convenience of programming.

-

An overloaded= +

An overloaded catch in the Local Values Support Functions file does the job.

Modified: fcode-utils/documentation/toke.html =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- fcode-utils/documentation/toke.html 2008-07-08 16:02:43 UTC (rev 196) +++ fcode-utils/documentation/toke.html 2008-07-11 23:21:43 UTC (rev 197) @@ -347,7 +347,7 @@ messages.
  • A complete list of FATAL conditions.
  • -
  • Support for IBM-Style Local +
  • Support for IBM-Style Local Values. That is the subject of a separate writeup.
  • @@ -416,8 +416,8 @@ generated into the Binary Output.  If a PCI Header is in effect, the position relative to the end of that PCI Header will also be shown; this is to maintain consistency with the "offsets" displayed be the DeTokenizer
    + href=3D"detok.html#with_offsets">"offsets" displayed by the DeTokenizer

    The Tokenizer typically runs through to completion of the source file, @@ -786,7 +786,7 @@

    Support IBM-style Local Values ("LV"s).  + href=3D"localvalues.html">Local Values ("LV"s).  Initially disabled.

    Allow Semicolon for Local Values = Separator -("Legacy"). + href=3D"localvalues.html#Separation_Character_between_Initialized">Separato= r +("Legacy").

    Display a Warning + href=3D"localvalues.html#Legacy_Separator">Warning Message when Semicolon is used as the Local Values Separator. @@ -3462,7 +3462,7 @@ Support File can be incorporated at a Global= level.  Normally, that would be problematical because -the Local +the Local Values Support functions are written to use in= stance --===============4442617798301998441==--