home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / maul123.zip / MAULINST.HLP (.txt) < prev    next >
OS/2 Help File  |  2000-03-27  |  13KB  |  307 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Maul Installation ΓòÉΓòÉΓòÉ
  3.  
  4. Welcome to the installation utility for Maul Publisher. 
  5.  
  6. IMPORTANT INFORMATION 
  7.  
  8. In case of difficulties getting either this install utility, or the main 
  9. program to run, please read the following 
  10.  
  11.      If the install utility won't run 
  12.  
  13.      If Maul Publisher won't run 
  14.  
  15.  Requirements 
  16.  
  17.      Maul must be installed on an HPFS partition, or better. The program 
  18.       requires long filename support. 
  19.      You  must also have multimedia installed. The multimedia extensions are 
  20.       used to import various bitmap formats, and should be installed even if 
  21.       you don't have a soundcard. Without them, Maul will not run. 
  22.      You must have a printer of some kind installed, even if it's only the 
  23.       'IBMNULL' printer. 
  24.      You must have a screen resolution of at least 1024x768, or you will not 
  25.       see some of the status messages. 
  26.  
  27.  Notes 
  28.  
  29.  If you are reinstalling over an earlier version, and you wish to change the 
  30.  installed path, or help path, you should uninstall the previous version before 
  31.  performing an install. If you are a registered customer, you will need to 
  32.  re-enter your registration information. 
  33.  
  34.  If you do not wish to change the installed path, use the advanced 
  35.  installation, and make sure that the help path is correct before installing. 
  36.  
  37.  This install program logs the installation process in a file called 
  38.  'install.log'. This file is found in the path where this installer was run. If 
  39.  Maul Publisher does not run, have a look to see if a file called 'error.log' 
  40.  was generated in the path where Maul was installed. Both log files may be 
  41.  required if you have trouble installing Maul Publisher. No 'error.log' file 
  42.  will be created if Maul runs correctly. 
  43.  
  44.  For more information about Maul's error logging system, have a look at the 
  45.  'Using Maul Publisher' manual after the installation has finished. 
  46.  
  47.  This program can uninstall as well as install or maintain Maul Publisher. You 
  48.  should therefore keep this program available, and not delete it. You can run 
  49.  this program from within the Publisher's own directory. Please make sure that 
  50.  this help file (maulinst.hlp) is kept in the same path as this program. 
  51.  
  52.  Additional release notes 
  53.  
  54.  Additional release notes are contained in readme.1st. This file is found in 
  55.  the original zip file. 
  56.  
  57.  Close this help panel to continue... 
  58.  
  59.  Created by Peter Koller, Maison des Anglais, Trebuon, 29530 Plonevez du Faou, 
  60.  France. 
  61.  
  62.  Maul Support <maul@manglais.com> 
  63.  
  64.  Γòò Peter Koller 1999 - 2000, All Rights Reserved 
  65.  
  66.  
  67. ΓòÉΓòÉΓòÉ 1.1. If the install utility won't run ΓòÉΓòÉΓòÉ
  68.  
  69. Known problems 
  70.  
  71. On some OS/2 systems, the utility 'unpack.exe' can get destroyed or altered. 
  72. You either can use the 'Seek and scan files' utility supplied with OS/2 or 
  73. 'Find...' on a popup menu to look for unpack.exe. You should not have, under 
  74. any circumstances, a version of unpack containing anything other than 72048 
  75. bytes. Some versions of Netfinity use a version of unpack.exe containing 
  76. something like 77200 bytes. If this file is in the path before the system 
  77. supplied path, this install will fail with 'Failed install:01 id = 70 rc = 2'. 
  78.  
  79. The Warp4 distribution has a working version of unpack in the path 
  80. '?:\OS2IMAGE\DISK_3' where the ? is your cd rom drive with Warp4 in it. On 
  81. Warp3 the same file is found on '?:\OS2IMAGE\DISK_2'. 
  82.  
  83. The correct 'unpack.exe' should be in the \os2 subdirectory of your boot drive, 
  84. and nowhere else. It's size should be 72048 bytes, and nothing else. 
  85.  
  86. Other problems 
  87.  
  88. The uninstall path may not be able to uninstall everything correctly. This is 
  89. particularly true if you have used the product, and created files that the 
  90. uninstaller does not know about. Once the uninstall has run, you may wish to :- 
  91.  
  92.      Delete the path added to the 'path=' statement in config.sys, although 
  93.       this has no detrimental effect. 
  94.  
  95.      Delete the directory to which maul was installed, along with all the 
  96.       subdirectories. 
  97.  
  98.  Getting Help 
  99.  
  100.  This install program logs the installation process in a file called 
  101.  'install.log'. This file is found in the path where this installer was run. 
  102.  
  103.  If you cannot find the help required here, please email Maul Support 
  104.  <maul@manglais.com>, with a copy of the 'install.log' file. 
  105.  
  106.  See also:- If Maul Publisher won't run 
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 1.2. If Maul Publisher won't run ΓòÉΓòÉΓòÉ
  110.  
  111. The program won't run 
  112.  
  113. First, make sure that multimedia is installed, even if you don't have a 
  114. soundcard. The multimedia extensions are used to import various graphics file 
  115. formats, including GIF and JPEG. Installing multimedia has the added advantage 
  116. that the operation system recognises the graphics file types, and opens them 
  117. with a double click. If you don't have multimedia installed, the program will 
  118. fail with an '@DosLoadModule' error. 
  119.  
  120. There is a problem on some OS/2 systems with a corrupted printer list. Once 
  121. Maul opens a printer device context, the runtime library gets corrupted, and 
  122. the program fails. The failure always occurs when loading a handler list. 
  123.  
  124. The most common messages for this error are:- 
  125.  
  126.      @fopen("maul_dll.lst", "r") 
  127.  
  128.      @LoadHandlerList 
  129.  
  130.  You may get the program to start up correctly by opening the properties 
  131.  notebook of the 'Maul Publisher' icon, and adding the optional parameter 
  132.  /nopdc on the Program page, but be aware that this may cause the program to 
  133.  fail elsewhere, such as when printing, or when attempting to load or save a 
  134.  stylesheet or master page. 
  135.  
  136.  Please note also, that you may have tried a number of other programs, and 
  137.  found them unreliable, particularly when printing. A surprising number of 
  138.  people have a corrupted printer list, and are unaware of the problem (Me too, 
  139.  for a while...). Maul Publisher is by no means the only program affected. 
  140.  
  141.  The correct solution is to set all your printers to 'IBMNULL' and to delete, 
  142.  and then re-install the latest correct printer drivers. To find out more about 
  143.  how to do this correctly please note the item below. 
  144.  
  145.  Other problems 
  146.  
  147.  A number of items are listed in the main user manual, 'Using Maul Publisher'. 
  148.  Have a look at the section called 'Known problems and bugs'. In particular, 
  149.  read the section on network printing, even if you are not on a network. 
  150.  
  151.  Getting Help 
  152.  
  153.  If Maul Publisher still does not run, have a look to see if a file called 
  154.  'error.log' was generated in the path where Maul was installed. No 'error.log' 
  155.  file will be created if Maul runs correctly. 
  156.  
  157.  If you cannot find the help required here, please email Maul Support 
  158.  <maul@manglais.com>, with a copy of the 'error.log' file. 
  159.  
  160.  See also:- If the install utility won't run 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 2. Choosing an installation mode ΓòÉΓòÉΓòÉ
  164.  
  165. Basic installation 
  166.  
  167. Unless you wish to update an existing installation, it's probably easier to use 
  168. the basic install mode. This mode will update the CONFIG.SYS file where 
  169. required. If CONFIG.SYS is updated, you will be asked if you wish to reboot 
  170. your machine. 
  171.  
  172. Advanced installation 
  173.  
  174. If you wish to update an existing installation, or you wish to choose what is 
  175. installed or where, you can use the advanced installation. In this mode you can 
  176. select what to install, and where to install it. You must be careful however, 
  177. as this mode is capable of creating an incomplete or non-functional 
  178. installation. 
  179.  
  180. Uninstall 
  181.  
  182. If you wish to remove Maul Publisher from your system, select the uninstall 
  183. mode. You will be prompted for each category to be uninstalled, so that you can 
  184. leave your templates intact, for example. Please take the time to read the 
  185. confirmations properly to avoid deleting something you might wish to keep! 
  186.  
  187.  
  188. ΓòÉΓòÉΓòÉ 3. Basic Installation ΓòÉΓòÉΓòÉ
  189.  
  190. This mode will perform a complete installation. If there is not enough room on 
  191. the current drive, you must change the installation path. Just change the drive 
  192. letter to the required drive. The 'Install' button will be disabled until 
  193. sufficient space is available. 
  194.  
  195. This mode installs files based on the main installation path. If the main 
  196. installation path is 'C:\MAUL' this mode will install files as follows:- 
  197.  
  198.      Main program files into C:\MAUL. 
  199.  
  200.      Library files into C:\MAUL\BIN. 
  201.  
  202.      Additional data files into C:\MAUL\ETC. 
  203.  
  204.      Operating manuals into C:\MAUL\INF. 
  205.  
  206.      Help files into C:\MAUL\HELP. 
  207.  
  208.  This mode automatically creates or updates the desktop objects, and also 
  209.  updates CONFIG.SYS. If the system requires re-booting, you will be asked to 
  210.  perform a shutdown when you exit the installer. After the basic install is 
  211.  finished, you will be returned to the installers main dialog. 
  212.  
  213.  
  214. ΓòÉΓòÉΓòÉ 4. Advanced Installation ΓòÉΓòÉΓòÉ
  215.  
  216. This mode will perform a managed installation. If there is not enough room on 
  217. the current drive, you must change the installation path. Just change the drive 
  218. letter to the required drive. The 'Install' button will be disabled until 
  219. sufficient space is available. 
  220.  
  221. In this mode you can choose to use an existing help path for your help files, 
  222. as well as for you main istallation path. If you wish to review Maul Publisher, 
  223. and then uninstall it, this modification avoids the need to alter the 
  224. CONFIG.SYS file. Do not do this unless you are sure of what you are doing. 
  225.  
  226. This mode installs files based on the main installation path. If the main 
  227. installation path is 'C:\MAUL' this mode will install files as follows:- 
  228.  
  229. Install Main Program 
  230.  
  231. The installer will always update the main program files, and help files. This 
  232. would default to 'C:\MAUL' and 'C:\MAUL\HELP' 
  233.  
  234. Install DLL Libraries 
  235.  
  236. If the item is checked, this installs all the handlers and DLL's in 
  237. 'C:\MAUL\BIN'. Maul will do nothing if these DLL's are not installed. 
  238.  
  239. Install additional data 
  240.  
  241. If the item is checked, this installs the dictionary and internationalisation 
  242. files in 'C:\MAUL\ETC'. These file are required to allow Maul to use a spell 
  243. checker and create date and time strings. The path is also used to hold style 
  244. sheets and master pages. 
  245.  
  246. Install operation manuals 
  247.  
  248. If the item is checked, this installs the operating manuals in 'C:\MAUL\INF'. 
  249. The manuals are the reference works for Maul and Maul's handlers. 
  250.  
  251. Create Desktop Folder 
  252.  
  253. If the item is checked, this creates the necessary desktop objects for Maul 
  254. Publisher. Objects are created for all items, even if these items are not 
  255. actually installed. If the objects already exist, this mode will simply refresh 
  256. the existing objects without changing their current place on the desktop. 
  257.  
  258. Update CONFIG.SYS 
  259.  
  260. If the item is checked, this updates CONFIG.SYS. If the system requires 
  261. re-booting, you will be asked to perform a shutdown when you exit the 
  262. installer. After the advanced install is finished, you will be returned to the 
  263. installers main dialog. 
  264.  
  265. If the item is not checked, the necessary changes are saved to 
  266. 'C:\MAUL\CONFIG.NEW'. You will then have to manually apply the changes. 
  267. Normally the only changes to make are the 'set path=' statement, and the 'set 
  268. helppath=' statement. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 5. Uninstalling Maul Publisher ΓòÉΓòÉΓòÉ
  272.  
  273. If you choose to uninstall Maul Publisher, this mode will remove all the files 
  274. based on the current configuration. 
  275.  
  276. You will be prompted for each category to be uninstalled, so that you can leave 
  277. your templates intact, for example. Please take the time to read the 
  278. confirmations properly to avoid deleting something you might wish to keep! 
  279.  
  280. The uninstall mode is not capable of removing entries in CONFIG.SYS. This does 
  281. not normally cause a problem, but if you wish to can manually apply the 
  282. changes. Normally the only changes to make are the 'set path=' statement, and 
  283. the 'set helppath=' statement. Carefully remove the entries pointing to the 
  284. installation path. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 6. Setting the Installation Path ΓòÉΓòÉΓòÉ
  288.  
  289. Normally Maul Publisher is installed into '<bootdrive>:\MAUL'. If OS/2 is 
  290. installed in C: this will be 'C:\MAUL'. You can alter the installation path to 
  291. be anything you like. Please make sure however, that you set a fully qualified 
  292. drive and single path, such as 'd:\fred'. In addition, it is probably not a 
  293. good idea to install Maul into an existing path, because this can cause files 
  294. from other programs to become overwritten. It is safe to install Maul over an 
  295. older version. 
  296.  
  297.  
  298. ΓòÉΓòÉΓòÉ 7. Setting the Help Path ΓòÉΓòÉΓòÉ
  299.  
  300. This dialog allows you to choose from a limited selection of help paths. The 
  301. selection is either an existing help path, or the 'help' subdirectory to the 
  302. installation path. If you choose the 'help' subdirectory to the installation 
  303. path, the installer may need to update the 'set helppath=' statement in your 
  304. CONFIG.SYS file. This will occur automatically unless you have disabled the 
  305. option. 
  306.  
  307.