home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #30 / NN_1992_30.iso / spool / comp / sys / mac / programm / 19809 < prev    next >
Encoding:
Internet Message Format  |  1992-12-14  |  3.3 KB

  1. Path: sparky!uunet!noc.near.net!hri.com!ukma!hsdndev!husc-news.harvard.edu!husc9!winer
  2. From: winer@husc9.Harvard.EDU (Adam Winer)
  3. Newsgroups: comp.sys.mac.programmer
  4. Subject: Re: Advice on Constructing Help Subsystem
  5. Keywords: Help,Hypercard,Apple Events
  6. Message-ID: <1992Dec14.154728.18481@husc3.harvard.edu>
  7. Date: 14 Dec 92 20:47:26 GMT
  8. References: <1992Dec14.044553.26938@feline.uucp>
  9. Sender: winer@husc9 (Adam Winer)
  10. Organization: Harvard University Science Center
  11. Lines: 54
  12. Nntp-Posting-Host: husc10.harvard.edu
  13.  
  14. In article <1992Dec14.044553.26938@feline.uucp>, king@feline.uucp (KingLeon) writes:
  15.  
  16. |>    Balloon help I find interesting, but very annoying - perhaps because
  17. |> it gets its message across too quickly and effectively, perhaps because
  18. |> all help is turned on when the user problably only wants to know about
  19. |> one item.  Help is restricted to objects that are physically present.
  20.  
  21. Try a cool shareware control panel called SpeedyFinder (v 1.5.7, I think).
  22. It lets you configure a group of modifier keys that, when held down,
  23. activate balloon help;  that way, you can get help for one thing alone.
  24. |> I'm working on my lecture notes for a course on GUI programming.  The
  25. |> course is a comparative study of the Mac and Windows.  Currently I am
  26. |> One can't ask about "how do I do this" kind of questions.  Windows help
  27. |> launches another hypertext application (WinHelp) which has a terrible 
  28. |> authoring environment and obscures the original application window.
  29. |> 
  30. |>     I recall that Apple at one time was pushing Hypercard as its help 
  31. |> environment, but that didn't seem to take place.
  32. |> 
  33. |>     My question is as follows:  What would a preferred method of adding 
  34. |> Help to an application:
  35. |>      1.  Launch Hypercard then send it a parameter or command either
  36. |>          thru an Apple Event, global memory value or a keyword that
  37. |>          is written to a a file?
  38. Definitely not;  that would be stunningly slow.
  39.  
  40. |>      2.  Stick with Balloon Help?
  41. |>      3.  There is some other technique that I've missed?
  42. Somewhere (IM VI, I believe), Apple discusses what type of help they think
  43. programs should provide.  If I remember correctly, it was multipart.
  44.    #1:  Balloon help, for very simple questions (basically, what the hell does
  45.               this button (menu item, etc.) do?)
  46.    #2:  Online help: see a typical Microsoft product for an example of this.
  47.             There are some freeware code packages that make implementing a
  48.             scaled down version of this _very_ easy.  I have one I highly
  49.             suggest, called "Show Help 2.0".  I got it off of Compuserve, so
  50.             I don't know if it's ftp'able.
  51.    #3:  A tutorial, preferably online.  I'm sure some programs have this, but
  52.             I can't remember an online tutorial in any program I've ever seen.
  53.    #4:  Documentation.  (Not really pertinent to your question, but certainly
  54.             an important issue in help.
  55.  
  56. So Apple doesn't really want you to stick to one small type of help.
  57.  
  58. |> 
  59. |> Option 1 appeals to me because of the authoring environment of Hypercard,
  60. |> but some sample code would be helpfull.
  61.  
  62. Hypercard, however, is probably intractable.
  63.  
  64. -- 
  65. Adam Winer        | The number you have reached is imaginary.
  66. WINER@HARVARD.EDU    | Please rotate your phone 90 degrees and
  67.                         | try again.
  68.