Digest #29 2018-02-27
Contributions
referenceImplementation - Standard 2012 as slightly reduced version - but as Part of the Forth Bookshelf
Dear Forthers,
when I fell over the standard here, I wondered why it is not more known, promoted and probably used.
As result I downloaded the PDF and tried to squeeze it into an additional eBook to make it part of the Forth Bookshelf. To give it some value as eBook, I would list it with the same costing the usual $4 to cover the done and additional work, in the future. As people can see the relevant links in the preview, they will know where to find the free PDF and can decide if it is worth buying the eBook. But the promotion to the Standard has been achieved anyway. I contributed it to Stephen Pelc who gave me so much support with my journey with Forth over the last 5 years. As well MPE made the VFXTESTAPP available, MSP430LITE and ARM LIT in addition to the commercial products.
This year is 50 Years Of Forth.
When I started writing / collecting for A Start With Forth Part 2
- I saw that referencing to this documentation would be quite helpful for the ones who want to Start With Forth.
The probelm I see now that it is not clear who would be the company / body / person within the Forth Community to give the ok for such a venture,
as done with all the other eBooks asking Chuck, Leon, Stephen, Ting, Leo and others
to make sure we have such a Forth Bookshelf. without copyright violations,
which is acually visible worldwide on amazon
and amazon actually sometimes runs advertising emails about Forth - encluding my eBooks.
The A Taste of the 2012 Forth Standard is nearly ready and I sent a partial PDF to Stephen for guidance, and he suggested to ask here.
Looking forward to your feedback.
This eBook that can be read on tablets and Mobiles as well, is shortened to the parts that can be read easily on Mobiles. The Contents pages further down show the original list and an i shows which parts are included ( or too difficult to reformat - so I left them out ). it relates to the Complete Document and shows which parts are included
- but the link to the complete Document is included anyway.
Contents Page of the full Standards document is shown and the link to it ( and pages _i marked sections are included in this eBook ) The full document for free download can be found at http://forth-standard.org/ and at http://www.forth200x.org/
Page numbers relate to the original PDF document so people can go there easily
Contents v_i
Foreword vi_i
Proposals Process vii_i
200x Membership x_i
1 Introduction 13_i 1.1 Purpose 13_i 1.2 Scope 13_i 1.2.1 Inclusions 13_i 1.2.2 Exclusions 13_i 1.3 Document organization 13_i 1.3.1 Word sets 13_i 1.3.2 Annexes 14_i 1.4 Future directions 14_i 1.4.1 New technology 14_i 1.4.2 Obsolescent features 14_i
2 Terms, notation, and references 16_i 2.1 Definitions of terms 16_i 2.2 Notation 19_i 2.2.1 Numeric notation 19_i 2.2.2 Stack notation 19_i 2.2.3 Parsed-text notation 19_i 2.2.4 Glossary notation 19_i 2.2.5 BNF notation 20_i 2.3 References 21_i
3 Usage requirements 22_i 3.1 Data types 22_i 3.1.1 Data-type relationships 22_i 3.1.2 Character types 23_i 3.1.3 Single-cell types 24_i 3.1.4 Cell-pair types 26_i 3.1.5 System types 26_i 3.2 The implementation environment 27_i 3.2.1 Numbers 27_i 3.2.2 Arithmetic 27_i 3.2.3 Stacks 28_i 3.2.4 Operator terminal 29_i 3.2.5 Mass storage 29_i 3.2.6 Environmental queries 29_i 3.2.7 Obsolescent Environmental Queries 29_i
3.3 The Forth dictionary 30_i 3.3.1 Name space 30_i 3.3.2 Code space 31_i 3.3.3 Data space 31_i
3.4 The Forth text interpreter 33_i 3.4.1 Parsing 34_i 3.4.2 Finding definition names 35_i 3.4.3 Semantics 36_i 3.4.4 Possible actions on an ambiguous condition 36_i 3.4.5 Compilation 37_i
4 Documentation requirements 38 4.1 System documentation 38 4.1.1 Implementation-defined options 38 4.1.2 Ambiguous conditions 39 4.1.3 Other system documentation 41 4.2 Program documentation 41 4.2.1 Environmental dependencies 41 4.2.2 Other program documentation 42
5 Compliance and labeling 43 5.1 Forth-2012 systems 43 5.1.1 System compliance 43 5.1.2 System labeling 43 5.2 Forth-2012 programs 43 5.2.1 Program compliance 43 5.2.2 Program labeling 43
6 Glossary 44 6.1 Core words 44 6.2 Core extension words 73
7 The optional Block word set 86 8 The optional Double-Number word set 92 9 The optional Exception word set 98 10 The optional Facility word set 103 11 The optional File-Access word set 114 12 The optional Floating-Point word set 126 13 The optional Locals word set 146 14 The optional Memory-Allocation word set 152 15 The optional Programming-Tools word set 155 16 The optional Search-Order word set 165 17 The optional String word set 170 18 The optional Extended-Character word set 175
A Rationale 182 A.1 Introduction 182 A.2 Terms and notation 182 A.3 Usage requirements 183 A.4 Documentation requirements 197 A.5 Compliance and labeling 197 A.6 Glossary 198 A.7 The optional Block word set 214 A.8 The optional Double-Number word set 214 A.9 The optional Exception word set 216 A.10 The optional Facility word set 217 A.11 The optional File-Access word set 221 A.12 The optional Floating-Point word set 223 A.13 The optional Locals word set 226 A.14 The optional Memory-Allocation word set 227 A.15 The optional Programming-Tools word set 227 A.16 The optional Search-Order word set 230 A.17 The optional String word set 231 A.18 The optional Extended-Character word set 232
B Bibliography 234_i
C Compatibility analysis 236_i C.1 FIG Forth (circa 1978) 236_i C.2 Forth 79 236_i C.3 Forth 83 236_i C.4 ANS Forth (1994) 237_i C.5 ISO Forth (1997) 237_i C.6 Approach of this standard 238_i C.7 Differences from Forth 94 238_i C.8 Additional words 241_i
D Portability guide 244_i D.1 Introduction 244_i D.2 Hardware peculiarities 244_i D.3 Number representation 246_i D.4 Forth system implementation 247_i D.5 Summary 248_i
E Alphabetic list of words 249_i
I understand that people might believe that such an eBook might not be necessary
- but if giving the copyright JUST for the publication is acceptable, I assume the people who are being made aware of the Standard will appreciate it as they do the other eBooks of the Bookshelf
- and can always look into it, see the link to the location here and decide then if they want to buy it to look at it on the move easily.
Looking forward to your feedback.
Kind regards Juergen