home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 February / PCWK0296.iso / sharewar / dos / program / interupt / winhelp / wh_ed111 / readme < prev    next >
Encoding:
Text File  |  1995-05-06  |  4.7 KB  |  93 lines
  1. WH_Ed111.ZIP includes
  2.  
  3.     README        1995-05_06    This file.
  4.     WH_wEdit.EXE    1995-05-06    A Windows help file editor, v. 1.11.
  5.     FILE_ID.DIZ    1995-05-06    Identification file.
  6.  
  7. Windows help files can have their initial window position and size defined
  8. at compile time - secondary windows in help files even must have these
  9. properties defined. The position and size are defined as fractions of the
  10. display screen, and therefore it can give inconveniences to carry help files
  11. between different graphics platforms.
  12.  
  13. The WH_wEdit program can edit Windows help files compiled with the HC31 or
  14. HCP help file compilers. WH_wEdit will let you edit both the windows' size and
  15. position, and the background colors of the header and text sections of the
  16. windows. Help files compiled with the HC30 compiler cannot be edited as the
  17. HC30 compiler does not support a [WINDOWS] section in the Help Project File.
  18.  
  19. Version 1.11 of WH_wEdit also facilitates macro editing. Windows help file
  20. macros perform initialization when the file is loaded by WinHelp. For example,
  21. if browsing is enabled (i.e. if << and >> pushbuttons are available) the help
  22. file will include the macro
  23.     BrowseButtons()
  24. which instructs WinHelp to show the pushbuttons on the button bar. Macro
  25. editing is a delicate matter, and you should not use the macro editor unless
  26. you know what you are doing. You will get the same warning every time you
  27. enable the editor after you have loaded WH_wEdit.
  28.  
  29. Version 1.11 fixes a bug in version 1.10 that could corrupt the help file.
  30.  
  31. WH_wEdit is a Windows application program. It is straightforward to use and
  32. has these few lines of online help:
  33.     Select a Help file from the "File" menu
  34.     Select a window to edit from the "Windows" list
  35.     Check appropriate "Defined" checkboxes to enable editing
  36.     Click on the "Change" pushbutton to facilitate editing
  37.     Select the "Edit" menu to enable macros editing
  38. The "WH_wEdit Sample" position and size editor window and the "Color" editor
  39. window have separate online help. The Macros Editor operates almost identical
  40. to Windows' NotePad editor. It includes copy and paste, so that you can copy
  41. macros from one help file - or other sources - to the clipboard, and paste
  42. them into another help file.
  43.  
  44. A few hints are appropriate, though. File|Save will save the current state of
  45. a editor unconditionally. File|Open and File|Exit will notify the user about
  46. changes selectively to the Windows part and in the Macros editor, and a save
  47. can be accepted or refused individually; selecting Cancel in any of these two
  48. windows will return you to the current state of the editor. If any changes
  49. were refused, and opening of a file was then canceled in the Open dialog box,
  50. then the changes will remain in the editor, but they are marked as saved.
  51.  
  52. Text can be entered in the Macros editor even if no file is open; WH_wEdit
  53. will offer to copy the editor's contents to the clipboard if you attempt to
  54. save this text or to open a file.
  55.  
  56. The program can report the following errors:
  57.  
  58. Cannot open <name>                Not found, or readonly
  59. <name> has unknown format            Probably not a help file
  60. <name> was compiled with HC30, can't edit    No windows to edit
  61. Insufficient heap for windows in <name>        More local memory needed
  62. No windows were defined in <name>         *)    Compiled without definitions
  63. Cannot reopen <name> for update            Another application deleted
  64. Length of <name> has changed, can't update    or changed the help file
  65. Nothing to save                    Attempt to save unedited file
  66. Window clipped at screen edge            Parts of sample off screen
  67. *) This is not an error message if the Macros Editor is enabled, then the
  68.    macros can be edited although no windows are defined.
  69.  
  70. There are 16 more possible errors concerning the help file format. I would
  71. appreciate to be informed if an error message appear not listed above, or if
  72. the "Insufficient heap" message appears.
  73.  
  74. WH_wEdit is copyright (C) 1994, 1995 Bent Lynggaard. The program is freeware,
  75. thus it can be used without any registring. It may be distributed from
  76. Bulletin Board Services.
  77.  
  78. The program may not be included in any commercial software package or
  79. shareware package without my permission. It may be included in public domain
  80. and freeware software packages provided that:
  81.      1. It is included in the original WH_Ed110.ZIP package together with this
  82.         README file, and with my PKZIP authenticity code intact (KJO555).
  83.      2. It is included in the package for a specific help file editing purpose.
  84. I would appreciate to be notified if WH_wEdit is included in a public domain
  85. package.
  86.  
  87. WH_wEdit is supplied without any warranties.
  88.  
  89. Make backups of your help files before you edit them.
  90.  
  91. 1995-05-06.
  92. Bent Lynggaard <lynggaard@risoe.dk> on Internet.
  93.