home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / pfe101.zip / FAQ.TXT < prev    next >
Text File  |  1999-01-20  |  26KB  |  548 lines

  1.                          Frequently Asked Questions
  2.                                      on
  3.                           Programmer's File Editor
  4.                          --------------------------
  5.  
  6.    [Answers in this file refer to facilities available in PFE 1.01.000]
  7.  
  8.     You may find information on any problem you have encountered in the
  9.  problems.txt file, which lists known major problems in the current release
  10.  
  11. -------------------------------------------------------------------------------
  12.  
  13. Q. What version of PFE is recommended for my current environments?
  14.  
  15. A. PFE is supplied in two forms: the 16-bit edition (PFE.EXE) and the
  16. 32-bit edition (PFE32.EXE). The recommended versions for various
  17. platforms are these:
  18.  
  19.     Windows 3.1x
  20.     Windows for Workgroups 3.1x        16-bit Edition
  21.  
  22.     Windows NT 3.51 (Intel)
  23.     Windows NT 4.0 (Intel)
  24.     Windows 2000 (Intel)                    
  25.     Windows 95                
  26.     Windows 98                32-bit Edition
  27.  
  28. An earlier release of PFE, version 0.07.002, is also available for Windows NT
  29. 3.51 and 4.0 on PowerPC pocessors.
  30.  
  31. Note that the "Intel" versions are also suitable for Intel-compatible
  32. processors such as the Cyrix and AMD chip sets
  33.  
  34. Version 1.00.000 is the last for which a 16-bit Edition will be produced.
  35.  
  36. -------------------------------------------------------------------------------
  37.  
  38. Q. I'm using the 32-Bit Edition, and I've set up associations so that I can
  39. open files in PFE by double clicking the names in File Manager and Explorer. It
  40. works fine most of the time, but if the name contains spaces it doesn't - PFE
  41. seems to think each part of the name is a filename all by itself
  42.  
  43. A. The problem here is that the most obvious command line to use in your
  44. association:
  45.  
  46.               pfe32
  47.  
  48. is not correct. Since PFE allows multiple files to be named on the command
  49. line, you must use some extra syntactic elements in the association.
  50.  
  51. To set up your associations easily and correctly, and to enable some right-
  52. click menu functionality under Windows 95, Windows 98, Windows NT 4.0 and
  53. Windows 2000, you need to set them up in the "Associations" panel of the dialog
  54. started by the Options Preferences panel.
  55.  
  56. If you want to create associations yourself you can do so: the command line
  57. to use is
  58.  
  59.              pfe32 "%1"
  60.  
  61. where the "%1" part ensures that the filename you click on is contained in
  62. quotes when the command is issued. However, if you do this you won't see the
  63. context menu items relating to PFE; and you may not find future enhancements
  64. will work correctly.
  65.  
  66. -------------------------------------------------------------------------------
  67.  
  68. Q. I'm using the 32-bit Edition, and sometimes the flashing insertion point
  69. marker just disappears and I can't type into any window. If I switch to another
  70. application and back to PFE, it works fine. What's wrong?
  71.  
  72. A. You are most probably using a Microsoft IntelliMouse with version 2.2 or
  73. later of the drivers that provide a facility known as "Universal Scrolling"
  74. (standard with Windows 98 and Windows 2000).
  75.  
  76. The driver aims to provide wheel support for applications that don't themselves
  77. implement it, and there are some bugs in how it works with some programs,
  78. including PFE. This version of PFE usually can get around the driver bugs under
  79. Windows NT 4.0, Windows 2000 and Windows 98, but there can still be problems
  80. under Windows 95 - turning the mouse wheel or clicking on it will cause the
  81. symptoms described.
  82.  
  83. The solution is to disable the "Universal Scrolling" feature for PFE. Click on
  84. Start|Settings|Control Panel and then double click on the Mouse icon to get to
  85. the IntelliMouse control panel, and select the "Wheel" tab at the top of the
  86. dialog.
  87.  
  88. Next, click on the "Exceptions" button, click on "Add" in the new dialog that
  89. appears, and browse to find the PFE32.EXE executable program file. Clicking on
  90. "Open" will add PFE to the list of programs for which the driver will not
  91. provide "Universal Scrolling".
  92.  
  93. Once you've done this, you'll still be able to scroll PFE windows by turning
  94. the mouse wheel, but you won't be able to scroll by clicking the mouse wheel
  95. and moving the mouse. Incidentally, it won't matter if you move the PFE
  96. executable to some other folder or install a new version - the mouse driver
  97. identifies the program from internal information within the executable data.
  98.  
  99. -------------------------------------------------------------------------------
  100.  
  101. Q. Why can't I open more than one file at a time with the File Open and File
  102. View commands? Early versions of PFE allowed me to do this.
  103.  
  104. A. In this release, the various file opening dialogs all default to allowing
  105. you to select only one file at a time.
  106.  
  107. You can use the "General Options" panel of the dialog started by the Options
  108. Prefences command to enable multiple selection; however, under Windows NT 3.51
  109. some long file names will not appear correctly (see the next item)
  110.  
  111. -------------------------------------------------------------------------------
  112.  
  113. Q. I'm using Windows NT 3.51, and I used Options Preferences to allow me to
  114. open more than one file at a time in the File Open command. However, my long
  115. file names don't apear any more - I just see the DOS 8.3 names 
  116.  
  117. A. There is a basic flaw in Microsoft's design of the library that provides the
  118. standard file open dialogs under Windows NT 3.51 (this code is not part of
  119. PFE). Essentially, it can't handle long file names THAT CONTAIN SPACES if you
  120. also allow multiple files to be selected. Long file names without spaces are
  121. handled correctly; but Microsoft's code automatically shows those with spaces
  122. as 8.3 names in order to get around their design error.
  123.  
  124. In its default mode of operation, PFE allows you to open only one file at a
  125. time, and here the problem does not arise.
  126.  
  127. Unfortunately, there is no way to beat this problem - if you want to open
  128. multiple files at one time, you won't see names with spaces in.
  129.  
  130. On the good side, though, the problem does not arise at all if you're running
  131. Windows 95, Windows 98, Windows NT 4.0 or Windows 2000
  132.  
  133. -------------------------------------------------------------------------------
  134.  
  135. Q. I use Windows NT on a DEC Alpha system - is there an executable of PFE32 for
  136. this?
  137.  
  138. A. PFE32 exists only for Intel hardware; however, users report that on DEC
  139. Alpha machines this runs very well under the Intel emulation system.
  140.  
  141. -------------------------------------------------------------------------------
  142.  
  143. Q. How can I arrange that edit windows are created to use the maximum area
  144. available in the MDI client area?
  145.  
  146. A. You can do this with the Options Preferences command. Start the
  147. preferences dialog and select "Window Control" from the list of option
  148. categories on the left. This shows you a panel that lets you configure
  149. exactly how child windows will be created
  150.  
  151. -------------------------------------------------------------------------------
  152.  
  153. Q. Why don't all the TrueType fonts I have installed on my system appear in the
  154. printer and screen fonts dialogs?
  155.  
  156. A. Because PFE is a programming-oriented text editor, rather than a word
  157. processor, it supports only fixed pitch fonts (ones in which all characters
  158. occupy the same width on screen or paper). There are, sadly, very few fixed
  159. pitch fonts available. There are no plans to add variable fixed pitch support
  160. in a future release.
  161.  
  162. -------------------------------------------------------------------------------
  163.  
  164. Q. I want PFE to remember the names of more than the last 5 files I've edited,
  165. so I can pick them quickly from the File menu. How can I do this?
  166.  
  167. A. You can configure the Most Recently Used (MRU) list with the Options
  168. Preferences command. Start the preferences dialog, and select "MRU List" from
  169. the list of option categories on the left. This shows you the panel that
  170. configures the MRU list.
  171.  
  172. You can configure the total size of the list, and how many files from
  173. the list will appear on the File menu (you will be able to select from the
  174. entire list with a dialog command that will follow the list on the menu).
  175. You can also specify that the File menu should be drawn in two columns rather
  176. than one if you want to show a large number of files. Note that you will need
  177. to exit PFE and restart it before your changes take effect.
  178.  
  179. -------------------------------------------------------------------------------
  180.  
  181. Q. I don't like the standard Windows File Manager, and prefer to use a third
  182. party one. How can I get the File Manager item on the Execute menu to start
  183. this instead of the standard one?
  184.  
  185. A. You can configure what the various "Manager" items on the Execute
  186. menu do with the Options Preferences command. Start the preferences
  187. dialog and select "Windows Managers" from the list of option categories
  188. on the left to show the panel that handles this
  189.  
  190. For each of the menu items, you can specify that PFE should run either
  191. the standard manager program supplied with Windows, or runs a command
  192. line of your choice
  193.  
  194. -------------------------------------------------------------------------------
  195.  
  196. Q. I use 4DOS-for-NT as my Windows NT command processor instead of Microsoft's
  197. cmd.exe - how can I get the Execute DOS Prompt and associated tool bar button
  198. to start this?
  199.  
  200. A. Normally, PFE will use the executable file named in the COMSPEC environment
  201. variable as the command processor. If this variable is not set, it uses the
  202. standard defaults "command.com" under Windows 3.1x, and "cmd.exe" under Windows
  203. NT, Windows 2000, Windows 95 and Windows 98
  204.  
  205. You can define the command processor you want to start with the Options
  206. Preferences command. Select the "DOS Shell" panel to configure what is started
  207. by the Execute DOS Prompt command; select the "Command Processor" panel to
  208. configure the command line used to run applications by the Execute DOS Command
  209. To Window command
  210.  
  211. -------------------------------------------------------------------------------
  212.  
  213. Q. How can I record my keyboard macros for use in other sessions?
  214.  
  215. A. The macro that you record as you type on the keyboard - known as the "active
  216. keyboard recording" - can be saved at any time with the Macro Save Recording
  217. command; PFE will automatically load it at the start of the next session.
  218.  
  219. You can also build libraries of macros that you can assign to keys of your
  220. choice using the Macro Librarian command.
  221.  
  222. -------------------------------------------------------------------------------
  223.  
  224. Q. How does PFE manage to allow more than 32K of text to be edited in an edit
  225. control?
  226.  
  227. A. PFE doesn't, in fact, use standard edit controls to show text. The windows
  228. you see are ordinary MDI child windows, and the text is drawn explicitly by PFE
  229. as required. Internally, a complicated memory management system keeps track of
  230. where each line of each file is stored.
  231.  
  232. -------------------------------------------------------------------------------
  233.  
  234. Q. Why, if I have word wrap switched on for a window, will PFE wrap text only
  235. when I'm typing at the end of the line and not when I insert in the middle of
  236. it?
  237.  
  238. A. The current design of PFE is set to do things that way for efficiency
  239. reasons. However, the Edit Text Reformat and Edit Text Reformat Paragraph
  240. commands allow you to reflow text to fit the current wrap margin at any time.
  241.  
  242. -------------------------------------------------------------------------------
  243.  
  244. Q. Why do I get "Help file not found" when I ask for help?
  245.  
  246. A. Make sure that you have the help file pfe.hlp in the same directory as the
  247. pfe.exe or pfe32.exe executable program
  248.  
  249. -------------------------------------------------------------------------------
  250.  
  251. Q. Why is the default of 32 undoable actions so small? Surely, when I'm typing
  252. text, I'll fill that up in 32 keypresses?
  253.  
  254. A. Actually, no - the undo system doesn't work in quite that way. It records
  255. specific _actions_ in its stack, such as a drag-drop move of text, or a cut of
  256. the highlighted text. When you're typing, each keypress is considered as part
  257. of a _single_ action, which is terminated only when you do something different,
  258. like moving the caret with the arrow keys, or switching to another window.
  259.  
  260. Then, when you use the Undo Typing command, PFE will remove all the typing
  261. you've performed in that action (a future release of PFE will probably let you
  262. undo typing actions character-by-character too)
  263.  
  264. You can change the number of undo actions that PFE records with the Options
  265. Preferences command. Start the preferences dialog and select "Editing Files"
  266. from the list of option categories on the left to show the relevant panel that
  267. lets you set the size of the list
  268.  
  269. -------------------------------------------------------------------------------
  270.  
  271. Q. If I select some text and start to drag it to a new location, how can I
  272. change my mind without having to drop the text somewhere and then undo the
  273. action?
  274.  
  275. A. You can cancel a drag-and-drop in one of two ways. If the highlighted text
  276. is visible in the window, move the mouse cursor somewhere inside it and release
  277. the left button. Alternatively, press the Escape key before you release the
  278. left mouse button.
  279.  
  280. -------------------------------------------------------------------------------
  281.  
  282. Q. How can I use drag-and-drop to move text from one window to another?
  283.  
  284. A. In the current design, PFE supports drag-and-drop only _within_ a window.
  285. Inter-window operation may be added in a future release.
  286.  
  287. -------------------------------------------------------------------------------
  288.  
  289. Q. How can I configure PFE so that the File Save command and its associated
  290. tool bar button are always available? At the moment, I can only use the command
  291. when I've changed the file in some way.
  292.  
  293. A. By default, PFE enables the File Save command only when the file showing in
  294. a window has altered. This gives you some feedback (complementing the 'file
  295. changed' marker in the status bar) that helps you avoid un-necessary saves.
  296.  
  297. You can use the Options Preferences command to change this setting.
  298. Start the preferences dialog and select "Saving Files" from the list of
  299. option categories on the left to show the relevant panel. Check the box
  300. labelled "Allow File Save on unaltered files" to make the File Save
  301. command and the toolbar button always available
  302.  
  303. -------------------------------------------------------------------------------
  304.  
  305. Q. I like the window that runs DOS commands with output capture to start full
  306. screen, and to have specific tuning details set. How can I do this?
  307.  
  308. A. DOS commands with output capture are run by either the pfedos.exe (for
  309. Windows 3) or pfedos32.exe (for Windows NT) helper modules. To change how the
  310. windows are created, set up suitable PIF files pfedos.pif and/or pfedos32.pif
  311. in the same directory, and use the Windows PIF editor to set the details as you
  312. require
  313.  
  314. -------------------------------------------------------------------------------
  315.  
  316. Q. How do I insert a Form Feed into a file, or specify it in the Find and
  317. Replace dialogs?
  318.  
  319. A. To insert a Form Feed (or any other non-typable character) use the
  320. EditTextInsertASCIICode command, which is by default mapped to Ctrl+Q. This
  321. starts up a dialog that lets you select Esc and Ctrl+A - Ctrl+Z easily by name,
  322. or specify any ASCII code you like as a number.
  323.  
  324. To specify Form Feed in the Find or Replace dialogs, write it as the two-
  325. character sequence "\f". You can also specify end-of-line by "\n" and tab by
  326. "\t"; and you can specify an arbitrary code as "\xhh", where "hh" represents
  327. two hex digits. Remember that if you actually want a "\" character, you need to
  328. write it as "\\".
  329.  
  330. -------------------------------------------------------------------------------
  331.  
  332. Q. Why do I see lots of files with type .$$$ (PFE version 0.05.007 and later)
  333. in my directories?
  334.  
  335. A. These are the backup files that PFE produces whenever you save a file. If a
  336. file of the same name exists already, PFE renames it with a type of .$$$ before
  337. writing the new data to disk.
  338.  
  339. The Options Preferences command allows you to configure some defaults
  340. for how backup is handled. Start the preferences dialog and select "Backup"
  341. from the list of option categories on the left to show the relevant
  342. panel.
  343.  
  344. In this dialog, you can disable all backup permanently; choose to have
  345. PFE make backup files to the same directory as the original file but
  346. with a file extension of your choice; or to make the copy into a file of
  347. the same name as the original, but in a subdirectory of the directory
  348. containing it
  349.  
  350. The File Save As dialog and the Options Default Modes and Options
  351. Current Modes dialogs also let you control some backup actions on a per-
  352. file basis
  353.  
  354. -------------------------------------------------------------------------------
  355.  
  356. Q. I used the Options Preferences, Options Default Modes and Options
  357. Current Modes command to set background colours for my edit windows and
  358. the main PFE workspace. Why are the colours I get not the ones I
  359. selected?
  360.  
  361. A. Depending on what type of video adapter you have fitted to your
  362. computer, only a very few of the infinite number of colours can be shown
  363. as pure or "solid" colours. Normally your system will provide 16 such
  364. solid colours, and you will see these in the block of colours shown at
  365. top left in the colour selection dialog.
  366.  
  367. When Windows is asked to display some other colour, it has to use a
  368. technique known as "dithering", that simulates the shade you want. For
  369. example, it might produce a pale blue by drawing a fine grid of dark
  370. blue lines on a white background; this will appear to be the colour you
  371. wanted when seen from a suitable distance.
  372.  
  373. Dithered colours are very unpleasant to use as backgrounds for text, and
  374. writing text on such a background is very much slower that if the
  375. background were a solid colour. For these reasons, PFE does not support
  376. the use of dithered colours, but instead translates the colour value you
  377. select to the closest available solid colour.
  378.  
  379. -------------------------------------------------------------------------------
  380.  
  381. Q. I work with a number of large projects and would like to have
  382. separate customised PFE environments. Can I do this?
  383.  
  384. A. With the 16-Bit Edition, you can use PFE's ability to locate its
  385. initialisation file pfe.ini in an arbitrary directory to do this.
  386.  
  387. With the 32-Bit Edition you can use "multiple configuration sets" in the
  388. registry to the same effect.
  389.  
  390. These facilities are controlled by the Options Preferences command; the Help
  391. button on the dialog will take you to descriptions of how they operate.
  392.  
  393. -------------------------------------------------------------------------------
  394.  
  395. Q. What are the licensing arrangements for PFE? I use it at home and
  396. would like to do so at my work too.
  397.  
  398. A. PFE is FreeWare. You don't need to register to use it, and there is
  399. no fee. You can use it at home, or at work without restriction.
  400.  
  401. If you'd like to include PFE on the distribution disks with a commercial
  402. product you can obtain a licence that will enable you to do this.
  403.  
  404. The help file contains full details on the current usage and licensing
  405. position.
  406.  
  407. -------------------------------------------------------------------------------
  408.  
  409. Q. I'm editing files on a NFS-mounted partition with the 16-Bit Edition,
  410. and whenever I save my edit changes the long name of the file disappears
  411. and all I see is the NFS-generated 8.3 name. What's happened?
  412.  
  413. A. The problem is in the way that PFE makes backups when you save files.
  414. In the current version, any existing file is renamed to be the backup
  415. copy, and a new file is created with the old name to save the changes
  416. into.
  417.  
  418. The step of renaming the file breaks the association that NFS maintains
  419. between the DOS 8.3 name and the file's long name. Thus, when PFE
  420. creates the new file to save - using the 8.3 name - NFS can no longer
  421. translate this to the "real" name and so has to pass the 8.3 name itself
  422. to Windows.
  423.  
  424. The only circumvention available in the current release is to disable
  425. making backup copies in these circumstances.
  426.  
  427. This problem does not arise in the 32-Bit Edition
  428.  
  429. -------------------------------------------------------------------------------
  430.  
  431. Q. How do I change the font that I use to print files out? In previous releases
  432. there was a "Font" button in the Print Setup dialog, but it's gone now
  433.  
  434. A. The printer system uses the same user interface and dialogs as other
  435. applications; the Print and Print Setup dialogs you see are the standard ones
  436. that are part of Windows. 
  437.  
  438. Unfortunately, the way that Windows works with these dialogs means that it
  439. isn't possible to select fonts from them. You should use the File Page Setup
  440. command for this.
  441.  
  442. -------------------------------------------------------------------------------
  443.  
  444. Q. I'm using the Execute DOS Command To Window command to run my compiler,
  445. which will prompt me for input if there's an error. Using the 32-bit edition I
  446. see the compiler output in the console window, but I never see the prompts and
  447. the output window seems to lock up, although if I type the expected reply blind
  448. it all seems to work. What's going wrong?
  449.  
  450. A. The problem here arises because PFE is essentially trying to subvert the
  451. compiler, fooling it into thinking that it's writing to the screen (as it
  452. normally would) when actually it's sending all its output to PFE (actually, to
  453. a small helper program that PFE runs for this purpose).
  454.  
  455. If the compiler or other program is simply writing, then it all works fine. But
  456. as you've seen, there are problems if the program wants you to perform input.
  457. Normally, when a program writes to the screen, Windows makes sure that all the
  458. output is sent there directly and not stored in the program's or Windows's
  459. buffers. Thus, you see the prompt as soon as the program writes it, and you
  460. know what to do.
  461.  
  462. But when PFE runs the compiler, the output is actually not to the screen, but
  463. to PFE. The compiler itself doesn't know the difference, but the underlying I/O
  464. systems and Windows certainly do. Since they know the program isn't writing to
  465. the screen, the compiler's output will be buffered for efficiency - thus it's
  466. quite possible, and actually most probable, that the prompt string will be
  467. stored in a buffer waiting to be written to the screen when the compiler asks
  468. you to type - so you never see the prompt.
  469.  
  470. There is no way round this problem, unfortunately. Although techniques are
  471. available for programs to detect what's happening and make sure that you _do_
  472. see the prompt, you'll be lucky to find one that uses them.
  473.  
  474. The moral, sadly, is that the Execute DOS Command To Window command is not
  475. suitable if the program you want to run will ever require you to type in to it
  476. rather than simply generate output
  477.  
  478. -------------------------------------------------------------------------------
  479.  
  480. Q. I like to work with tab width of 4 in my files, and I can set this up with
  481. the Options Current Modes command. However, if I edit the same files again, the
  482. tab setting reverts to the default of 8. How can I change this?
  483.  
  484. A. The Options Current Modes command affects the modes applied to only the
  485. current window; the effect is limited to that window, and when it closes the
  486. settings are lost.
  487.  
  488. To do what you want - which is to define the default modes for a file - you
  489. need to use the Options Default Modes command.
  490.  
  491. You'll find full information on how to use this command in the help file.
  492. Basically, you can define a number of "mode groups", which are collections of
  493. filename patterns like "*.c *.h readme.*". With each mode group you define the
  494. default modes you want; then, if any file you open has a name matching
  495. something in a mode group, the relevant default modes are applied.
  496.  
  497. -------------------------------------------------------------------------------
  498.  
  499. Q. I put the 32-Bit Edition of PFE on my desktop for handy access, but now it
  500. can't find the help file and if I try to run DOS commands I get a message
  501. "Unable to run pfedos32 helper module"
  502.  
  503. A. You've probably made a _copy_ of the pfe32.exe program file on your desktop,
  504. rather than creating a _shortcut_. When you make a copy, Windows copies the
  505. executable file to a special directory on your hard disk, and when you click
  506. the icon, the program is started from there.
  507.  
  508. PFE will run happily like this; but when you ask for help, or try to run a DOS
  509. command, it will find that the pfe.hlp help file and pfedos32.exe helper
  510. module are not in the same desktop directory as the program.
  511.  
  512. The solution is to delete the copy of PFE from your desktop and create a proper
  513. shortcut - if you use the _right_ mouse button to drap the PFE program file
  514. from its folder to the desktop, you'll see an option to create a shortcut on
  515. the menu that appears.
  516.  
  517. -------------------------------------------------------------------------------
  518.  
  519. Q. I have a 3-button mouse with drivers that emulate the wheel in a Microsoft
  520. Intellimouse, but PFE doesn't seem to respond when I try to use the middle
  521. button for scrolling
  522.  
  523. A. A standard Microsoft Intellimouse actually provides two distinct modes of
  524. operation: the central wheel can be both rotated as a wheel and clicked as a
  525. button.
  526.  
  527. Rotating the central wheel is normally used for scrolling, while clicking it
  528. initiates a feature known as "auto-panning", where the window moves to follow
  529. the mouse movement.
  530.  
  531. PFE supports the standard Microsoft IntelliMouse; other wheel mice may or may
  532. not work correctly.
  533.  
  534. -------------------------------------------------------------------------------
  535.  
  536. Q. I have a spelling checker that works fine with NotePad and some other
  537. applications, but not with PFE. Why is this?
  538.  
  539. A. External spell-check applications have to make some sweeping assumptions
  540. about how the application they're told to work with actually operates. Normally
  541. they assume that the application's text windows are a standard feature of
  542. Windows called an "edit control", or provide some emulation interfaces to this.
  543. With NotePad this is true; however PFE neither uses a standard "edit control"
  544. nor (at present) provides an emulation interface
  545.  
  546. -------------------------------------------------------------------------------
  547.  
  548.