home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #18 / NN_1992_18.iso / spool / comp / lang / apl / 956 < prev    next >
Encoding:
Text File  |  1992-08-18  |  2.5 KB  |  62 lines
  1. Newsgroups: comp.lang.apl
  2. Path: sparky!uunet!utcsri!torn!csd.unb.ca!UNBVM1.CSD.UNB.CA
  3. From: WRK0000 <WRK0@UNB.CA>
  4. Subject: APL2 HELP WORKSPACE
  5. Message-ID: <19AUG92.16132706.0052@UNBVM1.CSD.UNB.CA>
  6. Lines: 51
  7. Sender: usenet@UNB.CA
  8. Organization: The University of New Brunswick
  9. Date: Wed, 19 Aug 1992 18:56:15 GMT
  10.  
  11.  
  12.  Can you  remember whether  cosine is  1-circle or  2-circle?
  13.  Can you remember how to run  your system's quad function for
  14.  writing error handlers, or even what it is called?
  15.  
  16.  I can't:  So I made myself a "help" workspace.
  17.  
  18.  A help workspace in APL is easy, easy.  Text pertaining to a
  19.  topic is put  in a character array or a  function whose name
  20.  is the  topic.   Type COSINE  to find out  about "2-circle".
  21.  Having a  function demonstrate  its topic  on the  fly is  a
  22.  nifty touch, easy to do, and helps avoid mistakes.   Easy to
  23.  add topics:   The name of the new character matrix goes into
  24.  the symbol table automatically.
  25.  
  26.  My workspace is about IBM mainframe APL2 in ditto.
  27.  
  28. ** Something I did wrong:
  29.  I thoughtlessly thought like a programmer,  and didn't leave
  30.  well enough alone,  but wrote a program  -- a query parser.
  31.  Quad-LX  invokes  this  superfluous   parser  program  which
  32.  intercepts and processes your  query.   Though this provides
  33.  for queries  in the APL  alphabet,  in afterthought  I doubt
  34.  t'was worth the price in complication.   If your word be not
  35.  there, the parser tries to match leading letters with a word
  36.  it knows;   still not worth the  price as a  quad-NL command
  37.  would probably get  you there without the parser  which is a
  38.  program and so can and will go wrong.
  39.  
  40. ** Something I did right:
  41.  There are  synonyms.   Help  systems that  help only  if you
  42.  query according to their ideas  of proper vocabulary abound.
  43.  (Ever desperately try OFF, LOGOFF, BYE, STOP, END, QUIT, and
  44.  DROP DEAD, to escape a system which wants  Q() ,  accepts no
  45.  substitutes,  and whose supposed help facility only replies,
  46.  "topic unknown", unless you specifically query "Q()", which,
  47.  if you already know,  you need not ask?)   My  help tells of
  48.  )OFF when queried with STOP.
  49.  
  50.  _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
  51.  
  52.  Anyway,  the help workspace exists.   I'd like to send it to
  53.  people who would give it a good  home and maybe add topics I
  54.  left out, but I have no idea how to ship APL over the wires.
  55.  Only a masochist retypes from  printed copy.   (Among topics
  56.  missing from  workspace HELP  is how to  port APL,   so this
  57.  message is itself an implied request for help.)
  58.  
  59.  
  60.  William Knight / University of New Brunswick / Canada
  61.  
  62.