home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / programs / list / ep-docs.ark / EPERROR.DOC < prev    next >
Text File  |  1988-05-21  |  5KB  |  104 lines
  1. \high-resolution
  2. \ad 1"\ll 6"\font Helvetica
  3. \co\ju
  4. Notes on Eperror\ra Greg Lee, 9/84
  5. \ec #
  6.  
  7.   On those rare occasions when EP detects an erroneous formatting command,
  8. it will chain to EPERROR.COM, provided it can find this file on the
  9. current default disk. After Eperror has been called, the two most frequently
  10. exercised options will be ^C, to exit, or `e<CR>' to edit the file that
  11. was being formatted. But there are others.
  12.  
  13.   First, a few words about `e' for edit. The idea is to have an economical
  14. way for you to call up your own text editor, so all this does is call up
  15. the editor and supply the name of a text file. If the `e' is followed
  16. immediately by a carriage return, the name supplied to the editor will
  17. be that of the "principle" file that was being printed. This is the
  18. name that was given right after `EP' when EP was originally called. When
  19. you are using imbedded files, this might not be the file in which the
  20. problem arose. Fortunately, the `e' command can also be followed (immediately)
  21. by the name of the file you would actually like to edit.
  22.   The initial assumption is that your editor has the file name `E.COM'.
  23. If that is not so, this assumption can be changed by placing the name
  24. into the initialization file `EP.INI', by going through the following
  25. procedure:
  26.     (1) if eperror has not already been called, call it with
  27.         A>eperror
  28.     (2) load a fresh copy of EP.INI with `l<CR>'
  29.     (3) use the `$' command to enter the name of your editor -- e.g.
  30.         if the editor's file name is WS.COM, type `$ws<CR>' (don't
  31.         include the extension)
  32.     (4) save the updated EP.INI with `s<CR>'
  33.  
  34. In step (1), if Eperror is called independently, and the last program that
  35. you ran under CPM was not EP, Eperror's attempt to characterize the error
  36. that occurred and to list the line where it was found will produce some
  37. junk on the screen.
  38.  
  39.   Now for the other options. Eperror can be used to browse though the
  40. data area that EP has just been using, and also to change the default values
  41. assumed for command variables (page-length, bottom-margin, and so on).
  42. I don't know how much use this will be to you -- probably not much. As to
  43. browsing, Eperror has screen prompts that say how to look at what. If you
  44. are making extensive use of your own variables and macro commands, it
  45. might be helpful to look at the current variable values with the `\'
  46. command.
  47.  
  48.   As for changing default values, you might find it more straightforward
  49. to do this through EP by use of the \save command (cf. EPREF.DOC). But if
  50. you choose to use Eperror, the procedure is much like that given above
  51. for changing the editor's name, except that step (3) would involve using
  52. the `=' command to patch in new default values. The value typed in after
  53. `=', by the way, can be a decimal number, a hex number followed by `h',
  54. a character, or nothing (in which case 0 is assumed).
  55.   One sort of change to the defaults that you would need Eperror for is
  56. this: within EP.INI are codes for the types of EP commands, like whether
  57. they have arguments which are horizontal measures, and whether they cause
  58. breaks. In this last regard especially, you might find some of the
  59. choices I have made inconvenient. Or you might want to type some of your
  60. own variables. To change a type, obtain the memory address and the current
  61. value with the `t' command, then enter your new choice using `='. Here
  62. are the meanings of the bits in the coding:
  63.  
  64.     bit 0    takes `h' type argument -- numerical value, horizontal measure
  65.     bit 1    takes `v' type argument -- numerical value, vertical measure
  66.     bit 2    synonym of Epson command -- value is character to turn on
  67.                     an Epson print mode
  68.     bit 3    causes a break
  69.     bit 4    takes `c' type argument -- character value
  70.     bit 5   value is special character to be placed in output line
  71.     bit 6    value is pointer to string
  72.     bit 7    causes a break before next input line
  73.     bits 5 and 1 together
  74.         assume argument=1, don't scan for a numerical argument
  75.  
  76. Among the "special" characters associated with bit 5 are some internal
  77. codes, as follows:
  78.  
  79.     90H    center the following
  80.     91H    right adjust the following
  81.     92H    wide space
  82.     93H    wide space with absolute width
  83.     94H    pause here for console input
  84.     95H    place wide space here (from use of \hfill)
  85.     96H    back space
  86.  
  87.  
  88.   And finally, for reference, here is the overall format of the initialization
  89. data kept in EP.INI:
  90.  
  91.             load
  92.  type    symbol        addr size
  93.  
  94.  word    val[27][27]    4906 05B2 values of `pl', etc.
  95.  byte    valtp[27][27]    4EB8 02D9 type of value, e.g. numerical
  96.  byte    modelen[64]    5191 0040 width of Epson built-in char's, for each mode
  97.  byte    pmlen[256]    51D1 0100 width of Epson proportional char's
  98.  word    mode        52D1 0002 16 bits keep track of font, etc.
  99.  byte    (not used)    52D3 0001
  100.  byte    bending[7][24]    52D4 00A8 data for \bend command
  101.  byte    editname[10]    537C 000A name of editor called by eperror
  102.     (end)        5386
  103.         total = A80H bytes, 10 pp. or 21 records
  104.