home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / pmcstex.zip / install / pmCSTeX.INF (.txt) < prev    next >
OS/2 Help File  |  2000-04-16  |  83KB  |  2,057 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. 1 Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.  Welcome to pmCSTeX for EPM, version 16. 4. 2000. 
  5.  
  6.   Abstract
  7.   Motivation
  8.   License
  9.   Author
  10.   Download
  11.  
  12.  
  13. ΓòÉΓòÉΓòÉ 1.1. 1.1 Abstract ΓòÉΓòÉΓòÉ
  14.  
  15.  pmCSTeX for EPM is a macro package for the OS/2 editor EPM.  It adds CSTeX 
  16.  menu into the EPM's menu, hotkeys as well as some buttons on the EPM toolbar, 
  17.  allowing many of (em)TeX-related actions (TeXing, dvi-previewing, dvipsing, 
  18.  BibTeXing...)  to be easily accessed. 
  19.  
  20.  The aim of this work was the implementation of a pleasant emTeX menu system 
  21.  for OS/2.  Editor EPM has been chosen since it provides wonderful programming 
  22.  capabilities, and, what it is the most important for the Czech users, there is 
  23.  a programmable Czech keyboard implemented by Z. Wagner (you can get it 
  24.  anonymously from ftp.icpf.cas.cz).  (It should be noted that the keyboard that 
  25.  IBM includes in Warp is nearly unusable for programmers, who mostly prefer a 
  26.  reasonable combination of the US and Czech keyboard layouts, and not the 
  27.  standard Czech typing machine layout.  It is really bad that IBM does not 
  28.  provide (nor in Merlin!) a configurable keyboard driver or the source code for 
  29.  pmmerge.dll and keyboard.dcp). 
  30.  
  31.  This package is called pmCSTeX since it is related to the CSTeX distribution 
  32.  of TeX and because it was worked out by me (pm).  CSTeX (Czech and Slovak TeX) 
  33.  is being released since 1993 and it is based on the TeX implementation by 
  34.  Eberhard Mattes (the famous emTeX).  In addition to the standard emTeX 
  35.  distribution, the CSTeX distribution contains styles and some programs that 
  36.  support TeX typesetting in the Czech and Slovak languages.  CSTeX includes an 
  37.  installation program (which is missing in emTeX) and a very pleasant menu 
  38.  system for DOS. Nowadays, CSTeX covers Czech specials for unixes as well. 
  39.  
  40.  The pmCSTeX package does not require CSTeX installation; you can use it with 
  41.  any (em)TeX distribution. 
  42.  
  43.  Note: The coincidence of the abbreviation of my name and the abbreviation of 
  44.  the Presentation Manager is just accidental.  Unfortunately, IBM does not pay 
  45.  me any royalties.  Thus even this package is free, you are welcome to send me 
  46.  donations :-) 
  47.  
  48.  Joking...  postcards are welcome, but sending a short e-mail is easier and 
  49.  more rapid. 
  50.  
  51.  
  52. ΓòÉΓòÉΓòÉ 1.2. 1.2 Motivation ΓòÉΓòÉΓòÉ
  53.  
  54.  Working on the pmCSTeX for EPM, the author was motivated by the following 
  55.  packages: 
  56.  
  57.      CSTeX MNU for DOS: TeX menu system for DOS, included in the CSTeX 
  58.       distribution. Author: Petr Ol╤ç╨░k 
  59.  
  60.      TeXshell: Turbo Vision TeX developing system (for DOS and DOS window in 
  61.       OS/2). I liked it very much (I like Borland-like environments, on-line 
  62.       help etc.), it is programmable in a wonderful way. However, it's just DOS 
  63.       and it has many disadvantages coming from the Turbo Vision library: it 
  64.       has 64KB limit on file sizes, it crashes from time to time (in my OS/2 
  65.       window), and there is no "Undo" function. Author: Juergen Schlegelmilch 
  66.  
  67.      EPMTeX: TeX menu system for editor EPM. Good, but it does not fulfilled 
  68.       my high expectations I got accustomed to in TeXshell (late 1995), e.g. it 
  69.       always appended the Master file at the command line. I accepted its First 
  70.       line syntax (Master:, Format: etc.). Authors: Jon Hacker and Rodney Korte 
  71.  
  72.      WETeX: actions and icons are defined for texing, previewing and more for 
  73.       a document. Based on WPS and EAs, not Master: notation. I did not use it 
  74.       because of not having enough RAM to work under WPS (I had 12 MB RAM and I 
  75.       preferred Program Commander/2 RUNWORKPLACE replacement). Author: ZdenΓò¬k 
  76.       Wagner 
  77.  
  78.      emacs: well, I never used this editor except for very simple editing (I 
  79.       prefer vi on unix). However, I was always amazed by its feature "(La)TeX 
  80.       current paragraph"---therefore I implemented it in the pmCSTeX for EPM 
  81.       too. Authors: GNU 
  82.  
  83.      pmgraf: that's my integrated Turbo Vision environment for plotting the 2d 
  84.       and 3d graphs (see my WWW page for more details). The build-in editor 
  85.       (the same as that in the TeXshell) contains the hotkeys for pull-down 
  86.       menus for LaTeX environments and font sizes, and a Greek keyboard. Thus I 
  87.       implemented these features into EPM as well. Author: Petr Mikul╨▒k 
  88.  
  89.  Note:  in 1998, there appeared a package called epmtfe: EPM TeX Front End 
  90.  (distributed as epmtfe.zip) by Walter Schmidt. Unfortunately, the author 
  91.  reeinvets the functionality of pmCSTeX for EPM. Even though I immediately 
  92.  asked him not to duplicate the work and make a collaborate together, this has 
  93.  not happened so that nowadays you may find both our packages on the net.  In 
  94.  my humble opinion, I still believe that my pmCSTeX is superiour to epmtfe, 
  95.  profiting from its two-year advance and writing my thesis as well as many 
  96.  other documents with it. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 1.3. 1.3 License ΓòÉΓòÉΓòÉ
  100.  
  101.  Package pmCSTeX for EPM. 
  102.  Copyright  1996  Petr Mikulik 
  103.  ___________________________ 
  104.  
  105.  Package license: free-latex   distributed under the same terms as LaTeX 
  106.  
  107.  This program can be redistributed and/or modified under the terms of the LaTeX 
  108.  Project Public License Distributed from CTAN archives in directory 
  109.  macros/latex/base/lppl.txt; either version 1 of the License, or any later 
  110.  version. 
  111.  
  112.  License meaning in short:  use and distribution permitted, like any freeware. 
  113.  Package must be distributed together with the source code.  Reuse of the 
  114.  source code or any part of it is allowed.  Any changes or enhancement to this 
  115.  package must involve a change of name unless these changes are accepted by the 
  116.  author. You are welcome to submit your bugfixes, updates or new features. 
  117.  
  118.  Because the program is licensed free of charge, there is no warranty for any 
  119.  of its component.  You are responsible for any software, hardware, human or 
  120.  nature disaster resulting from installing and using of this package.  I am not 
  121.  responsible for any of your problem --- I am not EPM programmer, I'm 
  122.  physicist. 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 1.4. 1.4 Author ΓòÉΓòÉΓòÉ
  126.  
  127.  Petr Mikul╨▒k 
  128.  
  129.  Address: 
  130.  
  131.  Department of Solid State Physics, and Laboratory of Thin Films and 
  132.  Nanostructures, Faculty of Science, Masaryk University, Kotlarska 2, 611 37 
  133.  Brno, Czech Republic 
  134.  
  135.  Katedra fyziky pevn╨Æ f╨░ze a Laborato┬ñ tenk╤îch vrstev a nanostruktur, 
  136.  P┬ñ╨▒rodovΓò¬deck╨░ fakulta, Masarykova univerzita, Kotl╨░┬ñsk╨░ 2, 611 37 Brno 
  137.  
  138.  e-mail: mikulik@physics.muni.cz 
  139.  
  140.  URL: http://www.sci.muni.cz/~mikulik/ 
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ 1.5. 1.5 Download ΓòÉΓòÉΓòÉ
  144.  
  145.  Homepage of pmCSTeX for EPM is 
  146.  
  147.           http://www.sci.muni.cz/~mikulik/os2/pmCSTeX.html
  148.  
  149.  pmCSTeX for EPM is available on hobbes.nmsu.edu (directory 
  150.  /pub/os2/apps/editors/epm), on ftp.leo.org (directory 
  151.  pub/comp/os/os2/emTeX/contrib) and on CTAN mirrors (directory 
  152.  CTAN/systems/os2/pmcstex).  Online documentation and the up-to-date bug fix 
  153.  list (if needed) is available on my WWW page. 
  154.  
  155.  Further, for Czech/Slovak users only: pmCSTeX for EPM is included in my 
  156.  os2.zip modul in the CSTeX distribution, see 
  157.  http://math.feld.cvut.cz/olsak/cstex/. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 2. 2 Installation ΓòÉΓòÉΓòÉ
  161.  
  162.  The installation instructions are described in the subsections. 
  163.  
  164.  This package was developed and tested on EPM 6.03 and EPM 6.03b.  Get the 
  165.  latest version of EPM if you have an older one, i.e.  EPM 5.51 shipped with 
  166.  OS/2 Warp 3.0.  OS/2 Warp 4.0 (Merlin) ships with EPM 6.03b; however, for 
  167.  compiling the macros yourself you need the whole EPM distribution from the 
  168.  Net. 
  169.  
  170.   Information for Warp 3.0 users
  171.   Information for Merlin users
  172.   Upgrading pmCSTeX for EPM
  173.   Installation of pmCSTeX for EPM
  174.   Installing psview.cmd
  175.   Syntax highlighting
  176.   My config.sys
  177.   Spell checking in EPM
  178.   Installation of advanced macros
  179.   Recompiling EPM
  180.   Information for users of Czech.E
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 2.1. 2.1 Information for Warp 3.0 users ΓòÉΓòÉΓòÉ
  184.  
  185.  Get the EPM 6.03b (or later) from the Net and install it into the directory 
  186.  \APPS\EPM (or choose another directory if you like, but then change all the 
  187.  following information accordingly). 
  188.  
  189.  
  190. ΓòÉΓòÉΓòÉ 2.2. 2.2 Information for Merlin users ΓòÉΓòÉΓòÉ
  191.  
  192.  EPM 6.03b is a part of the OS/2 Warp 4.0 (Merlin). This operating system ships 
  193.  a localized version of EPM, which consists of the files \OS2\APPS\*epm*, 
  194.  \OS2\APPS\DLL\epm*, \OS2\APPS\DLL\etk* and \OS2\HELP\EPM* (at least in my 
  195.  Merlin CZ it is like that). 
  196.  
  197.  Consequently, you have these possibilities of installing and running EPM: 
  198.  
  199.  1. Use the shipped EPM.  Install pmCSTeX as explained further (into 
  200.  \APPS\EPM\CSTeX), but do not forget to keep EPMPATH pointing also to the 
  201.  \OS2\APPS directory (SET EPMPATH=...;E:\OS2\APPS).  Then look which files in 
  202.  the directory \APPS\EPM\CSTeX are found before those of the same name in the 
  203.  directory \OS2\APPS (actions.lst, for instance). 
  204.  
  205.  2. Use the shipped EPM, but move it into the directory \APPS\EPM in order to 
  206.  avoid the confusion of having several files of the same name in different 
  207.  directories on the hard disk:  Create the directory \APPS\EPM.  Move all files 
  208.  \OS2\APPS\*epm* and \OS2\APPS\DLL\epm*, \OS2\APPS\DLL\etk* and \OS2\HELP\EPM* 
  209.  to \APPS\EPM.  Then install pmCSTeX as explained further. 
  210.  
  211.  3. Let the shipped localized EPM in its \OS2\APPS directories.  Install the 
  212.  EPM from the Net (this is a US version) into \APPS\EPM, thus you will get the 
  213.  whole documentation, the sources for all macros etc.  Finally, install pmCSTeX 
  214.  as explained further.  Any time, you will be able to start the localized EPM 
  215.  from the command line \OS2\APPS\epm.exe or from an associated icon. 
  216.  
  217.  I use the method 3. 
  218.  
  219.  
  220. ΓòÉΓòÉΓòÉ 2.3. 2.3 Upgrading pmCSTeX for EPM ΓòÉΓòÉΓòÉ
  221.  
  222.  Upgrading pmCSTeX from the release 1996 requires complete reinstallation (but 
  223.  nobody is still using this version I hope). 
  224.  
  225.  If you have a working configuration from 1997 or later, then instead of the 
  226.  full installation make the upgrade discussed in this section.  Replace the old 
  227.  files by their current version, or read the documentation as mentioned below: 
  228.  
  229.      Updated EPM macros: CSTeX.e, CSTeX.ex, pm4EPM.e, pm4EPM.ex, pm_keys.e, 
  230.       pm_keys.ex, Profile.erx 
  231.  
  232.      Updated documentation: pmCSTeX.INF, pmCSTeX.emxdoc 
  233.  
  234.      MyCNF.e and MyCNF.ex have been taken away from the <=1997 releases (its 
  235.       defload routine for syntax highlighting has been moved to pm_keys.e; thus 
  236.       also 'link MyCNF' has been taken away from the Profile.erx 
  237.  
  238.      Installation of advanced macros with many additions for fine TeX et al. 
  239.       files writing has been newly written.  Its corresponding macro files are 
  240.       in the directory install\advanced 
  241.  
  242.      There are no new changes to config.sys 
  243.  
  244.      LaTeX2e.INF of the version 1.6 is available from the directory 
  245.       install\l2e_ndx, and LaTeX2e.NDX has been updated as well 
  246.  
  247.      Updated sampactn.e / sampactn.ex (see the reference to 29. 12. 1997 in 
  248.       History) 
  249.  
  250.      Please move all files from install\dvips directory into \EMTEX\data\dvips 
  251.       directory.  Then you can easily use Double-side or slot 2 printing from 
  252.       dvips 
  253.  
  254.  Please, see the History of pmCSTeX to track for the changes I made in pmCSTeX 
  255.  since your current version. 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 2.4. 2.4 Installation of pmCSTeX for EPM ΓòÉΓòÉΓòÉ
  259.  
  260.  I hope you already unzip-ed pmCSTeX.zip in an empty directory.  Let us suppose 
  261.  you correctly installed EPM to the directory E:\APPS\EPM.  Thus make directory 
  262.  E:\APPS\EPM\CSTeX (note:  use your drive letters; I have applications on drive 
  263.  E: and the operating system on drive F:).  Then 
  264.  
  265.    1. Move all files (not directories!)  from the install directory into 
  266.       \APPS\EPM\CSTeX.  Since you cannot move this pmCSTeX.INF while reading 
  267.       it, please exit it before the movement and then reload it back from 
  268.       \APPS\EPM\CSTeX. 
  269.  
  270.    2. Move CSTeX.* from one of the install\e-ex directories into 
  271.       \APPS\EPM\CSTeX:  the users of the CSTeX distribution use the directory 
  272.       e-ex.CS, all other world uses e-ex.NCS.  [Note:  install\e-ex.CS\CSTeX.e 
  273.       is compiled with the option CSTEX_CSTEX = 1, and install\e-ex.NCS\CSTeX.e 
  274.       is compiled with the option CSTEX_CSTEX = 0, see the section about the 
  275.       macro recompiling.) 
  276.  
  277.    3. Move install\e-ex.CS\Profile.erx or install\e-ex.NCS\Profile.erx into 
  278.       \APPS\EPM (this is an "autoexec.bat" for each file loaded into EPM), but 
  279.       please take care when moving it:  you may already have this file which 
  280.       you may have already modified---in that case only modify what is missing 
  281.       in your Profile.erx.  At least you should add and 'link pm4epm' and 'link 
  282.       CSTeX', and something more for pm_keys, Czech keyboard, syntax 
  283.       highliting, etc. 
  284.  
  285.    4. Switch on the EPM option Settings/Misc/Rexx profile so that EPM reads 
  286.       Profile.erx for each file being loaded. 
  287.  
  288.    5. CSTeX distribution users should install the Czech keyboard driver for EPM 
  289.       (implemented by Z. Wagner) if they are not satisfied with the typing 
  290.       machine layout.  If you already use the original czech.e and czech.ex, 
  291.       you have to replace it by the version compatible with pmCSTeX -- see also 
  292.       Czech.E. Therefore backup the original czech.e and czech.ex and replace 
  293.       them by moving the files install\e-ex.CS\czech.ex and 
  294.       install\e-ex.CS\czech_PM.zip into the directory \APPS\EPM\CSTeX. 
  295.  
  296.    6. Move the file actions.lst from the directory install\apps-epm into 
  297.       \APPS\EPM.  Be aware again---thi file can exist on your system, so:  add 
  298.       only the changes of actions.lst, i.e.  add the lines CSTeX and pm4EPM. 
  299.  
  300.    7. Move all files from install\cmd.CS or install\cmd.NCS into your 
  301.       \EMTEX\bin directory.  You must replace these files if you had the 
  302.       previous version of pmCSTeX (because of introducing the keyword 
  303.       EMTEXOPT), except for the *dvips.cmd files, that you may have modified 
  304.       yourself (sheet alignment can be introduced either here or in the 
  305.       dvips.cnf file). 
  306.  
  307.    8. Please move all files from install\dvips directory into \EMTEX\data\dvips 
  308.       directory.  Then you can easily use Double-side or slot 2 printing from 
  309.       dvips. 
  310.  
  311.    9. CSTeX-distribution users should move the binary files 
  312.       install\exe.CS\vlnka2.exe and install\exe.CS\dvi-out2.exe into \EMTEX\bin 
  313.       directory.  The original Turbo Pascal sources were compiled by Speed 
  314.       Pascal for OS/2, so that kbdvio32.dll must be present somewhere on your 
  315.       LIBPATH (I prefer the directory \UTILS). 
  316.  
  317.       If you are yet not using the cs2cs convertor, then copy it somewhere on 
  318.       your PATH (I have it in the directory \UTILS).  The full package of this 
  319.       programs, accompanied by the documentation and the source code, is 
  320.       available from the author's (Ferdinand Prantl, Jr.)  ftp site, 
  321.       ftp://aip1.fsv.cvut.cz/sys/pub/users/ferdi/cs2cs.zip. 
  322.  
  323.  Now, edit config.sys and change it like (use the letters of the partitions 
  324.  according to your hard disk, my system drive is F:): 
  325.  
  326.  Example: 
  327.  
  328.           SET EPMPATH=E:\APPS\EPM;E:\APPS\EPM\CSTeX;...;F:\OS2\APPS;...
  329.  
  330.  Further, 
  331.  
  332.  Example: 
  333.  
  334.           SET EMTEXOPT=/mt65000 /mp65000
  335.  
  336.  (this change together with the update of .cmd files is dated 19.5.1996, see 
  337.  History). 
  338.  
  339.  Add the path to your dictionary files US.dic, UK.dic, FR.dic, GR.dic etc... 
  340.  (please, read about the spell checker for more details where to get these 
  341.  files and how to ensure that they are used for both EPM and IBM Works): 
  342.  
  343.  Example: 
  344.  
  345.           SET EPM_DICTIONARIES=e:\apps\epm\Dictionaries
  346.  
  347.  [Note:  it's now more then one year after the Czech IBM released their 
  348.  "localized" version of Warp, but they are still not able to produce CZ.dic 
  349.  :-(( This and many other small things make really bad impression on the 
  350.  wonderful Warp.) 
  351.  
  352.  I'm quite sure you want the on-line hypertext help about the LaTeX2e commands. 
  353.  Thus move the files from the directory l2e_ndx into the directory 
  354.  %EMTEXDIR%\BOOK\ENGLISH (like E:\EMTEX\BOOK\ENGLISH).  You can read @CTINDX 
  355.  (in Czech) or @READNDX (in English) how I have created LaTeX2e.INF and 
  356.  LaTeX2e.NDX.  If you follow the instructions there you find that you have to 
  357.  modify your config.sys: 
  358.  
  359.  Example: 
  360.  
  361.           SET BOOKSHELF=..;E:\EMTEX\BOOK\ENGLISH;...
  362.           SET EPMPATH=...;E:\EMTEX\BOOK\ENGLISH;...
  363.           SET HELPNDX=...+LaTeX2e.NDX
  364.  
  365.  Now reboot your computer. When it is done, go to E:\APPS\EPM\CSTeX and type 
  366.  
  367.           start epm
  368.  
  369.  A new menu item CSTeX should appear on the menu bar.  If not, something was 
  370.  wrong and you should repair it (have a good chance!). 
  371.  
  372.  Now install the CSTeX toolbar.  Go to File/Settings/Toolbars, use "Import" 
  373.  file E:\APPS\EPM\CSTeX\CSTeX.bar, name it CSTeX toolbar and then "Make 
  374.  current".  Admire it.  If you are not satisfied, change the toolbar as you 
  375.  wish (I encourage you to remove it the next day after well sleeping, since my 
  376.  toolbar is really good :-)) ...  but I accept that you may like another one). 
  377.  
  378.  Please, now verify that you can run from the command line commands latex 
  379.  (=latex2e), plaintex, latex209 etc.  (CSTeX-distribution users should use 
  380.  cslatex, csplain, cslatex209 etc.).  You should have installed emTeX in such a 
  381.  way, that you have latex.cmd, plain.cmd,...  (or latex.cmd = cslatex.cmd, 
  382.  csplain.cmd, cslatex209.cmd,...)  in %EMTEXDIR%\bin, see above.  So you should 
  383.  be able to recompile any LaTeX document typing the command (in an OS/2 window) 
  384.  
  385.  Example: 
  386.  
  387.           latex _any_latex_document_.tex
  388.  
  389.  You should be able to start the previewer by 
  390.  
  391.  Example: 
  392.  
  393.           start dvipm @dvipm.cnf _any_tex_document_.dvi
  394.  
  395.  (I supposed you copied lj.cnf or p6l.cnf or whatever resolution you want to 
  396.  the file dvipm.cnf).  If the above does not work, configure emTeX properly. 
  397.  You find valuable information in files \EMTEX\BOOK and \EMTEX\DOC. 
  398.  
  399.  Check the last lines of %EMTEXDIR%\bin\maketexp.cmd file if you want that 
  400.  dvips generates fonts automatically (dvipm does that par definion). 
  401.  
  402.  If you want to run (La)TeX over your document from the command line (without 
  403.  launching EPM), you can also use pmTeXit.cmd _your_file_.tex.  However, 
  404.  pmTeXit.cmd knows only about the Format: keyword, so it is really better to 
  405.  run TeXing from the EPM, namely if you are using AMS-LaTeX and the Emtexopt: 
  406.  keyword.  See to do. 
  407.  
  408.  Now you can customize your EPM:  when installing EPM for my friends, I usually 
  409.  delete \OS2\epm.ini and copy them my install\apps-epm\epm.ini into the 
  410.  directory \APPS\EPM---you can do that too it if you like.  You can play with 
  411.  the values in File/Settings/Misc., and read their documentation (I think you 
  412.  must have "REXX support" on; and I further prefer "Stream mode editing"). 
  413.  
  414.  You may or may not want the automatic syntax highlighting. 
  415.  
  416.  Read Czech.E if you want to use the Czech keyboard in pmCSTeX or go to 
  417.  Tutorial.  Please don't forget to read about the syntax of the keywords on the 
  418.  first line of the Master file. 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ 2.5. 2.5 Installing psview.cmd ΓòÉΓòÉΓòÉ
  422.  
  423.  psview package is in the subdirectory psview.  This is a nice small tool for 
  424.  rapid PostScript file visualisation.  It is a keyboard-driven front-end to 
  425.  GhostScript (not mouseable as gvpm).  Great for small PostScript files or for 
  426.  writing your own commands. 
  427.  
  428.  Installation:  unzip the package.  Read and execute ReadMe, which should 
  429.  result in the following: 
  430.  
  431.      *.ps (i.e. gs312.ps and ps_view.ps) are in your GhostScript directory 
  432.       (e.g. E:\GS\gs4.03) 
  433.  
  434.      *.cmd (at least psview.cmd which is used by pmCSTeX for EPM), must be 
  435.       somewhere along your PATH 
  436.  
  437.      finally insure that psview.cmd and gs.exe (=gsos2.exe) are on PATH; 
  438.       config.sys have sth. like (see the GS documentation) SET 
  439.       GS_LIB=E:\GS\gs4.03;E:\GS\gs4.03\fonts;.\ Note: there is already 
  440.       GhostScript 5.10 in December 1997. 
  441.  
  442.  
  443. ΓòÉΓòÉΓòÉ 2.6. 2.6 Syntax highlighting ΓòÉΓòÉΓòÉ
  444.  
  445.  There are people that do like syntax highlighting (yes, I do) and those they 
  446.  do not like this colour circus.  This section deals with the installation of 
  447.  this feature.  If you have copied all files and pm_keys from the pmCSTeX 
  448.  distribution without changes, then it should work.  Just try to download any 
  449.  .h or .cpp or .tex or ...  file into EPM. 
  450.  
  451.  I prefer the syntax highlighting as usually used in Turbo Vision---yellow 
  452.  letters on blue background.  If you set those colours in the Settings of EPM, 
  453.  then you may find worth to copy the files from the directory pm_hilit to the 
  454.  directory \APPS\EPM to adjust the appropriate highlighting files for this 
  455.  colour scheme.  Moreover, syntax highlighting for .log files (created by TeX) 
  456.  are supported by the epmkwds.log file, so as the PostScript files (this is 
  457.  surely not complete; don't you have a list of all the postscript commands?) 
  458.  and awk files (GNU awk is a great and simple C/REXX-like scripting language). 
  459.  Please don't forget to backup the original files epmkwds.* files before you 
  460.  overwrite them.  Please see also I cannot see \begin FAQ. 
  461.  
  462.  Now the installation (or the deinstallation if you proceed in the reversed 
  463.  order) of the colour highliting: 
  464.  
  465.  In order to apply the colours into files listed on the command line after EPM 
  466.  has been started, add the following line to your Profile.erx file (done in its 
  467.  supplied version): 
  468.  
  469.           'cstex_highlight_all S'
  470.  
  471.  To let the files loaded from within EPM (e.g.  via menu) to be coloured, put 
  472.  the following code into any *.e file and compile it---I have it in pm_keys.e 
  473.  (see pm_keys): 
  474.  
  475.           defload
  476.           'a_togl_hilit S'
  477.  
  478.  and recompile it. 
  479.  
  480.  Files are highlighted according to their extension listed in sampactn.e file 
  481.  (and loaded from sampactn.ex) according to the colour scheme defined in the 
  482.  file like epmkwds._extension_.  The file epmkwds.c contains the syntax of the 
  483.  colouring.  Of course, you should have put the line 
  484.  
  485.  Example: 
  486.  
  487.           'link sampactn'
  488.  
  489.  into your Profile.erx (also done in the supplied Profile.erx). 
  490.  
  491.  My sampactn.e and sampactn.ex included in the pmCSTeX distribution includes 
  492.  also .sty, .cls and .dtx extensions for being TeX-like coloured, and the .log 
  493.  file colour, and the fortran .f files.  If you want to recompile sampactn.e 
  494.  yourself, you need files english.e, stdconst.e and menuhelp.h from epmmac.zip. 
  495.  
  496.  
  497. ΓòÉΓòÉΓòÉ 2.7. 2.7 My config.sys ΓòÉΓòÉΓòÉ
  498.  
  499.  Occasionally problems appear when some global variables in config.sys are 
  500.  missing.  Here is my config.sys if you want to have a look: 
  501.  
  502.  Example: 
  503.  
  504.  
  505.   SET PATH=...;e:\apps\epm;F:\OS2\APPS;e:\emtex\bin;...
  506.   SET DPATH=...;e:\apps\epm;F:\OS2\APPS;...
  507.   LIBPATH=...;e:\apps\epm;F:\OS2\APPS\DLL;e:\emtex\dll;...
  508.   SET BOOKSHELF=...;e:\apps\epm;e:\emtex\book\english;...
  509.      rem Someone prefers german instead of english
  510.   SET HELP=...;e:\emtex\help;...
  511.  
  512.   ...
  513.  
  514.   rem ******************** emTeX *********************************
  515.  
  516.   SET EMTEXDRV=E
  517.   SET EMTEXDIR=E:\EMTEX
  518.   SET TEXINPUT=E:\EMTEX\TEXINPUT!
  519.     rem For plain only; *tex*.cmd scripts redefine this
  520.   SET EMTEXOPT=/mt65000 /mp65000
  521.     rem This you MUST have!
  522.   SET DVIDRVINPUT=E:\EMTEX\DOC;E:\EMTEX\DOC\ENGLISH
  523.   SET DVIDRVFONTS=E:\EMTEX\fonts
  524.     rem In this case, I do not use the recommendation by E. Mattes to use \TEXFONTS directory
  525.     rem I do not like too much directories in the root
  526.   SET MFJOBOPT=/3
  527.     rem for using the mf386 version of MetaFont
  528.   SET INDEXSTYLE=E:\EMTEX\texinput\latex2e
  529.     rem sth like path for MakeIndex, .ist files?
  530.   SET DVIPSHEADERS=E:\EMTEX\data\dvips
  531.   SET TEXCONFIG=E:\EMTEX\data\dvips
  532.   SET CSBIBALP=E:\EMTEX\data\csbibtex
  533.  
  534.   REM *** EPM
  535.   SET EPMPATH=e:\apps\epm;e:\apps\epm\cstex;e:\apps\epm\epmmac;e:\apps\epm\epmmac2;
  536.      e:\emtex\book\english;e:\emtex\book\czech;F:\OS2\APPS
  537.   SET HELPNDX=EPMKWHLP.NDX+EMX.NDX+LaTeX2e.NDX
  538.  
  539.   REM *** pmCSTeX for EPM
  540.   SET TEXFORMATDEFAULT=latex
  541.   SET EPM_DICTIONARIES=e:\apps\epm\Dictionaries\
  542.     rem where are the dictionaries UK.dic, FR.dic, GR.dic etc. located
  543.  
  544.  (Note:  there is SET EPMPATH=...;F:\opendoc\bin under Merlin and OpenDoc) 
  545.  
  546.  
  547. ΓòÉΓòÉΓòÉ 2.8. 2.8 Spell checking in EPM ΓòÉΓòÉΓòÉ
  548.  
  549.  EPM comes with the US dictionary and synonym file (the EPM found on the Net, 
  550.  and the EPM enclosed in the "localized" Czech Merlin).  If you want to proof 
  551.  text written in another language, it could be easy if you have BonusPak for 
  552.  other languages, because the IBM Works from your BonusPak uses the same 
  553.  dictionary files as the EPM.  Thus go to the directory of IBM Works of the 
  554.  desired language version on your CD-ROM BonusPak (shipped with OS/2 Warp 3.0) 
  555.  and copy diction.@ file to your hard disc.  Unpack it by the command unpack 
  556.  diction.@ and copy the dictionary files (US.dic, UK.dic, francais.dic (I 
  557.  renamed this to FR.dic), GR.dic) to the desired location (I prefer 
  558.  \apps\epm\Dictionaries).  Then type the dictionary filename into EPM 
  559.  Settings/Paths/Dictionary file and rename the default personal dictionary 
  560.  lexam.adl to something like UK.adl, FR.adl etc.  There is/was another 
  561.  confusion:  some versions of EPM called these files *.dct; look at your hard 
  562.  disk, and delete it or rename it to *.dic. 
  563.  
  564.  Put into your config.sys: 
  565.  
  566.  Example: 
  567.  
  568.           SET EPM_DICTIONARIES=e:\apps\epm\Dictionaries\
  569.  
  570.  The same dictionary should be set up from the IBM Works settings if you have 
  571.  installed this package. 
  572.  
  573.  Then you can use the menu CSTeX/Spell-Checker to easily switch between the 
  574.  dictionaries of different languages, which saves your time and nerves for 
  575.  doing that in File/Settings/Paths/Dictionary Files and Personal Dictionary. 
  576.  The chosen dictionary is used until you exit EPM.  You can make this change 
  577.  permanent by entering and closing the Settings. 
  578.  
  579.  Note that your attempt to change the dictionary when Auto-spellcheck is on 
  580.  does not change the dictionary. 
  581.  
  582.  Since it seems that there are people that don't have that BonusPak CD, I have 
  583.  put some dictionaries somewhere on our ftp server and linked it to my WWW 
  584.  page. Or have IBM put it somewhere?  (Well, I was badly surprised that the 
  585.  Czech "localized" (!)  version of OS/2 Warp 4.0 Merlin contains only the US 
  586.  (!) dictionary, even I complained about that in the beta-testing). 
  587.  
  588.  
  589. ΓòÉΓòÉΓòÉ 2.9. 2.9 Installation of advanced macros ΓòÉΓòÉΓòÉ
  590.  
  591.  If you are too tired of installing pmCSTeX, you may skip this section and read 
  592.  this section later. 
  593.  
  594.  Otherwise, you may install the following features: 
  595.  
  596.   TeX-aware paragraph reformatting
  597.   TeX tags
  598.   Generalized Ctrl-[, Ctrl-] for TeX
  599.   Making backup copies of files before save
  600.   TeX, BibTeX (C, REXX etc.) assistance
  601.  
  602.  These they are independent of the CSTeX macro functionality, and included into 
  603.  the pmCSTeX package since they are fine when writing TeX files. 
  604.  
  605.  See also:  recompiling EPM 
  606.  
  607.  
  608. ΓòÉΓòÉΓòÉ 2.9.1. 2.9.1 TeX-aware paragraph reformatting ΓòÉΓòÉΓòÉ
  609.  
  610.  The hotkey Alt-P is used for reformatting the current paragraph to the current 
  611.  margins (see also Alt-Z in pm_keys).  However, the default reflowing routine 
  612.  is not TeX-aware, i.e.  it breaks lines with comments (text after the % 
  613.  character) and reformats into lines also the \begin{sth} ... \end{sth} LaTeX 
  614.  environments. 
  615.  
  616.  I have modified the macros responsible for the reformatting process.  If these 
  617.  are installed (see below), then the TeX-aware function is activated when 
  618.  editing *.tex, *.latex, *.sty, *.dtx, *.cls files, see also the constant 
  619.  TEX_EXTENSIONS in install\advanced\PM_MyCNF.e).  If no text is marked and 
  620.  Alt-P is pressed, then the paragraph reflowing stops at the first blank line 
  621.  (default) or at line containing: 
  622.  
  623.      %  --- comment 
  624.  
  625.      \begin --- new environment 
  626.  
  627.      \end  --- end of environment 
  628.  
  629.      \item  --- new item 
  630.  
  631.      \label  --- label 
  632.  
  633.      \[, \], \(, \) --- math environments 
  634.  
  635.  Notes: 
  636.  
  637.    1. For adding another TeX-reflow-stopping keyword (e.g. $ ... $), change the 
  638.       pm_reflow_is_tex_endline procedure in the source code. 
  639.  
  640.    2. The usual reflow routine is used when reformatting block mark of text. A 
  641.       warning appears in that case. If you wish to modify this routine as well, 
  642.       you are welcome. I never needed that. 
  643.  
  644.  Installation 
  645.  
  646.  There are the following two methods of installing the TeX-aware modifications: 
  647.  
  648.    1. Easy installation which overlays the hotkey Alt-P defined in epm.ex. To 
  649.       do that you need to put AltP4TeX.ex file somewhere in your EPMPATH and 
  650.       add the statement 
  651.  
  652.                     'link AltP4TeX'  /* Paragraph reflow (Alt-P hotkey) is TeX aware */
  653.  
  654.       to your Profile.erx.  The source code is in file AltP4TeX.e.  Both files 
  655.       are in the directory pmCSTeX\install\advanced\AltP\easy. 
  656.  
  657.    2. Advanced installation which requires to recompile EPM.ex. Proceed in the 
  658.       following way: 
  659.  
  660.           Save or move EPM.ex to something like epm_ex.00 
  661.  
  662.           Go to EPMMAC directory. Rename the original stdkeys.e and stdprocs.e 
  663.            to something like stdkeys_e.00 and stdprocs_e.00 
  664.  
  665.           Execute command 
  666.  
  667.                               gpatch -p0 <AltP-TeX.diff
  668.  
  669.            (adjust paths to gpatch and AltP-TeX.diff as needed). 
  670.  
  671.           Recompile EPM.e (etpm epm or etpm /v epm) 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ 2.9.2. 2.9.2 TeX tags ΓòÉΓòÉΓòÉ
  675.  
  676.  Have you ever used the EPM menu item View / Tags / Scan current file?  If not, 
  677.  try it when editing a C/C++, Pascal or .cmd file.  It will display list of all 
  678.  tags (i.e.  procedures and constants), and allow you to move quickly to their 
  679.  definitions.  The support for tags is compiled into epm.ex by including 
  680.  tags.e.  You can create a Toolbar item with Function:  * and Parameter: 
  681.  tagscan. 
  682.  
  683.  The support for TeX-related files is not in the standard EPM.  This has been 
  684.  contributed by Vladimir Kisil (vk@cage.rug.ac.be) and its function and 
  685.  installation is presented below. 
  686.  
  687.  TeX files (*.tex, *.latex, *.sty, *.dtx, *.cls) 
  688.  
  689.  Menu Tags / Scan current file displays nested list of commands: 
  690.  
  691.   \part
  692.   \chapter
  693.   \section
  694.       \subsection
  695.            \subsection
  696.              \paragraph
  697.              \subparagraph
  698.                \caption
  699.                  \label
  700.  
  701.  TeX log files (*.log) 
  702.  
  703.  Menu Tags / Scan current file displays list of messages: 
  704.  
  705.   ! TeX Errors
  706.       LaTeX (Font) Warning
  707.           Overflow
  708.  
  709.  BibTeX files (*.bib) 
  710.  
  711.  Menu Tags / Scan current file displays list of BibTeX entries: 
  712.  
  713.    @ARTICLE
  714.    @BOOK
  715.    @PROCEEDINGS
  716.    etc.
  717.  
  718.  Installation 
  719.  
  720.  There are two possible ways of installing tags with TeX file support.  Both 
  721.  come out from the same TeXtags.e file which is a modified version of tags.e. 
  722.  Note that it has been modified in accordance with suggestions in its beginning 
  723.  thus you will not lose any functionality for other types of files (C, C++, E, 
  724.  REXX, Pascal, etc.)  written in tags.e.  The modified version is in the 
  725.  directory pmCSTeX\install\advanced\tags. 
  726.  
  727.    1. Easy installation which overlays the tag scan definition in epm.ex.  Link 
  728.       precompiled TeXtags.ex file over existing EPM.ex file.  To do that you 
  729.       need to put TeXtags.ex file in your EPM directory and add a statement 
  730.  
  731.                     'link TeXtags'
  732.  
  733.       to your Profile.erx. 
  734.  
  735.    2. Advanced installation which requires to recompile EPM.ex. Proceed in the 
  736.       following way: 
  737.  
  738.           Save or move EPM.ex to something like epm_ex.00 
  739.  
  740.           Go to EPMMAC directory. Rename the original tags.e to something like 
  741.            tags_e.00 
  742.  
  743.           Execute command 
  744.  
  745.                               gpatch -p0 <tags-tex.diff
  746.  
  747.            (adjust paths to gpatch and tags-tex.diff as needed). 
  748.  
  749.           Recompile EPM.e (etpm epm or etpm /v epm) 
  750.  
  751.  
  752. ΓòÉΓòÉΓòÉ 2.9.3. 2.9.3 Generalized Ctrl-[, Ctrl-] for TeX ΓòÉΓòÉΓòÉ
  753.  
  754.  Currently, hotkeys  Ctrl-[ and Ctrl-] let the cursor jump between parenthesis. 
  755.  The following patch generalizes these hotkeys for searching the corresponding 
  756.  keyword in TeX constructs in TeX files: 
  757.  
  758.           \if.. \else \fi
  759.           \begin.. \end..
  760.           \begin{ \end{     or  \begin{..} \end{..}   (depends on COMPILE IF choice)
  761.           \left \right
  762.  
  763.  Technical note: routine passist() in assist.e has been patched. 
  764.  
  765.  Installation: 
  766.  
  767.  The installation requires to recompile recompile EPM.ex. Proceed in the 
  768.  following way: 
  769.  
  770.      Save or move EPM.ex to something like epm_ex.00 
  771.  
  772.      Go to EPMMAC directory. Rename the original asssist.e to something like 
  773.       assist_e.00 
  774.  
  775.      Execute command 
  776.  
  777.                     gpatch -p0 <assist-tex.diff
  778.  
  779.       (adjust paths to gpatch and assist-tex.diff as needed) 
  780.  
  781.      Recompile EPM.e (etpm epm or etpm /v epm), move epm.ex to its appropriate 
  782.       location. 
  783.  
  784.  
  785. ΓòÉΓòÉΓòÉ 2.9.4. 2.9.4 Making backup copies of files before save ΓòÉΓòÉΓòÉ
  786.  
  787.  EPM can make a backup copy of a file to be saved. This requires to recompile 
  788.  EPM.e with BACKUP_PATH defined in your MyCNF.e. If this variable is 
  789.  
  790.       BACKUP_PATH='='
  791.  
  792.  then the backup copy is made in the directory of the saved file. Otherwise you 
  793.  can specify unique directory to keep copies of all edited files, e.g. 
  794.  
  795.       BACKUP_PATH='d:\tmp\epm_save'
  796.  
  797.  The original routine denotes the backup file by trailing $ character. Since 
  798.  this is rather unique (in my opinion), usually editors name that file .bak or 
  799.  with trailing ~). Thus I patched the EPM routines to accept the following: 
  800.  
  801.    1. Backup file is denoted by trailing ~. 
  802.  
  803.    2. Making backup copies can be switched on or off via the command dialog 
  804.       Ctrl/I in EPM by the respective command 
  805.  
  806.                 backup_enable 1
  807.                 backup_enable 0
  808.  
  809.       or in Profile.erx via 
  810.  
  811.                 'backup_enable 1'
  812.                 'backup_enable 0'
  813.  
  814.       Furthermore, backing up can be allowed for file with some specified 
  815.       extensions (files for programming) and not for the other (text or 
  816.       postscript files). Again, in the command dialog of EPM, you can use 
  817.       either of 
  818.  
  819.                set_backup_extensions ''
  820.                set_backup_extensions 'AWK C CC CPP HTML TEX'
  821.  
  822.       or in Profile.erx 
  823.  
  824.                'set_backup_extensions'
  825.                'set_backup_extensions AWK C CC CPP HTML TEX'
  826.  
  827.       to allow all files to be backed up or only .awk, .c, .cc et al. The 
  828.       default definition is in stdprocs.e, where you can choose between '' and 
  829.       TEX_EXTENSIONS ' AWK ASM BIB E F F GP HTM HTML JAVA M PAS' (before 
  830.       recompiling EPM). 
  831.  
  832.  Installation: 
  833.  
  834.  The installation requires to recompile recompile EPM.ex. Proceed in the 
  835.  following way: 
  836.  
  837.      Save or move EPM.ex to something like epm_ex.00 
  838.  
  839.      Go to EPMMAC directory. Here you can save the original versions of 
  840.       stdprocs.e, e3emul.e, slnohost.e, and saveload.e. 
  841.  
  842.      Execute command 
  843.  
  844.                     gpatch -p0 <backup-files.diff
  845.  
  846.       (adjust paths to gpatch and backup-files.diff as needed) 
  847.  
  848.      Add the following two lines to your MyCNF.e: 
  849.  
  850.             -- backing up files before save?
  851.             BACKUP_PATH='='
  852.  
  853.      Recompile EPM.e (etpm epm or etpm /v epm), move new epm.ex to its 
  854.       appropriate location. 
  855.  
  856.      You may add the following to your Profile.erx if you like to change the 
  857.       default behaviour of backing up (otherwise, the default setting are 
  858.       taken): 
  859.  
  860.                 backup_enable 1
  861.                 set_backup_extensions ''
  862.  
  863.  
  864. ΓòÉΓòÉΓòÉ 2.9.5. 2.9.5 TeX, BibTeX (C, REXX etc.) assistance ΓòÉΓòÉΓòÉ
  865.  
  866.  Syntax assistance extended for TeX, in order to save some keystrokes, has been 
  867.  contributed by Vladimir Kisil (vk@cage.rug.ac.be).  It consists of myassist.e 
  868.  compiled if WANT_MY_ASSIST=1 and of some *.asi files. See the directory 
  869.  install\advanced\TeXassist for more details. 
  870.  
  871.  
  872. ΓòÉΓòÉΓòÉ 2.10. 2.10 Recompiling EPM ΓòÉΓòÉΓòÉ
  873.  
  874.  If you have not yet recompiled EPM macros (EPM.ex) to suit your needs, you may 
  875.  find the following notes useful. 
  876.  
  877.    1. Get epmmac.zip from the Net.  Unzip it in e.g.  \APPS\EPM\EPMMAC, add 
  878.       this directory into EPMPATH in the CONFIG.SYS and reboot. 
  879.  
  880.    2. Make a back-up copy of EPM.ex (e.g.  EPM_ex.00). 
  881.  
  882.    3. It is possible that after the installation of EPM you will obtain EPM.ex 
  883.       with the READ-ONLY attribute set.  In this case the E-compiler ETPM.EXE 
  884.       will not overwrite this version of EPM.ex.  The trap is that no error or 
  885.       warning message is issued in this case.  So after a "success-seems-to-be" 
  886.       compilation you will have still the old EPM.ex with the old 
  887.       functionality.  You should clear READ-ONLY attribute of EPM.ex by attrib 
  888.       command or just delete it. 
  889.  
  890.    4. Go to \APPS\EPM\EPMMAC.  Read the documentation and FAQ in read.me. 
  891.       Recompile:  etpm epm.  Replace old epm.ex by the compiled version, kill 
  892.       all EPM sessions and start EPM with any file to edit. 
  893.  
  894.    5. If this is your first try of recompiling EPM.ex and you have not read the 
  895.       documentation in details you have probably obtained the new EPM with a 
  896.       menu very different from the distributed one.  All trick is the 
  897.       definitions in MyCNF.e.  You may try to rename my PM_MyCNF.e to MyCNF.e 
  898.       and recompile again.  Otherwise, the configuration EPMGCNF.SMP file 
  899.       rather than MYCNF.SMP should be taken for the base for your MyCNF.e file 
  900.       to obtain an EPM.ex most close to the distributed one. 
  901.  
  902.       Note:  you can use my configuration file install\advanced\PM_MyCNF.e, if 
  903.       you rename it to MyCNF.e and copy to the EPMMAC directory. 
  904.  
  905.    6. Explanation of some constants useful to put in MyCNF.e is listed now: 
  906.  
  907.           Layout of the menu items:  The point is STD_MENU_NAME constant in 
  908.            MyCNF.e file. Check that your MyCNF.e file contains the following 
  909.            line 
  910.  
  911.                               STD_MENU_NAME = 'fevshmnu.e' -- (undef) Use WFEVSH menu style
  912.  
  913.            This will produce the usual EPM menu layout.  See EPM User's guide | 
  914.            Changing the default configuration | Summary of configuration 
  915.            constants for more information on STD_MENU_NAME. 
  916.  
  917.           If you recompile EPM.ex you may wish to make the highlighting oval 
  918.            for the Find / Replace dialog more notable than in the default 
  919.            EPM.ex. If you like the oval of Find next error in pmCSTeX, you may 
  920.            put 
  921.  
  922.                               LOCATE_CIRCLE_STYLE  =  4
  923.                               LOCATE_CIRCLE_COLOR1 = 13
  924.                               LOCATE_CIRCLE_COLOR2 = 13
  925.  
  926.            somewhere in you MYCNF.e file. The place inside a statement 
  927.  
  928.                               compile if defined(BLACK)
  929.                               ...
  930.                               compile endif
  931.  
  932.            or the end of MyCNF.e are the most appropriate to do that.  See EPM 
  933.            User's guide:  Changing the default configuration | Summary of 
  934.            configuration constants for more information on these constants, or 
  935.            search there for LOCATE_CIRCLE_STYLE and MAGENTA strings. 
  936.  
  937.           Menu items representing the EPM documentation are available if this 
  938.            is defined in MyCNF.e: 
  939.  
  940.                               SUPPORT_USERS_GUIDE = 1
  941.                               SUPPORT_TECHREF = 1
  942.  
  943.           With this option the EPM does not add the eoln char after with the 
  944.            selected word (Alt-W): 
  945.  
  946.                               WORD_MARK_TYPE = 'CHAR'
  947.  
  948.           Bug fix: please correct the minor bug in file load.e. The wrong line 
  949.  
  950.                               compile if defined(TEX_FILE_TYPES)
  951.  
  952.            should be corrected to 
  953.  
  954.                               compile if defined(TEX_FILETYPES)
  955.  
  956.           For various functions (both constants should keep the same string): 
  957.  
  958.                               TEX_FILETYPES  = 'TEX LATEX STY CLS DTX'
  959.                               TEX_EXTENSIONS = 'TEX LATEX STY CLS DTX'
  960.  
  961.    7. You can add TeX aware paragraph reformatting, see Alt-P. 
  962.  
  963.    8. You can replace tags.e from the standard distribution by the version 
  964.       enhanced for TeX, .log and BibTeX files.  See TeX tags. 
  965.  
  966.    9. You can add syntax assistance enhanced for TeX and BibTeX files. 
  967.  
  968.  
  969. ΓòÉΓòÉΓòÉ 2.11. 2.11 Information for users of Czech.E ΓòÉΓòÉΓòÉ
  970.  
  971.  If you use the macro Czech.E that implements the Czech keyboard in EPM (by Z. 
  972.  Wagner), you would encounter some collisions with the Greek keyboard.  That's 
  973.  why you should replace Czech.E by Czech_PM.E (from Czech_PM.zip file in this 
  974.  package), is it has been explained earlier.  I have added one global variable 
  975.  that keeps the status of the Czech keyboard (and I have commented out the 
  976.  beeps; you can restore them if you like them). 
  977.  
  978.  Pokud p┬ñijdete na d╨òvod tΓò¬ch koliz╨▒ a oprav╨▒te to, dejte mi pros╨▒m vΓò¬dΓò¬t. 
  979.  
  980.  Now, go to Tutorial. 
  981.  
  982.  
  983. ΓòÉΓòÉΓòÉ 3. 3 Tutorial ΓòÉΓòÉΓòÉ
  984.  
  985.  Welcome to the tutorial! I suppose you launched EPM in the demo directory by 
  986.  the command 
  987.  
  988.  Example: 
  989.  
  990.           start epm example.tex inc.tex
  991.  
  992.  If there is no CSTeX menu item in the EPM, reboot the computer.  Try Tutorial 
  993.  again.  If there is no progress, consult the Installation. 
  994.  
  995.  Now click on the word description (in example.tex file).  Press Ctrl/H. Help 
  996.  should appear.  If not, LaTeX2e.INF and LaTeX2e.NDX ware not installed 
  997.  correctly.  Further, if you press Ctrl/H on \mistake, you get the warning 
  998.  "Unable to find entry...".  It means this keyword is not listed in 
  999.  LaTeX2e.NDX. Now press Ctrl/H with the cursor being on the word \allowbreak. 
  1000.  Nothing happens:  it's correct---this is TeX primitive and it is also not 
  1001.  documented in LaTeX2e.INF. 
  1002.  
  1003.  You edit example.tex.  Choose CSTeX/(La)TeX document /b.  Then latex.cmd will 
  1004.  be launched to proceed your file (CSTeX-distribution users should have their 
  1005.  LaTeX.cmd command script equal to csLaTeX.cmd).  It finished.  There was one 
  1006.  mistake.  However, tex386 has not stopped due to the /b (=batchmode) command 
  1007.  line parameter passed into tex386.  So you now press Shift-F12 and the error 
  1008.  will be localized.  Press several times F12 to localize and read the .log file 
  1009.  in the edit ring.  Go back to example.tex, correct the mistake, and press 
  1010.  Shift-F12 again.  "No more errors" message should appear.  Then start 
  1011.  Previewer.  Usually you are re(La)TeXing your document while dvipm is 
  1012.  simultaneously on your screen, so you can hear the beep when tex386 has 
  1013.  finished and dvipm is reloading the document (it must be enabled via the dvipm 
  1014.  menu). 
  1015.  
  1016.  In the above procedure the tex386 window has been minimized so you cannot 
  1017.  interact with this program.  For the interactive work, you can use the menu 
  1018.  item "CSTeX/(La)TeX document".  It (La)TeXes your document on foreground using 
  1019.  the usual interactive mode. 
  1020.  
  1021.  Now click on any paragraph (a block of the text) and click on the toolbar icon 
  1022.  [TeXit].  The current paragraph should be recompiled and automatically updated 
  1023.  by dvipm (haven't you forget to set Auto reload in dvipm?). 
  1024.  
  1025.  Now play with it yourself.  Also, read the other part of this documentation 
  1026.  for more details.  For full details, read the source code of pm4EPM.e and 
  1027.  CSTeX.e, as well as all EPM manuals :-)).  If there some problems, please 
  1028.  correct them and send me the solution.  Have fun! 
  1029.  
  1030.  Please don't forget to read about the syntax of the keywords on the first line 
  1031.  of the Master file.  Those supplied in the example.tex 
  1032.  
  1033.  Example: 
  1034.  
  1035.    % Format: latex  emtexopt: */mp85500* dvips: *-p 123* ViewOpts: */tr1 +inverse*
  1036.  
  1037.  mean the following: 
  1038.  
  1039.      Format of the document is latex, i.e. use latex.cmd script to recompile 
  1040.       it, 
  1041.  
  1042.      before launching the above script, the environmental variable is enlarged 
  1043.       (with respect to its value from the config.sys) by the option /mp85500, 
  1044.       so that tex386 has larger pool size so it can process the AMS-LaTeX 
  1045.       documents, 
  1046.  
  1047.      if you are dvipsing (.dvi->.ps) the .dvi file, then only pages up to the 
  1048.       page 123 are printed (makes no sense in example.tex anyway), 
  1049.  
  1050.      ViewOpts are passed into the full-screen previewer and to the printer 
  1051.       drivers. 
  1052.  
  1053.  
  1054. ΓòÉΓòÉΓòÉ 4. 4 Usage ΓòÉΓòÉΓòÉ
  1055.  
  1056.  Please go yourself through all the CSTeX menu options, icons and actions that 
  1057.  you can icon-ify.  This manual will probably never be too complete.  You are 
  1058.  welcome to contribute. 
  1059.  
  1060.  However, it should not mine, since "ordinary" users will hardly change the 
  1061.  code, and the programmers will do it easily.  Anyway, you are welcome to have 
  1062.  a look at .e files what's really inside.  They are readable... 
  1063.  
  1064.  
  1065. ΓòÉΓòÉΓòÉ 4.1. 4.1 Syntax of expansions ΓòÉΓòÉΓòÉ
  1066.  
  1067.  You edit a file. It is called working file. If its first line contains 
  1068.  
  1069.  Example: 
  1070.  
  1071.     %  .......   Master: b.tex   .....
  1072.  
  1073.  then b.tex is its master file to which all actions like latexing, previewing 
  1074.  etc.  will be related.  If there is no Master: keyword on its first line, this 
  1075.  file is both Working and Master. 
  1076.  
  1077.  The first line of the Master file can contain other keywords which are 
  1078.  expanded by pm4EPM.e.  CSTeX.e reacts to the following keywords: 
  1079.  
  1080.  Example: 
  1081.  
  1082.     % .... Format: cslatex209  .....
  1083.  
  1084.  or 
  1085.  
  1086.  Example: 
  1087.  
  1088.     % .... Format: plain .....
  1089.  
  1090.  This is used to texing the document.  .cmd file of the same name as is that of 
  1091.  the format is called to compile the document (in the above example, 
  1092.  cslatex209.cmd and plain.cmd are called, respectively).  If no Format: is 
  1093.  present, environmental variable LATEXFORMATDEFAULT is searched.  If that is 
  1094.  not defined, default format latex is used. 
  1095.  
  1096.  Synonym to the Format: myformat is %&myformat starting the command line; this 
  1097.  allows to accept cweb/unix style of format determination. 
  1098.  
  1099.  Example: 
  1100.  
  1101.     % .... EMTEXOPT: */mp85500*  .....
  1102.  
  1103.  This keyword is added to the environmental variable EMTEXOPT before 
  1104.  _format_.cmd is started.  The above option I use for AMS-LaTeX and AMS-fonts. 
  1105.  Another example:  if you want to get rid of the user interaction even in the 
  1106.  CSTeX/(La)TeX document, then replace */mp85500* by */mp85500 /b* or by */b*. 
  1107.  See the emTeX documentation for more details (\emtex\doc\(english or 
  1108.  german)\tex.doc). 
  1109.  
  1110.  Example: 
  1111.  
  1112.     % .... dvips: *-p 3 -l 9 -A*  .....
  1113.  
  1114.  This keyword enables passing parameters into dvips (in this case, only the odd 
  1115.  pages between page 3 and 9 are postscripted).  Look at dvips documentation (or 
  1116.  type dvips at the command prompt) for more details. 
  1117.  
  1118.  Example: 
  1119.  
  1120.     % .... makeindex: * -s mystyle *  .....
  1121.  
  1122.  Options that are passed into the MakeIndex program.  See its documentation for 
  1123.  more details. 
  1124.  
  1125.  Example: 
  1126.  
  1127.     % .... ViewOpts: */tr1 +zoom:4 +inverse*  .....
  1128.  
  1129.  The string between those stars (*) or any pair of same chars is taken as the 
  1130.  argument for printer/viewer command line.  That means not for "Viewer 
  1131.  document" (interactive dvipm), but for "Preview before print" and "Print". 
  1132.  Consult \emtex\doc\english\dvidrv.doc for more details about the available 
  1133.  switches, or type /?? at the dvi* prompt. 
  1134.  
  1135.  If you are Editing settings of an icon on the toolbar, there is "Parameters" 
  1136.  line related to "Action".  This Parameter is expanded as described directly in 
  1137.  the pm4EPM.e file.  They are not used by CSTeX.e (yet). 
  1138.  
  1139.  
  1140. ΓòÉΓòÉΓòÉ 4.2. 4.2 CSTeX menu items explanation ΓòÉΓòÉΓòÉ
  1141.  
  1142.  (La)TeX document 
  1143.  
  1144.  Compiles document on foreground:  start /c /win /f cmd.exe /c %format.cmd %N 
  1145.  Abbreviation %N expands to the master file in the Unix style and %format to 
  1146.  the format of the document. 
  1147.  
  1148.  (La)TeX document /b 
  1149.  
  1150.  As above, but TeXing is started on the background.  Well, in both cases, you 
  1151.  should have used \batchmode TeX command in the beginning of your file to force 
  1152.  tex386 go smoothly over errors (you locate errors later using Shift-F12). 
  1153.  
  1154.  (La)TeX paragraph 
  1155.  
  1156.  Compiles the current paragraph of the edited text.  The paragraph is the text 
  1157.  block between two blank lines, or a line block of text (marked by Alt-L ... 
  1158.  Alt-L, for instance).  A temporary file $cstex$.tex is written, which contains 
  1159.  everything from the first line to the \begin{document} statement of the Master 
  1160.  file, then the current paragraph, and the file is terminated by 
  1161.  \end{document}.  After reLaTeXing, the .dvi and .log files are copied over 
  1162.  those of the Master file. 
  1163.  
  1164.  Locate next error 
  1165.  
  1166.  A. Error searching: If .log file is loaded, then search for the next error. 
  1167.  If .log file is not loaded, load it to the editor and search for the first 
  1168.  error.  If it is loaded, refresh it and start from the beginning. 
  1169.  
  1170.  (Technical note:  the above works fine for me; I think there is no need to 
  1171.  implement in next_error to check the file on the harddisk whether it has 
  1172.  changed or not every time when next_error function is invoked by the user.) 
  1173.  
  1174.  B. Warning searching: 
  1175.  
  1176.  If you position the cursor in .log file on a line which is like one of these: 
  1177.  
  1178.   Overfull \hbox (19.0473pt too wide) detected at line 5
  1179.   Overfull \hbox (19.94281pt too wide) in alignment at lines 95--104
  1180.   Underfull \hbox (badness 10000) in paragraph at lines 356--373
  1181.   LaTeX ...whatever, e.g. Warning: or Font Info:.... line 138.
  1182.  
  1183.  then the Locate next error will find the location of the warning from that 
  1184.  line. 
  1185.  
  1186.  Otherwise the method A. is in action, of course.  That's what you use 
  1187.  normally. 
  1188.  
  1189.  PostScript menus 
  1190.  
  1191.  dvips will be used to convert .dvi -> .ps.  Then you can launch either gvpm 
  1192.  program (it is the GhostView for OS/2, available from any net server mirroring 
  1193.  the ghostscript staff) or use the DOS previewer psview (available at 
  1194.  ftp.muni.cz:pub/tex/local/postscript/psview.zip).  If you print from dvips, 
  1195.  then the output goes to the prn port.  See also the keyword dvips: applicable 
  1196.  for the Master's first line, which is described in the section Syntax. 
  1197.  
  1198.  If you use the menu item dvips-it, then pmCSTeX will beep when it is finished, 
  1199.  so that you can reload the file in GhostView or send it into a PostScript 
  1200.  printer.  You can switch this beep off, see recompiling. 
  1201.  
  1202.  Printing menus 
  1203.  
  1204.  Menu for printing using dvihplj and 300 dpi was well tested.  Others not.  If 
  1205.  you have other printer not listed explicitly in the menu, then .cmd script 
  1206.  will be called with myprt1.cmd or myprt2.cmd.  For previewing, myprt1.cnf or 
  1207.  myprt2.cnf will be used.  You should prepare them yourself, according to 
  1208.  \emtex\bin\prt*.cmd and \emtex\data\*.cnf files. 
  1209.  
  1210.  Editor / Include 
  1211.  
  1212.  The file whose name is under the cursor is included into the editor.  The 
  1213.  routine is implemented such that it looks to the current directory, then to 
  1214.  ..\units, then to \emtex\texinput, then to some of the \emx\include 
  1215.  directories.  You can easily add your favourite directories to the source code 
  1216.  of CSTeX.e and recompile the macros. 
  1217.  
  1218.  Moreover, not only the file under cursor, but as well as those files with .h, 
  1219.  .c, .cpp, .sty, .tex are searched. Try it and see. 
  1220.  
  1221.  CStoCS (╨╝esk╨░ verze) 
  1222.  
  1223.  Pokud nem╨░te konverzn╨▒ program cs2cs (dal jsem ho do modulu os2.zip?), tak si 
  1224.  ho st╨░hnΓò¬te p┬ñ╨▒mo od jeho autora: ftp://aip1.fsv.cvut.cz/users/ferdi/cs2cs.zip 
  1225.  
  1226.  Spell / Czech,Slovak,English (╨╝esk╨░ verze) 
  1227.  
  1228.  Pravopis se oprav╨▒ v DOSovsk╨Æm programu %EMTEXDIR%\cstug\texspell.exe, kter╤î 
  1229.  je sou╨»╨░st╨▒ p╨░t╨Æ diskety CSTeXu pro registrovan╨Æ ╨»leny CSTUGu.  M╨░ smysl 
  1230.  pou╨╖╨▒vat pouze pro opravy ╨»e╤çtiny ╨»i sloven╤çtiny do t╨Æ doby, ne╨╖ n╨░m IBM 
  1231.  laskavΓò¬ dod╨░ CZ.DIC anebo SK.DIC, bude-li to v╨òbec nΓò¬kdy.  U╨╖ by s t╨▒m taky 
  1232.  mohli trochu pohnout, ╨╖e? 
  1233.  
  1234.  1999: slovn╨▒ky, tedy alespo╤à jak╨Æsi soubory *.dic, jsou sou╨»╨░st╨▒ Netscapu 
  1235.  4.61. Ov╤çem zase nejdou ╨»╨▒st v EPM, cosi s nimi pad╨░. See bugs. 
  1236.  
  1237.  Other TeX programs 
  1238.  
  1239.  Drawing programs:  TeXcad is well-known, Qfig probably less.  But there are 
  1240.  XFree86 ported to OS/2 (http://set.gmd.de/~veit/os2/xf86os2.html) so I'm 
  1241.  really glad that I can use Xfig for OS/2.  Since you run XFree86 in a separate 
  1242.  full-screen session, there is no item for it.  PageDraw is a good tool for 
  1243.  PostScript drawings---it runs in Win-OS2 session, so the author should be 
  1244.  asked for a native OS/2 version. 
  1245.  
  1246.  TeXclean 
  1247.  
  1248.  Deletes all files *.aux *.log *.dlg *.dvi *.toc *.lot *.lof *.blg *.idx *.ind 
  1249.  *.glo *.gls *.hp *.mfj *.pri *.bak 
  1250.  
  1251.  
  1252. ΓòÉΓòÉΓòÉ 4.3. 4.3 Hotkeys in CSTeX ΓòÉΓòÉΓòÉ
  1253.  
  1254.  These hotkeys are defined: 
  1255.  
  1256.  Ctrl/1 
  1257.  
  1258.  It brings menu with paragraph, section, chapter... 
  1259.  
  1260.  Ctrl/3 
  1261.  
  1262.  It brings menu with LaTeX environments.  If there is a line-mark, then 
  1263.  surround the marked text block by the choosen environment; otherwise insert 
  1264.  the environment and a blank line in between 
  1265.  
  1266.  Ctrl/4 
  1267.  
  1268.  It brings menu with AMSLaTeX environments If there is a line-mark, then 
  1269.  surround the marked text block by the choosen environment; otherwise insert 
  1270.  the environment and a blank line in between 
  1271.  
  1272.  Ctrl/5 
  1273.  
  1274.  It brings menu with LaTeX font sizes 
  1275.  
  1276.  Ctrl/6 
  1277.  
  1278.  It brings menu with textrm, textsf, texttt, textmd, textbf, textup, textit, 
  1279.  textsl, textsc, emph, textnormal 
  1280.  
  1281.  Ctrl/7 
  1282.  
  1283.  It brings menu with rmfamily, sffamily, ttfamily, mdseries, bfseries, upshape, 
  1284.  itshape, slshape, scshape, em, normalfont 
  1285.  
  1286.  Alt-G 
  1287.  
  1288.  Switches the keyboard to the Greek keyboard.  After pressing Alt-G and 
  1289.  pressing a key, its Greek character (in TeX syntax) will be typeset instead. 
  1290.  E.g. Alt-G a produces \alpha. 
  1291.  
  1292.  Note:  if the keyboard is not switched to the keyboard layout you was using 
  1293.  before, then change the end of DEFPROC pm_TypeGreek() according to any global 
  1294.  flag your personal keyboard provides. 
  1295.  
  1296.  And finally, here is the translation table: 
  1297.  
  1298.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÉ
  1299.   Γöéa    Γöéb   Γöéc  Γöéd    Γöée      Γöéf  Γöég    Γöéh  Γöéi   Γöéj  Γöék    Γöél     Γöém Γöén Γöé
  1300.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöñ
  1301.   Γöé-    Γöé-   Γöé-  ΓöéD    Γöé-      ΓöéF  ΓöéG    Γöé-  Γöé-   ΓöéJ  Γöé-    ΓöéL     Γöé- Γöé- Γöé
  1302.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöñ
  1303.   ΓöéalphaΓöébetaΓöéchiΓöédeltaΓöéepsilonΓöéphiΓöégammaΓöéetaΓöéiotaΓöépsiΓöékappaΓöélambdaΓöémuΓöénuΓöé
  1304.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÿ
  1305.  
  1306.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÉ
  1307.   Γöéo    Γöép Γöéq    Γöér  Γöés    Γöét  Γöéu         Γöév     Γöéw       Γöéx Γöéy      Γöéz   Γöé
  1308.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöñ
  1309.   ΓöéO    ΓöéP ΓöéQ    Γöé-  ΓöéS    Γöé-  Γöé-         Γöé-     Γöé-       ΓöéX ΓöéY      Γöé-   Γöé
  1310.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöñ
  1311.   ΓöéomegaΓöépiΓöéthetaΓöérhoΓöésigmaΓöétauΓöévarepsilonΓöévarphiΓöévarthetaΓöéxiΓöéupsilonΓöézetaΓöé
  1312.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÿ
  1313.  
  1314.  
  1315. ΓòÉΓòÉΓòÉ 4.4. 4.4 Hotkeys in pm_keys ΓòÉΓòÉΓòÉ
  1316.  
  1317.  There are some hotkeys you may or may not find useful.  You can either add 
  1318.  
  1319.           'link pm_keys'
  1320.  
  1321.  into Profile.erx, or copy the hotkey definitions into your MyKeys.E file (then 
  1322.  recompile it).  Currently, I use these definitions: 
  1323.  
  1324.  Ctrl/Y 
  1325.  
  1326.  It deletes the current line (as Ctrl/BackSpace does).  I'm used to this key 
  1327.  sequence from Borland-like editors. 
  1328.  
  1329.  Alt-1 
  1330.  
  1331.  Generalizes / enhances the standard EPM file load hotkey, equivalent to 
  1332.  CSTeX/Editor/Include. 
  1333.  
  1334.  Alt-3 
  1335.  
  1336.  Inserts \begin{} 
  1337.  
  1338.  Alt-4 
  1339.  
  1340.  Inserts \end{} 
  1341.  
  1342.  Alt-5 
  1343.  
  1344.  Inserts \[  \] 
  1345.  
  1346.  Alt-6 
  1347.  
  1348.  Inserts $$  $$ 
  1349.  
  1350.  Alt-Z 
  1351.  
  1352.  It brings a dialog with margin setup.  Easier then going to File/Settings... 
  1353.  
  1354.  Alt-Q 
  1355.  
  1356.  This hotkey provides either of the following two actions: 
  1357.  
  1358.  1. quickly makes \begin{equation} ...  \end{equation} environment with two two 
  1359.  comment lines above and below.  Thus pressing Alt-Q on this line would do: 
  1360.  
  1361.      %
  1362.      \begin{equation}
  1363.  
  1364.      \end{equation}
  1365.      %
  1366.  
  1367.  2. If the line under the cursor contains only \begin{equation}, it changes it 
  1368.  into \begin{eqnarray}.  If there is \begin{eqnarray}, it is changed to 
  1369.  \begin{align}, and if there is \begin{align}, it transforms back to 
  1370.  \begin{equation}.  The same rotation works for the \end{equation}, 
  1371.  \end{eqnarray} and \end{align} lines too, as well as for the \begin and \end 
  1372.  versions of equation*, eqnarray* and align* environments. 
  1373.  
  1374.  Note for future:  this could be more powerful if this command would change 
  1375.  both \begin{..} and \end{..} simultaneously. 
  1376.  
  1377.  
  1378. ΓòÉΓòÉΓòÉ 5. 5 Recompiling the macros ΓòÉΓòÉΓòÉ
  1379.  
  1380.  Your need stdconst.e from epmmac.zip (see hobbes.nmsu.edu:os2/editors).  This 
  1381.  file has to be on your EPMPATH. 
  1382.  
  1383.  The following commands will compile CSTeX EPM macros: 
  1384.  
  1385.  Example: 
  1386.  
  1387.           etpm pm4EPM
  1388.           etpm CSTeX
  1389.  
  1390.  You can recompile CSTeX.e into two menu schemes depending on the constant 
  1391.  CSTEX_CSTEX: 
  1392.  
  1393.  CSTEX_CSTEX=1 
  1394.  
  1395.  This produces CSTeX for EPM that is distributed together with CSTeX'96 
  1396.  distribution.  It includes support for all our favourite CS features and 
  1397.  programs 
  1398.  
  1399.  CSTEX_CSTEX=0 
  1400.  
  1401.  This disables compilation of the features specific for CSTeX'96 distribution 
  1402.  
  1403.  CSTEX_CS2CS=1 
  1404.  
  1405.  Uses OS/2 program cs2cs.exe for Czech encodings conversion (this program does 
  1406.  not come with CSTeX'96 distribution yet, get it from 
  1407.  ftp://aip1.fsv.cvut.cz/users/ferdi/cs2cs.zip 
  1408.  
  1409.  CSTEX_CS2CS=0 
  1410.  
  1411.  Uses DOS program cstocs.exe for Czech encodings conversion (included in 
  1412.  CSTeX'96 distribution, but due to cs2cs.exe it became obsolete now) 
  1413.  
  1414.  PM_DICTIONARIES=1 
  1415.  
  1416.  Adds dictionary (language) menu for EPM spell checking+synonyms 
  1417.  
  1418.  CSTEX_USEMASTERDIR=1 
  1419.  
  1420.  The master file is firstly searched in the directory of the working file, then 
  1421.  in the current directory; if 
  1422.  
  1423.  CSTEX_USEMASTERDIR=0 
  1424.  
  1425.  then the master file is searched in the current directory, i.e.  in the 
  1426.  directory where the EPM was started from.  The choice =1 is much better if EPM 
  1427.  runs permanently (EPM /i). 
  1428.  
  1429.  Two options in DEFINIT routine in CSTeX.e 
  1430.  
  1431.  cstex_true_tex_background=1 is default option that minimizes window of the 
  1432.  background TeXing.  Set cstex_true_tex_background=0 to get the whole window. 
  1433.  cstex_background_beep=0 is default option to avoid beep when background texing 
  1434.  has finished (dvipm can do it for you).  Set cstex_background_beep=1 if you 
  1435.  would prefer this beep. 
  1436.  
  1437.  You can do the appropriate changes in both files---as you wish.  In fact, you 
  1438.  should changed the menus and related things if some build-in options do not 
  1439.  suite your customs.  I tried to write the code as simple as possible---I'm not 
  1440.  professional EPM programmer. 
  1441.  
  1442.  However, KEEP IN MIND that you can distribute the files derived from CSTeX 
  1443.  ONLY IF the original distribution of pmCSTeX.zip comes with them!  People need 
  1444.  to know where that comes from, whom they can make donations to or who is the 
  1445.  person to blame... 
  1446.  
  1447.  
  1448. ΓòÉΓòÉΓòÉ 6. 6 Conclusion ΓòÉΓòÉΓòÉ
  1449.  
  1450.  This release of pmCSTeX for EPM works perfectly for me, but that need not be 
  1451.  the case for you.  If it does not work, please verify the installation of EPM, 
  1452.  go again through the Installation, and read about Bugs.  If this did not help, 
  1453.  then let me know about your problems. 
  1454.  
  1455.  You can also write me about your suggestions or even your solutions to your 
  1456.  suggestions, what should be additionally included etc.  Thanks. 
  1457.  
  1458.  
  1459. ΓòÉΓòÉΓòÉ 6.1. 6.1 History ΓòÉΓòÉΓòÉ
  1460.  
  1461.   16. 4. 2000 
  1462.  
  1463.              License explicitly added (required by (La)TeX packages 
  1464.               catalogue). 
  1465.  
  1466.              Syntax of expansions: synonym to the Format: myformat is 
  1467.               %&myformat starting the command line; this allows to accept 
  1468.               cweb/unix style of format determination. 
  1469.  
  1470.              Installing all advanced features via diff files and gpatch 
  1471.               instead of the distribution of modified source files. 
  1472.  
  1473.              Added patch for making backup copies of files before save. 
  1474.  
  1475.              Documented the idea of solving the red oval instability in the 
  1476.               bugs section. 
  1477.  
  1478.              Czech specific: added updated version of dvi-out2 (contributed by 
  1479.               Jaromir Kuben). 
  1480.  
  1481.              New hotkeys Alt-3,Alt-4, Alt-5, Alt-6. 
  1482.  
  1483.              Czech specific: added updated version of vlnka (contributed by 
  1484.               Jaromir Kuben). Previous vlnka2.exe removed, added new vlna.exe. 
  1485.  
  1486.              Czech specific: added EPM for TeX short guide EPMpopisJK.INF by 
  1487.               Jaromir Kuben. 
  1488.  
  1489.              Added TeX syntax assistance, to save some keystrokes, by Vladimir 
  1490.               Kisil (vk@cage.rug.ac.be).  See the directory 
  1491.               install\advanced\TeXassist for more details. 
  1492.  
  1493.   15. 3. 1999 
  1494.  
  1495.              enhancement for Ctrl-[ and Ctrl-] hotkeys in order to search pair 
  1496.               construct (La)TeX keywords 
  1497.  
  1498.   6. 3. 1999 
  1499.  
  1500.              enhancement for Ctrl/3,4 Hotkeys in CSTeX for the inclusion of 
  1501.               (AMS-)LaTeX environments:  if a line-marked block (Alt-L) exists, 
  1502.               then surround it by the choosen environment; otherwise 
  1503.               environment inserted at the cursor position (as before) 
  1504.  
  1505.   14. 12. 1998 
  1506.  
  1507.              Improvement:  skipping text between Overfull/Underfull and [] 
  1508.               (sometimes produced a warning about wrong number of corrupted 
  1509.               .log file because of parenthesis) 
  1510.  
  1511.              Improvement: skipping text from LaTeX Warning: until blank line 
  1512.  
  1513.   18. 1. 1998 
  1514.  
  1515.              Figured out how to make Double-side or slot 2 printing from dvips 
  1516.  
  1517.              Bugfix:  the greek keyboard was switching off Auto-spellcheck. 
  1518.  
  1519.              Generalization of the Locate next error function (available from 
  1520.               the menu, as the toolbar icon or as hotkey Shift-F12). 
  1521.  
  1522.               If you put the cursor in .log file on a line which is like 
  1523.  
  1524.                             Overfull \hbox (19.0473pt too wide) detected at line 5
  1525.                             Overfull \hbox (19.94281pt too wide) in alignment at lines 95--104
  1526.                             Underfull \hbox (badness 10000) in paragraph at lines 356--373
  1527.                             LaTeX ...whatever, e.g. Warning: or Font Info:.... line 138.
  1528.  
  1529.               then the Locate next error will find the location of the warning 
  1530.               from that line. 
  1531.  
  1532.               Otherwise, i.e.  from non-.log files or having there cursor on 
  1533.               another line (which is usual when searching for true errors), the 
  1534.               behaviour of this function is unchanged. 
  1535.  
  1536.   5. 1. 1998 
  1537.  
  1538.              (La)TeXing the paragraph: now accepts the current paragraph as 
  1539.               well as the line block of text, if selected; see CSTeX menu items 
  1540.               explanation 
  1541.  
  1542.              Bugfix in the Czech version: reversed parameters of Master and 
  1543.               Options when calling csdvips 
  1544.  
  1545.              This documentation updated for the Installation of advanced 
  1546.               macros 
  1547.  
  1548.   29. 12. 1997 
  1549.  
  1550.              TeX->PS routine---thus you can use the action 
  1551.               cstex_texit_and_dvips for making a toolbar icon (now: only menu 
  1552.               item (La)TeX and dvips document) 
  1553.  
  1554.              Change in sampactn.e (syntax highlighting): *.ps, *.eps and *.pdx 
  1555.               files are coloured according to epmkwds.ps 
  1556.  
  1557.   15. 12. 1997 
  1558.  
  1559.              In the pm_keys.e, I have joined Alt-Q and Ctrl-Q into Alt-Q, 
  1560.               since I have found how the Ctrl-Q and the ALL command can be 
  1561.               useful 
  1562.  
  1563.              Moreover, the new version of Alt-Q work on TeX-like files only 
  1564.               (i.e.  files with extension TEX, LATEX, STY, CLS or DTX 
  1565.  
  1566.              View documentation menu item enhanced to browse pmCSTeX.INF and 
  1567.               LaTeX2e.INF 
  1568.  
  1569.   11. 11. 1997 
  1570.  
  1571.              Bug fix:  EPM crashed when (La)TeXing a paragraph invoked from a 
  1572.               very deep directory (this was caused by EPM's string length 
  1573.               limitation) 
  1574.  
  1575.              View documentation menu item added (note:  this routine works if 
  1576.               the EPM has been compiled with WANT_SEARCH_PATH) 
  1577.  
  1578.              Call of the macro already_in_ring replaced by its expansion (did 
  1579.               not work for two users who recompiled EPM without the E3EMUL 
  1580.               support) 
  1581.  
  1582.              FAQ added to the documentation 
  1583.  
  1584.   24. 9. 1997 
  1585.  
  1586.              TeXing a paragraph was not working if another EPM session (or EPM 
  1587.               server) on different partition was running simultaneously 
  1588.  
  1589.   16. 7. 1997 
  1590.  
  1591.              Alt-1 (in pm_keys) load file hotkey in pm_keys accepts also 
  1592.               absolute filenames as well as those in Unix format (forward 
  1593.               slashes) 
  1594.  
  1595.   13. 4. 1997 
  1596.  
  1597.              Alt-1 (in pm_keys) load file hotkey replaced by my 
  1598.               generalization. 
  1599.  
  1600.              Options for MakeIndex are now available. 
  1601.  
  1602.              PostScript: psview.cmd added (i.e. psview.bat converted for OS/2 
  1603.               and changed its option in the menu). 
  1604.  
  1605.              PostScript: dvips-it + pause added. 
  1606.  
  1607.              Spell-checker: warning if the selected dictionary does not exist, 
  1608.               Spain dictionary added. Greek keyboard: ksi->xi fixed. 
  1609.  
  1610.              Other programs (CSTeX version): dvi-out2 works in current 
  1611.               directory and shows the messages. 
  1612.  
  1613.   5. 2. 1997 
  1614.  
  1615.              Bugfix for a typo in the previously updated version of the 
  1616.               protection against damaged .log files. 
  1617.  
  1618.   30. 1. 1997 and 3. 2. 1997 
  1619.  
  1620.              The oval over the mistakes found is now thicker and 
  1621.               light_magenta, thus easier to distinguish 
  1622.  
  1623.   26. 1. 1997 
  1624.  
  1625.              'TeXclean' now deletes *.bak files too 
  1626.  
  1627.              'Highlight all' now does correctly go back to the first file 
  1628.  
  1629.   15. 1. 1997 
  1630.  
  1631.              Documentation rewritten, packed together in order to release the 
  1632.               beta version of the pmCSTeX for EPM, the version for the year 
  1633.               1997 
  1634.  
  1635.   4. 1. 1997 
  1636.  
  1637.              The master file is firstly searched in the directory of the 
  1638.               working file, then in the current directory (compilation option 
  1639.               CSTEX_USEMASTERDIR) 
  1640.  
  1641.              Menu item "Cykl" taken away (well, it was there for some 
  1642.               historical reasons and I never used it under EPM) 
  1643.  
  1644.   30. 11. 1996 
  1645.  
  1646.              (Czech version):  za╨»lenΓò¬ny dvi-out2.exe, vlnka2.exe (pascalsk╨Æ 
  1647.               zdroj╨░ky p╨òvodn╨▒ch DOSovsk╤îch program╨ò byly kone╨»nΓò¬ zkopilovan╨Æ 
  1648.               pro OS/2).  Update se provede takto:  tyhle dva nov╨Æ ex╨░╨»e a nov╤î 
  1649.               csdvips.cmd se zkop╨▒ruj╨▒ do %EMTEX%\bin 
  1650.  
  1651.   28. 10. 1996 
  1652.  
  1653.              Dictionaries FR.dic, UK.dic, US.dic, etc. are taken from the 
  1654.               directory defined by the EPM_DICTIONARIES environmental variable. 
  1655.               If this does not exist, then from the directory \APPS\EPM. See 
  1656.               also spell checker 
  1657.  
  1658.   22. 10. 1996 
  1659.  
  1660.              For the CS version: separate BibTeX, MakeIndex and csBibTeX, 
  1661.               csMakeIndex (csBibTeX has been compiled in 1994 and it is not 
  1662.               compatible with the new emTeX directory structure) 
  1663.  
  1664.   9. 10. 1996 
  1665.  
  1666.              CSTeX.e: in DEFC cstex_highlight_all added nextfile after the 
  1667.               loop; but then taken away because of other link; I'll check it in 
  1668.               future. 
  1669.  
  1670.              Profile.erx: remarks should be enclosed in /*  */ instead of only 
  1671.               a semicolon prefix 
  1672.  
  1673.   22. 7. 1996 
  1674.  
  1675.              Hotkeys Ctrl/1, Ctrl/6, Ctrl/7 added 
  1676.  
  1677.   11. 6. 1996 
  1678.  
  1679.              Added dictionary (language) menu for EPM spell checking+synonyms. 
  1680.               The corresponding compile option is PM_DICTIONARIES 
  1681.  
  1682.   8. 6. 1996 
  1683.  
  1684.              Final release---upload to hobbes, leo and CTAN 
  1685.  
  1686.   7. 6. 1996 
  1687.  
  1688.              Meaning of Alt-Q changed, added Ctrl-Q hot key; spell-checker 
  1689.               discussion 
  1690.  
  1691.   28. 5. 1996 
  1692.  
  1693.              TeXing action works even when you ask for it from within .log 
  1694.               file 
  1695.  
  1696.              'Locate Next Error': oval drawing for ...long line with an error 
  1697.               works now better 
  1698.  
  1699.   26. 5. 1996 
  1700.  
  1701.              Typo/bug from 19. 5. corrected 
  1702.  
  1703.              sampactn.e replaced according to new EPM 6.03b 
  1704.  
  1705.   19. 5. 1996 
  1706.  
  1707.              EMTEXOPT keyword added (see syntax) so you don't need to change 
  1708.               your .cmd files if you use AMS-LaTeX or memory consuming 
  1709.               documents.  Therefore EMTEXOPT environmental variable has to be 
  1710.               established and it should contain fixed memory parameters (see 
  1711.               Installation).  These were previously in .cmd files and they have 
  1712.               been changed in this release.  Using this EMTEXOPT trick there is 
  1713.               no more need to have \batchmode command in the Master file. 
  1714.               Document being (La)TeXed on background is iconified, but this can 
  1715.               be changed (see recompiling) 
  1716.  
  1717.   16. 5. 1996 
  1718.  
  1719.              Suggestions and minor changes reported by Wolfgang Kronberg 
  1720.               (kroni@bite.shnet.org) taken into account 
  1721.  
  1722.              Section about syntax highlighting written 
  1723.  
  1724.   15. 5. 1996 
  1725.  
  1726.              Annoying message "I think you re(La)TeXed..." taken away 
  1727.  
  1728.              dvips option into pm4EPM (i.e. new expandable keyword dvips for 
  1729.               the Master's first line included) 
  1730.  
  1731.   9. 5. 1996 
  1732.  
  1733.              OdstranΓò¬no zdvojen╨▒ ~V v menu View a vlnka 
  1734.  
  1735.   6. 5. 1996 
  1736.  
  1737.              Announcement in comp.os.os2.announce 
  1738.  
  1739.              cstocs.exe replaced by cs2cs.exe 
  1740.  
  1741.   2. 5. 1996 
  1742.  
  1743.              AMS-LaTeX environments support  (Ctrl/4 hotkey in pm_keys) 
  1744.  
  1745.   28. 4. 1996 
  1746.  
  1747.              Only small changes 
  1748.  
  1749.   1. 3. 1996 
  1750.  
  1751.              First public announcement 
  1752.  
  1753.   6. 2. 1996 
  1754.  
  1755.              Distribution for my colleagues 
  1756.  
  1757.   30. 1. 1996 
  1758.  
  1759.              First useable version for myself 
  1760.  
  1761.  
  1762. ΓòÉΓòÉΓòÉ 6.2. 6.2 FAQ---Frequently Asked Questions ΓòÉΓòÉΓòÉ
  1763.  
  1764.  There are some Frequently Asked Questions listed here. 
  1765.  
  1766.   How to run MetaFont, gnuplot, awk... on the edited file
  1767.   Incorrection version
  1768.   How to read previous EPM messages?
  1769.   I cannot see \begin etc. keywords
  1770.   You don't like my hotkeys
  1771.   Nefunguje mi ╨»esk╨░ kl╨░vesnice
  1772.   Double-side or slot 2 printing from dvips
  1773.   Tags are fine, but are there "permanent" tags?
  1774.   I have a question/I have found a bug...
  1775.   Renaming a file
  1776.   Running EPM as a server
  1777.   Saving file with LF or CRLF line ends
  1778.   Make a backup file copy before save
  1779.   Automaticke vygenerovani pk fontu z ps fontu
  1780.   What is gpatch?
  1781.   Various .dic files from IBM
  1782.  
  1783.  
  1784. ΓòÉΓòÉΓòÉ 6.2.1. 6.2.1 How to run MetaFont, gnuplot, awk... on the edited file ΓòÉΓòÉΓòÉ
  1785.  
  1786.  The syntax with the first line Format: keyword makes it possible to run any 
  1787.  command over the edited file.  For instance, you are editing a mypic.mf: 
  1788.  
  1789.  Example: 
  1790.  
  1791.           % Format: runmf
  1792.           ... some MetaFont code here...
  1793.  
  1794.  A click on the TeXit icon, or the Shift-F11 hotkey, will run the batchfile 
  1795.  runmf.cmd on the currently edited file (or even more, you can use Master:). 
  1796.  
  1797.  Note that even the icon is called TeXit, it can run whatever you write in the 
  1798.  appropriate script, like mf386.exe, or gnuplot.exe if gp.cmd states for 
  1799.  @gnuplot %1 %2 %3 %4 %5 %6 %7 %8 %9: 
  1800.  
  1801.  Example: 
  1802.  
  1803.           # Format: gp
  1804.           set title "Hello, gnuplot"
  1805.           set grid
  1806.           plot sin(x)/x
  1807.           pause -1
  1808.  
  1809.  Note:  I use EPM to edit configuration files for my calculations in physics; 
  1810.  the only necessity is to write a batch file that launches the correct 
  1811.  application.  Furthermore, writing a syntax highlighting file is a matter of 
  1812.  maybe 10 minutes (well, someone could contribute the epmkwds.mf file for 
  1813.  MetaFont). 
  1814.  
  1815.  
  1816. ΓòÉΓòÉΓòÉ 6.2.2. 6.2.2 Incorrection version ΓòÉΓòÉΓòÉ
  1817.  
  1818.  A message like Incorrection version... is displayed in the EPM status window. 
  1819.  That means that you have started EPM earlier than 6.03b.  Please verify your 
  1820.  configuration, namely: 
  1821.  
  1822.      Is \Apps\EPM cited before \OS2\Apps in PATH and LIBPATH? See Installation 
  1823.       of pmCSTeX or my config.sys).  Remember that Warp 3.0 is shipped with EPM 
  1824.       5.51, see Installation on Warp 3.0. 
  1825.  
  1826.      Have you correctly installed EPM 6.03b?  One user was convinced that he 
  1827.       installed this product well, but he was reading the installation 
  1828.       instructions by EPM 6.0 while installing EPM 6.03b into the same 
  1829.       directory.  Thus some .dll files were locked and they were not 
  1830.       overwritten, he got a crazy mixture of two versions!  Hint:  backup 
  1831.       previous version, delete it complete, install the new one. 
  1832.  
  1833.  
  1834. ΓòÉΓòÉΓòÉ 6.2.3. 6.2.3 How to read previous EPM messages? ΓòÉΓòÉΓòÉ
  1835.  
  1836.  What has EPM written to the bottom status bar?  Look at the menu: 
  1837.  View/Messages. 
  1838.  
  1839.  
  1840. ΓòÉΓòÉΓòÉ 6.2.4. 6.2.4 I cannot see \begin etc. keywords ΓòÉΓòÉΓòÉ
  1841.  
  1842.  The highlighting epmkwds files enclosed in pmCSTeX are suited for the 
  1843.  yellow&blue combination of foreground&background.  Thus, if you prefer the 
  1844.  default EPM setting of black&white, then do NOT use my epmkwds files, 
  1845.  otherwise you will not see any TeX keyword.  See also syntax highlighting. If 
  1846.  you want to use my highlighting files for non-yellow&blue combination, then 
  1847.  you should process them by a script for sed, awk, REXX,... to convert the 2nd 
  1848.  and 3rd column to a combination that pleases your eyes. 
  1849.  
  1850.  
  1851. ΓòÉΓòÉΓòÉ 6.2.5. 6.2.5 You don't like my hotkeys ΓòÉΓòÉΓòÉ
  1852.  
  1853.  You may redefine them or take completely away.  Look at pm_keys.e, 
  1854.  change/delete them, and recompile it. 
  1855.  
  1856.  
  1857. ΓòÉΓòÉΓòÉ 6.2.6. 6.2.6 Nefunguje mi ╨»esk╨░ kl╨░vesnice ΓòÉΓòÉΓòÉ
  1858.  
  1859.  P┬ñe╨»ti si, pros╨▒m, Bugs, zpr╨░va ╨│plnΓò¬ naspod. 
  1860.  
  1861.  
  1862. ΓòÉΓòÉΓòÉ 6.2.7. 6.2.7 Double-side or slot 2 printing from dvips ΓòÉΓòÉΓòÉ
  1863.  
  1864.  Finally, I have found the way how to print double side from dvips (17.  1. 
  1865.  1998!)!  It uses the -h option of dvips and the correct header files. Thus, 
  1866.  from within EPM, use: 
  1867.  
  1868.   %  ...   dvips: * -h 2sideP.ps *
  1869.  
  1870.  for double-side printing on portrait sheet, 
  1871.  
  1872.   %  ...   dvips: * -h 2sideL.ps *
  1873.  
  1874.  for double-side printing on landscape sheet, or 
  1875.  
  1876.   %  ...   dvips: * -h Slot2.ps *
  1877.  
  1878.  for printing on transparencies or on the paper deposited in the slot 2 of the 
  1879.  postscript printer. 
  1880.  
  1881.  Installation: 
  1882.  
  1883.  For use withing pmCSTeX, all should be prepared as described in sections 
  1884.  Installation of pmCSTeX or Upgrading pmCSTeX.  If you want to use this feature 
  1885.  on another TeX installation/platform, then copy those files into your TeX 
  1886.  directory tree and use them in commands like 
  1887.  
  1888.           dvips -h 2sideL.ps my_text.dvi
  1889.  
  1890.  
  1891. ΓòÉΓòÉΓòÉ 6.2.8. 6.2.8 Tags are fine, but are there "permanent" tags? ΓòÉΓòÉΓòÉ
  1892.  
  1893.  Use the ALL *string_to_find* command (invoke command line by Ctrl/I). Then use 
  1894.  (repeatedly) Ctrl/Q. 
  1895.  
  1896.  
  1897. ΓòÉΓòÉΓòÉ 6.2.9. 6.2.9 I have a question/I have found a bug... ΓòÉΓòÉΓòÉ
  1898.  
  1899.  Ok, write me a mail.  But please, be sure that you have read this manual 
  1900.  completely, it is sometimes difficult to figure out what's wrong on your 
  1901.  system.  Remember that a lot of users have installed this product without 
  1902.  problems.  If you find a bug, please read the Bugs section first, and then let 
  1903.  me know about it by e-mail if that insect has not been documented up to now. 
  1904.  
  1905.  
  1906. ΓòÉΓòÉΓòÉ 6.2.10. 6.2.10 Renaming a file ΓòÉΓòÉΓòÉ
  1907.  
  1908.  Instead of using the menu options, EPM offers a more direct way to change the 
  1909.  name of the file your working on.  Place the mouse pointer over the title bar 
  1910.  and double-click the right mouse button.  The title bar will change to an edit 
  1911.  field so that you can change the file name.  When you're done, click the mouse 
  1912.  anywhere off the title bar. 
  1913.  
  1914.  Source of this trick:  http://ourworld.compuserve.com/homepages/luvabo/ 
  1915.  
  1916.  
  1917. ΓòÉΓòÉΓòÉ 6.2.11. 6.2.11 Running EPM as a server ΓòÉΓòÉΓòÉ
  1918.  
  1919.  Running epm /r /i installs EPM as an editor server.  All further downloads 
  1920.  into it by epm /r myfile.dat are much faster (e.g., you can setup an Alternate 
  1921.  editor in File Commander/2 by epm /r or by start epm /r /i). 
  1922.  
  1923.  
  1924. ΓòÉΓòÉΓòÉ 6.2.12. 6.2.12 Saving file with LF or CRLF line ends ΓòÉΓòÉΓòÉ
  1925.  
  1926.  You can change miscellaneous default save options in Profile.erx.  Among them, 
  1927.  the following line saves the files in Unix `LF' convention: 
  1928.  
  1929.           'universal default_save_options /u'
  1930.  
  1931.  Later on, if you want to save an edited file in the standard OS/2 `CRLF' 
  1932.  format, then you can use the command save /o 
  1933.  
  1934.  
  1935. ΓòÉΓòÉΓòÉ 6.2.13. 6.2.13 Make a backup file copy before save ΓòÉΓòÉΓòÉ
  1936.  
  1937.  Do you want to backup the previous version of your edited file before 
  1938.  overwriting it by the Save command? Well, this is described in the section 
  1939.  Making backup copies of files before save. 
  1940.  
  1941.  
  1942. ΓòÉΓòÉΓòÉ 6.2.14. 6.2.14 Automaticke vygenerovani pk fontu z ps fontu ΓòÉΓòÉΓòÉ
  1943.  
  1944.  Prispel pan J. Kuben: Pokud jde o automaticke vygenerovani pk fontu z ps 
  1945.  fontu, je to reseno pomoci dvips. To se zavola (pri nastaveni prvniho radku) 
  1946.  
  1947.         % dvips *-Pnic*
  1948.  
  1949.  Soubor emtex\data\dvips\nic.cfg ukazuje na prazdny seznam ps fontu 
  1950.  emtex\data\dvips\prazdny.map. Davka emtex\exe\epm\csdvips.cmd (musi byt v 
  1951.  ceste) je upravena tak, ze nastavi set maketexpk=make_pk. Tento soubor vola 
  1952.  dvips a predava mu parametry (protoze mu bylo receno, ze nejsou ps fonty). 
  1953.  Rexx soubor emtex\exe\make_pk.cmd (musi byt v ceste) je treba naeditovat. V 
  1954.  uvodni casti je treba nastavit cesty podle konkretni instalace (kde jsou ps 
  1955.  fonty, konfiguracni soubory, kam se budou ukladat pk fonty). Ten pak prohlizi 
  1956.  soubor emtex\data\dvips\adobe.sez, kde je ulozen seznam ps fontu, ktere jsou k 
  1957.  dispozici, nazev zdrojaku a parametry, s nimiz se vola ps2pk (musi byt v 
  1958.  ceste; pouzivam verzi 1.6).  Tento soubor je mozne podle potreby rozsirovat. 
  1959.  Parametry odpovidaji syntaxi z psfonts.map.  Pokud neni font v seznamu 
  1960.  nalezen, vola se emtex\exe\maketexp.cmd, a tudiz mfjob (opet je treba nastavit 
  1961.  cesty podle instalace).  Dvipm ma pak pripravene pk fonty a pri dalsim volani 
  1962.  dvips se smaze -Pnic, aby se spravne pouzily ps fonty. 
  1963.  
  1964.  
  1965. ΓòÉΓòÉΓòÉ 6.2.15. 6.2.15 What is gpatch? ΓòÉΓòÉΓòÉ
  1966.  
  1967.  gpatch means GNU patch program.  It is usually called patch on Unix system. 
  1968.  Since there is already another \os2\patch.exe program by IBM distributed with 
  1969.  OS/2, it makes sense to call GNU patch gpatch.exe. You can download the whole 
  1970.  GNU patch package as gnupatch.zip from hobbes or leo. 
  1971.  
  1972.  Note: diff-files enclosed in pmCSTeX were produced by 
  1973.  
  1974.         diff  -uw  xxx-original.e  xxx-modified.e >xxx.diff
  1975.  
  1976.  
  1977. ΓòÉΓòÉΓòÉ 6.2.16. 6.2.16 Various .dic files from IBM ΓòÉΓòÉΓòÉ
  1978.  
  1979.  There are several versions of the dictionary *.dic files from IBM all around. 
  1980.  The latest are distributed together with Netscape 4.61 (April 2000). However, 
  1981.  these are not compatible to the .dic files of EPM, obviously because of its 
  1982.  oslexam.dll. Anybody knows how to use the new dictionaries with EPM, mainly 
  1983.  those for languages lacking an EPM dictionary? 
  1984.  
  1985.  
  1986. ΓòÉΓòÉΓòÉ 6.3. 6.3 Known bugs and missing features ΓòÉΓòÉΓòÉ
  1987.  
  1988.  pmCSTeX for EPM related bugs and missing features: 
  1989.  
  1990.    1. The command 'link pm_keys' must be the first one in the Profile.erx, 
  1991.       otherwise Ctrl/Y will not work for *.c* and *.h files.  This occured 
  1992.       after 4.1.1997.  Probably a clash with CKEYS.E keyset or whatever else, 
  1993.       when I redefine those EDIT_KEYS. 
  1994.  
  1995.    2. The makeindex first line keyword (see Syntax of expansions) was added 
  1996.       according to demand of one person, but I've got no feedback.  Whether 
  1997.       this works or not for you, please let me know. 
  1998.  
  1999.    3. Using "Next error", an error is found correctly but the current file (the 
  2000.       file with the error) is switched off to .log file.  I don't know why, 
  2001.       this comes irregularly, is there something wrong what is on the stack of 
  2002.       EPM?  Because just before the return command the current file is correct. 
  2003.  
  2004.    4. CSTEX distribution users:  Jsou probl╨Æmy s csbibtexem, kter╤î se do 
  2005.       distribuce CSTEX'96 dostal z CSTEX'94:  neakceptuje novou adres╨░┬ñovou 
  2006.       strukturu emTeXu, nezn╨░ dlouh╨░ jm╨Æna .aux soubor╨ò... 
  2007.  
  2008.    5. Czech.E users:  V prvn╨▒m oknΓò¬ ringu funguje ╨»esk╨░ kl╨░vesnice bez 
  2009.       probl╨Æm╨ò, ov╤çem v dal╤ç╨▒ch ji nen╨▒ mo╨╖n╨Æ spustit (p┬ñes Alt-[).  Mus╨▒ se 
  2010.       napsat jak╨Ækoliv ┬ñeck╨Æ p╨▒smeno (nap┬ñ.  Alt-G a) a teprve potom d╨░t Alt-[. 
  2011.       Nev╨▒te nΓò¬kdo, pro╨» se to chov╨░ takto? 
  2012.  
  2013.    6. pmTeXit.cmd:  change it so that it accepts not only the Format: keyword, 
  2014.       but also the EmtexOpt: and Master: keywords.  (This means, you are 
  2015.       welcome to do that---I haven't used pmTeXit.cmd for more than one year, 
  2016.       since I do everything from within the EPM). 
  2017.  
  2018.    7. (La)TeX paragraph is now targeted for use in LaTeX documents only.  Plain 
  2019.       TeX documents should end by \bye command instead of \end{document}. 
  2020.       However, there was no demand for plain TeX paragraph TeXing until now, so 
  2021.       there is no need to code this. 
  2022.  
  2023.  General EPM related bugs and missing features: 
  2024.  
  2025.    1. I could disable the menu of changing the dictionary file when the 
  2026.       Auto-spellcheck is on.  Just I would have to find/receive from you a 
  2027.       trick how to detect it. 
  2028.  
  2029.    2. Sometimes actions from the menu items cannot be fired, while toolbar and 
  2030.       hotkeys action are still working normally.  Any idea?  I have a 
  2031.       suspiction that this could be related to the EPM's string length 
  2032.       limitation. 
  2033.  
  2034.    3. Sometimes the syntax highliting stops working for the files newly loaded. 
  2035.       Anyone knows why? 
  2036.  
  2037.    4. The same problem of the instability of the red oval over the first error 
  2038.       found in .log file as in EPMTEX occured if the syntax highlighting is on. 
  2039.       The reason has been discovered recently:  it is caused by defload syntax 
  2040.       highlighting method, since the the syntax highlighting is made AFTER ALL 
  2041.       macros are finished, thus the oval is re-coloured. 
  2042.  
  2043.       Workaround is not 'trivial'. However, I was hacking this in 1998 and I 
  2044.       have figured out that this problem could be solved by patching routine 
  2045.       toggle_parse() in stdctrl.e. pmCSTeX would set on global variables with 
  2046.       the filename and oval positions, which will be executed at the end of the 
  2047.       syntax colouring routine. If anybody is wishing to implement this idea, 
  2048.       please submit the patch for inclusion into pmCSTeX. 
  2049.  
  2050.    5. Netscape 4.61 contains new dictionaries; the most important are localized 
  2051.       ones not available for EPM before (czech.dic, for instance).  However, 
  2052.       these dictionaries do not work with EPM.  Do you have an idea what to do? 
  2053.  
  2054.  
  2055. ΓòÉΓòÉΓòÉ 6.4. 6.4 To do! ΓòÉΓòÉΓòÉ
  2056.  
  2057.  Use EPM and (La)TeX every day! Have a nice day/night writing your beautiful