home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / comp / sys / next / programm / 8285 < prev    next >
Encoding:
Text File  |  1993-01-24  |  2.2 KB  |  51 lines

  1. Newsgroups: comp.sys.next.programmer
  2. Path: sparky!uunet!europa.asd.contel.com!howland.reston.ans.net!spool.mu.edu!agate!doc.ic.ac.uk!pipex!demon!prim.demon.co.uk!dave
  3. From: dave@prim.demon.co.uk (Dave Griffiths)
  4. Subject: Unhelpful Help Builder
  5. Message-ID: <1993Jan24.205434.2560@prim>
  6. Organization: Primitive Software Ltd.
  7. Date: Sun, 24 Jan 1993 20:54:34 GMT
  8. Lines: 41
  9.  
  10. Am I missing something, or is it incredibly clumsy to add Help to your 
  11. application with IB's Help Builder? If I want to add help to a menu item
  12. called Wombat, for instance, I go through the following steps:
  13.  
  14. 1) Go into Edit and create the help file. Resize the window to the same size
  15.    as Help Bulder and save it as Objects/Wombat.rtf.
  16.  
  17. 2) Edit Index.rtfd and add entry for Wombat. Set the link to the file
  18.    Objects/Wombat.rtf. (You need some way to bring up Wombat.rtf from within
  19.    Help Builder). There's also some mysterious rule about a hidden file
  20.    called Prolog.rtf.
  21.  
  22. 3) IB doesn't realize that Index.rtfd has been edited, so quit and reload
  23.    the nib file. (Note: IB doesn't remember your current directory).
  24.  
  25. 4) In IB, bring up the Help Builder panel and click on Index, then click on
  26.    the newly created Wombat entry.
  27.  
  28. 5) Select the Wombat menu item and click the "Attach File to Selection"
  29.    button.
  30.  
  31. What could be simpler? :-| Of course it's easier to do a whole batch of
  32. them. Why can't you edit the Help text from inside IB? That's the convenience
  33. of having this rtf functionality inside the Text object. At least you can
  34. select the filename in the Inspector and do "Services/Open in Workspace".
  35.  
  36. Has anybody worked out how to create a Help.store file? I wonder why NeXT
  37. chose not to let us use this feature.
  38.  
  39. I did try to keep the same "look and feel" as the standard NeXT help for
  40. my menu items, but after copying and pasting one of their files I discover
  41. that simply to have some text with black or grey background, they use TIFF
  42. files! Yuk. There's no way to easily edit one of those. I'm sure they must
  43. use some sort of program to automatically create these TIFF files rather
  44. than creating them by hand. Again, it would be helpful to have this program.
  45.  
  46. No wonder so few NeXT apps have implemented Help.
  47.  
  48. [Ob. positive note: the new Edit/Gdb interaction is superb!]
  49.  
  50. Dave Griffiths
  51.