home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #18 / NN_1992_18.iso / spool / comp / os / mswindo / programm / tools / 727 < prev    next >
Encoding:
Text File  |  1992-08-18  |  2.8 KB  |  73 lines
  1. Newsgroups: comp.os.ms-windows.programmer.tools
  2. Path: sparky!uunet!munnari.oz.au!bruce.cs.monash.edu.au!monu6!steve
  3. From: steve@monu6.cc.monash.edu.au (Steve Balogh (+61 3 565 4747))
  4. Subject: Re: Help! Borland Help Compiler error
  5. Message-ID: <1992Aug18.231800.23034@monu6.cc.monash.edu.au>
  6. Organization: Monash University, Melbourne, AUSTRALIA
  7. References: <SRA.92Aug18184717@nansen.ecs.soton.ac.uk>
  8. Date: Tue, 18 Aug 1992 23:18:00 GMT
  9. Lines: 62
  10.  
  11. In article <SRA.92Aug18184717@nansen.ecs.soton.ac.uk> sra@ecs.soton.ac.uk (Stephen Adams) writes:
  12. >I have just tried to use the help compiler (HC) that comes
  13. >with BC++ 3.0.  I tried to use it on the example (HELPEX).
  14. >I edited HELPEX.RTF using MS WORD 2.0, and I did very little
  15. >editing on the screen that has the bitmaps by reference.
  16. >Then HC gave me the error
  17. >
  18. >Error R2055: File HELPEX.RTF is not a usable RTF topic file
  19. >
  20. >This error will not go away....
  21.  
  22. This reminds me of the troubles I had interfacing the WP4W RTF output with the
  23. help compiler. Lots of errors, and no positive results.
  24.  
  25. My solution has been to create and edit the actual RTF files themselves. I have
  26. had no problems since.
  27.  
  28. My Method:
  29.  
  30. 1. Create a template of an empty help page, but containing any RTF stuff needed
  31.    for the page. Also include any font, and font size controls for headings.
  32.  
  33. 2. Copy this template to a new file for each new help page required.
  34.  
  35. 3. Fill in the blanks. You may need a reference card for the more common RTF
  36.    commands. You would be surprised how few you actually need.
  37.  
  38. 4. Use make to concatenate all of the individual RTF files and compile the 
  39.    merged RTF file. I also include a program which generates various cross-
  40.    reference and consistancy reports to help make sure that all hypertext
  41.    links reference real help pages, browse sequences are in a logical order,etc.
  42.  
  43. Benefits:
  44.  
  45. 1. The help compiler no longer complains.
  46.  
  47. 2. You have initimate control over what is placed into the RTF files. You can
  48.    eliminate lots of RTF stuff inserted by WP4W but apparently not required.
  49.  
  50. 3. It's easy to create additional utilities to generate cross reference reports.
  51.  
  52. 4. You can use any editor to create or modify your RTF files. You are not
  53.    restricted to a particular editor running under Windows. I can continue to
  54.    work on the help files on a PC which is not running Windows.
  55.  
  56. 5. You can easily re-use help pages for other applications.
  57.  
  58. Disadvantages:
  59.  
  60. 1. You have to learn the basics of the RTF format and some commands.
  61.  
  62. 2. Ummmm? You tell me.
  63.  
  64.  
  65. Regards,
  66.     Steve
  67.  
  68. ----_--_-_-_--_-__-_------_-__---_-___-_----_-____-_-_--__-_--_--___-_-_-_--__-_
  69. Steve Balogh  VK3YMY   (Maths G.14)   | steve@monu6.cc.monash.edu.au
  70. Monash University, Clayton Campus     |      37 54'38.8"S  145 07'47.1"E ...ICBM
  71. Wellington Road, Clayton.            |      +61 3 565 4747 Voice (Office)
  72. Melbourne, AUSTRALIA. 3168          |      +61 3 565 4746 Fax
  73.