home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / TURBOM2 / M2GUIDE.NOT < prev    next >
Text File  |  2000-06-30  |  6KB  |  121 lines
  1.                  The Turbo Modula-2 User's Guide
  2.                  ===============================
  3.                      Some Notes and Comments
  4.                       Glenn Brooke 12/29/86
  5.  
  6. Disclaimer  1  : I have no commercial or  monetary  interests  in 
  7. Borland  International  or  Echelon  Inc.   These  are   strictly 
  8. personal  notes  and  comments,  constituting  one   individual's 
  9. perspective.
  10.  
  11. Disclaimer 2 : I have only used Turbo Modula-2 for a short while.  
  12. I will therefore limit my comments to the Guide.
  13.  
  14. ****  General  impression : THIS IS  AN  EXCELLENT  MANUAL! ****
  15.  
  16. PHYSICAL FORM 
  17. =============
  18.      The Guide is a quality paperbound publication, quite sturdy.  
  19. It  should  hold  up well to programmer abuse.   This  is  a  big 
  20. manual; there are 544 pages of dense print.  I doubt anyone  will 
  21. complain about lack of information here!  It would be terrific if 
  22. the guide laid flat, since part of it serves as a reference Guide 
  23. for the libraries and will be in regular use beside the keyboard, 
  24. but my magazine holder works just fine.  Some weak-eyes folks may 
  25. wish  for  larger  type, too, particularly in  dim  light.    The 
  26. layout itself is readable and well organized.  The detailed table 
  27. of contents, list of tables and figures, and index are a  delight 
  28. to use.
  29.  
  30. OVERVIEW OF CONTENTS
  31. ====================
  32.      There  are  four areas to the Guide:  an  introduction,  the 
  33. module  library, a reference section, and appendices.  There  are 
  34. twelve  chapters  covering startup  and  configuration,  Modula-2 
  35. language  structure,  elements, and basic  programming  strategy, 
  36. more   advanced   topics  (such   as   system-specific   details, 
  37. extensions,     low-level     facilities),     use     of     the 
  38. editor/compiler/linker  shell and utilities, complete  discussion 
  39. of the library modules (14 modules, over 100 procedures), and the 
  40. extensive  (280  pages!)  look-up  reference  section  of   every 
  41. language feature, extension, and procedure in the Turbo  Modula-2 
  42. implementation.   Six  appendices cover the  differences  between 
  43. Modula-2   and  Pascal,  detailed   installations   instructions, 
  44. compiler directives, error messages/definitions/diagnosis  (quite 
  45. well  done!),  BNF syntax diagrams, and special features  of  the 
  46. SB180-specific compiler.  
  47.      This is a lot of information!  I'm certain that most of  the 
  48. programmer's questions will be answered by a simple check of  the 
  49. manual.   This  Guide  beats  those packaged  with  the  FTL  and 
  50. Logitech implementations hands down, in my opinion.
  51.  
  52. QUALITY OF WRITING
  53. ==================
  54.      Ok,  so there is a lot of information.  Is it organized  and 
  55. presented in a clear, readable, usable fashion?  That's the  true 
  56. test of a manual, isn't it?
  57.      I  had  absolutely  no trouble  following  the  installation 
  58. instructions  and compiling the sample programs  provided,  using 
  59. the  information in chapter 1 ("Getting Started").  As a  further 
  60. test,  however,  I let Cathy, my fiance, do the same  thing  from 
  61. scratch,  using  only the manual.  Cathy is  an  intelligent  but 
  62. computer-naive user.  She got it perfectly the first time.  
  63.      The Guide has a wonderful tone, talking with the user as  an 
  64. intelligent   person  with  real  questions.   There   are   many 
  65. suggestions  for  using the compiler options, for  instance,  and 
  66. better  yet, explanations of why errors may occur  and  different 
  67. methods   to  circumvent  them.   Not   hand-holding,   insulting 
  68. descriptions,  but  friendly explanations.  I  found  this  quite 
  69. refreshing  after reading several insulting (even worse,  useless 
  70. or just plain wrong) manuals over the past years.
  71.      Anyone seriously interested in learning about Turbo Modula-2 
  72. will  have little trouble with this Guide.  You won't have to  be 
  73. an  expert programmer to dig out the information, you won't  have 
  74. to  wade  through insulting prose, and above all you  won't  have 
  75. (many) unanswered questions.
  76.  
  77. USER'S GUIDE AND USING TURBO MODULA-2
  78. =====================================
  79.      I can honestly tell you that you must have the Guide to make 
  80. full  use of the compiler/editor/linker system.  You  can  hardly 
  81. imagine the wealth of information about the libraries (which  you 
  82. must  know before you can really use them in programs),  compiler 
  83. and  linking options, and extensions to standard  (Wirth-defined) 
  84. Modula-2  that  you will never discover without the Guide.  I  am 
  85. glad for this; it should severely curtail pirating, ensuring that 
  86. Echelon and Borland receive their just rewards.  
  87.      I  hope that no one examines the compiler without the  Guide 
  88. and proceeds to make reviews, because you might as well buy a car 
  89. based upon the brochure's description of the ride.  Get the whole 
  90. picture; get the Guide.
  91.      This  means,  of course, that you will be  using  the  Guide 
  92. quite a bit, at least initially.  That's fine.  You would do that 
  93. with  any  new implementation of any language, and for  once  you 
  94. have a Guide worth taking along on your adventures!
  95.  
  96. LEARNING MODULA-2 FROM THE GUIDE
  97. ================================
  98.      The  Guide makes a good effort to teach Modula-2  principles 
  99. and  practice.  If you already know even a little  Modula-2,  the 
  100. Guide  will be sufficient to bring you up to speed.  If  you  are 
  101. familiar  with  Pascal, the Guide will almost  certainly  contain 
  102. enough  information for you to learn Modula-2 (see the  excellent 
  103. comparison  of  Pascal and Modula-2 in Appendix A).  If  you  are 
  104. comfortable with another structured high level language (like C), 
  105. the  Guide  will  be an excellent  start  to  learning  Modula-2, 
  106. although  you may want to study other introductions to  Modula-2.  
  107. If you are new to programming in structured high level languages, 
  108. I would seriously advise you to read other introductory books  on 
  109. Modula-2 in addition to the Guide; the Guide does not contain  an 
  110. extensive tutorial that would be helpful to real novices.
  111.  
  112. SUMMATION
  113. =========
  114.      The  User's  Guide  is excellent.  Turbo  Modula-2  (by  all 
  115. accounts so far) is excellent.  Get it!  No point in saying more.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.