home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Boink! 1995 May/June
/
Image.bin
/
df_
/
mailbox
/
terminat
/
0151ter2._xe
/
rar
/
MANUAL.EXE
/
MANUAL.DOC
< prev
next >
Wrap
Text File
|
1994-09-23
|
7KB
|
146 lines
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ Terminate manuals ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
This simple program will compile all *.HLP files into TERMINAT.DOC.
While doing this, it will remove all color codes, insert a table of
contents at the top and formfeeds.
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ Translation information ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
When modifying the help menu files, you must note that Terminate will use
some search strings that are found in the default help files. You should
not remove those entries or put similar strings in other places in the
help file. You risk that a subject will then be located in the wrong place
when displaying the help files. If you don't understand the rest of this
document, you should not try to modify the helpfiles.
Maximum help file size is 1000 lines of 255 characters.
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ Formfeeds are important ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
You can insert an ascii #12 () anywhere to force a new page on the
printer, the #12 will be ignored when showing the help online. This should
only be done as a very last resort. What you do is to go through the
compiled TERMINAT.DOC and find the menues that are broken. Place a #12
just before the menu and compile again. Remember the last line location
and jump in your editor (Ctrl-J in Qedit). Use STRIPFF.EXE ro remove old
#12 first. The mainreason for doing this is to avoid broken boxes on two
printed pages.
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ Installing local language files ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
When Terminate is first installed it will look for a file called
T-LOCAL.EXE (or T_LOCAL.EXE) in the same path as the installation files
and unpack this file to a directory named LANGUAGE\.
When running Terminate for the first time, Terminate will look for a file
called LANGUAGE\LANGUAGE.TXT and read the first line. This line should
contain the language name, like 'Dansk' for Danish or 'German' for
Germany. If the file does not exist, Terminate will say local language
files.
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ Colour codes ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
code Description Default colour
─────────────────────────────────────────────────────────────────────────
^n Normal text colour Gray
^h Highlighted text colour Cyan
^b Bold text colour Yellow
^r Menu bar colour Blue on grey background
^m Menu colour Bright cyan
^t Menu head colour Yellow on blue background
^f Toggle flash/blink No flash, always after a color command
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ Keywords ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
Terminate has a lot of keywords inside the TERMINAT.EXE file. These
words are used for placing the cursor bar in the helpfiles, so you will
get faster access to help for the current item. Generally do not change the
text inside headlines or highlighted text like: ^hConfiguration^n
Note that the search word will have a ^ appended so it won't stop in the
menu. Example:
Menu:
^m┌────────────────────┐
│ Configuration ^m│
│ Exit ^m│
└────────────────────┘^n
Information:
^hConfiguration^n
If the menubar is placed on configuration, then the actual search word
will be: CONFIGURATION^ in uppercase and with a ^ appended. This will
result in the menubar being placed at the information instead of at the
menu. That is why you should not place the ^ right after a menu option. In
general do not change color except right in front of where the colour
change is needed.
Terminate will show which keyword you are missing when calling the
help menu. Then look at the keyword and change it back in the .HLP file.
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ MANUAL.EXE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
This tool compiles all the .HLP files into a file called TERMINAT.TMP and
simultaneously creates a table of contents in TERMINAT.IDX. Then the files
will be copied together into one big TERMINAT.DOC:
FRONTPGE.HLP (The Terminate logo and copyright)
TERMINAT.IDX (The table of contents with page numbers)
TERMINAT.TMP (The actual text, now including line feeds and page numbers)
Use MANUAL /850 to transform this manual into codepage 850
(Use correct box-corners)
Upon installation Terminate will try to detect the codepage and if codepage
850 is detected then MANUAL.EXE will be started with a /850.
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ The archive ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
With the manual files you must create a FILE_ID.DIZ which should look like
the one that comes with the english manuals in MANUAL\FILE_ID.DIZ: Do
NEVER use more than 39 chars and 10 lines. Use the same header and frame
like the below example and never use any highbit characters #128-#255 -
they may look nice, but many sysops complain and some systems will mess it
up.
----======< TERMINATE x.xx >======-----
- The Final Terminal -
- Documentation in Danish -
- Translated by Carsten Milling -
_______________________________________
Only *.HLP files, MANUAL.DOC and MANUAL.EXE should be placed in the archive.
For example to pack the Danish language archive (XX=version):
PKZIP T-DAN-XX *.HLP MANUAL.* FILE_ID.DIZ
Result:
T-DAN-XX.ZIP The finished archive. Good luck.
┌───────────────────────────────────────────────────────────────────────────┐
│ ░░░░ THE END ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
└───────────────────────────────────────────────────────────────────────────┘
- Bo Bendtsen -