home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 July / Chip_1998-07_cd.bin / sharewar / fileedit / pfe0702 / README.TXT < prev   
Text File  |  1997-07-19  |  11KB  |  298 lines
  1.                     Programmer's File Editor 0.07.002
  2.                     ---------------------------------
  3.  
  4. Welcome to Programmer's File Editor. This file is the place to start looking at
  5. the program: if you've not seen PFE before there's a synopsis of its main
  6. features; and if you've used earlier versions there's some essential
  7. information on major changes.
  8.  
  9. Below you'll find
  10.  
  11.     1. ABSTRACT
  12.         A brief list of PFE's main features
  13.     2. USING AND DISTRIBUTING PFE
  14.         The terms on which you can use it and pass it on
  15.     3. CONTACTING THE AUTHOR
  16.         How to pass on your criticisms, suggestions, bug reports
  17.         and maybe even praise
  18.     4. WHERE TO GET PFE
  19.         Places to look for PFE on the Internet and elsewhere
  20.     5. WHICH VERSION SHOULD YOU USE?
  21.         How to pick the most appropriate version
  22.     6. UPGRADING FROM PREVIOUS RELEASES
  23.         Important information if you're currently using an older
  24.         version of PFE
  25.     7. OTHER FILES YOU SHOULD LOOK AT
  26.         The other important text files in this release
  27.     8. THE FILES YOU SHOULD GET
  28.         What should be in your distribution set
  29.     9. INSTALLING PFE
  30.         How to install everything
  31.  
  32. ---
  33.  
  34. Alan Phillips    ( A.Phillips@lancaster.ac.uk )
  35.         ( http://www.lancs.ac.uk/people/cpaap/pfe )
  36.  
  37.  
  38. -------------------------------------------------------------------------------
  39.  
  40.  
  41. 1. ABSTRACT
  42. -----------
  43.  
  44. This is the 0.07.002 release of Programmer's File Editor, a large-capacity
  45. multi-file programming oriented editor for Windows 95, Windows NT 3.51 and
  46. 4.0 on Intel platforms, and Windows 3.1x
  47.  
  48. PFE includes the following features:
  49.  
  50. - The size of file it can handle is limited only by the total amount of
  51.   virtual memory available
  52. - No arbitrary limit on the number of lines a file can contain
  53. - It can edit multiple files, the number being limited only by the
  54.   available system resources
  55. - Allows multiple edit windows showing the same file
  56. - Multi-level undo facility
  57. - Can read and write files in UNIX format using LF as line terminator, with
  58.   automatic format detection
  59. - Line numbers can be shown in any edit window if required
  60. - Text can be copied and moved by dragging and dropping
  61. - Right-click mouse menus give access to commonly required functions
  62. - DOS commands such as compilers can be run with the output captured
  63.   in an edit window
  64. - Commonly-used text can be inserted in a simple operation from template
  65.   libraries
  66. - Fully-remappable keyboard, including two-key operation similar to MicroEMACS
  67.   and mapping of Alt keys to functions
  68. - Keystrokes and menu commands can be recorded in replayable keyboard macros
  69.   which can be collected into libraries
  70. - Files can be printed either in total, by line range, or selected text only
  71. - Files can be printed with two pages per sheet of paper in landscape mode
  72.   or as booklets
  73. - Automatic line indenting and removal of trailing spaces
  74. - Automatic configuration of edit options depending on file type
  75. - Automatic configuration of tab sizes depending on file type
  76. - Automatic brace alignment when editing C source
  77. - Text indent/undent operations
  78. - Optional automatic text wrapping at configurable margin
  79. - Supports Microsoft IntelliMouse (32-Bit Edition)
  80.  
  81. Additionally, the editor can be controlled by another application across a
  82. DDE client-server link.
  83.  
  84.  
  85. 2. USING AND DISTRIBUTING PFE
  86. -----------------------------
  87.  
  88. PFE may be used in any way, for any purpose, at no cost. In may be distributed
  89. by any means, provided that the original files as supplied by the author remain
  90. intact and no charge is made other than for reasonable distribution costs.
  91.  
  92. You do not need to register to use PFE, or buy a licence to use it
  93.  
  94. PFE may be placed on any archive or BBS system
  95.  
  96. PFE may not be distributed with any commercial product without a prior license
  97. agreement with the author
  98.  
  99.  
  100.  
  101. 3. CONTACTING THE AUTHOR
  102. ------------------------
  103.  
  104. I would very much appreciate hearing from you if you use PFE and find problems,
  105. or if you can think of ways it could be improved - and even (or is that
  106. 'especially'?) if you just think it's great. Even if the facility you would
  107. like to see appears to be of interest only to you, tell me about it - you'd be
  108. surprised how many ideas in that class have a much wider appeal.
  109.  
  110. You can contact me by e-mail at
  111.  
  112.                     A.Phillips@lancaster.ac.uk
  113.  
  114. I will try to reply to all the mail I receive, but it may take a week or so if
  115. I'm very busy.
  116.  
  117.  
  118.  
  119. 4. WHERE TO GET PFE
  120. -------------------
  121.  
  122. The current version of PFE is distributed in two ZIP files. The names they have
  123. when they are sent out are these:
  124.  
  125.    pfe0702i.zip      The 32-bit edition for Windows 95, and Windows NT 3.51
  126.                        and 4.0 on Intel platforms
  127.    pfe0702.zip       The 16-bit edition for Windows 3.1x
  128.  
  129. There is no implementation of this version for Windows NT on PowerPC systems.
  130. However, version 0.07.001 is available for this platform in a file that should
  131. have the name pfe0701p.zip
  132.  
  133. The distribution files will end up on archives all over the Internet, so a
  134. search for these file names will probably show them somewehere.
  135.  
  136. The definitive source for new releases, news and useful information is the PFE
  137. Home Page on the World Wide Web; the URL is
  138.  
  139.                 http://www.lancs.ac.uk/people/cpaap/pfe/
  140.  
  141. Feel free to create links to this page from your own web site if you desire.
  142.  
  143.  
  144. 5. WHICH VERSION SHOULD YOU USE?
  145. -------------------------------
  146.  
  147. Although the various editions of PFE will run on platforms other than their
  148. intended ones, not all facilities will be available in some combinations. For
  149. the best result, you should use the versions recommended here:
  150.  
  151.     System                Edition To Use
  152.     ------                --------------
  153.     Windows 95            32-Bit Edition
  154.     Windows NT 4.0 Intel        32-Bit Edition
  155.     Windows NT 3.51 Intel        32-Bit Edition
  156.     Windows 3.1x            16-Bit Edition
  157.  
  158.  
  159.  
  160. 6. UPGRADING FROM PREVIOUS RELEASES
  161. -----------------------------------
  162.  
  163. If you've been using PFE version 0.07.001, then you won't need to take any
  164. special steps to move to 0.07.002
  165.  
  166. However, if you've been using 0.06.002 or earlier, take a moment to read the
  167. notes below, as there have been some significant changes that you need to
  168. consider before you install the new version.
  169.  
  170.  
  171. FOR 32-BIT EDITION USERS ONLY
  172.  
  173. If you've been using 0.06.002 or earlier of the 32-Bit Edition under Windows 95
  174. or Windows NT, then you'll probably want to take some installation steps before
  175. you start to run the new version of PFE.
  176.  
  177. PFE now uses the Windows Registry to store configuration information rather
  178. than the PFE32.INI initialisation file; this allows it to support per-user
  179. configuration data and offer some extra facilities.
  180.  
  181. The INI2REG utility allows you to convert existing initialisation files into
  182. the Windows Registry and explains the new facilities. You should read the text
  183. file UPGRADE.TXT that is part of the distribution set for complete details
  184.  
  185.  
  186. FOR ALL USERS
  187.  
  188. PFE now sets up associations for the file types you want to use it with itself,
  189. using the Options Preferences command. You should begin by using this command
  190. to define your associations, as this will guarantee that they are correctly
  191. defined, and also enable some context menu support for the 32-Bit Edition. Note
  192. that your manually-defined associations will not be shown by PFE when you do
  193. this.
  194.  
  195. If you're upgrading from version 0.05.007 or earlier, it's best to delete your
  196. existing initialisation files (PFE.INI or PFE32.INI) and begin again with the
  197. new release.
  198.  
  199.  
  200.  
  201. 7. OTHER FILES YOU SHOULD LOOK AT
  202. ---------------------------------
  203.  
  204. The distribution set contains several other text files of important
  205. information.
  206.  
  207. For the answers to some of the common questions that users have, see FAQ.TXT.
  208. Looking in here can save you a lot of worry and experimentation, and save you
  209. from posting your question to newsgroups and mailing lists.
  210.  
  211. The CHANGES.TXT file tells you what's changed from earlier releases. If you
  212. find something unexpected going on, look in here too - it could be a feature
  213. rather than a bug.
  214.  
  215. The PROBLEMS.TXT file tells you about any major problems that were discovered
  216. too late to be addressed in this release, and what you can do if you hit them.
  217.  
  218.  
  219.  
  220. 8. THE FILES YOU SHOULD GET
  221. ---------------------------
  222.  
  223. There are a small number of files in the PFE distribution. You should find the
  224. following items:
  225.  
  226. 32-bit Intel Edition:
  227.  
  228.     [For Windows 95, and Windows NT 3.51 and 4.0 on Intel platforms]
  229.  
  230.     pfe32.exe        The editor itself
  231.     pfe.hlp            The help file
  232.     pfedos32.exe        A helper module, needed to run commands and
  233.                 capture output
  234.     readme.txt        This file
  235.     upgrade.txt        Details on how to convert your initialisation
  236.                 files into the Windows Registry if you're
  237.                                 currently using version 0.06.002 or earlier
  238.     ini2reg.exe        The program that converts your initialisation
  239.                 files into the Windows Registry
  240.     changes.txt        Changes from previous releases
  241.     faq.txt            Frequently Asked Questions
  242.     problems.txt        Information on late-breaking problems
  243.  
  244. 16-bit Edition:
  245.  
  246.     [For Windows 3.1x]
  247.  
  248.     pfe.exe            The editor itself
  249.     pfe.hlp            The help file
  250.     pfedos.exe        A helper module, needed to run commands and
  251.                 capture output
  252.     pfedos.pif        The PIF file for this module
  253.     readme.txt        This file
  254.     changes.txt        Changes from previous releases
  255.     faq.txt            Frequently Asked Questions
  256.     problems.txt        Information on late-breaking problems
  257.  
  258. [The help file pfe.hlp is identical for the 16-bit and 32-bit editions]
  259.  
  260.  
  261.  
  262. 9. INSTALLING PFE
  263. -----------------
  264.  
  265. There is no setup program for PFE, as it doesn't really need one. Installation
  266. is done by simply copying the supplied files:
  267.  
  268. 32-bit Edition:
  269.  
  270.  Copy pfe32.exe, pfe.hlp, pfedos32.exe to a suitable directory. This need not
  271.  be on your path; but it's important that all the files are in the same
  272.  directory.
  273.  
  274.  Next, read upgrade.txt carefully, and if you wish, use the ini2reg utility to
  275.  convert your existing initialisation file PFE32.INI into the Windows Registry
  276.  
  277.  If you like to have PFE handy on your desktop, make sure that you place a
  278.  shortcut there, rather than a copy of the program file itself. If you make a
  279.  copy, you'll find that you can't run DOS commands, since the pfe.exe executable
  280.  will be in the desktop directory, and the pfedos32.exe helper module will be
  281.  somewhere else.
  282.  
  283. 16-bit Edition:
  284.  
  285.  Copy pfe.exe, pfe.hlp, pfedos.exe and pfedos.pif to a suitable directory.
  286.  This need not be on your path; but it's important that all the files are
  287.  in the same directory.
  288.  
  289.  
  290. It's a good idea to keep the 16-bit and 32-bit editions in the same place; then
  291. you will need only one copy of the help file.
  292.  
  293. After you've installed PFE, the best thing to do is start it up, then use the
  294. Options Preferences command to explore the customisation options and set it up
  295. to run as you prefer.
  296.  
  297.  
  298.