home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 14 / CD_ASCQ_14_0694.iso / maj / 4379 / read.me < prev    next >
Text File  |  1994-04-18  |  13KB  |  341 lines
  1. THE FINISHING TOUCH
  2. Professional Software Installer
  3. Version 2.7
  4. April 18, 1994
  5. Developed by ImagiSOFT, Inc.
  6. Member of the Association of Shareware Professionals.
  7.  
  8. For the latest copy of the Finishing Touch, call our BBS:  (505) 275-9697
  9. Registered users may call this BBS and download the latest registered
  10. version as this product is continually updated.
  11.  
  12.  
  13. This is a fully working shareware copy of THE FINISH TOUCH.
  14.           ~~~~~~~~~~~~~
  15. NOTE:  The ONLY difference between this shareware copy and the registered
  16.        version is that the shareware copy does a CRC check on the files
  17.        ORDER.TXT and INSTALL.TXT.  This causes up to a TEN SECOND TIME
  18.        DELAY at the beginning of this program.  The registered version
  19.        does NOT have this restriction.
  20.  
  21. To print the documentation use the command:
  22.     COPY INSTALL.TXT LPT1:
  23.  
  24. To print the order form use the command:
  25.     COPY ORDER.TXT LPT1:
  26.  
  27. The Finishing Touch Software Installer consists of the minimum six files:
  28.    PACKER.EXE             file compression utility
  29.    INSTALL.EXE            installation utility
  30.    INSTALL.FIL            sample installation script file
  31.    INSTALL.TXT            documentation for all of the above
  32.    ORDER.TXT              order form
  33.    READ.ME                this file
  34.  
  35. If these files are missing or altered, the software WILL NOT run!
  36.  
  37. A seventh file, SAMPLE.PAK should be included with this software to
  38. so people can see first hand how the software installer works with a "real"
  39. application.  ALL SEVEN files must be on the floppy disk to see the demo
  40. run or you will get a "Files Missing" message.
  41.  
  42. Several other, optional files are included so you can see a "real" scripts:
  43.    Tax Sheltered Annuity Software:  1.FIL, 2C.FIL, 2B.FIL, and 4.FIL
  44.    MOVIES TO GO! Software:          MOVIES1.FIL, MOVIES2.FIL and MOVIES.BAT
  45.    THE COLOR WIZARD:                WIZARD.FIL and WIZARD.BIN
  46.    To use the program as an upate:  UPDATE.FIL
  47.  
  48. Modifying INSTALL.FIL and these files is the "fast start" way to learn
  49. how to use THE FINISHING TOUCH.  You have a fully working shareware evaluation
  50. copy of THE FINISHING TOUCH, and hope you the smallest, most powerful,
  51. easiest to use product with the best file compression available anywhere.
  52.  
  53. ENJOY!
  54.  
  55. Michael J. Prestwich,
  56. President,
  57. ImagiSOFT, Inc.
  58.  
  59.  
  60. June 10, 1992
  61.  
  62. Today we implemented two minor changes:
  63.  
  64.   1)  DR DOS was displaying the CRC values during the UNPACK command which
  65.       caused an annoying scroll on the screen.  This problem was corrected.
  66.  
  67.   2)  A new user needed a SET.BUFFERS command similar SET.FILES so we added
  68.       it.  It works exactly the same way as SET.FILES command does; see the
  69.       documentation for details.
  70.  
  71.  
  72. June 15, 1992
  73.  
  74. Today we added several new commands:
  75.  
  76. PROMPT On/Off turns windows on or off for the COPY, DELETE, DISK, and UNPACK
  77. commands.  This is easier than "hiding" windows by making them the same color
  78. as the background as explained in the documentation.
  79.  
  80. PAUSE t
  81. Pause for t hundredths of a second.  Nice if you want to "animate" windows.
  82.  
  83. WINMOVE x y
  84. Moves the current window the new x y position.  If you use the command
  85. WINMOVE +1 +1 it will move the current window relative to its current position
  86. one row down and one row across.
  87.  
  88. BORDER t
  89.    t = type   0 = none
  90.               1 = single line (default)
  91.               2 = double line
  92.  
  93. WINUPDATE x y c
  94.           x position on the screen
  95.           y position on the screen
  96.           c color value
  97.  
  98. Use WINUPDATE to display a string inside the current open window. For example:
  99.   WINUPDATE +2 +1 79
  100.   "This line is displayed in the current"
  101.   "window with white letters on a red"
  102.   "background.  It is relative to the"
  103.   "upper left corner by 2 characters across"
  104.   "and 1 row down."
  105.  
  106. Relative Cursor / Window Positions
  107.  
  108. WINOPEN now supports relative cursor positions.  For example, WINOPEN +0 +5 17
  109. will open a new window 5 rows down from the last window open. Relative
  110. positioning also works in the UNPACK, PATH, DRIVE, ASK, COPY, DELETE, WINMOVE,
  111. and WINUPDATE commands.
  112.  
  113. Relative cursor positioning is especially useful when you are printing the
  114. selected DRIVE and PATH on the screen with the variables ~1 and ~2.
  115. For example:
  116.  
  117. WINOPEN 0 0 79                                           ' red centered window
  118. "The directory ~1~2 already exists and contains files!"
  119. "Are you SURE you want to install your software in"
  120. "this directory    Y / N?"
  121. ASK +26 +3                                               ' position cursor on
  122.                                                          ' the N character
  123.                                                          ' no matter how the
  124.                                                          ' window is centered
  125.  
  126.  
  127. August 12, 1992
  128.  
  129. We added a new command:
  130.  
  131. INPUT s l x y c
  132. This command allows the user to input text strings which you can assign to
  133. the variables ~A through ~Z.  Your script can substitute these codes similar
  134. to the ~0, ~1, ~2, and ~3 variables as explained in the documentation.
  135.  
  136.     s    = String ID ("A" through "Z", your choice).
  137.     l    = String length, from 1 to 40.
  138.  
  139.     x, y = Input position on the screen.  It is best to use
  140.            the + and - here, because the entire input field
  141.            must be contained within the current open window.
  142.  
  143.     c    = Input color (see the color chart in the documentation).
  144.  
  145. Example:
  146.  
  147.     WINOPEN 0 0 31           ' open a window centered on the screen
  148.                              ' in color 31 (bright white on blue)
  149.  
  150.     ""
  151.     "Please enter the following information:           "
  152.     ""
  153.     "Name:"
  154.     "Address:"
  155.     "City, State, Zip:"
  156.     ""
  157.     "License Number:"
  158.     ""
  159.  
  160.     ' input 30 characters in color 15 (bright white on black)
  161.  
  162.     INPUT N 30 +20 +4 15     ' (Name)             assign to variable "N"
  163.     INPUT A 30 +20 +5 15     ' (Address)          assign to variable "A"
  164.     INPUT C 30 +20 +6 15     ' (City, State, Zip) assign to variable "C"
  165.  
  166.     ' NOTE: the license number is only 15 characters long
  167.  
  168.     INPUT L 15 +20 +8 15     ' (License Number)   assign to variable "L"
  169.  
  170.     WINCLOSE                 ' close the window
  171.  
  172.     ' write the results into an
  173.     ' ASCII file called USER.FIL
  174.  
  175.     FILE ~1~2\USER.FIL
  176.  
  177.     "Name:              ~N"          ' The text that the user input
  178.     "Address:           ~A"          ' will be substituted for the
  179.     "City, State, Zip   ~C"          ' appropriate variables ~N, ~A,
  180.     ""                               ' ~C, and ~L.
  181.     "License Number     ~L"
  182.  
  183.  
  184. February 9, 1993   VERSION 2.3
  185.  
  186. This version fixes a bug in the SET.PATH statement.  In previous versions
  187. SET.PATH adds the directory to the PATH whether or not the directory already
  188. exists in the PATH.  This was especially frustrating if the user had to
  189. install the software several times.  Now SET.PATH looks to see if the
  190. directory already exists in the PATH, and if it does, the SET.PATH
  191. statement isn't executed.
  192.  
  193.  
  194. We also added the CALL command:
  195.  
  196. CALL l
  197.      l = Name of the label to call.  The last line of this label must end
  198.          with RETURN or an error will result.
  199.  
  200. For example:
  201.  
  202. CALL TMP_DEL
  203. .
  204. .
  205. .
  206.  
  207. ' --------------------------------
  208. '   * * * shared routines * * *
  209. ' --------------------------------
  210.  
  211. ' --------------------------
  212. '   delete temporary file
  213. '    (don't inform user)
  214. ' --------------------------
  215. :TMP_DEL
  216. PROMPT OFF
  217. DELETE ~A.TMP 0 0 0
  218. PROMPT ON
  219. BEEP
  220. RETURN
  221.  
  222.  
  223. March 3, 1993
  224.  
  225. We have forced the ~3 variable to reference the root directory of the drive
  226. given in the COMSPEC variable found in the environment.  Several of our users
  227. have noted that the COMSPEC=C:\COMMAND.COM entry placed in the environment
  228. by DOS is often changed for various reasons to read COMSPEC=C:\DOS\COMMAND.COM
  229. or something similar.  Since, in this example, the ~3 variable would be set
  230. to C:\DOS, the CONFIG.SYS and AUTOEXEC.BAT files could not be correctly
  231. modified.  This change discards the \DOS portion, and forces ~3 to reference
  232. the root directory of C:.  This should resolve any problems that you have
  233. experienced with the SET.FILES, SET.BUFFERS, and SET.PATH commands.
  234.  
  235.  
  236. March 12, 1993
  237.  
  238. The BEEP command has been expanded to allow the following variations:
  239.  
  240.                BEEP ON
  241.                BEEP OFF
  242.  
  243. If the BEEP ON command is issued, all internal error messages that open
  244. a window will beep the speaker.  The option can be disabled using the
  245. BEEP OFF command, which is the start-up default.  This feature was added
  246. at the request of developers who write software for visually impaired users.
  247.  
  248.  
  249. March 31, 1993
  250.  
  251. Some of our users have expressed a need for the PATH command to permit
  252. installation to the root directory for cases involving substituted or
  253. network drives.  Currently, the root directory is only allowed if the user
  254. is installing to a floppy disk, otherwise, a directory name must be given.
  255. Today we have added a "back door" to bypass this error trap.  Simply
  256. terminate the pre-stuffed default path (the first parameter in the PATH
  257. command) with a semi-colon, and The Finishing Touch will allow the user
  258. to access the root directory.  Without the semi-colon, the PATH command
  259. will function as before.  However, if the terminator is given, it is
  260. stripped from the string prior to input, and the error trap will be bypassed.
  261.  
  262. For example:
  263.  
  264.     PATH \WORDPRO; 10 10 31 15 20 12 79
  265.                  ^
  266.                  This semi-colon terminator instructs the PATH command to
  267.                  permit installation to the root directory of a hard drive.
  268.  
  269.  
  270. April 16, 1993
  271.  
  272. A new command has been added to test free disk space:
  273.  
  274.     FREE X       Where X is the minimum amount of free disk space
  275.                  required on the target drive.  The value is given in
  276.                  K bytes (i.e. 1024 = 1,048,576 bytes or 1Mb).  The
  277.                  internal YES or NO flag is set to YES if the free
  278.                  disk space is available, and set to NO if it is not.
  279.  
  280. This function differs from the SPACE command in that FREE can be issued
  281. at any time in the script file.  The SPACE command must be issued before
  282. the DRIVE command, and is not tested until the drive letter is entered.
  283.  
  284.  
  285. September 20, 1993
  286.  
  287. The DRIVE and PATH commands can now be set to a specific location without
  288. prompting the user by entering the command without any location or color
  289. variables.  For example, set the DRIVE and PATH to C:\WINDOWS
  290.    DRIVE C:
  291.    PATH \WINDOWS
  292.  
  293. For an example of how this can be used, see the script file EASY.FIL in
  294. SAMPLES.ZIP.  We use this new feature to install our product, EASY TO LEARN
  295. COMPUTING in the Windows environment.
  296.  
  297.  
  298.  
  299. September 27, 1993
  300.  
  301. The LANGUAGE command was extended today to include
  302.  
  303.    LANGUAGE DANISH  So that those in Denmark can read the error messages
  304.                     in their own language.  For languages other than
  305.                     English, French, Spanish, German, and now, Danish,
  306.                     use the command PROMPT OFF and enter your own error
  307.                     messages, PATH Prompt, Unpacking message, etc.
  308.  
  309.  
  310.  
  311. November 11, 1993
  312.  
  313. The LANGUAGE command was extended today to include
  314.  
  315.    LANGUAGE DUTCH   So that those in Holland can read the error messages
  316.                     in their own language.  For languages other than
  317.                     English, French, Spanish, German, Danish, and now, Dutch,
  318.                     use the command PROMPT OFF and enter your own error
  319.                     messages, PATH Prompt, Unpacking message, etc.
  320.  
  321.  
  322. April 18, 1994
  323.  
  324. The BACKGROUND command was extended today to display a binary screen file.
  325. It still supports the numeric backgrounds as explained in the documentation
  326. (for example, BACKGROUND 48 displays a cyan background), but if a filename
  327. of a binary screen is passed, it will now display that screen.  For example:
  328.  
  329.    BACKGROUND ~0\WIZARD.BIN
  330.  
  331. Binary screens can be created with THE LAUGHING DOG screen editor and
  332. THE DRAW which are both in the shareware area of our BBS.  If you try these
  333. programs and create a binary screen that you eventually use with THE FINISHING
  334. TOUCH, please remember to register them with their respective authors.
  335.  
  336. An example of how we implemented this new command can be found in SAMPLES.ZIP
  337. on our BBS in the files WIZARD.FIL (which you should rename to INSTALL.FIL) and
  338. WIZARD.BIN.  A shareware version of THE COLOR WIZARD is available in the file
  339. CLRWIZ10.ZIP.
  340.  
  341.