echo off
XTRA
clear  +YELLOW,BLUE
box 2,0,78,21,1
PUT 2,," CLOCKWORK                         PROGRAM˙
BIG 1,,2," XTRA
color white
PUT  6,,Thank you for buying XTRA from CLOCKWORK SOFTWARE.

PUT 8,8,On this disc you will find a copy of XTRA.COM, and a number of
PUT ,8, batch files illustrating XTRA commands at work.  We advise you
PUT ,8, to copy these original files for security.

PUT 12,8,To execute a batch file, simply type its name (excluding the .BAT)
PUT ,8, "at the prompt.

PUT 15,8,XTRA is particularly good at generating bright, easily updated menus
PUT ,8,and MENU.BAT and MULTI.BAT are intended as models for your development.


PUT 18,8, MENU.DOC and MULTI.DOC are commented versions of MENU and MULTI.
PUT ,8, If you want to print out using your printer, type:-
color +white
PUT 21,,COPY MENU.DOC PRN:
color +red
PUT 24,50," Press any key to continue˙
get

color white
box 6,,76,16,0
PUT 6,,UNDOCUMENTED FEATURES
PUT 8,8,These features have been added to XTRA following customer feedback.
put 10,8,"1) Fonts 1,2,3,6,7,8 now have a stop . colon : and hyphen -
put 12,8,"2) The cursor is hidden while xtra commands are being carried out.
put   ,11,(but it is not hidden while DOS is fetching the next command.)
put 15,8,"3) A new command CURSOR on/off turns the cursor permanently off
put ,11,or on.  REMOVE always turns the cursor back on.
put 18,8,"4) Three switches have been added to the XTRA command,
put   ,11,see next page.
get
box 6,,76,16,0
PUT 6,,UNDOCUMENTED SWITCHES
PUT 8,8,Three switches have been added to the command line at customer
put  ,8, request :-
put 11,6, /M  Mono mode.  The bright bar in POINT and LINEOUT commands
put ,10,simply reverses the current colours. Shadow fonts are converted
put  ,10,to their shadowless equivalents.  This mode is for mono monitors.
put 15,6, /S  Silent mode.  Inhibits the pip on GET, CHOOSE, POINT and
put   ,10,LINEOUT commands.  Does not affect BEEP and CHORD of course.
put 18,6,/I  Inhibit Install Info. Inhibits the installation plate.
put 20,30, example XTRA /I/M/S
put 22,,All these switch settings remain in force until XTRA is REMOVEd.
color +white
put 15,6, /S
put 11,6, /M
put 18,6,/I
put 20,38, XTRA /I/M/S
get
color white
box 6,,76,16,0
PUT 6,,WRITING BATCH FILES
PUT 8,8,Batch files are plain text files which the computer reads almost
put ,8,as if you were typing them through the keyboard.
put 11,8,To write or modify batch files, you will need a text editor program
put ,8,or word-processor capable of creating plain text (ASCII) files.
put ,8,Some word-processors are better at this than others.
put
put ,8,Some people use RPED, as supplied with your machine, but the
put ,8,Sidekick-notepad is absolutely ideal, because being a resident
put ,8, program, you can work interactively (try it, modify it, try it
put ,8, again) very efficiently.
get
box 6,,76,16,0
PUT 6,,NOTES ON REMOVE
put 8,8,You may wish to remove XTRA from memory from time to time, either to
put ,8,release memory it uses (10k), or because of a possible clash with
put ,8,another program.
put
put ,8, The REMOVE command removes XTRA and all resident programs installed
put ,8, since XTRA was installed.
put
put ,8,This can be very useful feature, because it is not always easy to
put ,8,remove residents without rebooting the system.
put
put ,8,But if you want to install a resident (SIDEKICK say) to remain after
put ,8,XTRA is removed, install it underneath by temporarily removing XTRA :-
colour +yellow
put ,36,REMOVE
put ,36,SIDEKICK
put ,36,XTRA
get
color white
box 6,,76,16,0
PUT 6,,PROGRAM CONFLICTS
put
put ,8,We now know that certain programs object to XTRA being resident :
put
put ,,LOTUS 123
put ,,WORDSTAR 1512
put
put ,8,Specifically the problem occurs when these programs do an ambiguous
put ,8,file search.  We don't know why.
put
put ,8,The cure is simply to remove XTRA before executing the program, thus:
put
put ,10,REMOVE
put ,10,WS1512
put
put,8,Make sure that the XTRA command is below the :START label if you
put ,8,intend to loop round the menu again.
get
color white
box 6,,76,16,0
PUT 6,,AUTOEXEC.BAT
put
put ,8,Your computer looks for the AUTOEXEC.BAT file on each boot, and it
put ,8,is a handy place to have such commands as MOUSE and KEYBUK.
put
put ,8,But it's bad form to include menu options in the AUTOEXEC.BAT itself,
put ,8,(KEYBUK consumes 2k of RAM each time it is called).
put
put ,8,Keep your MENU.BAT-type files separate, and just call them from
put ,8,AUTOEXEC.BAT or from each other by including their name in the calling
put ,8,file.
put
put ,,BUGS & IMPROVEMENTS
put
put ,8,Clockwork Software are not aware of any bugs or problems with this
put ,8,program. If you find one, or have suggestions of features you would
put ,8,like to see added, we shall be glad to know.
get
color +yellow,red,black
box 11,,40,7,6
color +white
PUT 13,,CLOCKWORK SOFTWARE
color +yellow
PUT 14,,Bidbury House, Bidbury Lane
PUT  ,,HAVANT,Hants
PUT ,,PO9 3JG
PUT ,,"0705-483217
PUT 19,," (c) John Worley 1988˙
get
clear white,black
