Dec 092017
 
Allows you to customize entries in the DOS 5.0 help program.
File ADDHELP.ZIP from The Programmer’s Corner in
Category Miscellaneous Language Source Code
Allows you to customize entries in the DOS 5.0 help program.
File Name File Size Zip Size Zip Type
ADDHELP.EXE 6566 6302 deflated
ADDHELP.HLP 130 117 deflated
ADDHELP.TXT 3614 1546 deflated
SETUP.BAT 417 238 deflated

Download File ADDHELP.ZIP Here

Contents of the ADDHELP.TXT file


ADDHELP - An Application Help Installation Utility - Version 1.01P
Copyright (C) 1991 Richard Sands CIS 70279,103
All rights reserved


OVERVIEW
---------
This utility will install a DOS 5 help entry into the HELP System. It is
intended to be distributed with DOS 5 applications and used from the
application's batch setup file or exec'd from an installation program.
I know it's easy to just edit the helpfile, but this "ensures" that the help
file is not accidentally corrupted. It also gives the developer more,
although not absolute, control over what wording goes into the help file
about their application.

What it does is reads a specified help entry file and automatically inserts
it into the DOSHELP.HLP file in the correct position. It allows 255
characters of description to be inserted, with ADDHELP doing the formatting.

If the description already exists, it displays the existing help item (first
line only) and prompts the user for a Y/N decision to overwrite the existing
description.

ADDHELP creates a DOSHELP.BAK file before overwriting the original.


USAGE
------
ADDHELP newhelp[.hlp] [d:path]
where
newhelp[.hlp] is the new help entry to be inserted into the
existing DOSHELP.HLP file.

[d:path] is an optional path specifying the directory to
find DOSHELP.HLP. However, ADDHELP will search
the path to find the DOSHELP.HLP file if omitted.

Returns
ERRORLEVEL = 3 if user terminated
ERRORLEVEL = 2 could not find DOSHELP.HLP
ERRORLEVEL = 1 invalid params or file not found
ERRORLEVEL = 0 on success

HELP ENTRY FILE FORMAT
-----------------------
New Help File Entries are contained in a ascii file with the extension
.HLP although any extension works. You can create this file with the
EDIT program supplied with DOS.

The first line contains the application's filename (no file extension).

The following lines contain the short description of the application
limited to 255 characters. You do not have to worry about word wrap or
indention.

You may not have blank lines in the file. Remarks may be before the
application name, and must be preceded by an "@" character. Remarks are
not placed into the DOSHELP file.


HELP ENTRY FILE EXAMPLE
-----------------------
@
@ You may delete this file after running SETHELP.BAT
@
AddHelp
Help installation utility for new
DOS 5.0 external commands.


DISTRIBUTING & OTHER THINGS
----------------------------
This software is submitted to the Public Domain "as is". It may be freely
distributed with applications. It is requested that both the ADDHELP.EXE and
ADDHELP.HLP files are included and the user is given an option to install
ADDHELP.HLP on the destination DOSHELP file as part of the installation.

You may also include just your ADDHELP format .HLP file and allow the user
to use either ADDHELP or manually combine the .HLP and the DOSHELP.HLP file.
No distribution of ADDHELP.EXE is required, it is up to the user to get a
copy of ADDHELP.EXE.

If you would like to be emailed whenever there is a new update, or have
greater leverage for suggestions, bug-fixes, etc., send $5.00 to register
your Name and CompuServe ID with us to
Richard Sands
P.O. Box 3917
Portland, Oregon 97208

Please include your Name and CompuServe ID.


 December 9, 2017  Add comments

Leave a Reply