home *** CD-ROM | disk | FTP | other *** search
/ Windows NT Super Tune-Up Kit / PIE-WindowsNTSuperTuneUpKit-1997.iso / EDITORS / PFE0602I / README.TXT < prev   
Text File  |  1995-10-15  |  14KB  |  380 lines
  1.                     Programmer's File Editor 0.06.002
  2.                     ---------------------------------
  3.                              (17 October 1995)
  4.  
  5. Welcome to Programmer's File Editor. This file is the place to start looking at
  6. the program: if you've not seen PFE before there's a synopsis of its main
  7. features; and if you've used earlier versions there's some essential
  8. information on major changes.
  9.  
  10. Below you'll find
  11.  
  12.     1. ABSTRACT
  13.         A brief list of PFE's main features
  14.     2. USING AND DISTRIBUTING PFE
  15.         The terms on which you can use it and pass it on
  16.     3. CONTACTING THE AUTHOR
  17.         How to pass on your criticisms, suggestions, bug reports
  18.         and maybe even praise
  19.     4. WHERE TO GET PFE
  20.         Places to look for PFE on the Internet and elsewhere
  21.     5. WHICH VERSION SHOULD YOU USE?
  22.         How to pick the most appropriate version
  23.     6. UPGRADING FROM 0.06.001
  24.         Important information if you're currently using the release
  25.         immediately prior to this one
  26.     7. UPGRADING FROM 0.05.007 AND EARLIER
  27.         Important information if you're currently using a very old
  28.         release of PFE
  29.     8. OTHER FILES YOU SHOULD LOOK AT
  30.         The other important text files in this release
  31.     9. THE FILES YOU SHOULD GET
  32.         What should be in your distribution set
  33.     10. INSTALLING PFE
  34.         How to install everything
  35.  
  36. ---
  37.  
  38. Alan Phillips     ( A.Phillips@lancaster.ac.uk )
  39.  
  40.  
  41. -------------------------------------------------------------------------------
  42.  
  43.  
  44. 1. ABSTRACT
  45. -----------
  46.  
  47. This is the 0.06.002 release of Programmer's File Editor, a large-capacity
  48. multi-file programming oriented editor for Windows 95, Windows NT 3.51 on Intel
  49. and PowerPC platforms, and Windows 3.1x
  50.  
  51. PFE includes the following features:
  52.  
  53. - The size of file it can handle is limited only by the total amount of
  54.   virtual memory available
  55. - No arbitrary limit on the number of lines a file can contain
  56. - It can edit multiple files, the number being limited only by the
  57.   available system resources
  58. - Accepts files dropped from File Manager or other drag-drop server
  59. - Allows multiple edit windows showing the same file
  60. - Multi-level undo facility
  61. - Can read and write files in UNIX format using LF as line terminator, with
  62.   automatic format detection
  63. - Can run multiple instances if desired
  64. - Backup copies can be maintained of existing files when saving
  65. - Most-recently-used list of files allows easy selection between sessions
  66. - Line numbers can be shown in any edit window if required
  67. - Any installed fixed-pitch screen font, including TrueType, can be used in
  68.   edit windows
  69. - The most frequent operations can be performed from active buttons on a 
  70.   tear-off toolbar
  71. - Active status bar reports settings and allows easy alteration of common ones
  72. - Text can be copied and moved by dragging and dropping
  73. - Tabs can be inserted as TAB characters or spaces
  74. - DOS commands, such as compilers, can be run with the output captured
  75.   in an edit window
  76. - An application being developed can be quickly launched from a configurable
  77.   dialog
  78. - Commonly-used text can be inserted in a simple operation from template
  79.   libraries
  80. - Fully-remappable keyboard, including two-key operation similar to MicroEMACS
  81.   and mapping of Alt keys to functions
  82. - Multiple sets of key mappings can be stored, and selected as required from
  83.   a dialog or from the command line
  84. - Keystrokes and menu commands can be recorded in a replayable keyboard macro
  85. - Commonly-used program development tools can be configured into a list
  86.   and started simply from a dialog
  87. - Files can be printed either in total, by line range, or selected text only
  88. - Automatic line indenting and removal of trailing spaces
  89. - Automatic configuration of edit options depending on file type
  90. - Automatic configuration of tab sizes depending on file type
  91. - Automatic brace alignment when editing C source
  92. - Text indent/undent operations
  93. - Optional automatic text wrapping at configurable margin
  94. - Can mail files to MAPI-compliant mailers like Microsoft Mail
  95. - User-configurable help menu
  96. - Comprehensive help file with help buttons on all dialogs and F1 help
  97.   available for system messages
  98. - Mouse help available on screen and menu items
  99. - Double click on right button starts help engine for help on keywords
  100.   in edit windows
  101. - Allows Windows to be closed down and the system rebooted from the system menu
  102. - Uses standard MDI methods to be fully compatible with other Windows apps
  103. - All operations are TWI compliant
  104. - Windows can be tiled vertically to maximize width
  105. - Window text, window background, workspace, toolbar and status bar colours
  106.   fully configurable
  107.  
  108. Additionally, the editor can be controlled by another application across a
  109. DDE client-server link.
  110.  
  111.  
  112. 2. USING AND DISTRIBUTING PFE
  113. -----------------------------
  114.  
  115. PFE may be used in any way, for any purpose, at no cost. In may be distributed
  116. by any means, provided that the original files as supplied by the author remain
  117. intact and no charge is made other than for reasonable distribution costs.
  118.  
  119. You do not need to register to use PFE, or buy a licence.
  120.  
  121. PFE may be placed on any archive or BBS system
  122.  
  123. PFE may not be distributed as a component of any commercial product without a
  124. prior license agreement with the author
  125.  
  126.  
  127.  
  128. 3. CONTACTING THE AUTHOR
  129. ------------------------
  130.  
  131. I would very much appreciate hearing from you if you use PFE and find problems,
  132. or if you can think of ways it could be improved - and even (or is that
  133. 'especially'?) if you just think it's great. Even if the facility you would
  134. like to see appears to be of interest only to you, tell me about it - you'd be
  135. surprised how many ideas in that class have a much wider appeal.
  136.  
  137. You can contact me by e-mail at
  138.  
  139.                     A.Phillips@lancaster.ac.uk
  140.  
  141. I will try to reply to all the mail I receive, but it may take a week or so if
  142. I'm very busy.
  143.  
  144. Please DON'T mail me on CompuServe - you may find an account there with my name
  145. on it, but it's owned by my employers and I don't visit it often. I don't
  146. respond to mail I find there not related to work, sorry. If YOU are on
  147. CompuServe it's easy to mail me on the Internet - just address the mail to
  148.  
  149.                  >internet:A.Phillips@lancaster.ac.uk
  150.  
  151. However, this may cost you a little more than mail to other CompuServe users
  152.  
  153.  
  154. 4. WHERE TO GET PFE
  155. -------------------
  156.  
  157. PFE is distributed in three ZIP files. The names they have when they
  158. leave me are
  159.  
  160.    pfe0602i.zip      The 32-bit edition for Windows 95 and Windows NT 3.51
  161.                        on Intel platforms
  162.    pfe0602p.zip      The 32-bit edition for Windows NT 3.51 on PowerPC
  163.                        platforms
  164.    pfe0602.zip       The 16-bit edition for Windows 3.1x
  165.  
  166. The definitive source for new releases is the PFE Home Page on the World Wide
  167. Web; the URL is
  168.  
  169.                 http://www.lancs.ac.uk/people/cpaap/pfe/
  170.  
  171. The home page also contains a list of archives where the latest version of
  172. PFE is known to be held
  173.  
  174.  
  175. 5. WHICH VERSION SHOULD YOU USE?
  176. -------------------------------
  177.  
  178. The Windows 95, Windows NT and Windows 3.1x operating systems allow you a lot of
  179. flexibility in what versions of programs you can run. However, PFE works best
  180. in certain combinations, as listed below:
  181.  
  182.  
  183. System        Edition        Comments
  184. ------        -------        --------
  185.  
  186. Windows 95    16-bit         NOT RECOMMENDED
  187. (4.00.950)            You will not be able to run commands and
  188.                 capture output, or use long file names.
  189.         32-bit Intel    RECOMMENDED
  190.                 All facilities are available
  191.         32-bit PowerPC    WILL NOT RUN
  192.  
  193. Windows 3.1x    16-bit        RECOMMENDED
  194.                 All facilities are available
  195.         32-bit Intel    NOT RECOMMENDED
  196.                 You will not be able to run commands and
  197.                 capture output
  198.         32-bit PowerPC    WILL NOT RUN
  199.  
  200. Windows NT 3.1    16-bit         NOT RECOMMENDED
  201. (Intel)                You will not be able to run commands and
  202.                 capture output
  203.         32-bit Intel    WILL NOT RUN
  204.         32-bit PowerPC    WILL NOT RUN
  205.  
  206. Windows NT 3.5    16-bit         NOT RECOMMENDED
  207. (Intel)                You will not be able to run commands and
  208.                 capture output
  209.         32-bit Intel    WILL NOT RUN
  210.         32-bit PowerPC    WILL NOT RUN
  211.  
  212. Windows NT 3.5    16-bit         WILL NOT RUN
  213. (PowerPC)    32-bit Intel    WILL NOT RUN
  214.         32-bit PowerPC    WILL NOT RUN
  215.  
  216. Windows NT 3.51    16-bit        NOT RECOMMENDED
  217. (Intel)                You will not be able to run commands and
  218.                 capture output
  219.         32-bit Intel    RECOMMENDED
  220.                 All facilities are available
  221.         32-bit PowerPC    WILL NOT RUN
  222.  
  223. Windows NT 3.51    16-bit         WILL NOT RUN
  224. (PowerPC)    32-bit Intel    WILL NOT RUN
  225.         32-bit PowerPC    RECOMMENDED
  226.                 All facilities are available
  227.  
  228.  
  229.  
  230. 6. UPGRADING FROM 0.06.001
  231. --------------------------
  232.  
  233. The immediately preceding release of PFE was 0.06.001. You don't need to change
  234. anything if you've been using this release; all files and configuration details
  235. are compatible.
  236.  
  237.  
  238. 7. UPGRADING FROM 0.05.007 AND EARLIER
  239. --------------------------------------
  240.  
  241. If you're currently using PFE version 0.05.007, you'll find that your keymap
  242. (.key) files and template (.tpl) files will continue to work with this release.
  243. Keymap files produced with earlier releases than 0.05.007 won't be recognised.
  244.  
  245. In this new release have been many changes to the initialisation file (pfe.ini
  246. or pfe32.ini depending on the edition you use).
  247.  
  248. The first major change is that you no longer ever need to edit it to change
  249. options. Now there's an Options Preferences command that does it all - and
  250. you'll find that there are lots more options to choose from too.
  251.  
  252. The second major change involves the filters you define for the file open
  253. dialogs. Your existing ones will not be recognised, so please use Options
  254. Preferences to redefine them.
  255.  
  256. Thirdly, the way the various Windows "managers" (like File Manager and
  257. Print Manager) are handled from the Execute menu has changed, allowing you
  258. to start a full command line with arguments. Your existing definitions will
  259. not be used; again, please use Options Preferences to set up what you want.
  260.  
  261. Finally, the system of associating file and window modes with file extensions
  262. has been completely redesigned. The modes you can set now include window and
  263. text colours; and instead of mapping a single extension to a set of modes, you
  264. now build "mode groups" containing wildcarded filename patterns, each of which
  265. has a set of modes associated with it. Again your old mode settings won't be
  266. recognised, so you'll need to use Options Preferences to use the new system.
  267.  
  268. If you wish, you can remove the [fileopen-filters], [modes] and [managers]
  269. sections from your initialisation file.
  270.  
  271. One other change to note is that the default extension used for making backup
  272. files has changed from ".&&&" to ".$$$". You can also customise it with the
  273. Options Preferences command
  274.  
  275.  
  276.  
  277. 8. OTHER FILES YOU SHOULD LOOK AT
  278. ---------------------------------
  279.  
  280. The distribution set contains several other text files of important
  281. information.
  282.  
  283. For the answers to some of the common questions that users have, see FAQ.TXT.
  284. Looking in here can save you a lot of worry and experimentation, and save you
  285. from posting your question to newsgroups and mailing lists.
  286.  
  287. The CHANGES.TXT file tells you what's changed from earlier releases. If you
  288. find something unexpected going on, look in here too - it could be a feature
  289. rather than a bug.
  290.  
  291. The PROBLEMS.TXT file tells you about any major problems that were discovered
  292. too late to be addressed in this release, and what you can do if you hit them.
  293.  
  294.  
  295.  
  296. 9. THE FILES YOU SHOULD GET
  297. ---------------------------
  298.  
  299. There are a small number of files in the PFE distribution. You should find the
  300. following items:
  301.  
  302. 32-bit Intel Edition:
  303.  
  304.     [For Windows 95, and Windows NT 3.51 on Intel platforms]
  305.  
  306.     pfe32.exe        The editor itself
  307.     pfe32.dbg        Debugging symbols
  308.     pfe.hlp            The help file
  309.     pfedos32.exe        A helper module, needed to run commands and
  310.                 capture output
  311.     readme.txt        This file
  312.     changes.txt        Changes from previous releases
  313.     faq.txt            Frequently Asked Questions
  314.     problems.txt        Information on late-breaking problems
  315.  
  316. 32-bit PowerPC Edition:
  317.  
  318.     [For Windows NT 3.51 on PowerPC platforms]
  319.  
  320.     pfe32.exe        The editor itself
  321.     pfe.hlp            The help file
  322.     pfedos32.exe        A helper module, needed to run commands and
  323.                 capture output
  324.     readme.txt        This file
  325.     changes.txt        Changes from previous releases
  326.     faq.txt            Frequently Asked Questions
  327.     problems.txt        Information on late-breaking problems
  328.  
  329. 16-bit Edition:
  330.  
  331.     [For Windows 3.1x]
  332.  
  333.     pfe.exe            The editor itself
  334.         pfe.sym                 Debugging symbols
  335.     pfe.hlp            The help file
  336.     pfedos.exe        A helper module, needed to run commands and
  337.                 capture output
  338.     pfedos.pif        The PIF file for this module
  339.     readme.txt        This file
  340.     changes.txt        Changes from previous releases
  341.     faq.txt            Frequently Asked Questions
  342.     problems.txt        Information on late-breaking problems
  343.  
  344. The help file pfe.hlp is identical for the 16-bit and 32-bit editions.
  345.  
  346.  
  347.  
  348. 10. INSTALLING PFE
  349. ------------------
  350.  
  351. There is no setup program for PFE, as it doesn't really need one. Installation
  352. is done by simply copying the supplied files:
  353.  
  354. 32-bit Edition:
  355.  
  356.  Copy pfe32.exe, pfe.hlp, pfedos32.exe to a suitable directory. This need not
  357.  be on your path; but it's important that all the files are in the _same_
  358.  directory. If you have the Intel version you might like to copy pfe32.dbg into
  359.  this directory also; in the event of a program fault your Dr Watson logs will
  360.  contain a symbolic trace, which will make problem diagnosis easier if you're
  361.  able to mail the details to me.
  362.  
  363. 16-bit Edition:
  364.  
  365.  Copy pfe.exe, pfe.hlp, pfedos.exe and pfedos.pif to a suitable directory.
  366.  This need not be on your path; but it's important that all the files are
  367.  in the _same_ directory. You might also like to copy the pfe.sym file; this
  368.  gives symbolic information in any Dr Watson logs you get, which make diagnosis
  369.  easier for me.
  370.  
  371.  
  372. It's a good idea to keep the 16-bit and 32-bit editions in the same place; then
  373. you will need only one copy of the help file.
  374.  
  375. After you've installed PFE, the best thing to do is start it up, then use the
  376. Options Preferences command to explore the customisation options and set it up
  377. to run as you prefer.
  378.  
  379.  
  380.