home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / oplrefdoc / ReadMe < prev   
Text File  |  1995-04-02  |  5KB  |  102 lines
  1. ReadMe file for OPL_Ref (27-Feb-95)
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4.  
  5. What this is
  6. ~~~~~~~~~~~~
  7. This is an Impression Publisher/Style version of OPLREF/ZIP, a Psion/Pocket Book II
  8. database file of OPL commands specific to the 3a/Pocket Book II - the original file
  9. can be found on Arcade BBS and elsewhere. Acorn make a Programming Manual which
  10. contains many OPL tutorials and command reference sections, if you are new to
  11. programming you may find this document insufficient for your needs (it only contains
  12. reference information with a few use-examples).
  13.  
  14. OPL_Ref is A4 and should be printed 'backed-up' (printed on both side of the paper).
  15. See the section on Printing Hints for further information.
  16.      
  17.  
  18. The OPL Language
  19. ~~~~~~~~~~~~~~~~
  20. If you know BBC BASIC then you should get on well with OPL, however there are one or
  21. two pitfalls to catch you out. As these are not immediately obvious in OPL_Ref, the
  22. main differences are detailed below:
  23.  
  24.   Acorn-Esc aborts a running program.
  25.         
  26.   Program flow: OPL executes the first PROC and then exits therefore use the
  27.   first procedure to control the rest of your code - it's a bit like C's
  28.   main.
  29.  
  30.   You are forced to declare whether a variable is LOCAL or GLOBAL before you
  31.   can use it.
  32.  
  33.   Variable names can be a maximum of 8 characters - no longer. If a variable
  34.   ends in $ (string), % (integer +32767 to -32768 only), & (long integer +2147483647
  35.   to -2147483648) then the last identifying character uses up one of your eight.
  36.   Unless specified in this manner, variables are floating point. The machine works
  37.   fastest with integer variables.
  38.  
  39.   Array%(5) creates a five element integer array as normal, but Str$(5) means
  40.   'create a string variable which can contain five characters maximum' - you must
  41.   specify length when you create a string variable.
  42.  
  43.   There are no two dimensional arrays! If you see Str$(20,10) in OPL it means a
  44.   string array of 20 elements, each 10 characters maximum.
  45.  
  46.   OPL is largely case insensitive: Pocket% and pocket% are the same variable. Don't
  47.   create variables with the same name as OPL keywords.
  48.  
  49.   Acorn-T translates your OPL code into an OPO (a 'runable' program). After successful
  50.   translation you are invited to run your code (it will also appear as a file under
  51.   the RunOpl icon on the Desktop).
  52.   You can also create OPA's (OPL Applications) with their own icon, etc - see the APP
  53.   keyword for details. OPA's must be installed from the Desktop's 'Apps' menu before
  54.   they can be run. There is usually no need to remove and re-install if you change the
  55.   OPL code and re-compile.
  56.  
  57.   That's all, there was something else but I can't think of it right now... :(
  58.  
  59.  
  60. Authors
  61. ~~~~~~~
  62. nhealey@cix.compulink.co.uk did all the hard work and suggests you send comments, bugs
  63. etc to that address - BEWARE if it looks like a layout error then it's my fault! To
  64. avoid any (mutual) embarrassment I suggest you contact me in the first instance:
  65.  
  66. Internet        jdstaples@arcade.demon.co.uk
  67. FidoNet         James D. Staples at 2:254/27.0 (User 1576, Arcade BBS)
  68.  
  69.  
  70. Printing Hints
  71. ~~~~~~~~~~~~~~
  72. Impression has excellent control over how pages are printed; you'll need to know
  73. your way around the Print dialogue boxes (covered in Impression's manual). If you
  74. are an experienced Impression printer you can stop reading now - hope you find
  75. OPL_Ref useful!
  76.  
  77. If you view OPL_Ref, imagine the rings of a ring binder running down the centre of
  78. the pages. The first left hand page is nonexistent, the first right hand page is the
  79. cover sheet and if this page were turned, on the rear you would find the first page
  80. of the index (which is a double page spread). Turn the right hand index page over
  81. and on the rear is page one of the main section.
  82.  
  83. First you should print all the left hand pages only then reload the paper and print
  84. just right hand pages on the reverse side.
  85.  
  86. If, after the first print run, you have successfully printed one face of the paper
  87. but now all of the sheets are in reverse order then don't panic: there is a Reverse
  88. switch in the Print dialogues: Impression can print documents backwards (Satan!).
  89.  
  90. When Impression says 'Print From 1 to 9', etc it doesn't mean the numbers on the
  91. bottom of the sheets you will print. OPL_ref page numbering starts with '1' on page
  92. five; page one is blank, two is the cover sheet, three and four are the index. Subtract
  93. 4 from the physical page number to get that particular OPL_Ref numbered page.
  94.  
  95. That's it - mail me if you have printing problems. If you have OPL problems please
  96. don't mail me; they are your problems, you own them, I don't want to share them with
  97. you ;)
  98.  
  99. James
  100. Loughborough, UK
  101. PocketFS, Edit, Zap, BASIC, Publisher and Hatris were used in the creation of OPL_Ref.
  102.