🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: comp.sys.next.programmer
Article #2302

Unhelpful Help Builder

#2302
From: Dave Griffiths
Date: Sun, 24 Jan 1993 20:54
41 lines
2331 bytes
Am I missing something, or is it incredibly clumsy to add Help to your 
application with IB's Help Builder? If I want to add help to a menu item
called Wombat, for instance, I go through the following steps:

1) Go into Edit and create the help file. Resize the window to the same size
   as Help Bulder and save it as Objects/Wombat.rtf.

2) Edit Index.rtfd and add entry for Wombat. Set the link to the file
   Objects/Wombat.rtf. (You need some way to bring up Wombat.rtf from within
   Help Builder). There's also some mysterious rule about a hidden file
   called Prolog.rtf.

3) IB doesn't realize that Index.rtfd has been edited, so quit and reload
   the nib file. (Note: IB doesn't remember your current directory).

4) In IB, bring up the Help Builder panel and click on Index, then click on
   the newly created Wombat entry.

5) Select the Wombat menu item and click the "Attach File to Selection"
   button.

What could be simpler? :-| Of course it's easier to do a whole batch of
them. Why can't you edit the Help text from inside IB? That's the convenience
of having this rtf functionality inside the Text object. At least you can
select the filename in the Inspector and do "Services/Open in Workspace".

Has anybody worked out how to create a Help.store file? I wonder why NeXT
chose not to let us use this feature.

I did try to keep the same "look and feel" as the standard NeXT help for
my menu items, but after copying and pasting one of their files I discover
that simply to have some text with black or grey background, they use TIFF
files! Yuk. There's no way to easily edit one of those. I'm sure they must
use some sort of program to automatically create these TIFF files rather
than creating them by hand. Again, it would be helpful to have this program.

No wonder so few NeXT apps have implemented Help.

[Ob. positive note: the new Edit/Gdb interaction is superb!]

Dave Griffiths
Technical Details
Message-ID: <1993Jan24.205434.2560@prim>
Path: arc1-ca.pugleaf.net!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

Show Full Headers
Complete Article Headers
Newsgroups: comp.sys.next.programmer
Path: arc1-ca.pugleaf.net!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
From: dave@prim.demon.co.uk (Dave Griffiths)
Subject: Unhelpful Help Builder
Message-ID: <1993Jan24.205434.2560@prim>
Organization: Primitive Software Ltd.
Date: Sun, 24 Jan 1993 20:54:34 GMT
Lines: 41