home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / ventura / vpapp_6.arc / VPAPP_6.TXT < prev    next >
Text File  |  1989-05-23  |  16KB  |  364 lines

  1. @PARAFILTR ON =
  2.  
  3. @BANNER = Ventura Publisher<M^><190><D>
  4.  
  5. @APP NOTE = Application Note #6
  6.  
  7. @NAME = Subjects:    DOS file operations<R>
  8.      Sidekick Plus
  9.  
  10. @HEAD 1 = Overview
  11.  
  12. While within Ventura Publisher, many people want to have access to 
  13. full DOS file operations. Some reasons for this include:
  14.  
  15. @BULLET 1 = Need to format a disk in the middle of a Multi-Chapter 
  16. Copy operation.
  17.  
  18. @BULLET 1 = Need to verify the date, time, and size of a file.
  19.  
  20. @BULLET 1 = Need to copy several files to another directory, but do 
  21. not need all of the Multi-Chapter capabilities.
  22.  
  23. @BULLET 1 = Need to look at data within a file using the DOS TYPE 
  24. command prior to loading.
  25.  
  26. @BULLET 1 = Need to search across a number of files for the occurrence 
  27. of a magic text string which will help you locate the correct file 
  28. for loading.
  29.  
  30. @BULLET 1 = Need to rename a file (the File Type/Rename actually creates 
  31. a new file rather than renaming).
  32.  
  33. @BULLET 1 = Need to override the read-only status of a file without 
  34. leaving Ventura Publisher (a dangerous practice, but some people want 
  35. to do it).
  36.  
  37. One option is VP Manager from New Rider's Publishing which provides 
  38. some, but not all, of these DOS operations. This program installs 
  39. directly into Ventura Publisher and also provides many document management 
  40. features not available with any other product.
  41.  
  42. However, in addition to wanting to execute these DOS functions, many 
  43. other people also want to be able to perform simple file editing using 
  44. a standard text-based word processor without leaving Ventura Publisher. 
  45. Application Note #4, describes how to use multi-tasking operating 
  46. system add-ons such as DESQview in conjunction with your favorite 
  47. word processor, to give you full DOS functionality, text editing and 
  48. more. However, for many users, this approach is not attractive because:
  49.  
  50. @BULLET 1 = Multi-tasking software will not fit in their computer.
  51.  
  52. @BULLET 1 = Multi-tasking software requires more computing power than 
  53. their computer provides.
  54.  
  55. @BULLET 1 = Multi-tasking software requires more work to set up than 
  56. they want to deal with.
  57.  
  58. Therefore, this application note describes a much simpler approach 
  59. which uses the popular application <B>Sidekick<M^><190><B> Plus<D> 
  60. from Borland Software. This program includes all of the simple DOS 
  61. capabilities described above and also provides a powerful ASCII text 
  62. editor. In addition, a very large number of people already own Sidekick 
  63. Plus and therefore no additional software purchase is necessary.
  64.  
  65. @HEAD 2 = Reference Guide warning
  66.  
  67. As described in the Ventura Publisher Reference Guide, TSR (Terminate 
  68. But Stay Resident) programs such as Sidekick are not normally recommended 
  69. for use with Ventura Publisher for two reasons:
  70.  
  71. @BULLET 1 = They consume valuable conventional memory space and may 
  72. therefore make it impossible to load Ventura Publisher.
  73.  
  74. @BULLET 1 = They often improperly reset the video mode, thus making 
  75. it impossible to return to Ventura Publisher after running the TSR 
  76. application.
  77.  
  78. While conventional memory is still a very precious commodity that 
  79. should be conserved, Ventura Publisher's use of EMS memory, starting 
  80. with version 2.0, decreases conventional memory requirements and therefore 
  81. lets you successfully run Sidekick Plus (or other TSR programs) if 
  82. your computer contains EMS memory. You must still pay attention to 
  83. the TSR's installation, however. This application note provides proper 
  84. installation information.
  85.  
  86. While graphic incompatibilities are still possible, Sidekick Plus 
  87. provides superior graphics handling compared to Sidekick. With most 
  88. graphics cards, the Ventura Publisher screen will reappear correctly 
  89. after running Sidekick. (You may encounter problems with some EGA 
  90. cards. If so, you're out of luck.)
  91.  
  92. @HEAD 1 = Installation
  93.  
  94. After installing Sidekick Plus, you should customize it for best possible 
  95. memory utilization In addition, if your primary reason for using Sidekick 
  96. Plus is to provide DOS services and a text editor within Ventura Publisher, 
  97. then you will want to delete unneeded functions. The following procedure 
  98. will accomplish both of these goals.
  99.  
  100. @HEAD 2 = Run INSTALL
  101.  
  102. The first step in configuring an already-installed Sidekick Plus is 
  103. to run the INSTALL program again. The <B>Configuration<D> menu then 
  104. appears. Change the settings to conform to settings shown in the second 
  105. illustration, then select <B>Continue SKPLUS Design<D>. If you plan 
  106. to install the minimal configuration described here, set EMS memory 
  107. to 300K bytes. (A full Sidekick Plus configuration requires more EMS.) 
  108. If your computer doesn't contain much EMS memory, specify as much 
  109. EMS as you can spare. If insufficient EMS is specified, the portion 
  110. of Sidekick Plus which won't fit into EMS plus conventional memory 
  111. will be swapped to hard disk. Sidekick Plus will still run.
  112.  
  113. Note: <MI>Make sure you leave at least 48K EMS for Ventura Publisher 
  114. or 256K for Professional Extension!<D> If you allocate all EMS for 
  115. Sidekick Plus, then Ventura Publisher will not load. For example, 
  116. if your computer has 512K EMS available, then you should not allocate 
  117. more than 464K for Sidekick Plus if you plan to use Ventura Publisher, 
  118. or 256K for Sidekick Plus of you plan to use the Professional Extension.
  119.  
  120. If you want to create a special version of Sidekick Plus to run with 
  121. Ventura Publisher, then you can create another EXE file. Otherwise, 
  122. use the SKPLUS.EXE filename which is provided as the default (see 
  123. third illustration).
  124.  
  125. The last illustration on this page shows a minimal Sidekick Plus configuration 
  126. for use with Ventura Publisher:
  127.  
  128. @BULLET 1 = Make sure you move the cursor to the <B>EMS<D> column.
  129.  
  130. @BULLET 1 = For each application you want to include, press the <B>Enter<D> 
  131. key. For certain applications, such as the Notepad and Phonebook, 
  132. you will need to answer certain other questions.
  133.  
  134. The amount of EMS memory you specified at the beginning of this installation 
  135. must equal the EMS amount (152K in this example) plus Resident Size 
  136. (71K in this example), plus Data Buffer (64K in this example). Once 
  137. you have gotten this far, if the total of these three memory sizes 
  138. is less than what you allocated in the earlier step, press <B>ESC<D> 
  139. several times to get back to the earlier screen, specify the correct 
  140. amount, and then return to this screen by retracing the steps above.
  141.  
  142. Press <B>F2<D> to begin the build process.
  143.  
  144. @HEAD 1 = Load Sidekick Plus
  145.  
  146. The simplest way to load Sidekick Plus is to type <B>SKPLUS<D>. If 
  147. you have EMS memory and have configured Sidekick Plus for the minimal 
  148. configuration shown above, and if you have very few other device drivers 
  149. or TSR programs, then Ventura Publisher or the Professional Extension 
  150. should load.
  151.  
  152. If you have a 386 computer using Quarterdeck's <B>QEMM-386<D> or Qualitas 
  153. Software's <B>386max<D>, or if you have a 286 computer using All Computer's 
  154. <B>Chargecard<D>, then you can use these program's LOADHI function 
  155. to load Sidekick Plus into the memory area between 640K and 1 megabyte. 
  156. This will make Sidekick Plus appear to consume virtually no conventional 
  157. memory. You should definitely load Sidekick Plus into this high memory 
  158. area if you have this hardware and software.
  159.  
  160. @HEAD 2 = SWAPSP
  161.  
  162. If you don't have any of this hardware and software, then Sidekick 
  163. Plus will consume at least 71K of conventional memory. As described 
  164. in Application Note #2, you can run Ventura Publisher with only 500K 
  165. remaining, and you can run the Professional Extension with only 465K 
  166. remaining in computers which contain EMS memory. Thus, you may be 
  167. able to tolerate 71K. If you can't, you can purchase a simple utility 
  168. called <B>SWAPSP<D> from a company called Innovative Data Concepts. 
  169. Their address is: 1657 The Fairways, Suite 101, Jenkintown, PA 19046. 
  170. The product costs $20. You can either order directly from them, or 
  171. else first download the program from Compuserve in the BORAPP forum 
  172. and then send in your money. This program reduces the amount of conventional 
  173. memory usage from 71K to less than 10K by swapping the resident portion 
  174. of Sidekick Plus to EMS. Your computer must contain at least 64K more 
  175. EMS memory than what you have already allocated for Sidekick Plus. 
  176. Performance degradation resulting from swapping the resident portion 
  177. is virtually undetectable even on a slow 286 AT computer.
  178.  
  179. To install SWAPSP, copy the SWAPSP.COM and TESTSP.COM files to the 
  180. same directory where the Sidekick Plus EXE file resides. Then, run 
  181. the TESTSP program to install SWAPSP. Once this is done, simply type:
  182.  
  183. @TABLE = <F1M>SWAPSP /G<F255D>
  184.  
  185. @BODY NO INDNT = to install Sidekick Plus. The /G makes sure that 
  186. graphics is swapped out correctly when you invoke Sidekick Plus from 
  187. within Ventura Publisher.
  188.  
  189. To use SWAPSP from within a batch file, change to the drive and directory 
  190. which contains SWAPSP and your Sidekick Plus EXE file. Then enter 
  191. the following two lines (assuming SKPLUS is the Sidekick Plus EXE 
  192. file):
  193.  
  194. @TABLE = SWAPSP /N/G<R>
  195. SKPLUS
  196.  
  197. @HEAD 1 = Screen shots
  198.  
  199. For those not familiar with Sidekick Plus, the screen shots on the 
  200. following page show the file manager, ASCII table, and notepad.
  201.  
  202. @HEAD 1 = Advanced use
  203.  
  204. @HEAD 2 = Cut & Paste
  205.  
  206. Sidekick Plus can be used in many ways. In addition to providing DOS 
  207. file facilities, it can be used to cut and paste between different 
  208. applications. While you cannot cut <MI>from<D> Ventura Publisher, 
  209. you can paste text which you have cut from other applications <MI>into<D> 
  210. Ventura Publisher. You may need to slow down Sidekick Plus' paste 
  211. speed when pasting large blocks.
  212.  
  213. @HEAD 2 = Word processing
  214.  
  215. The Notepad in Sidekick Plus has a full search and replace function. 
  216. This can be used to perform search and replace on an ASCII file without 
  217. leaving Ventura Publisher. As an example of how to use this feature, 
  218. consider the following:
  219.  
  220. @BULLET 1 = Open a chapter from within Ventura Publisher.
  221.  
  222. @BULLET 1 = If the text within this chapter is not saved as ASCII 
  223. text:
  224.  
  225. @BULLET 2 = Select the frame which contains the text file.
  226.  
  227. @BULLET 2 = Select the <B>File Type/Rename<D> option.
  228.  
  229. @BULLET 2 = Select <B>ASCII<D>.
  230.  
  231. @BULLET 2 = Select <B>OK.<D>
  232.  
  233. @BULLET 2 = Then select <B>Save<D> in the File menu. The text file 
  234. will now be saved in ASCII format.
  235.  
  236. @BULLET 1 = Invoke Sidekick Plus (<B>Ctrl Alt<D>).
  237.  
  238. @BULLET 1 = Select the Notepad.
  239.  
  240. @BULLET 1 = Use the New File (<B>F3<D>) option to load the ASCII text 
  241. file you just saved.
  242.  
  243. @BULLET 1 = Use the search and replace (<B>Ctrl QA<D>) and other editing 
  244. functions to edit the file.
  245.  
  246. @BULLET 1 = Save the file (<B>F2<D>). Return to Ventura Publisher.
  247.  
  248. @BULLET 1 = After returning to Ventura Publisher, select <B>Open<D> 
  249. from the file menu and re-open the same chapter. You must do this 
  250. to load all the changes you just made. Similarly, if you make changes 
  251. in Ventura Publisher, you must <B>Save<D> those changes before going 
  252. to back to Sidekick Plus <MI>and<D> you must then use the new file 
  253. option (<B>F3<D>) again to re-load the text file. This re-loading 
  254. is the only way to transfer the changes between the two applications.
  255.  
  256. @HEAD 3 = Hints
  257.  
  258. @BULLET 1 = If you use the notepad extensively, you should set the 
  259. Options File Autosave <B>ON<D>. This assures that any changes made 
  260. within Sidekick Plus will always be saved before you return to Ventura 
  261. Publisher.
  262.  
  263. @BULLET 1 = If you exit from Sidekick Plus using <B>Ctrl Alt<D> instead 
  264. of <B>ESC<D>, then when you return to Sidekick Plus from Ventura Publisher 
  265. you will be returned directly to the application in use (in this case 
  266. the notepad).
  267.  
  268. @BULLET 1 = To re-read the same file upon returning to Sidekick Plus, 
  269. press <B>F3<D> then <B>Enter<D>.
  270.  
  271. @HEAD 3 = Wordwrap
  272.  
  273. Note that if you edit the file with automatic wordwrap turned on, 
  274. or if you reformat a paragraph using <B>Ctrl B<D>, Sidekick Plus will 
  275. wrap the blank space which Ventura Publisher places at the end of 
  276. each line. This results in two spaces between words. You can either 
  277. use the search and replace function in Sidekick Plus to remove these 
  278. extra spaces <MI>after<D> you have finished editing, or your can remove 
  279. them as soon as you load the file. To remove them immediately after 
  280. you load, search for <B>space/carriage return/line feed<D> and replace 
  281. this with <B>carriage return/line feed<D>. This is done as follows:
  282.  
  283. @BULLET 1 = Place the cursor at the beginning of the file (<B>Ctrl 
  284. QR<D>).
  285.  
  286. @BULLET 1 = Press and hold the <B>Ctrl<D> key. Then press <B>QA<D>.
  287.  
  288. @BULLET 1 = On the <B>Search For<D> line, delete any characters remaining 
  289. from the last search.
  290.  
  291. @BULLET 1 = Press the space bar once.
  292.  
  293. @BULLET 1 = Hold the <B>Ctrl<D> key and press <B>PMPJ<D>. This is 
  294. the code for a carriage return followed by a line feed.
  295.  
  296. @BULLET 1 = Press the <B>Enter<D> key.
  297.  
  298. @BULLET 1 = On the <B>Replace With<D> line, delete any characters 
  299. remaining from the last search.
  300.  
  301. @BULLET 1 = Hold the <B>Ctrl<D> key and press <B>PMPJ<D>.
  302.  
  303. @BULLET 1 = Press the <B>Enter<D> key.
  304.  
  305. If the cursor is at the beginning the of the file before you begin 
  306. this operation and if you have set Ask Before Replace to <B>No<D>, 
  307. then the blank space at the end of each line in the entire file is 
  308. deleted. If you don't want to watch all the search operations as they 
  309. occur, press <B>Ctrl Q<D> as soon as the replace operation begins 
  310. (this is an old Wordstar trick that also works in Sidekick Plus).
  311.  
  312. If you later bring this file back into Ventura Publisher, the lack 
  313. of a trailing space won't affect character spacing. Also, the search 
  314. and replace options are remembered. Therefore if you save the document 
  315. from within Ventura Publisher and then use the New File (F3) option 
  316. in Sidekick Plus to retrieve the edited document, you can simple type 
  317. <B>Ctrl QA<D> followed by <B>Enter Enter<D> to replace the blank space 
  318. at the end of each line.
  319.  
  320. The notepad is limited to 54,000 characters. 
  321.  
  322. @HEAD 2 = ASCII table
  323.  
  324. Sidekick Plus also has a complete ASCII table. Although the character 
  325. mapping above ASCII 128 is not identical to the characters used in 
  326. Ventura Publisher, the characters between 128 and 168 <MI>are<D> the 
  327. same. Therefore, if you need to quickly find most foreign characters:
  328.  
  329. @BULLET 1 = Call up the ASCII table within Sidekick Plus.
  330.  
  331. @BULLET 1 = Find the character in the table.
  332.  
  333. @BULLET 1 = Press<B> Enter<D> to paste the character into the Paste 
  334. Buffer.
  335.  
  336. @BULLET 1 = Press <B>Alt +<D> to paste the character from the ASCII 
  337. table Paste Buffer into the Sidekick Plus clip board.
  338.  
  339. @BULLET 1 = Exit from Sidekick Plus.
  340.  
  341. @BULLET 1 = If not already in Text mode, switch to this mode and place 
  342. the text cursor where you want the new character to appear.
  343.  
  344. @BULLET 1 = Press <B>Ctl Ins<D> to paste the foreign character into 
  345. Ventura Publisher.
  346.  
  347. Note: you may want to change the Services Setup Clipboard End of Line 
  348. Character option.
  349.  
  350. The ASCII table in Sidekick cannot be edited.
  351.  
  352. @HEAD 1 = Summary
  353.  
  354. This note describes how to install and use Sidekick Plus with Ventura 
  355. Publisher or with Professional Extension. One final note. Although 
  356. you can run Sidekick Plus with the base Ventura Publisher, the amount 
  357. of memory available for your document will be decreased. This will 
  358. cause Ventura Publisher to swap portions of the document to hard disk, 
  359. resulting in delays as you go from page to page. If you cannot accept 
  360. any performance degradation, you may wish to limit use of Sidekick 
  361. Plus only to those computers on which you have installed the Professional 
  362. Extension. 
  363.  
  364.