home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 25 Icons / 25-Icons.zip / newwarp.zip / README.1ST < prev    next >
Text File  |  1997-02-13  |  7KB  |  145 lines
  1. FIRST OF ALL:
  2. ============================================================
  3.  
  4. BASICALLY: YOU'RE USING THIS SOFTWARE AT YOUR OWN RISK
  5.  
  6. THIS PACKAGE IS PROVIDED AS-IS!!!  IT WORKED FOR ME, AND DID NOT SCREW UP
  7. MY SYSTEM.  IF IT KILLS YOURS, SORRY - BUT I AM NOT RESPONSIBLE FOR IT!!
  8.  
  9. ON A SEPARATE NOTE:  I HONESTLY DON'T THINK THAT ANY HARM SHOULD COME,
  10. BUT IF IT SHOULD, ALL MODIFIED FILES ARE BACKED UP BEFORE BEING REPLACED!!
  11.  
  12. LEGAL BLAH BLAH BLAH BLAH ..... I'LL SPARE YOU THE TIME, SINCE YOU PROBABLY
  13. ALREADY KNOW ALL OF THAT MUMBO-JUMBO......
  14.  
  15.  
  16.  
  17. INTRODUCTION:
  18. ======================================================================
  19.  
  20.  
  21. This is a "fixup" of the file Wrp2mrln.zip that was posted on hobbes a short time ago.
  22.  
  23. I found that the executable provided with the file sorta-screwed up because it couldn't find
  24. some needed files at some certain times - so I took the quickest way out: made a REXX script
  25. that did basically the same (with a couple of exceptions).
  26.  
  27. Thankfully the creators of Warp2Merlin were kind enough to include the source code for the executable
  28. in the package, so I could see exactly what was being done, when and how.
  29.  
  30. The core of the package are the scripts NewWarp.cmd and Process.cmd
  31.  
  32. NewWarp.cmd is simply an iterator for Process - it calls Process.cmd for each file that must be processed.
  33. I decided to split it into two separate scripts to give someone the ability to modify and re-create only
  34. one specific file at a time.
  35.  
  36. ALL CREDIT FOR THIS I GIVE TO THE CREATOR OF THE ORIGINAL WRP2MRLN.ZIP - I CAN ONLY
  37. TAKE CREDIT FOR AUTHORING THE SCRIPTS AND MODIFYING A FEW ICONS HERE AND THERE
  38.  
  39. THE CREATOR(S) OF THE ORIGINAL FILE ARE:
  40.  
  41. Marcos Francisco Caselin Nava (salesman@m-net.arbornet.org)
  42. and  Alfonso Pesqueira (apocalps@teesa.com)
  43.  
  44. Also, BMP's are included for X-It 2.xx and NPS WPS Enhancer.
  45.  
  46.  
  47. INSTALLATION:
  48. ========================================================================
  49.  
  50. Simply unzip this file into any (preferably newly created or empty) directory in your OS/2 Boot Drive.
  51. After that, you can execute NewWarp.cmd to change the look'n feel of Warp!!
  52.  
  53. PLEASE NOTE:  Both scripts use paths relative to their working directory, so if you move them away
  54. from the NewWarp installation directory they won't work anymore!!  All files must be together!
  55.  
  56. Then you can call either Merlin or Process to process the files and make Warp look prettier!!
  57.  
  58. Merlin.cmd does not use parameters, so no matter what you pass to it, it will always do the same - process all
  59. 8 of the DLL's that must be modified.
  60.  
  61. Process.cmd accepts one parameter: the filename of the DLL to be processed (WITHOUT the extension!)
  62.  
  63. I.E:  the command line 'PROCESS PMMERGE' processes PMMERGE.DLL, doing all the things that must be done to it
  64. to enhance the look'n'feel of the windows.
  65.  
  66.  
  67.  
  68. WHAT IT DOES:
  69. ========================================================================
  70.  
  71. NewWarp enhances the look'n'feel of Warp to make it what is should've been upon release:
  72. it changes the window control buttons, the default folder, template, and some other icons, etc....
  73.  
  74. PLEASE NOTE:  Since I have my PC running at 1024x768x16bit, I (obviously) used 24bit Icons.  If you use these 
  75. icons in anything less than 8bit color, they'll look really ugly, so don't!!!  Or you might want to make 16 color
  76. versions of some of the icons...I won't since I despise working with 16 colors - and besides: Who DOES?!?!
  77.  
  78. If you absolutely, positively must use them on a 16 color system, then you should edit them so they look the best
  79. possible in your circumstances!
  80.  
  81. This package, when "installed" - say to the subdirectory d:\NewWarp - and run, creates one subdirectory:
  82.  
  83. "D:\Merlin\Backup DLL"
  84.  
  85. It's used to store the current "working" (or original) copies of the DLL's to be patched - to have a backup
  86. in case of tragedy!
  87.  
  88. This is what is actually done:
  89.  
  90. 1) A backup is made of the original DLL
  91. 2) RC is called to create a *.RES file that can then be used to patch the DLL
  92. 3) ResMgr is called to use the *.RES file for the actual patching (ResMgr.ZIP can be found separately and
  93. in fullness on HOBBES - for space reasons I do not include all of it here).
  94. 4)  After the processing is done, the script uses UNLOCK.EXE (provided with LXLT115.ZIP) to unlock the 
  95. active DLL's so they can be replaced on-the-fly.
  96. 5) All created files are deleted - leaving the directories in their original state.
  97.  
  98. CUSTOMIZING YOUR CONTROLS, ICONS, ETC....
  99. ========================================================================
  100.  
  101. Provided are 8 Directories - each with the name of the DLL to which they associate.  If you want to modify the icons
  102. used in a specific DLL, all you have to do is choose the icon you wish to change and change it!
  103.  
  104. A few notes about editing:
  105.  
  106. 1) All icons have the extension PTR, and are associated as a pointer (duhhh).  Icons and Pointers are saved in the
  107. same format, so they're interchangeable:  this means that if you have an icon already made, and want to use
  108. it in the DLL, simply make a new copy of the icon, and rename the new copy to the EXACT filename (and 
  109. extension) of the "pointer" (icon) you wish to replace from the DLL, and then replace the old one with the new one.
  110. This does not apply to Bitmaps - since they're not stored in the same format as Icons/pointers.
  111.  
  112. 2) I already have The Icon Collection, which I pulled from Hobbes - and there's QUITE A LOT of REALLY KEWL 
  113. icons in it - some of which I used in my modifications of the DLL's.   Respective credit goes to the authors of these
  114. Icons, who are too numerous to name here (and besides, some of 'em I don't even know their name! :) )
  115.  
  116. 3) New, improved, or whatever icons are welcome - and also, I'd appreciate if someone sent me an index of
  117. what each icon actually represents (some are self-explanatory, but others are quite a mistery!), so I may pick
  118. or create an appropriate icon for the job!
  119.  
  120. This program was inspired by Warp2Merlin - a file posted on HOBBES some time ago - the authors' names can
  121. be found at the top of this document.  All credit for the idea should go to them (I can only claim credit for making 
  122. these simple scripts and documenting how this works a little better).
  123.  
  124. PROBLEMS:
  125. =======================================================================
  126.  
  127. So far's I could tell, there are no known problems if everything is done right 
  128. (install into any [preferably a new] directory - how hard can that be?!?!?!)
  129.  
  130. Should there be any problems, you may contact me thru e-mail at: e912976@anubis.ecci.ucr.ac.cr
  131.  
  132. THIS SOFTWARE HAS BEEN INOCULATED AGAINST THE WINDOWS95(TM) VIRUS (if it even qualifies for that!! ;) )
  133. IT WILL ONLY RUN ON FAST, STABLE, TECHNOLOGICALLY SUPERIOR OPERATING SYSTEMS, NAMELY - WARP!!!
  134.  
  135. Happy Warping boyz'n'girlz!!
  136.  
  137. DIEGO RIVERA (NOT THE MURALIST!!!)
  138. e912976@anubis.ecci.ucr.ac.cr
  139. ///
  140.  
  141. PS:/
  142.  
  143. This is my first upload, so bear with me if I left stuff out that should be here or if I put something in that should not
  144. be...I hope some friendly, undersanding co-warper will offer tips for future uploads!  Sorry if I ouched anyone
  145. by leaving them out - it was PURELY (I mean it!) unintentional.