home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / com / pmqwk / pmqwk.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1993-04-22  |  65.9 KB  |  1,559 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Bug Reports/Feature Requests ΓòÉΓòÉΓòÉ
  3.  
  4. Bug reports and/or feature requests may be made to one of two people, in one of 
  5. several ways. 
  6.  
  7.  Please contact Brady Flowers at Oberon Software or Kimberly Bobrow. 
  8.  
  9.  
  10. ΓòÉΓòÉΓòÉ 2. Oberon Software ΓòÉΓòÉΓòÉ
  11.  
  12. Oberon Software has been involved in the creation of OS/2 related products and 
  13. services since 1988.  Founded by Brady Flowers, Oberon Software (named for the 
  14. wood sprite in Shakespeare's "A Mid-Summer Night's Dream") is committed to 
  15. enhancing the software base for the ever growing community of OS/2 users and to 
  16. helping foster the growth and acceptance of OS/2 as the next generation in 
  17. operating systems for personal computers and workstations. 
  18.  
  19. Oberon products are generally marketed as shareware to keep marketing overhead 
  20. to a minimum.  The savings can then be devoted to further development and 
  21. enhancements and customer service. Please, support the shareware concept by 
  22. registering the shareware products which you use and by passing them along to 
  23. others for their inspection. 
  24.  
  25. In addition to this program, Oberon Software offers the following products and 
  26. services: 
  27.  
  28. o Oberon Terminal Emulator/2 (TE/2) 
  29. o Oberon FSHL Command Line Executive 
  30. o Oberon LstPM file viewer 
  31. o Consulting Services and Custom Programming 
  32.  
  33. Several new products are planned for release in the near future. These will 
  34. include a programmer's Async Communications library/toolkit, enhancements to 
  35. all of our existing programs, and some new surprises. 
  36.  
  37.  
  38. ΓòÉΓòÉΓòÉ 2.1. Oberon Terminal Emulator/2 ΓòÉΓòÉΓòÉ
  39.  
  40. The Oberon Terminal Emulator/2, or TE/2, is Oberon Software's full featured, 
  41. easy to use, general purpose telecommunications program for OS/2. Developed 
  42. originally for OS/2 1.1, it was one the very first such programs written 
  43. specifically to take advantage of the power and capabilities of OS/2.  As OS/2 
  44. has grown, so has TE/2. It is now one of the most popular and widely 
  45. recommended telecommunications programs for OS/2! 
  46.  
  47. TE/2's features include: 
  48.  
  49. o One of the most complete script languages to be found in any telecomm program 
  50.   anywhere 
  51. o REXX/2 as a fully supported, optional script language 
  52. o Extensive facility for running external programs and protocols 
  53. o Multiple, 200 entry dialing directories 
  54. o Call logging 
  55. o Split screen chat mode 
  56. o 48 Assignable function keys 
  57. o Free technical support via the Oberon BBS! 
  58.  
  59. TE/2 includes these file transfer protocols: 
  60.  
  61. o XModem and XModem-1K 
  62. o YModem and YModem-G 
  63. o ZModem with automatic start-up and resume 
  64. o CompuServe(tm) B-Plus protocol 
  65. o Ascii file upload and capture 
  66.  
  67. Supported terminal emulations include: 
  68.  
  69. o Standard TTY (teletype) mode 
  70. o ANSI-BBS and enhanced ANSI 
  71. o VT100 (with VT102 and VT220 extensions) 
  72. o IBM 3101 
  73.  
  74. Call, write, or FAX Oberon Software for more information on TE/2. 
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 2.2. Oberon FSHL Command Line Executive ΓòÉΓòÉΓòÉ
  78.  
  79. FSHL, \ef' shel\ n. [Flowers' shell, named for Brady Flowers, software designer 
  80. during the late 20th century]: a program which greatly enhances the power a 
  81. user has when working at the OS/2 command prompt by adding aliases and macros, 
  82. enhanced and extended command line recall and editing functions, extended 
  83. command set, enhanced batch language, and provisions for user-created 
  84. extensions. 
  85.  
  86. FSHL, Oberon Software's Alternative Command Line Executive for OS/2, layers 
  87. itself over the default OS/2 command line interpreter, CMD.EXE, to provide the 
  88. user with all of these extended services without sacrificing access to OS/2's 
  89. base level functionality! 
  90.  
  91. These are just some of the features of FSHL: 
  92.  
  93. o FSHL aliases allow the user to replace often typed, hard to type, or hard to 
  94.   remember commands with any other command of their preference. 
  95. o Full featured command line editor adds features to the OS/2 command prompt 
  96.   similar to those found in word processing programs. 
  97. o Recall previously typed commands: 
  98.  
  99.    - One at a time 
  100.    - By matching a partially typed command 
  101.    - By selection from a list 
  102.  
  103. o Extends the OS/2 batch language to allow access to FSHL's aliases and 
  104.   history. 
  105. o Dynamic pseudo environment variables to access system information such as the 
  106.   time and date, errorlevels, and window state. 
  107. o New built-in commands like: 
  108.  
  109.    - Sweep to execute a given command over an entire directory tree. 
  110.    - Window to control the OS/2 text mode window in which FSHL is running from 
  111.      the command line or a batch file. 
  112.    - Prty to adjust the OS/2 priority at which a program will run. 
  113.    - And lots more! 
  114.  
  115. o Extended options on existing OS/2 commands. 
  116. o All 48 function keys programmable as text macros. 
  117. o Two separate, powerful programming APIs allow third party developers to 
  118.   extend the basic FSHL command set and to allow applications to call back into 
  119.   FSHL to access its services. 
  120. o Free technical support via the Oberon BBS! 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 2.3. LstPM File Viewer ΓòÉΓòÉΓòÉ
  124.  
  125. LstPM is a 32 bit application which can be used for viewing just about any text 
  126. or data file on your system, either as text (ASCII or EBCDIC) or as a 
  127. hexadecimal "dump" representation. 
  128.  
  129. You can invoke LstPM by installing a WPS program object for it on your desktop 
  130. or in the folder of your choice and clicking on its icon, from the OS/2 command 
  131. line with an optional file name as parameter, or by dragging and dropping a 
  132. selected file or files onto its icon. 
  133.  
  134.  
  135. ΓòÉΓòÉΓòÉ 2.4. Consulting Services and Custom Programming ΓòÉΓòÉΓòÉ
  136.  
  137. Any of Oberon Software's products may be customized to meet your company's 
  138. specific needs.  Or, if you need something totally new, Oberon Software 
  139. specializes in the areas of: 
  140.  
  141. o Asynch/Telecommunications Software 
  142. o Interprocess Communications 
  143.  
  144.    - Network Environment 
  145.    - Standalone 
  146.  
  147. o Presentation Manager Based Software 
  148. o OS/2 Programmer and User Training 
  149. o Migrating D.O.S. applications to OS/2 
  150.  
  151. Please, contact Oberon Software for references and further information. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 3. PmQwk Offline Mail Reader ΓòÉΓòÉΓòÉ
  155.  
  156. Welcome to Oberon Software's Offline mailreader for OS/2 2.0 Presentation 
  157. Manager! 
  158.  
  159. PmQwk is the first and only offline reader for OS/2's Presentation Manager 
  160. which allows you to truly multitask your offline reading.  You can read from 
  161. any number of conferences, from any number of BBSs simultaneously. 
  162.  
  163. You can have multiple replies, from any conference, from any BBS in progress at 
  164. any given time. 
  165.  
  166. There is support for netmail, taglines, regular expression searching, address 
  167. book, and much more! 
  168.  
  169. At last, an offline mail reader that is as good as the operating system it runs 
  170. on! 
  171.  
  172. For additional information, refer to the help for: 
  173.  
  174. o Installing PmQWk 
  175. o Starting PmQwk 
  176. o Help for BBS List 
  177.  
  178. You may also be interested in information regarding: 
  179.  
  180. o Registering PmQwk 
  181. o Oberon Software Products 
  182. o Copyright, License, and Warranty 
  183.  
  184.  
  185. ΓòÉΓòÉΓòÉ 3.1. Installing PmQwk ΓòÉΓòÉΓòÉ
  186.  
  187. There are three files which need to be installed on your harddisk for proper 
  188. operation of PmQwk: 
  189.  
  190.                 PMQWK.EXE
  191.                 PmQwk program executable file.  For best results, a dedicated 
  192.                 directory should be made for PmQwk.  We suggest that you make a 
  193.                 directory, on the disk of your choice, by the name PMQWK and 
  194.                 copy PMQWK.EXE and TagLines.txt into that directory.  You 
  195.                 should ensure that this directory is your current working 
  196.                 directory while you are running PmQwk as PmQwk will maintain 
  197.                 subdirectories for each bulletin board underneath this 
  198.                 directory. These files should be placed in a directory 
  199.                 specified in your PATH if you wish to run PmQwk from the 
  200.                 command line. 
  201.  
  202.                 REGEXPUT.DLL
  203.                 Regular Expression support library.  This must be placed in a 
  204.                 directory specified in your LIBPATH. 
  205.  
  206.                 PMQWK.HLP
  207.                 PmQwk help file.  This must be placed in a directory specified 
  208.                 by your HELP environment variable in order to have help active 
  209.                 while running PmQwk. 
  210.  
  211. Once PmQwk is installed on your hard disk, open the OS/2  Templates Folder, 
  212. select a Program Object Template with the left mouse button and then, using the 
  213. right mouse button, drag it onto the desktop or into the folder of your choice. 
  214. When the Settings Notebook appears, fill in the following: 
  215.  
  216. o Path and file name should be set to the full path/name to PMQWK.EXE (i.e., 
  217.   where you place the file in the step above). 
  218. o Parameters should be left blank - any parameters are ignored. 
  219. o Working directory should be the directory you placed PMQWK.EXE in. 
  220.  
  221. Click on the notebook tab labeled General and, on that page, set the Title to 
  222. PmQwk or a title of your preferance. 
  223.  
  224. See also First Time Startup 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 3.1.1. First Time Startup. ΓòÉΓòÉΓòÉ
  228.  
  229. You may start PmQwk from the OS/2 command line by first ensuring that the disk 
  230. and directory containing PmQwk are current and typing "PMQWK" at the system 
  231. prompt.  If you have installed PmQwk into your desktop setup (following the 
  232. rules for current directory) you may start it that way. 
  233.  
  234. Example batch file for starting PmQwk assuming that it is installed in to 
  235. directory 'D:\PMQWK': 
  236.  
  237.       @echo off
  238.       D:
  239.       CD \PMQWK
  240.       START /PM /N PMQWK
  241.  
  242.  Immediately upon entering PmQwk for the first time, select the menu item 
  243.  labeled Options and the submenu item labeled Paths 
  244.  
  245.  Select Save Options from the Options menu to make the changes permanent. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 3.2. Starting PmQwk ΓòÉΓòÉΓòÉ
  249.  
  250. If you have created a program object, you may start PmQwk by simply clicking on 
  251. its icon. 
  252.  
  253. From the OS/2 command line, you may simply type "PMQWK". 
  254.  
  255. See also:  Installing PmQwk 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 3.3. Registering PmQwk ΓòÉΓòÉΓòÉ
  259.  
  260. You can register this wide beta version for $25.00 (US) and receive a free 
  261. upgrade when the release version comes out.  The release version will be $35.00 
  262. (US) 
  263.  
  264. You may send your check or money order to Oberon Software or users who want to 
  265. use their Visa/MasterCard to order on line may do so by calling GREATER CHICAGO 
  266. Online!! at (708) 895-4042.  We are participating in their Shareware Support 
  267. Program for OS/2 Authors. 
  268.  
  269. Technical support is available through the Oberon Software bulletin board 
  270. system or by phone at no charge. 
  271.  
  272. A license is required for use of PmQwk by corporations and institutions, and 
  273. for its commercial distribution. 
  274.  
  275. You may obtain a license for the use of PmQwk by contacting Oberon Software. 
  276. The license is for perpetual, non-exclusive use of one version. 
  277.  
  278. Purchase orders and invoicing are acceptable. 
  279.  
  280. The fee for a license depends on the estimated number of copies of the program 
  281. that you will use.  The fee applies to one site.  For local area networks, one 
  282. copy must be licensed for each computer that will be using the program on the 
  283. network.  A discount schedule will be made available when the general release 
  284. is made. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 3.4. Copyright, License, and Warranty ΓòÉΓòÉΓòÉ
  288.  
  289. This electronic document and the program files PMQWK.EXE, and PMQWK.HLP, ("the 
  290. software") are copyrighted by Oberon Software and the author, Brady Flowers. 
  291. The copyright owner hereby licenses you to use the software given these 
  292. restrictions: 
  293.  
  294.  o The program shall be supplied in its original, unmodified form, which 
  295.    includes this documentation; 
  296.  
  297.  o For-profit use without a license is prohibited; 
  298.  
  299.  o The program may not be included - or bundled - with other goods or services. 
  300.    Exceptions may be granted upon written request only. 
  301.  
  302.  o No fee is charged; an exception is granted to not for profit user's groups, 
  303.    which are permitted to charge a small fee (not to exceed $5) for materials, 
  304.    handling, postage, and general overhead.  No other organization is permitted 
  305.    to charge any amount for distribution of copies of the software or 
  306.    documentation, or to include copies of the software or documentation with 
  307.    sales of their own products. 
  308.  
  309.  The Regular Expression Engine provided in the dynamic link library 
  310.  REGEXPUT.DLL, used by PmQwk, is derived from previously copyrighted software. 
  311.  This is the copyright notice from the source code to that section of the 
  312.  software: 
  313.  
  314.  Copyright (c) 1986 by University of Toronto.  Written by Henry Spencer. Not 
  315.  derived from licensed software. 
  316.  
  317.  Permission is granted to anyone to use this software for any purpose on any 
  318.  computer system, and to redistribute it freely, subject to the following 
  319.  restrictions: 
  320.  
  321.   1. The author is not responsible for the consequences of use of this 
  322.      software, no matter how awful, even if they arise from defects in it. 
  323.  
  324.   2. The origin of this software must not be misrepresented, either by explicit 
  325.      claim or by omission. 
  326.  
  327.   3. Altered versions must be plainly marked as such, and must not be 
  328.      misrepresented as being the original software. 
  329.  
  330.  Slight alterations were made to Mr. Spencer's software in the process of 
  331.  porting it to the OS/2 environment.  Mr. Spencer's original source code is 
  332.  available to the public for download from the Oberon Software User Support 
  333.  BBS. 
  334.  
  335.  There is no warranty of any kind.  By using the software, you agree to this. 
  336.  
  337.  The software and documentation are: 
  338.  
  339.      Copyright (C) 1990-1992 by Oberon Software and Brady Flowers 
  340.      Mankato, MN, USA 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 4. Help for Keys ΓòÉΓòÉΓòÉ
  344.  
  345. The following information is available regarding PmQwk's keyboard interface: 
  346.  
  347.  o Menus 
  348.  o Dialog Boxes 
  349.  
  350.  
  351. ΓòÉΓòÉΓòÉ 4.1. Menu Item Selection ΓòÉΓòÉΓòÉ
  352.  
  353. You can select any item from the action bar menu by typing Alt-letter where 
  354. "letter" is the underlined letter in the menu item text.  For example, the File 
  355. menu item text has the letter "F"  underlined so it may be accessed by typing 
  356. Alt-F.  Alternately, you may activate the action bar by pressing and releasing 
  357. the Alt key or by pressing and releasing the the F10 key. Thereafter, you may 
  358. select an item by pressing the key corresponding to the underlined letter in 
  359. the menu item text or by moving the highlight to that item with the arrow keys 
  360. and pressing Enter when it is highlighting the desired item. 
  361.  
  362. When a pulldown menu or a submenu is visible, you may select an item from these 
  363. menus by pressing the underlined letter key (the Alt key is optional in this 
  364. case) or by moving the highlight with the arrow keys and pressing Enter. 
  365.  
  366. The System Menu (the icon with the mini icon in the upper left corner of the 
  367. window frame) may be activated from the keyboard by pressing Alt-SpaceBar. 
  368.  
  369. You may exit any menu without making a selection by pressing the ESC key. 
  370.  
  371. Some menu items have an associated accelerator key associated with them.  For 
  372. example, Alt-F4 is associated with the Close item on the System menu.  These 
  373. accelerator keys are always available whenever PmQwk's main window or its 
  374. action bar has the focus. 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 4.2. Dialog Boxes ΓòÉΓòÉΓòÉ
  378.  
  379. Dialog boxes are usually divided into groups of controls (buttons, entry 
  380. fields, list boxes, etc.).  The TAB key will move the highlight from control to 
  381. control regardless of group boundaries;  Shift+TAB will do the same in the 
  382. reverse direction.  The Arrow Keys will move the highlight from control to 
  383. control always staying within the current group of controls. 
  384.  
  385. Buttons are selected by moving the highlight to the desired button and pressing 
  386. the SpaceBar or, if the button's text contains an underlined letter, by 
  387. pressing Alt+letter (see also the discussion on accelerator keys in the help 
  388. for menus 
  389.  
  390. Usually a dialog box will have one button with a special highlight. This is the 
  391. default button which is invoked by pressing Enter. If the dialog has a button 
  392. labeled Cancel, this button may be invoked by pressing the ESC key. 
  393.  
  394. Some controls have special rules for keystrokes: 
  395.  
  396.  o Entry fields are not exited via the TAB key.  To exit an entry field, press 
  397.    Enter (the default button will not be invoked). 
  398.  
  399.  o When a List Box has the highlight, the arrow keys will move the highlight 
  400.    within the list box up and down (or scroll the list box left and right if it 
  401.    has a horizontal scroll bar).  Exit a List Box using the TAB key. 
  402.  
  403.  o Spin Buttons and Combo Boxes behave analogously to List Boxes. 
  404.  
  405.  o Select or deselect a Check Box by pressing the SpaceBar while the Check Box 
  406.    has the highlight. 
  407.  
  408.  o Move the selection within a group of Radio Buttons using the Arrow Keys. 
  409.  
  410.  
  411. ΓòÉΓòÉΓòÉ <hidden> Menu Help for File Menu ΓòÉΓòÉΓòÉ
  412.  
  413. Pack, unpack and address book choices available here. 
  414.  
  415.  
  416. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Unpack QWK Packet ΓòÉΓòÉΓòÉ
  417.  
  418. This selection will bring you to the Unpack QWK Packet 
  419.  
  420. Related Information: 
  421.  
  422.  Unpacking packets 
  423.  Setting Paths 
  424.  Packing Replies 
  425.  Setting Unpacking Software 
  426.  
  427.  
  428. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Pack Replies ΓòÉΓòÉΓòÉ
  429.  
  430. This selection will bring you to the Pack Replies dialog which will allow you 
  431. to pack replies for one or more BBSs. 
  432.  
  433. Related Information: 
  434.  
  435.  Packing Replies 
  436.  Setting Paths 
  437.  Unpacking packets 
  438.  Setting Packing Software 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Address Book ΓòÉΓòÉΓòÉ
  442.  
  443. Opens up the PmQwk Address Book. 
  444.  
  445. Related Information:  Address Book 
  446.  
  447.  
  448. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Exit ΓòÉΓòÉΓòÉ
  449.  
  450. Exit PmQwk 
  451.  
  452.  
  453. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Options ΓòÉΓòÉΓòÉ
  454.  
  455. Fonts, Colors, Paths, Preferences, and Editors can be selected from here. 
  456.  
  457. Related Information: 
  458.  
  459.  Setting Fonts 
  460.  Setting Colors 
  461.  Setting Paths 
  462.  Setting Preferences 
  463.  Selelcting an Editor 
  464.  
  465.  
  466. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Fonts ΓòÉΓòÉΓòÉ
  467.  
  468. Choose fonts for listboxes and text areas. 
  469.  
  470. Related Information:  Setting Fonts 
  471.  
  472.  
  473. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Colors ΓòÉΓòÉΓòÉ
  474.  
  475. Choose colors for listboxes and text areas. 
  476.  
  477. Related Information:  Setting Colors 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Paths ΓòÉΓòÉΓòÉ
  481.  
  482. Select paths for packers and unpackers. 
  483.  
  484. Related information: 
  485.  
  486.  Setting Paths 
  487.  Unpacking QWK Packets 
  488.  Packing Replies 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Editors ΓòÉΓòÉΓòÉ
  492.  
  493. Select an editor for replies. 
  494.  
  495. Related information:  Setting the editor 
  496.  
  497.  
  498. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Preferences ΓòÉΓòÉΓòÉ
  499.  
  500. Set various preferences: 
  501.  
  502.  Beep on personal messages 
  503.  Show only active conferences 
  504.  Quote attribution text 
  505.  Wrap column 
  506.  Prepend/Strip "Re:" from subject lines 
  507.  No Slider Bar in Reading Window 
  508.  Use Taglines 
  509.  Use Cutline 
  510.  
  511.  Related information:  Selecting preferences 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Save Options ΓòÉΓòÉΓòÉ
  515.  
  516. Save PmQwk options and preferences. 
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Help Menu ΓòÉΓòÉΓòÉ
  520.  
  521. Various help for PmQwk Offline Reader. 
  522.  
  523.  
  524. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Using Help ΓòÉΓòÉΓòÉ
  525.  
  526. Help for the help system. 
  527.  
  528.  
  529. ΓòÉΓòÉΓòÉ <hidden> Menu Help for General Help ΓòÉΓòÉΓòÉ
  530.  
  531. General help for PmQwk. 
  532.  
  533.  
  534. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Key Help ΓòÉΓòÉΓòÉ
  535.  
  536. Help for keyboard keys in PmQwk. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Help Index ΓòÉΓòÉΓòÉ
  540.  
  541. Help index. 
  542.  
  543.  
  544. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Product Information ΓòÉΓòÉΓòÉ
  545.  
  546. Information about the current version of PmQwk. 
  547.  
  548.  
  549. ΓòÉΓòÉΓòÉ 5. BBS List ΓòÉΓòÉΓòÉ
  550.  
  551. The BBS List displays all currently unpacked QWK packets.  To read from the 
  552. conferences in a particular BBS, select the BBS in the list box, and press the 
  553. Open button, or simply double-click on the BBS name in the list box. 
  554.  
  555. Related information: 
  556.  
  557.  Selecting a Conference to read from 
  558.  Deleting messages from an Open BBS Packet 
  559.  Deleting Open BBS Packets 
  560.  Packing Replies 
  561.  Unpacking QWK Packets 
  562.  
  563.  
  564. ΓòÉΓòÉΓòÉ 5.1. Delete BBS Messages ΓòÉΓòÉΓòÉ
  565.  
  566. Choose Delete Msgs from the BBS List to remove the unpacked messages from your 
  567. hard drive.  Deleting messages in this way will allow you to save space used up 
  568. by already read messages, but will allow you to still enter messages for that 
  569. BBS.  PmQwk keeps the small files from the QWK packet which describe the 
  570. conferences for that BBS. 
  571.  
  572.  
  573. ΓòÉΓòÉΓòÉ 5.2. BBS Delete ΓòÉΓòÉΓòÉ
  574.  
  575. Choose Delete from the BBS List to delete the files from an open BBS 
  576. conference.  You will also have the option to delete the corresponding QWK 
  577. packet from your disk as well.  If there are unpacked replies, you will be 
  578. prompted to confirm their deletion. 
  579.  
  580. Related information:  Deleting QWK packets .* 
  581.  
  582.  
  583. ΓòÉΓòÉΓòÉ 6. Selecting a Conference ΓòÉΓòÉΓòÉ
  584.  
  585. To begin the process of reading messages, first select a BBS from the BBS List 
  586. window (if this list is empty, you must first unpack at least one QWK packet! 
  587. See Unpacking QWK packets). 
  588.  
  589. After selecting a BBS, another dialog will appear which will list the available 
  590. conferences for that BBS.  Conferences which contain messages will show the 
  591. number of messages in them in the Total column, empty conferences will have 0 
  592. in the Total column.  Each conference has values in the columns indicating the 
  593. number read, the total number of messages, and the percentage of messages you 
  594. have read. 
  595.  
  596. Please note that, by default, areas which contain no messages are not shown at 
  597. all.  To enable their visibility, use the Preferences dialog and toggle the 
  598. checkbox labeled Show only active conferences to OFF. 
  599.  
  600.  There are two extra, pseudo-conferences which appears at the beginning of each 
  601. BBS's conference list.  One is named "Bookmarks".  Messages are entered into 
  602. this conference by pressing the Bookmark button while viewing the message in 
  603. the reading areas, or by bookmarking it from the "List" dialog of a conference. 
  604. This conference behaves just as any other conference would, except it will 
  605. contain messages from several other conferences, and the bookmark button is 
  606. replaced with a Remove Bookmark button.  This is a good conference to put 
  607. messages into when you want to save them for replying at a later time. 
  608.  
  609. The other is named "Replies".  This is where all of your entered messages and 
  610. replies will be kept until they are packed for retransmission to the BBS.  It 
  611. behaves in most ways exactly like a "normal" message window. However, the 
  612. "Reply" and "Enter" functions are replaced with "Edit" and "Delete".  "Edit" 
  613. will allow you to reedit the message, possibly just the "envelope" information 
  614. or the entire message text, while "Delete" will erase the currently viewed 
  615. reply. 
  616.  
  617. If this is a netmail message, the Receiver's net address will appear in 
  618. parentheses after his/her name. 
  619.  
  620.  
  621. ΓòÉΓòÉΓòÉ 7. Reading Messages ΓòÉΓòÉΓòÉ
  622.  
  623. When you select a conference to view, you will be presented with a window which 
  624. contains a "message header" at the top of the window, a scrollable region in 
  625. the central area containing the message text, and a set of buttons at the 
  626. bottom of the window for initiating various activities. 
  627.  
  628. The "message header" contains the following information: the message number, 
  629. the number of the message it refers to (if any), the position in the list of 
  630. messages (e.g."#5 of 15"), the sender's name, the addressee's name, the subject 
  631. of the message, its time and date stamp, whether it is a private or public 
  632. message, and whether the bulletin board has marked this message as "Seen by 
  633. you" or not. If this is a net mail message, the sender's net address will be 
  634. given after his/her name in parentheses. 
  635.  
  636. In an effort to provide more functionality using a minimum of screen real 
  637. estate icon buttons are used for all reading activities.  Because icons are 
  638. often not as inuitive as text, a small staus area in the bottom right corner of 
  639. the reading screen will show the text for any button as the mouse cursor passes 
  640. over it.  The letter which is capitalized is the 'hotkey' you can press to 
  641. simulate clicking on that button. 
  642.  
  643. Most of the activities are self-explanatory: 
  644.  
  645.  o Next and Prev will view the next and previous message in the conference 
  646.    respectively. 
  647.  
  648.  o Page Up and Page Down will scroll the message area a page full, in the same 
  649.    manner as if you had used the scroll bars.  This allows you to keep your 
  650.    mouse in the same general area and still be able to navigate completely. 
  651.  
  652.  o Next Screen will bring you to the next screen of text - whether that is a 
  653.    the equivalent of a Page Down, or a Next operation.  If you have Next 
  654.    Message->Next Conference selected from More Preferences then on the last 
  655.    message Next Screen will bring you to the current message in the next 
  656.    conference when you have reached the end of a conference. 
  657.  
  658.  o Quit closes the window 
  659.  
  660.  o Help invokes the help display. 
  661.  
  662.  o Reply and Enter will invoke the reply editor, the difference being that 
  663.    Reply will preset much of the reply header information with data from the 
  664.    current message while Enter will begin the creation of a new, unrelated (as 
  665.    least as far as the QWK format is concerned) message. 
  666.  
  667.  Related Information: 
  668.  
  669.  o Listing messages 
  670.  o Copying messages 
  671.  o Swiping taglines 
  672.  o Bookmarks 
  673.  
  674.  
  675. ΓòÉΓòÉΓòÉ 7.1. Replying to Messages ΓòÉΓòÉΓòÉ
  676.  
  677. To reply to a message, simply invoke the "reply" button while you are viewing 
  678. the message in question.  The message will be placed into a file in "quoted" 
  679. form and your editor will be invoked on that file.  You may edit any part of 
  680. this file and/or append to the file.  While your editor is in the process of 
  681. editing the reply, a new icon will appear in the main client window: the Active 
  682. Edit Sessions 
  683.  
  684. When you finish editing your reply, you will be returned to PmQwk and given the 
  685. opportunity to edit the "Envelope" information.  This will already have your 
  686. name, the receivers name, net address (if applicable), the conference for the 
  687. message, and the subject filled in.  You may edit any of these items except 
  688. your own name.  If TagLines are enabled (see Options) you may select a tagline 
  689. to use from this dialog. 
  690.  
  691. If you press "OK" and all of the required fields are filled in, the reply will 
  692. be saved.  If you press "Cancel" the message will be discarded after you 
  693. confirm that this is your desire. 
  694.  
  695. Should you need to reedit a reply message or delete a reply message, invoke the 
  696. "Replies" pseudo-confernce and perform the desired action from there (see 
  697. Selecting Conferences) 
  698.  
  699.  
  700. ΓòÉΓòÉΓòÉ 7.2. Help for Entering a New Message ΓòÉΓòÉΓòÉ
  701.  
  702. Sometimes you may wish to enter a message which is not a reply to any existing 
  703. message.  There are two ways to do this: via the "Enter" button while viewing a 
  704. conference, and via the "Message" button from the Conference List dialog.  In 
  705. both cases, the procedure that follows is almost exactly that of creating a 
  706. reply message with the following exceptions: 
  707.  
  708.  o The "Envelope" dialog will appear both before AND after you edit the 
  709.    message. 
  710.  o No default information is filled in in the "Envelope" dialog the first time; 
  711.    you must specify all fields. 
  712.  
  713.  Otherwise, for all intents and purposes, a message of this sort is treated 
  714.  exactly like any other reply. 
  715.  
  716.  
  717. ΓòÉΓòÉΓòÉ 7.2.1. Active Edit Sessions ΓòÉΓòÉΓòÉ
  718.  
  719. This is a list of all current invocations of the editor and a button which will 
  720. allow you to immediately switch to any of the listed editor sessions. 
  721.  
  722.  
  723. ΓòÉΓòÉΓòÉ 7.3. Copying Messages ΓòÉΓòÉΓòÉ
  724.  
  725. You may mark areas within the message text using the mouse pointer and copy 
  726. them to the system clipboard using CONTROL+INSERT or you may use the "Copy" 
  727. dialog. 
  728.  
  729. This dialog allows you to refine how you export the data to a greater degree. 
  730. You may chose to copy the entire message or just the marked area (if any), you 
  731. may optionally include header information about the message in the export, and 
  732. you may copy it directly to a file or to the system clipboard. 
  733.  
  734. Related information: 
  735.  
  736.  o Copying to file 
  737.  o Swiping Taglines 
  738.  
  739.  
  740. ΓòÉΓòÉΓòÉ 7.3.1. Copying to File ΓòÉΓòÉΓòÉ
  741.  
  742. Selecting the Copy to file option from the Copy dialog will open up a standard 
  743. file dialog. 
  744.  
  745. Select a drive, directory, and either choose an existing file name from the 
  746. list box (to append or replace) or type the file name in the entry field. 
  747.  
  748.  
  749. ΓòÉΓòÉΓòÉ 7.4. Swiping Taglines ΓòÉΓòÉΓòÉ
  750.  
  751. PmQwk gives you the ability to swipe taglines directly from messages by using 
  752. the Copy button while reading a message. 
  753.  
  754. To swipe a portion of a message as a tagline, simply mark it with your mouse 
  755. (click and drag) and press the Copy button.  If the text is within the maximum 
  756. size for a tagline (2 less than the wrap column value from Preferences) the 
  757. Swipe Marked Text as Tagline button will be enabled.  Pressing this button adds 
  758. the marked text to the end of TAGLINES.TXT . 
  759.  
  760.  
  761. ΓòÉΓòÉΓòÉ 7.5. Listing Messages ΓòÉΓòÉΓòÉ
  762.  
  763. This invokes a dialog window which, initially contains a list of all messages 
  764. in the area, their message number, subject, sender, receiver, and time/date. 
  765. Messages which you have read are marked with a bullet in the leftmost column. 
  766. You may select a message from this list and press the Go to... button to go 
  767. immediately to that message. 
  768.  
  769. Select the Leave open check box to leave the dialog open while you continue to 
  770. read messages or perform other tasks. 
  771.  
  772. You can size the window, and move the vertical split bar to accomodate your 
  773. personal preference.  PmQwk will save the last size and position of the dialog, 
  774. and also the location of the split bar. 
  775.  
  776. The Filter button in this dialog allows you to view a subset of the messages in 
  777. the list.  You may search for text in "envelope"  fields (Sender, Receiver, and 
  778. Subject) or in the message body itself. 
  779.  
  780. The filtering is for purposes of the "List" dialog only, it does not affect the 
  781. behavior of the message window at all at this time (except as regards jumping 
  782. to a message).  The ability to read only messages which passed through the 
  783. filter is planned for a future release. 
  784.  
  785.  
  786. ΓòÉΓòÉΓòÉ 7.5.1. Filtering Messages ΓòÉΓòÉΓòÉ
  787.  
  788. The message filter allows you to search through a conference for messages that 
  789. have specific characteristics.  You can search in one of four fields for text: 
  790.  
  791.  o Sender 
  792.  o Receiver 
  793.  o Subject 
  794.  o Message 
  795.  
  796.  There are two search styles: 
  797.  
  798.  o Case sensitive - which will ignore upper and lower case when selected. 
  799.  o Regular expression (double-click for more information.) 
  800.  
  801.  Press Search to obtain a list of messages which satisfy the search 
  802.  requirements.  You may then read any message just as you would from the 
  803.  regular List dialog. 
  804.  
  805.  The filtering is for purposes of the "List" dialog only, it does not affect 
  806.  the behavior of the message window at all at this time (except as regards 
  807.  jumping to a message).  The ability to read only messages which passed through 
  808.  the filter is planned for a future release. 
  809.  
  810.  
  811. ΓòÉΓòÉΓòÉ 7.5.2. Regular Expression ΓòÉΓòÉΓòÉ
  812.  
  813. REGULAR EXPRESSION SYNTAX 
  814.  
  815. A regular expression is zero or more branches, separated by '|'.  It matches 
  816. anything that matches one of the branches. 
  817.  
  818. A branch is zero or more pieces, concatenated.  It matches a match for the 
  819. first, followed by a match for the second, etc. 
  820.  
  821. An atom is a regular expression in parentheses (matching a match for the 
  822. regular expression), a range (see below), '.' (matching any single character), 
  823. '^' (matching the null string at the beginning of the input string), '$' 
  824. (matching the null string at the end of the input string), a '\' followed by a 
  825. single character (matching that character), or a single character with no other 
  826. significance (matching that character). 
  827.  
  828. A piece is an atom possibly followed by '*', '+', or '?'. 
  829.  
  830.  o An atom followed by '*' matches a sequence of 0 or more matches of the atom. 
  831.  o An atom followed by '+' matches a sequence of 1 or more matches of the atom. 
  832.  o An atom followed by '?' matches a match of the atom, or the null string. 
  833.  
  834.  A range is a sequence of characters enclosed between square brackets '[' and 
  835.  ']'.  It normally matches any single character from the sequence.  If the 
  836.  sequence begins with '^',  it matches any single character not found in the 
  837.  rest of the sequence.  If two characters in the sequence are separated by '-', 
  838.  this is shorthand for the full list of ASCII characters between them (e.g. 
  839.  '[0-9]' matches any decimal digit).  To include a literal ']' in the sequence, 
  840.  make it the first character (following a possible '^').  To include a literal 
  841.  '-', make it the first or last character. 
  842.  
  843.  EXAMPLES 
  844.  
  845.       The regular expression: "go*d"
  846.       Would match any of: "gd", "god", "good", "gooooooood".
  847.  
  848.       The regular expression: "^[Dd]ear [A-Z]"
  849.       Would match the first six characters of "Dear John" or "dear Me"
  850.       if the string is found as the first thing on the line in which it occurs.
  851.  
  852.       The regular expression: "[^Dd]ear [A-Z]"
  853.       Would NOT match either "Dear John" or "dear Me" regardless of
  854.       where they occurred on the line.  It would match the first six
  855.       characters of either "Bear Country" or "Fear And Loathing" anywhere
  856.       on the line however.
  857.  
  858.       The regular expression:
  859.   "^[_a-zA-Z].*\(.*\)[ \t]*(/\*.*\*/[ \t]*)*$"
  860.  
  861.       Would match any "C" language function definition!  If you understand
  862.       this last example, however, please refer to the note regarding
  863.       C-style backslash notation
  864.  
  865.  AMBIGUITY 
  866.  
  867.  If a regular expression could match two different parts of the input string, 
  868.  it will match the one which begins earliest.  If both begin in the same place 
  869.  but match different lengths, or match the same length in different ways, life 
  870.  gets messier, as follows. 
  871.  
  872.  In general, the possibilities in a list of branches are considered in 
  873.  left-to-right order, the possibilities for '*', '+', and '?' are considered 
  874.  longest-first, nested constructs are considered from the outermost in, and 
  875.  concatenated constructs are considered leftmost-first.  The match that will be 
  876.  chosen is the one that uses the earliest possibility in the first choice that 
  877.  has to be made.  If there is more than one choice, the next will be made in 
  878.  the same manner (earliest possibility) subject to the decision on the first 
  879.  choice. And so forth. 
  880.  
  881.  For example, '(ab|a)b*c' could match 'abc' in one of two ways.  The first 
  882.  choice is between 'ab' and 'a'; since 'ab' is earlier, and does lead to a 
  883.  successful overall match, it is chosen.  Since the 'b' is already spoken for, 
  884.  the 'b*' must match its last possibility (the empty string) since it must 
  885.  respect the earlier choice. 
  886.  
  887.  In the particular case where no '|'s are present and there is only one '*', 
  888.  '+', or '?', the net effect is that the longest possible match will be chosen. 
  889.  So 'ab*', presented with 'xabbbby', will match 'abbbb'.  Note that if 'ab*' is 
  890.  tried against 'xabyabbbz', it will match 'ab' just after 'x', due to the 
  891.  begins-earliest rule.  (In effect, the decision on where to start the match is 
  892.  the first choice to be made, hence subsequent choices must respect it even if 
  893.  this leads them to less-preferred alternatives.) 
  894.  
  895.  
  896. ΓòÉΓòÉΓòÉ 7.6. Bookmarks ΓòÉΓòÉΓòÉ
  897.  
  898. While reading messages in a conference, you may want to mark some for later 
  899. reading.  PmQwk supports this with a pseudo-conference called Bookmarks 
  900.  
  901. You can place a message from any conference into the bookmark conference by 
  902. pressing the bookmark button  . 
  903.  
  904. You can remove a message from the bookmark conference by pressing the removal 
  905. button  while in the Bookmark conference. 
  906.  
  907.  
  908. ΓòÉΓòÉΓòÉ 8. Unpacking QWK Packets ΓòÉΓòÉΓòÉ
  909.  
  910. QWK packets from any number of BBSs may be unpacked simultaneously, although 
  911. only one packet from any one specific BBS may be opened at a time.  Future 
  912. releases of PmQwk will have the ability to combine packets from the same BBS. 
  913.  
  914. Make sure that any and all QWK packets in which you are interested are located 
  915. in the directory which you specified as your  InBound path.  Select "Unpack QWK 
  916. Packet" from the menu or press the "Unpack" button in the  BBS List dialog 
  917. window.  You will be presented with a list of valid QWK packets which PmQwk was 
  918. able to locate in your "InBound" directory.  Select one to unpack either by 
  919. double clicking on the file name and info or by selecting it and pressing the 
  920. "OK" button.  The packet will now be unpacked (if you are about to overwrite 
  921. another packet, you will be given to opportunity to abort the action).  Repeat 
  922. this procedure for every QWK packet you wish to unpack. 
  923.  
  924. If you have never unpacked a packet from this source before, a new item will 
  925. appear in the BBS List window at this point. 
  926.  
  927. Note:  The first time you start PmQwk with a valid InBound path, or the first 
  928. time you select "Unpack QWK Packet" with a valid InBound path, there may be 
  929. some delay as PmQwk scans the inbound directory for the first time.  This delay 
  930. will only be significant if there are many files matching the pattern "*.q*" in 
  931. that directory.  Only "new files" are scanned so the delay should not be 
  932. significant on subsequent invocations. 
  933.  
  934.  
  935. ΓòÉΓòÉΓòÉ 8.1. Deleting Qwk Packets ΓòÉΓòÉΓòÉ
  936.  
  937. You may delete QWK packets which are in your current  Inbound directory. 
  938.  
  939. Select "Unpack QWK Packet" from the menu or press the "Unpack" button in the 
  940. BBS List dialog window.  You will be presented with a list of valid QWK packets 
  941. which PmQwk was able to locate in your InBound directory.  Select one to delete 
  942. by clicking on the QWK packet and then pressing the Delete button.  You will be 
  943. prompted for confirmation before the packet is deleted. 
  944.  
  945.  
  946. ΓòÉΓòÉΓòÉ 9. Packing Replies ΓòÉΓòÉΓòÉ
  947.  
  948. Select Pack Replies from the menu or press the Pack button is the BBS List 
  949. dialog window. 
  950.  
  951. You will be presented with a list of all BBSs which have unpacked reply 
  952. messages defined.  Select one or more from this list and press "OK". 
  953.  
  954. For each selection from the previous list, you will be given a dialog wherein 
  955. you may select the archiver to use for packaging this reply packet and, if a 
  956. file by the target name already exists in your OutBound directory, the option 
  957. of overwriting that file or appending the new messages to it. 
  958.  
  959. There are possibly two buttons in this dialog labeled List Replies; one which 
  960. always appears and another which will only be present if there already exists a 
  961. reply packet in your  OutBound path.  This second button appears inside of a 
  962. group box labeled Existing Replies in this case.  The first of these buttons 
  963. will provide a list of Reply Headers (the conference number, receiver, and 
  964. subject) for each message in the group of new messages the second will do the 
  965. same for the existing replies.  Note, if the existing reply packet was not 
  966. created using PmQwk, PmQwk will not attempt to list its contents. 
  967.  
  968. The button labeled Change Path will invoke a dialog wherein you may override 
  969. the currently set OutBound path (or reset it to the default value if you have 
  970. changed it). 
  971.  
  972. Press the OK button to begin the packing process, press Cancel to abort the 
  973. process. 
  974.  
  975.  
  976. ΓòÉΓòÉΓòÉ 9.1. Changing Reply Paths ΓòÉΓòÉΓòÉ
  977.  
  978. Select the Change Path button from the  Save Packet dialog to change the path 
  979. for a single reply packet. 
  980.  
  981. Select Options and then Paths for a permanent outbound path change. 
  982.  
  983.  
  984. ΓòÉΓòÉΓòÉ 10. Address Book ΓòÉΓòÉΓòÉ
  985.  
  986. The address book feature of PmQwk is activated by choosing Address Book from 
  987. the Files menu in the main client window of PmQwk. 
  988.  
  989. This is a small database wherein you may keep an organized list of names, 
  990. netmail addresses, and notes for future reference. 
  991.  
  992. Each data record in the Address Book consists of four fields: a Search key, and 
  993. Name, and a Net Address, each of which may be up to 25 characters long plus a 
  994. Notes field which can hold up to 949 characters of information. 
  995.  
  996. The reason for having the Key field separate from the Name field is so that you 
  997. may enter the name as it is to appear in your reply envelopes (i.e., Name: 
  998. Barney Rubble or UUCP) and still have your list sorted by something other than 
  999. first name (i.e., Search Key: Rubble, Barney). 
  1000.  
  1001. There are five buttons in the Address Book window, each of which will initiate 
  1002. an action.  Close will close the address book window, New will insert a new, 
  1003. empty record and place the Address Book in edit mode for that record, Edit will 
  1004. place the address book into edit mode for the currently viewed record, Delete 
  1005. will delete the currently displayed record 
  1006.  
  1007. Note:  In the BETA release of the program, the user is NOT queried at this 
  1008. point whether or not to really delete the record! 
  1009.  
  1010. By default, the Address Book comes up in 'lookup mode'.  You may view the 
  1011. details for any entry by either selecting its key from the listbox at the left 
  1012. of the window or by typing the first character or characters of the key into 
  1013. the entry field labeled Search Key in the upper left of the window.  The latter 
  1014. performs an 'incremental search' through the list of keys, that is, if you type 
  1015. 'F', the listbox highlight moves to the first entry which begins with an 'F' 
  1016. (this is not case sensitive), if you then proceed to type an 'L', the highlight 
  1017. moves to the first entry in the listbox which begins with 'FL'. 
  1018.  
  1019. Related information: 
  1020.  
  1021.  o Adding Address Book Entries 
  1022.  o Editing Address Book Entries 
  1023.  o Copying information to the Envelope window 
  1024.  
  1025.  
  1026. ΓòÉΓòÉΓòÉ 10.1. Adding/Editing Address Book Entries ΓòÉΓòÉΓòÉ
  1027.  
  1028. You enter 'edit mode' by pressing either the New button or the Edit button. 
  1029. The New button inserts a new, blank record and allows you to edit that record; 
  1030. the 'Edit' button is only available if a valid record is currently displayed 
  1031. and it allows you to edit the currently viewed record. 
  1032.  
  1033. In 'edit mode', the listbox is replaced with a short, informational message and 
  1034. all four of the entry fields (Search key, Name, Net Addr, and Notes) will now 
  1035. accept input.  You may type anything into these fields you wish; you may use 
  1036. all of the standard OS/2 editing keys and clipboard functions (i.e., 
  1037. Shift+Delete, Ctrl+Insert, and Shift+Insert for Cut, Copy, and Paste). To save 
  1038. the record as edited, press the Save button, to cancel changes press the Cancel 
  1039. button 
  1040.  
  1041. If you have edited the 'Search Key', the listbox in the 'view mode' window will 
  1042. be rearranged as needed. 
  1043.  
  1044.  
  1045. ΓòÉΓòÉΓòÉ 10.2. Addressing envelopes from the Address Book ΓòÉΓòÉΓòÉ
  1046.  
  1047. The OS/2 editing keys which allow you to access the system clipboard are 
  1048. active, that is, you may 'Mark' the name in the Address Book with the mouse or 
  1049. the keyboard, copy it to the clipboard (Ctrl+Insert) and paste it into any OS/2 
  1050. application which will accept clipboard data.  This, of course, includes the 
  1051. the fields in PMQWK's Envelope windows.  For direct communication with the 
  1052. Envelope window, however, you may elect to use the built-in "Drag and Drop" 
  1053. interface. 
  1054.  
  1055. If you press and hold Mouse Button Two (usually the right mouse button) while 
  1056. the mouse pointer is over the 'Name" field or field label in the Address Book 
  1057. window, the mouse pointer will change into a small rectangle with the word NAME 
  1058. in it.  Still holding mouse button two, move the mouse pointer to the Envelope 
  1059. window in which you wish this name to appear until the superimposed circle with 
  1060. a slash disappears and release the mouse button.  The name will replace 
  1061. whatever text is currently in the To: field in the envelope window.  If you 
  1062. begin this operation from the Net Addr field or field label in the Address Book 
  1063. window, the mouse pointer will instead read NET and the data will be placed 
  1064. into the Net: field in the envelope window.  If you begin from anywhere else in 
  1065. in the Address Book window other than directly over the above mentioned fields 
  1066. or their labels, the mouse pointer will appear as two rectangles, NAME and NET, 
  1067. and the data will go to both fields in the Envelope window.  To cancel the drag 
  1068. and drop operation, simply release the mouse button anywhere where it DOES have 
  1069. the circle-slash visible. 
  1070.  
  1071. There is no corresponding drag and drop mechanism for copying data from the 
  1072. Envelope into the Address Book in this release of PmQwk. You may, of course, 
  1073. use the system clipboard to accomplish this as outlined above. 
  1074.  
  1075.  
  1076. ΓòÉΓòÉΓòÉ 11. Setting Options ΓòÉΓòÉΓòÉ
  1077.  
  1078. Select Options from the menu bar to do any of the following: 
  1079.  
  1080.   1. Sorting 
  1081.   2. Fonts 
  1082.   3. Colors 
  1083.   4. Paths 
  1084.   5. Editor 
  1085.   6. Preferences 
  1086.   7. More Preferences 
  1087.   8. Save Options 
  1088.  
  1089.  
  1090. ΓòÉΓòÉΓòÉ 11.1. Sorting Messages ΓòÉΓòÉΓòÉ
  1091.  
  1092. This dialog allows you to sort your messages by message number, date, time, 
  1093. sender, receiver or subject.  You may also define secondary and tertiary sorts 
  1094. to determine the order of messages which have identical values in the field you 
  1095. choose for the primary sort. 
  1096.  
  1097. To sort from high to low, select the Descending check box in any of the sorts, 
  1098. as applicable. 
  1099.  
  1100. If you select the Sort button from the message reading window, you will set the 
  1101. sort order for messages for that conference only.  PmQwk will remember your 
  1102. sort order for that conference in the future, and will maintain your messages 
  1103. in that order until you select an alternate sorting method. 
  1104.  
  1105. If you select Default Sorting from the Options pulldown menu, you will be able 
  1106. to set default sorting options for PmQwk.  Any conferences for which you have 
  1107. not set up a sort will use the PmQwk default you designate. 
  1108.  
  1109. The OK button will save the sort for the system or conference (as applicable) 
  1110. the Apply button, available only on the Default Sorting dialog will apply the 
  1111. sort to all open conferences, modifying each individual conference's default 
  1112. sorting in the process. 
  1113.  
  1114.  
  1115. ΓòÉΓòÉΓòÉ 11.2. Changing Fonts ΓòÉΓòÉΓòÉ
  1116.  
  1117. This dialog allows you to set the fonts which PmQwk will use for message 
  1118. displays and list boxes. 
  1119.  
  1120. Select Options from the menu bar, then Fonts, then either Messages... or List 
  1121. Boxes... to open a standard font dialog. 
  1122.  
  1123. Press Apply to immediately see the result of your font choice in your PmQwk 
  1124. windows without leaving the font dialog.  Press Ok to apply the font to your 
  1125. PmQwk windows and dismiss the font dialog. 
  1126.  
  1127.  
  1128. ΓòÉΓòÉΓòÉ 11.3. Changing Colors ΓòÉΓòÉΓòÉ
  1129.  
  1130. Select Options from the menu bar, then Colors, to open a dialog which will 
  1131. allow you to change the colors withing PmQwk for message displays and list 
  1132. boxes. 
  1133.  
  1134. Note:  In this BETA release of PMQWK, entries appear for "Message HiLited Text" 
  1135. and "Message HiLited Text Background".  These setting are NOT functional in 
  1136. this release, the highlighted colors in message displays are a function of the 
  1137. normal, non-hilighted colors. 
  1138.  
  1139.  
  1140. ΓòÉΓòÉΓòÉ 11.4. Selecting Paths ΓòÉΓòÉΓòÉ
  1141.  
  1142. Set various paths for PmQwk: 
  1143.  
  1144.  o Inbound QWK Packets 
  1145.  o Outbound Reply Packets 
  1146.  o Packers and Unpackers 
  1147.  
  1148.  
  1149. ΓòÉΓòÉΓòÉ 11.4.1. Inbound QWK Packets ΓòÉΓòÉΓòÉ
  1150.  
  1151. Set this item to the name of the directory in which new QWK packets will appear 
  1152. after they have been downloaded from the BBS or on-line services.  In general, 
  1153. this will be the download directory which your telecommunications program uses 
  1154. although you may wish to create a new directory specifically for this purpose 
  1155. and move QWK packets into this directory by other means after they have been 
  1156. downloaded. 
  1157.  
  1158. Note:  In this version of PmQwk the validity of this path is NOT checked at 
  1159. this point. 
  1160.  
  1161.  
  1162. ΓòÉΓòÉΓòÉ 11.4.2. Outbound Reply Packets ΓòÉΓòÉΓòÉ
  1163.  
  1164. Set this item to the name of the directory where you wish PmQwk to deposit 
  1165. packaged reply packets to be uploaded back to the BBS or on-line service. In 
  1166. general, this will be a directory in which your telecommunications program 
  1167. expects to find files for upload. 
  1168.  
  1169. Note:  In this version of PmQwk the validity of this path is NOT checked at 
  1170. this point. 
  1171.  
  1172.  
  1173. ΓòÉΓòÉΓòÉ 11.4.3. Packers and Unpackers ΓòÉΓòÉΓòÉ
  1174.  
  1175. Fill in as many of these as are applicable with the drive, path, and name of 
  1176. the appropriate archiving program or programs.  If they exist in a directory 
  1177. referred to in your PATH environment variable, you may omit the drive and path 
  1178. specification and give only the name of the program file. 
  1179.  
  1180. Note:  In this version of PmQwk, these programs names and paths are NOT checked 
  1181. for validity at this point. FURTHER NOTE: in this version of PmQwk, only the 
  1182. first three archivers are supported: PK(UN)ZIP, ARC, and LH.  Entries exist for 
  1183. ARJ and ZOO for future use only, they are not used by this version of PmQwk. 
  1184.  
  1185.  
  1186. ΓòÉΓòÉΓòÉ 11.5. Setting Editor ΓòÉΓòÉΓòÉ
  1187.  
  1188. You may select your editor of choice  for purposes of editing reply messages by 
  1189. selecting the menuitem Editors under the menu bar item Options 
  1190.  
  1191. Type the name of the editor in the indicated field, if the program file is not 
  1192. in a directory referred to in your PATH environment variable, you must include 
  1193. the entire drive and path specification for the program.  Once you have 
  1194. specified a valid program name here you will be given the opportunity to select 
  1195. how the program will be executed, i.e., as a Presentation Manager program, in a 
  1196. full screen session, or in a windowed session.  Both OS/2 and D.O.S. based 
  1197. editors are supported. 
  1198.  
  1199. The default editor for PmQwk is E.EXE, the OS/2 system editor. 
  1200.  
  1201. Note:  Certain editors will cause problems with PmQwk.  The OS/2 Enhanced 
  1202. Editor (EPM.EXE) will work correctly with PmQwk if and only if there are no 
  1203. other copies of EPM running on your machine at the time you begin an edit 
  1204. session via PmQwk (this includes other PmQwk edit sessions).  The IBM IUO 
  1205. editor, LXPM, does not function correctly for use with PmQwk. 
  1206.  
  1207.  
  1208. ΓòÉΓòÉΓòÉ 11.6. Setting Preferences ΓòÉΓòÉΓòÉ
  1209.  
  1210. Preferences is a catchall for a number of semi-related settings.  Select any of 
  1211. the following for more information: 
  1212.  
  1213.  o Beep on personal messages 
  1214.  o Show only active conferences 
  1215.  o Attribute Quotes 
  1216.  o Wrap Column for Quotes 
  1217.  o Prepend "Re:" to response subject lines 
  1218.  o Strip existing "Re:" from subject lines 
  1219.  o No Slider Bar in Reading Window 
  1220.  o Use Taglines 
  1221.  o Use PmQwk Cutline 
  1222.  
  1223.  See also More Preferences 
  1224.  
  1225.  
  1226. ΓòÉΓòÉΓòÉ 11.6.1. Beep on personal messages ΓòÉΓòÉΓòÉ
  1227.  
  1228. If this setting is checked, PmQwk will alert you with a tone whenever you view 
  1229. a message addressed to you. 
  1230.  
  1231.  
  1232. ΓòÉΓòÉΓòÉ 11.6.2. Show only active conferences ΓòÉΓòÉΓòÉ
  1233.  
  1234. If this option is set ON (the default), PmQwk will only display those 
  1235. conference names belonging to conferences containing more than zero messages in 
  1236. the "Conference List" dialog.  Use this setting if you have a large number of 
  1237. empty conferences listed by a BBS and you do not wish to navigate past them to 
  1238. find the active areas. 
  1239.  
  1240.  
  1241. ΓòÉΓòÉΓòÉ 11.6.3. Attribute quotes ΓòÉΓòÉΓòÉ
  1242.  
  1243. If this setting is checked, you specify that you want PmQwk to provide an 
  1244. "Attribution" to the quotes in your reply messages and you may further specify 
  1245. how you wish this Attribution to appear. 
  1246.  
  1247. Type any text you wish into the associated entry field and it will be echoed 
  1248. into your reply messages.  There are several special character sequences which 
  1249. you may embed into this text which will cause PmQwk to insert relevant 
  1250. information from the message header: 
  1251.  
  1252.  o %s inserts the SENDER's name from the original message 
  1253.  
  1254.  o %r inserts the RECEIVER's name from the original message 
  1255.  
  1256.  o %j inserts the SUBJECT of the original message 
  1257.  
  1258.  o %d inserts the DATE of the original message 
  1259.  
  1260.  o %t inserts the TIME of the original message 
  1261.  
  1262.  o %_ inserts a line break in the attribution string 
  1263.  
  1264.  o %% is used to insert a '%' character in the string. 
  1265.  
  1266.  Please note, these codes ARE case sensitive!  "%S" will NOT work like "%s", 
  1267.  instead it will simply insert the characters "%S" into the attribution string. 
  1268.  
  1269.  
  1270. ΓòÉΓòÉΓòÉ 11.6.4. Wrap Column for Quotes ΓòÉΓòÉΓòÉ
  1271.  
  1272. The column at which lines will be broken for purposes of quoting original 
  1273. messages.  PmQwk attempts to be intelligent about word boundaries and will try 
  1274. to wrap lines at word breaks. 
  1275.  
  1276. Because messages are reformatted based on your setting for "Wrap Column" both 
  1277. when quoting a message before a reply and when importing your message from the 
  1278. editor back into PmQwk, you should be aware of the algorithm used for message 
  1279. formatting so that you can achieve a pleasing result. 
  1280.  
  1281. The message formatter is paragraph based.  It assumes that a new paragraph has 
  1282. started when it encounters either a blank line or an indented line.  It will 
  1283. pull the entire paragraph together to make a "best fit" within your defined 
  1284. wrap column.  For example, assuming you have the (unlikely) wrap setting of 30, 
  1285. the following text: 
  1286.  
  1287.     |---|----|----|----|----|----|
  1288.      Now is the time for all good men to
  1289.      come to the aid
  1290.      of their country.
  1291.  
  1292.  would be reformatted as: 
  1293.  
  1294.     |---|----|----|----|----|----|
  1295.      Now is the time for all good
  1296.      men to come to the aid of
  1297.      their country.
  1298.  
  1299.  While the following: 
  1300.  
  1301.     |---|----|----|----|----|----|
  1302.       Table data:
  1303.       Column 1       Column 2
  1304.       --------       --------
  1305.       Apples         Oranges
  1306.  
  1307.  would not be reformatted at all because of the indentation.  If you are not 
  1308.  aware of the way this behaves, you may end up with undesirable results.  For 
  1309.  instance, if you entered the following: 
  1310.  
  1311.     |---|----|----|----|----|----|
  1312.      Hello Joe!
  1313.      Whatcha know?
  1314.      I just got back from Kokomo!
  1315.      Yours truly,
  1316.      Ira
  1317.  
  1318.  it would end up looking like: 
  1319.  
  1320.     |---|----|----|----|----|----|
  1321.      Hello Joe! Whatcha know? I
  1322.      just got back from Kokomo!
  1323.      Yours truly, Ira
  1324.  
  1325.  Use blank lines and indentation to avoid having lines pulled back for you when 
  1326.  you don't want this to happen. 
  1327.  
  1328.  
  1329. ΓòÉΓòÉΓòÉ 11.6.5. Prepend "Re:" to response subject lines ΓòÉΓòÉΓòÉ
  1330.  
  1331. Automatically place the characters "Re:" at the beginning of subjects lines in 
  1332. replies.  "Re:" will NOT be prepended if those characters are already present 
  1333. at the beginning of the subject. 
  1334.  
  1335.  
  1336. ΓòÉΓòÉΓòÉ 11.6.6. Strip existing "Re:" from subject lines ΓòÉΓòÉΓòÉ
  1337.  
  1338. Remove the characters "Re:" and any white space following from subject lines in 
  1339. replies.  Note that this option and the Prepend option are NOT mutually 
  1340. exclusive!  If they are both checked, subject lines in replies will always 
  1341. contain one and only one "Re:" if neither is checked, no subject line is ever 
  1342. altered by PmQwk. 
  1343.  
  1344. Note further that you have the ability to add or remove any characters you wish 
  1345. from a subject line via the "Envelope" dialog; these setting are provided as a 
  1346. convenience. 
  1347.  
  1348.  
  1349. ΓòÉΓòÉΓòÉ 11.6.7. Slider Bar in Reading Window ΓòÉΓòÉΓòÉ
  1350.  
  1351. You may wish to remove the slider bar from the reading window for one of two 
  1352. reasons. 
  1353.  
  1354.   1. You don't use it and would like the screen 'real estate' back for the 
  1355.      message itself. 
  1356.  
  1357.   2. You have a version of the OS/2 2.1 beta which has a bug with slider bars 
  1358.      which PmQwk demonstrates beautifully. 
  1359.  
  1360.  If you are disabling it because of the bug - be sure to do so before opening a 
  1361.  single conference.  The change only takes effect for conferences opened or 
  1362.  reopened since you selected this preference. 
  1363.  
  1364.  Note:  You may also remove the slider bar with a startup parameter of /2 or 
  1365.  -2. 
  1366.  
  1367.  
  1368. ΓòÉΓòÉΓòÉ 11.6.8. Use Taglines ΓòÉΓòÉΓòÉ
  1369.  
  1370. If this option is checked, PmQwk will look in the same directory that contains 
  1371. the PMQWK.EXE file for a file named "TagLines.txt". If it is found it will use 
  1372. this for its source of tag lines (humorous or provocative short quotes which 
  1373. will be appended to your outgoing messages) and the "TagLine" drop-down list 
  1374. will be enabled in the various "Envelope" dialogs.  From there you may select a 
  1375. line from the list, type in a fresh one "on the fly", or erase it entirely. 
  1376.  
  1377. The TagLines.txt file is a flat ASCII file containing one tagline per line of 
  1378. file; you may edit this file with any text editor. Taglines should not be 
  1379. longer than about 60 or 70 characters. 
  1380.  
  1381.  
  1382. ΓòÉΓòÉΓòÉ 11.6.9. Use PmQwk Cutline ΓòÉΓòÉΓòÉ
  1383.  
  1384. If this option is set OFF then PmQwk will not append it's own "signature line" 
  1385. to your outgoing messages. 
  1386.  
  1387.  
  1388. ΓòÉΓòÉΓòÉ 11.7. Setting More Preferences ΓòÉΓòÉΓòÉ
  1389.  
  1390.  o Last Message in Conference Options 
  1391.  o Tagline Options 
  1392.  o Message Options 
  1393.  
  1394.  
  1395. ΓòÉΓòÉΓòÉ 11.7.1. Last Message in Conference Options ΓòÉΓòÉΓòÉ
  1396.  
  1397. Several options are available to you when you reach the last message of a 
  1398. conference.. 
  1399.  
  1400. Select Beep on last message to cause a unique beep whenever you reach the last 
  1401. message of any conference.  The beep is distinct from the beep you will get on 
  1402. a personal message (if you have selected that option.) 
  1403.  
  1404. Select Focus Moves to Previous Button to cause the 'focus' to move to the 
  1405. Previous button when you reach the last message.  This has the effect of 
  1406. displaying messages in reverse order when you are simply pressing the Enter 
  1407. key.  This was the way earlier versions of PmQwk operated. 
  1408.  
  1409. Select Focus Moves to Quit Button to cause the 'focus' to move to the Quit 
  1410. button when you reach the last message.  If you are pressing the Enter key to 
  1411. navigate through the messages, this has the effect of quitting the conference 
  1412. you are reading when you have reached the end.  Focus will move to the Select 
  1413. Conferences dialog if it is open. 
  1414.  
  1415. Select 'Next Message'->'Next Conference' to cause PmQwk to go to the current 
  1416. message in the next conference when you have reached the end of a conference. 
  1417. Focus will stay on the Next button, but on the last message of a conference 
  1418. pressing the  Next button will cause the current conference to close, and the 
  1419. next conference to open, if it wasn't already, and to display the current 
  1420. message (this will be the first message if it hasn't been opened before.) 
  1421.  
  1422.  
  1423. ΓòÉΓòÉΓòÉ 11.7.2. Tagline Options ΓòÉΓòÉΓòÉ
  1424.  
  1425. Select Start with First Tagline to have PmQwk start using Taglines from the 
  1426. beginning of your tagline file each time you start PmQwk. 
  1427.  
  1428. Select Start with Last Used Tagline to have PmQwk start up with the tagline you 
  1429. last used. 
  1430.  
  1431. Note:  Neither one of these settings is particularly applicable if you have 
  1432. selected random taglines. 
  1433.  
  1434. Select Select Taglines Sequentially to have PmQwk select taglines in the order 
  1435. they appear in the tagline file. 
  1436.  
  1437. Select Select Taglines Randomly to have PmQwk randomly select taglines from 
  1438. your tagline file. 
  1439.  
  1440. Note:  Because 'random' means random, sometimes you will get a duplicate 
  1441. tagline before you see every tagline used. 
  1442.  
  1443.  
  1444. ΓòÉΓòÉΓòÉ 11.7.3. Message Options ΓòÉΓòÉΓòÉ
  1445.  
  1446. No formatting on reply text allows you to tell PmQwk to leave your replies as 
  1447. is.  If your editor is configured to put hard returns and margins 
  1448. appropriately, you may want to select this. 
  1449.  
  1450. Note:  Absolutely no formatting is done to your replies.  Please verify that 
  1451. your editor is doing all the appropriate formatting for you by checking your 
  1452. replies both on PmQwk, as well as on the BBS you upload to.  Some BBSes will 
  1453. truncate if you have not formatted with hard returns, etc. 
  1454.  
  1455. Convert Subject/To/From to uppercase is meant to be used for BBSes which don't 
  1456. handle lower or mixed case in these fields, well or at all.  This must be 
  1457. selected prior to starting a reply, or re-editing a reply. 
  1458.  
  1459.  
  1460. ΓòÉΓòÉΓòÉ 11.8. Conference Window Size Default ΓòÉΓòÉΓòÉ
  1461.  
  1462. Select this option from the Options pull down menu to set a default size for 
  1463. the read message window.  All conferences save their last size and position, 
  1464. but this allows you to decide what the initial sizing of this window will be. 
  1465.  
  1466.  
  1467. ΓòÉΓòÉΓòÉ 11.9. Saving Options ΓòÉΓòÉΓòÉ
  1468.  
  1469. All options discussed in the Preferences section may be saved semi-permanently 
  1470. in an initialization file by selecting this option.  You may always change an 
  1471. option again and resave it. 
  1472.  
  1473. If you change options and do not select "Save options" before you attempt to 
  1474. exit PmQwk, you will be alerted to this fact and given the opportunity to do so 
  1475. at that point. 
  1476.  
  1477. Options are saved in a file named PMQWK.INI in the same directory as PMQWK.EXE. 
  1478. If you've really made a mess of your settings and wish to "start from scratch" 
  1479. just delete this file while PmQwk is not running and restart the program. 
  1480.  
  1481. Warning: If you have used an earlier (16-bit) beta version of PmQwk, you MUST 
  1482. delete your PMQWK.INI file before running this version and then use the current 
  1483. version to reset your options. 
  1484.  
  1485.  
  1486. ΓòÉΓòÉΓòÉ 12. Message Envelope ΓòÉΓòÉΓòÉ
  1487.  
  1488. When you finish editing your reply, you will be returned to PmQwk and given the 
  1489. opportunity to edit the "Envelope" information.  This will already have your 
  1490. name, the receivers name, net address (if applicable), the conference for the 
  1491. message, and the subject filled in.  You may edit any of these items except 
  1492. your own name.  If TagLines are enabled you may select a tagline to use from 
  1493. this dialog. 
  1494.  
  1495. If you press "OK" and all of the required fields are filled in, the reply will 
  1496. be saved.  If you press "Cancel" the message will be discarded after you 
  1497. confirm that this is your desire. 
  1498.  
  1499.  
  1500. ΓòÉΓòÉΓòÉ 13. Setting Icons for Confs and BBSs ΓòÉΓòÉΓòÉ
  1501.  
  1502. Though not on any menu within this version of PmQwk, you may specify your own 
  1503. custom icons and attach them to any "BBS Conference List" dialog or to any 
  1504. "Conference" dialog.  You must use OS/2 version 1.3 compatible color or black 
  1505. and white icon files (.ICO).  To do this, create a directory underneath the 
  1506. directory containing PMQWK.EXE named "PMQIcons" and place all of your custom 
  1507. icon files in this directory.  PmQwk will determine how to use these icons by 
  1508. the names you give the files: 
  1509.  
  1510.  o To attach an icon to a BBS (Conference List Dialog) give the icon file the 
  1511.    same "first name" as the BBS id and an extension of .ICO.  (Example: A BBS 
  1512.    id might be "FERNWOOD", name the icon file "FERNWOOD.ICO"). 
  1513.  
  1514.  o To attach an icon to a specific conference for a specific BBS, use the same 
  1515.    first name as above but give the file an extension which is the conference 
  1516.    number, left padded to three characters with zeros (Example: to attach an 
  1517.    icon to conference #5 for the "FERNWOOD" BBS, name the icon file 
  1518.    "FERNWOOD.005"). 
  1519.  
  1520.  o To attach an icon to the "Personal Messages" conference, do as above but 
  1521.    give the icon file the extension ".PER".  To attach it to the "Replies" 
  1522.    pseudo-conference, give it the extension ".ANS". 
  1523.  
  1524.  Note:  This procedure will be built into the program and made more easy for 
  1525.  the average user in the future.  Do not attempt this procedure if the above 
  1526.  discussion made little or no sense to you! 
  1527.  
  1528.  
  1529. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1530.  
  1531.  Oberon Software 
  1532.  518 Blue Earth Street 
  1533.  Mankato, MN 56001-2142 USA 
  1534.  Phone: 507-388-7001 
  1535.  FAX: 507-388-7568 
  1536.  BBS: 507-388-1154 
  1537.  CompuServe: 72510,3500 
  1538.  GEnie: B.FLOWERS 
  1539.  MCI Mail: oberon/413-5847 
  1540.  
  1541.  
  1542. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1543.  
  1544.  Fidonet netmail: Kimberly Bobrow @ 1:109/347 
  1545.  Internet address: Kimberly.Bobrow@kimberly.bobrow@f347.n109.z1.fidonet.org 
  1546.  OS/2 Shareware BBS ID: Kimberly Bobrow 
  1547.  Oberon Software BBS ID: Kimberly Bobrow 
  1548.  Voice message: (212) 465-3367 [USA] 
  1549.  
  1550.  
  1551. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1552.  
  1553. Please note that the '\t' used in the example to imply a TAB character is there 
  1554. for illustration only because an actual TAB character is difficult to display 
  1555. within the context of the IPF.  The C-style backslash notation for tabs, 
  1556. newlines, etc. is NOT supported by this regular exression engine. Because of 
  1557. the '^' and '$' metacharacters and the fact that matches cannot occur across 
  1558. line boundaries, the loss of '\n' and '\r' should be no hardship.  If you need 
  1559. to specify a TAB, you may simply enter an actual TAB character.