home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / epmtex31.zip / readme < prev    next >
Text File  |  1995-09-27  |  9KB  |  211 lines
  1.                 TeX Macro Enhancements for EPM 5.51a and EPM 6
  2.  
  3.                            EPMTeX Standard Version  3.1
  4.                                       and
  5.                              EPMTeX Pro Version  3.1
  6.  
  7.                             Installation/Upgrade Notes
  8.  
  9.                                    Jon Hacker
  10.                                   Rodney Korte
  11.  
  12.                                  September 1995
  13.  
  14.  
  15. License Agreement:
  16. ~~~~~~~~~~~~~~~~~
  17. You agree to abide by the license agreement contained in the on-line help
  18. of epmtex.exe if you choose to install or use the EPMTeX macro package.
  19.  
  20.  
  21. CONTENTS
  22. ~~~~~~~~
  23.  Section 1:  What is EPMTeX and this new EPMTeX Pro?
  24.              (a brief synopsis of what it can do)
  25.  
  26.  Section 2:  Easy installation of EPMTeX 3.1 (standard version)
  27.              (how to get going as fast and easily as possible)
  28.  
  29.  Appendix A: Removing a previous version of EPMTeX
  30.              (how to remove an old version before upgrading)
  31.  
  32.  Appendix B: Compiling in the EPMTeX Macros.
  33.              (an alternative more complicated way to install)
  34.  
  35.  Appendix C: Disclaimer
  36.              (Hey, you get what you pay for!)
  37.  
  38.  
  39. #######################################################################
  40.  
  41. Section 1: What is EPMTeX, and this new EPMTeX Pro?
  42. ~~~~~~~~~  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43. EPMTeX is a sophisticated *free* macro package that integrates the TeX
  44. typesetting system with the IBM enhanced editor EPM for OS/2.  The
  45. EPMTeX macro suite adds a TeX pull down menu to the EPM menu bar, and
  46. includes a PM style notebook program for configuration of the package.
  47.  
  48. Menu items in the TeX pull down menu allow the user to TeX (with any
  49. format, e.g.  LaTeX), jump to errors in the TeX source, preview
  50. (portrait and landscape), and print (portrait and landscape) the TeX
  51. file currently active in EPM.  Custom 'user' modes may also be defined
  52. for special needs unique to the user.
  53.  
  54. Due to popular demand, the standard edition of EPMTeX now comes
  55. precompiled.  The version of EPM shipped with OS/2 is all that is
  56. required to run EPMTeX.  It is no longer necessary to obtain the EPM
  57. macro compiler from IBM to add the core EPMTeX features.  Consequently,
  58. installation is now greatly simplified.
  59.  
  60. EPMTeX Pro... what is this?
  61.  
  62. EPMTeX was substantially rewritten to allow it to be distributed
  63. precompiled.  In the process, some existing features were removed due to
  64. limitations in what can be done with a precompiled EPM macro.  Users of
  65. earlier versions of EPMTeX may not wish to give up these features,
  66. particularly if they are comfortable compiling macros for EPM.  For this
  67. reason, a Pro version of the macro package is also provided.  The Pro
  68. version does *not* come precompiled and is not recommended for novice
  69. users.  Its installation is complicated, requires the complete EPM macro
  70. compiler from IBM, and does not offer much more than the standard
  71. version anyway.  It is provided solely as a comfort to our longtime
  72. EPMTeX users.
  73.  
  74. The Pro version offers the following (minor) extra things over the
  75. standard version:
  76.  
  77.     - The format and orientation can be chosen from either the settings
  78.       notebook (as per the standard version) or from the EPM TeX menu.
  79.     - The EPM TeX menu items get enabled/disabled (greyed out) as
  80.       appropriate.  For example, if the dvi file does not exist, the
  81.       preview and print functions will be greyed out in the menu.
  82.     - Access to the macro source code should you wish to dabble in
  83.       a little customization of the package.
  84.  
  85. If you wish to use EPMTeX Pro, unzip the file TeXpro.zip included with
  86. EPMTeX 3.1 and follow the installation instructions contained in the
  87. file readme.pro.  
  88.  
  89. We recommend most users stick with the simpler precompiled EPMTeX 
  90. Standard version, as it is much easier to install.
  91.  
  92.  
  93. #######################################################################
  94.  
  95. Section 2: Easy Installation Procedure (Standard version)
  96. ~~~~~~~~~  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  97.    (see also the on-line help in epmtex.exe)
  98.  
  99. NOTE: Users of older versions of EPMTeX will first have to
  100.       expunge the old EPMTeX files before installing the new
  101.       version. Refer to Appendix A for further instructions.
  102.  
  103. a) Unzip the EPMTeX files into a convenient directory.
  104.  
  105. b) Copy tex.ex and profile.erx to a directory that
  106.    is specified in either EPMPATH or PATH so that EPM can
  107.    find them.  Most *.EX files are in the \OS2\APPS directory.
  108.  
  109. NOTE: For people using EPM version 6, you need to unzip the tex.ex
  110.       file from v60x.zip to replace the tex.ex that is the
  111.       default (v5.51a).
  112.  
  113. c) Copy bpmcc.dll to any directory in your LIBPATH.  Copy
  114.    epmtex.exe and epmtex.hlp anywhere to your liking, it doesn't
  115.    matter where, but keep them together.
  116.  
  117. d) Run epmtex.exe and fill in the notebook to describe your local TeX
  118.    environment.  Refer to the on-line help for further information.
  119.  
  120. e) Now you are ready to use the EPMTeX.  There are a couple of
  121.    ways to tell EPM to load the tex.ex file (see also Appendix B).
  122.    The  simplest is to use the REXX profile file 'profile.erx'
  123.    supplied with EPMTeX.  EPM will automatically 'run' this file
  124.    when it starts, creating a way to customize EPM without recompiling
  125.    the epm macro files.
  126.  
  127.    Start EPM.  If the TeX menu is not visible, then you need
  128.    to enable the REXX profile support.  Type ctrl -i  to open the EPM
  129.    command window.  Type the command 'profile on' (no quotes).  Then
  130.    select the 'Save Options' command in the pull-down EPM menu.
  131.  
  132. NOTE: For people using EPM version 6, enable REXX profile support by
  133.       opening the EPM settings notebook and check the 'REXX profile'
  134.       option on the Misc page.
  135.  
  136. f) Exit EPM and restart.  The TeX menu should be visible now.  Load a
  137.    TeX file and test it out!
  138.  
  139.  
  140. #######################################################################
  141.  
  142. APPENDIX A:   Removing a previous EPMTeX Version
  143.  
  144. To install over a previous version of EPMTeX you will need to first
  145. purge the old EPMTeX files from your system.
  146.  
  147. a) Remove the old EPMTeX version from your epm files:
  148.  
  149.   1) Delete the EPMTeX part of Mymnuini.e
  150.   2) Delete the EPMTeX part of Mykeyset.e (if any)
  151.   3) Delete the EPMTeX part of Mykeys.e (if any)
  152.   4) Delete the EPMTeX part of Mystuff.e (if any)
  153.   5) Delete the EPMTeX constants from Mycnf.e  (This is optional
  154.      but the constants are no longer used)
  155.   6) delete the old tex.ex (if any)
  156.  
  157. b) Recompile (version 6 users can skip the extra.e recompile)
  158.    etpm epm
  159.    etpm extra
  160.  
  161. c) Now you should have a plain version of EPM, like
  162.    it was before you installed EPMTeX.  Try running EPM
  163.    and make sure the TeX menu is gone.
  164.  
  165.  
  166. #######################################################################
  167.  
  168. APPENDIX B:   Compiling in the EPMTeX Macros.
  169.  
  170.    Another way to link in the tex.ex file is to edit your mystuff.e file.
  171.    This is more work because it requires recompiling your EPM macros. In
  172.    fact, if you're going to go to this much bother, you might as well
  173.    just install the full blown EPMTeX Pro version.  But for those people
  174.    who want to do it anyway, add the following lines to mystuff.e
  175.  
  176.    definit
  177.      'linkverify tex'
  178.  
  179.    Now recompile (version 6 users can skip the extra.e recompile)
  180.  
  181.    etpm epm
  182.    etpm extra
  183.  
  184.    This will cause tex.ex to be linked in automatically whenever
  185.    you start EPM.  You can delete the EPMTeX portion of your profile.erx
  186.    file if you use this method since it is no longer needed.
  187.  
  188.  
  189. #######################################################################
  190.  
  191. APPENDIX C: Disclaimer:
  192.             ~~~~~~~~~~
  193.  
  194. We are by no means experts on programming the EPM enhanced editor.  While these
  195. TeX enhancements have been fairly thoroughly tested, there could easily be
  196. oversights on our parts that result in problems for some configurations of EPM.
  197. If you think you have found a genuine bug, or would like to make suggestions,
  198. contributions, or enhancements to this code please drop one of us a note.
  199. Since we have released this code without charge, we cannot offer a warranty
  200. or customer support.  Everything you need to get going should be available
  201. in the EPMTeX package and the IBM supplied EPM documentation.
  202.  
  203. 9/95
  204. Jon Hacker
  205. INTERNET: hacker@patagonia.bellcore.com
  206.  
  207. Rodney Korte
  208. Penn State, State College, PA
  209. INTERNET: korte@sabine.psu.edu
  210.  
  211.