home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / listpm7.zip / listpm.IPF < prev    next >
Text File  |  1999-07-14  |  31KB  |  596 lines
  1. :userdoc.
  2. :title.ListPM, text file lister for PM.
  3. :docprof  toc=123456 
  4. ctrlarea=coverpage.
  5. :h1 id='Notices' res=300.Notices
  6. :link reftype=hd res=301.Trademarks :elink.used in this document.
  7. This program is :link reftype=hd res=302.copyrighted:elink..
  8. It uses the :link reftype=hd res=303.GNU Public Licence:elink..
  9. :h2 id='Trademarks' res=301.Trade marks
  10. :ol.
  11. :li.
  12. :i1.C Set ++
  13. C Set ++
  14. :li.
  15. :i1.IBM
  16. IBM
  17. :li.
  18. :i1.Operating System/2
  19. Operating System/2
  20. :li.
  21. :i1.OS/2
  22. OS/2
  23. :li.
  24. :i1.OS/2 Warp
  25. OS/2 Warp
  26. :li.
  27. :i1.Visual Age
  28. Visual Age
  29. :li.
  30. :i1.Open Class
  31. Open Class
  32. :li.
  33. :i1.Presentation Manager
  34. Presentation Manager
  35. :li.
  36. :i1.WorkFrame
  37. WorkFrame 
  38. :li.
  39. :i1.Universal Resource Editor
  40. Universal Resource Editor (
  41. :i1.URE
  42. URE)
  43. :li.Integrated Resource Editor (IRE)
  44. :eol.
  45. are 
  46. :i1.listPM
  47. :i1.trade mark
  48. trade marks of IBM.
  49. :h2 id='Copyright' res=302.Copyright
  50. /*
  51. listPM list files under Presentation Manager. Uses Open Class Library.
  52. :i1.Copyright
  53. Copyright (C) 1998, 1999  Paul Elliott 
  54. This program is free software; you can redistribute it and/or modify it under
  55. the terms of the GNU General Public License as published by the Free Software
  56. Foundation; either version 2 of the License, or (at your option) any later
  57. version. This program is distributed in the hope that it will be useful, but
  58. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  59. FITNESS FOR A PARTICULAR PURPOSE. See the 
  60. :i1.GNU General Public License
  61. GNU General Public License for more details.  You should have received a copy of
  62. the 
  63. :i1.GNU
  64. GNU General Public License along with this program; if not, write to the 
  65. Free Software Foundation, Inc., 
  66. 675 Mass Ave, 
  67. Cambridge, MA 02139, USA. 
  68. :p.
  69. Paul Elliott     
  70. PMB # 181
  71. 11900 Metric Blvd Ste. J
  72. Austin Tx 78758-3117
  73. pelliott@io.com
  74. */ 
  75. :h2 id='GPL' res=303.Full GNU Public Licence
  76. GNU GENERAL PUBLIC LICENSE 
  77. Version 2, June 1991   
  78. Copyright (C) 1989, 1991 
  79. :i1.Free Software Foundation, Inc.
  80. Free Software Foundation, Inc.                           675 Mass Ave,
  81. Cambridge, 
  82. MA 02139, USA  
  83. Everyone is permitted to copy and distribute verbatim copies  of this license
  84. document, but changing it is not allowed. 
  85. Preamble 
  86. The licenses for most software are designed to take away your freedom to share
  87. and change it.  By contrast, the GNU General Public License is intended to
  88. guarantee your freedom to share and change free software--to make sure the
  89. software is free for all its users.  This General Public License applies to most
  90. of the Free Software Foundation's software and to any other program whose
  91. authors commit to using it.  (Some other Free Software Foundation software is
  92. covered by the GNU Library General Public License instead.)  You can apply it to
  93. your programs, too.
  94. :p.
  95. When we speak of free software, we are referring to freedom, not price.  Our 
  96. General Public Licenses are designed to make sure that you have the freedom to
  97. distribute copies of free software (and charge for this service if you wish),
  98. that you receive source code or can get it if you want it, that you can change
  99. the software or use pieces of it in new free programs; and that you know you can
  100. do these things. 
  101. :p.
  102. To protect your rights, we need to make restrictions that forbid anyone to deny
  103. you these rights or to ask you to surrender the rights. These restrictions
  104. translate to certain responsibilities for you if you distribute copies of the
  105. software, or if you modify it. 
  106. :p.
  107. For example, if you distribute copies of such a program, whether gratis or for a
  108. fee, you must give the recipients all the rights that you have.  You must make
  109. sure that they, too, receive or can get the source code.  And you must show them
  110. these terms so they know their rights. 
  111. :p.
  112. We protect your rights with two steps&colon. (1) copyright the software, and (2)
  113. offer you this license which gives you legal permission to copy, distribute
  114. and/or modify the software. 
  115. Also, for each author's protection and ours, we want to make certain that
  116. everyone understands that there is no warranty for this free software.  If the
  117. software is modified by someone else and passed on, we want its recipients to
  118. know that what they have is not the original, so that any problems introduced by
  119. others will not reflect on the original authors' reputations. 
  120. :p.
  121. Finally, any free program is threatened constantly by software patents.  We wish
  122. to avoid the danger that redistributors of a free program will individually
  123. obtain patent licenses, in effect making the program proprietary.  To prevent
  124. this, we have made it clear that any patent must be licensed for everyone's free
  125. use or not licensed at all. 
  126. :p.
  127. The precise terms and conditions for copying, distribution and modification
  128. follow. 
  129. :p.
  130. GNU GENERAL PUBLIC LICENSE 
  131. TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION    
  132. :p.
  133. 0. This License applies to any program or other work which contains a notice
  134. placed by the copyright holder saying it may be distributed under the terms of
  135. this General Public License.  The "Program", below, refers to any such program
  136. or work, and a "work based on the Program" means either the Program or any
  137. derivative work under copyright law&colon. that is to say, a work containing the
  138. Program or a portion of it, either verbatim or with modifications and/or
  139. translated into another language.  (Hereinafter, translation is included without
  140. limitation in the term "modification".)  Each licensee is addressed as "you".  
  141. :p.
  142. Activities other than copying, distribution and modification are not covered by
  143. this License; they are outside its scope.  The act of running the Program is not
  144. restricted, and the output from the Program is covered only if its contents 
  145. constitute a work based on the Program (independent of having been made by 
  146. running the Program). Whether that is true depends on what the Program does.    
  147. :p.
  148. 1. You may copy and distribute verbatim copies of the Program's source code as 
  149. you receive it, in any medium, provided that you conspicuously and appropriately
  150. publish on each copy an appropriate copyright notice and disclaimer of warranty;
  151. keep intact all the notices that refer to this License and to the absence of any
  152. warranty; and give any other recipients of the Program a copy of this License
  153. along with the Program.  
  154. :p.
  155. You may charge a fee for the physical act of transferring a copy, and you may at
  156. your option offer warranty protection in exchange for a fee.    
  157. :p.
  158. 2. You may modify your copy or copies of the Program or any portion of it, thus
  159. forming a work based on the Program, and copy and distribute such modifications
  160. or work under the terms of Section 1 above, provided that you also meet all of
  161. these conditions&colon.      
  162. :p.
  163. a) You must cause the modified files to carry prominent notices stating that you
  164. changed the files and the date of any change.      
  165. :p.
  166. b) You must cause any work that you distribute or publish, that in whole or in
  167. part contains or is derived from the Program or any part thereof, to be licensed
  168. as a whole at no charge to all third parties under the terms of this License.   
  169. :p.
  170. c) If the modified program normally reads commands interactively when run, you 
  171. must cause it, when started running for such interactive use in the most
  172. ordinary way, to print or display an announcement including an appropriate
  173. copyright notice and a notice that there is no warranty (or else, saying that 
  174. you provide a warranty) and that users may redistribute the program under these
  175. conditions, and telling the user how to view a copy of this License. 
  176. (Exception&colon. if the Program itself is interactive but does not normally
  177. print such an announcement, your work based on the Program is not required to
  178. print an announcement.)
  179. :p.
  180. These requirements apply to the modified work as a whole.  If identifiable
  181. sections of that work are not derived from the Program, and can be reasonably
  182. considered independent and separate works in themselves, then this License, and
  183. its terms, do not apply to those sections when you distribute them as separate
  184. works.  But when you distribute the same sections as part of a whole which is a
  185. work based on the Program, the distribution of the whole must be on the terms of
  186. this License, whose permission for other licensees extend to the entire whole,
  187. and thus to each and every part regardless of who wrote it.  
  188. :p.
  189. Thus, it is not the intent of this section to claim rights or contest your
  190. rights to work written entirely by you; rather, the intent is to exercise the
  191. right to control the distribution of derivative or collective works based on the
  192. Program.  
  193. :p.
  194. In addition, mere aggregation of another work not based on the Program with the
  195. Program (or with a work based on the Program) on a volume of a storage or
  196. distribution medium does not bring the other work under the scope of this
  197. License.    
  198. :p.
  199. 3. You may copy and distribute the Program (or a work based on it, under Section
  200. 2) in object code or executable form under the terms of Sections 1 and 2 above
  201. provided that you also do one of the following&colon.      
  202. :p.
  203. a) Accompany it with the complete corresponding machine-readable source code,
  204. which must be distributed under the terms of Sections 1 and 2 above on a medium
  205. customarily used for software interchange; or,  
  206. :p.
  207. b) Accompany it with a written offer, valid for at least three years, to give
  208. any third party, for a charge no more than your cost of physically performing
  209. source distribution, a complete machine-readable copy of the corresponding
  210. source code, to be distributed under the terms of Sections 1 and 2 above on a
  211. medium customarily used for software interchange; or,      
  212. :p.
  213. c) Accompany it with the information you received as to the offer to distribute
  214. corresponding source code.  (This alternative is allowed only for noncommercial
  215. distribution and only if you received the program in object code or executable
  216. form with such an offer, in accord with Subsection b above.)  
  217. :p.
  218. The source code for a work means the preferred form of the work for making
  219. modifications to it.  For an executable work, complete source code means all the
  220. source code for all modules it contains, plus any associated interface
  221. definition files, plus the scripts used to control compilation and installation
  222. of the executable.  However, as a special exception, the source code distributed
  223. need not include anything that is normally distributed (in either source or
  224. binary form) with the major components (compiler, kernel, and so on) of the
  225. operating system on which the executable runs, unless that component itself
  226. accompanies the executable.
  227. :p.
  228. If distribution of executable or object code is made by offering access to copy
  229. from a designated place, then offering equivalent access to copy the source code
  230. from the same place counts as distribution of the source code, even though third
  231. parties are not compelled to copy the source along with the object code. 
  232. :p.
  233. 4. You may not copy, modify, sublicense, or distribute the Program except as
  234. expressly provided under this License.  Any attempt otherwise to copy, modify,
  235. sublicense or distribute the Program is void, and will automatically terminate
  236. your rights under this License. However, parties who have received copies, or
  237. rights, from you under this License will not have their licenses terminated so
  238. long as such parties remain in full compliance.    
  239. :p.
  240. 5. You are not required to accept this License, since you have not signed it. 
  241. However, nothing else grants you permission to modify or distribute the Program
  242. or its derivative works.  These actions are prohibited by law if you do not
  243. accept this License.  Therefore, by modifying or distributing the Program (or
  244. any work based on the Program), you indicate your acceptance of this License to
  245. do so, and all its terms and conditions for copying, distributing or modifying
  246. the Program or works based on it.    
  247. :p.
  248. 6. Each time you redistribute the Program (or any work based on the Program),
  249. the recipient automatically receives a license from the original licensor to
  250. copy, distribute or modify the Program subject to these terms and conditions. 
  251. You may not impose any further restrictions on the recipients' exercise of the
  252. rights granted herein. You are not responsible for enforcing compliance by third
  253. parties to this License.    
  254. :p.
  255. 7. If, as a consequence of a court judgment or allegation of patent infringement
  256. or for any other reason (not limited to patent issues), conditions are imposed
  257. on you (whether by court order, agreement or otherwise) that contradict the
  258. conditions of this License, they do not excuse you from the conditions of this
  259. License.  If you cannot distribute so as to satisfy simultaneously your
  260. obligations under this License and any other pertinent obligations, then as a
  261. consequence you may not distribute the Program at all.  For example, if a patent
  262. license would not permit royalty-free redistribution of the Program by all those
  263. who receive copies directly or indirectly through you, then the only way you
  264. could satisfy both it and this License would be to refrain entirely from
  265. distribution of the Program. 
  266. :p.
  267. If any portion of this section is held invalid or unenforceable under any
  268. particular circumstance, the balance of the section is intended to apply and the
  269. section as a whole is intended to apply in other circumstances. 
  270. :p.
  271. It is not the purpose of this section to induce you to infringe any patents or
  272. other property right claims or to contest validity of any such claims; this
  273. section has the sole purpose of protecting the integrity of the free software
  274. distribution system, which is implemented by public license practices.  Many
  275. people have made generous contributions to the wide range of software 
  276. distributed through that system in reliance on consistent application of that
  277. system; it is up to the author/donor to decide if he or she is willing to
  278. distribute software through any other system and a licensee cannot impose that
  279. choice.  T
  280. :p.
  281. This section is intended to make thoroughly clear what is believed to be a
  282. consequence of the rest of this License.    
  283. :p.
  284. 8. If the distribution and/or use of the Program is restricted in certain
  285. countries either by patents or by copyrighted interfaces, the original copyright
  286. holder who places the Program under this License may add an explicit
  287. geographical distribution limitation excluding those countries, so that
  288. distribution is permitted only in or among countries not thus excluded.  In such
  289. case, this License incorporates the limitation as if written in the body of this
  290. License.    
  291. :p.
  292. 9. The Free Software Foundation may publish revised and/or new versions of the
  293. General Public License from time to time.  Such new versions will be similar in
  294. spirit to the present version, but may differ in detail to address new problems
  295. or concerns.  
  296. :p.
  297. Each version is given a distinguishing version number.  If the Program specifies
  298. a version number of this License which applies to it and "any later version",
  299. you have the option of following the terms and conditions either of that version
  300. or of any later version published by the Free Software Foundation.  If the
  301. Program does not specify a version number of this License, you may choose any
  302. version ever published by the Free Software Foundation.    
  303. :p.
  304. 10. If you wish to incorporate parts of the Program into other free programs
  305. whose distribution conditions are different, write to the author to ask for
  306. permission.  For software which is copyrighted by the Free Software Foundation,
  307. write to the Free Software Foundation; we sometimes make exceptions for this. 
  308. Our decision will be guided by the two goals of preserving the free status of
  309. all derivatives of our free software and of promoting the sharing and reuse of
  310. software generally.  
  311. :p.
  312. NO WARRANTY    
  313. :p.
  314. 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
  315. PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN OTHERWISE
  316. STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM
  317. "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
  318. BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  319. PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  320. PROGRAM IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
  321. ALL NECESSARY SERVICING, REPAIR OR CORRECTION.    
  322. :p.
  323. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  324. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE
  325. PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  326. SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY
  327. TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
  328. RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF
  329. THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
  330. PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  
  331. :p.
  332. END OF TERMS AND CONDITIONS 
  333. :p.
  334. Appendix&colon. How to Apply These Terms to Your New Programs    
  335. :p.
  336. If you develop a new program, and you want it to be of the greatest possible use
  337. to the public, the best way to achieve this is to make it free software which
  338. everyone can redistribute and change under these terms.    
  339. :p.
  340. To do so, attach the following notices to the program.  It is safest to attach
  341. them to the start of each source file to most effectively convey the exclusion
  342. of warranty; and each file should have at least the "copyright" line and a
  343. pointer to where the full notice is found. 
  344. :p.
  345. <one line to give the program's name and a brief idea of what it does.> 
  346. :p.
  347. Copyright (C) 19yy  <name of author>      
  348. :p.
  349. This program is free software; you can redistribute it and/or modify     it
  350. under the terms of the GNU General Public License as published by     the Free
  351. Software Foundation; either version 2 of the License, or     (at your option)
  352. any later version.      
  353. :p.
  354. This program is distributed in the hope that it will be useful, but WITHOUT ANY
  355. WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
  356. PARTICULAR PURPOSE.  See the GNU General Public License for more details. 
  357. :p.
  358. You should have received a copy of the GNU General Public License along with 
  359. this program; if not, write to the Free Software     Foundation, Inc., 675 Mass
  360. Ave, Cambridge, MA 02139, USA.  
  361. :p.
  362. Also add information on how to contact you by electronic and paper mail.  
  363. :p.
  364. If the program is interactive, make it output a short notice like this when it
  365. starts in an interactive mode&colon.      
  366. :p.
  367. Gnomovision version 69, Copyright (C) 19yy name of author     
  368. :p.
  369. Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This
  370. is free software, and you are welcome to redistribute it under certain
  371. conditions; type `show c' for details.  
  372. :p.
  373. The hypothetical commands `show w' and `show c' should show the appropriate
  374. parts of the General Public License.  Of course, the commands you use may be
  375. called something other than `show w' and `show c'; they could even be
  376. mouse-clicks or menu items--whatever suits your program.
  377. :p.
  378. You should also get your employer (if you work as a programmer) or your school,
  379. if any, to sign a "copyright disclaimer" for the program, if necessary.  Here is
  380. a sample; alter the names&colon.    
  381. :p.
  382. Yoyodyne, Inc., hereby disclaims all copyright interest in the program   
  383. :p.
  384. `Gnomovision' (which makes passes at compilers) written by James Hacker.    <
  385. signature of Ty Coon>, 1 April 1989   Ty Coon, President of Vice  
  386. :p.
  387. This General Public License does not permit incorporating your program into
  388. proprietary programs.  If your program is a subroutine library, you may consider
  389. it more useful to permit linking proprietary applications with the library.  If
  390. this is what you want to do, use the GNU Library General Public License instead
  391. of this License. 
  392. :p.
  393. :p.
  394. :p.
  395. :h1 id='Why' res=304.Why did I write ListPM?
  396. I wrote ListPM because I could not get other presentation manager text listing
  397. programs to :link reftype=hd refid='Clipboard'.copy to the clipboard:elink..
  398. Also, I wanted to learn how to write Open Class Library programs.
  399. :p.It is a
  400. :i1.multi-threaded
  401. multi-threaded program so you can display separate files on different windows at
  402. the same time.
  403. :h1 id='Installation' res=318.Installation
  404. Copy the program, listpm.exe to somewhere in your path.  Copy the help file: 
  405. listpm.hlp to some directory indicated by the HELP variable. Copy the INF file
  406. to some directory indicated by the BOOK variable.
  407. :h2 id='Languages' res=319.Other Languages (advanced)
  408. To support this program for other 
  409. :i1.language
  410. languages, edit listpm.res using the Universal resource Editor (URE). Change the
  411. English in the strings to the language of your choice. Relink listpm.dll. And
  412. put it into your path. All text strings are are in the resource DLL so you
  413. should not need to modify the executable.
  414. :p.Everyone is encouraged to define support for ListPM in other languages,
  415. provided you honor the :link reftype=hd refid='GPL'.GNU Public Licence:elink..
  416. Unfortunately, I only write English (after a fashion) (
  417. :i1.hackish dialect
  418. hackish dialect).
  419. :h1 id='Do' res=305.What can ListPM do?
  420. List PM displays files. :link reftype=hd refid='New'.New files :elink.can be
  421. opened in multiple windows. The currently displayed file can be :link
  422. reftype=hd refid='Replace'.replaced :elink.by another.
  423. :p.Word wrapping can be used to display long lines. The font used to display
  424. files can be changed.
  425. :h2 id='File' res=306.File (Alt-F)
  426. The 
  427. :i1.file
  428. file menu allows you to choose :link reftype=hd refid='New'.new file :elink.to
  429. be displayed in a new window. It also allows you to :link reftype=hd
  430.  refid='Replace'.replace the file :elink.displayed in the current window. The
  431. Window can be :link reftype=hd res=310.closed:elink..
  432. :h3 id='New' res=307.New File Open (Alt-N)
  433. Open a 
  434. :i1.New
  435. New file in a new window. The file to open may be chosen with a open file
  436. dialog. In this dialog, you may specify more than one file, and separate window
  437. will be opened for each file.
  438. :h3 id='Replace' res=309.Replace File (Alt-R)
  439. :i1.Replace
  440. Replace the file displayed in the current window. The new file to display may be
  441. chosen with a open file dialog.
  442. :h3 id='Close' res=310.Close (Alt-X) F3 <ESC>
  443. This option 
  444. :i1.close
  445. closes the current window. Other display windows continue.
  446. :h2 id='Edit' res=311.Edit (Alt-E)
  447. This menu allows you to do 
  448. :i1.editting type things
  449. emitting type things, such as :link reftype=hd refid='Clipboard'.copying text to
  450. the clipboard:elink..
  451. :h3 id='Clipboard' res=312.Copy to Clipboard (CTRL-Ins)
  452. Copy the selected text to the OS/2 
  453. :i1.clipboard
  454. clipboard. Text may be selected by dragging mouse button 1.
  455. :h3 id=ID@27 res=327.Search for text
  456. You can search for any text string in the displayed file. The search can require
  457. an exact case match or can be independent of upper and lower case. You can
  458. search forward from the current location or in the reverse direction.
  459. :h4 id=ID@28 res=329.Controling a search
  460. You can specify the text to be searched for in the entry field. Check the exact
  461. case check box if you wish to require that the found text match the specified
  462. string exactly, including upper and lower case. You can control the direction of
  463. the search, with the Forward and Reverse radio buttons.
  464. :h5 id='ExactCase' res=331.Exact case
  465. Checking the Exact case checkbox causes ListPM to consider upper and lower case
  466. when searching for text. For example if you were searching for the string
  467. "selectively" and the text contained the word "Selectively", then ListPM would
  468. not detect a match if exact case were checked, but it would if it was unchecked.
  469. :h5 id='Forward' res=332.Forward search
  470. When the Forward Search radio button is checked, the search will proceed in the
  471. forward direction. That is, from the beginning toward the end of the file.
  472. :h5 id='Reverse' res=333.Reverse Search
  473. When the Reverse Search radio button is checked, the search will proceed in the
  474. reverse direction. That is, from the end toward the beginning of the file.
  475. :h3 id=ID@29 res=328.Search for text again
  476. Search for the previously specified text string again, in the same direction and
  477. with the same exact case specification.
  478. :h2 id='Options' res=313.Options
  479. Select ListPM 
  480. :i1.option
  481. options such as :link reftype=hd refid='WordWrap'.word wrap :elink.and
  482. :link reftype=hd refid='Font'.fonts:elink..
  483. :h3 id='WordWrap' res=314.Word Wrap (Alt-W)
  484. :i1.Word wrapping
  485. Word wrapping controls how lines that are too long for the window are displayed.
  486. When turned :link reftype=hd refid='On'.ON:elink., long text file lines are
  487. broken between words and displayed on multiple window lines. When turned
  488. :link reftype=hd refid='Off'.OFF:elink., long lines are truncated in the
  489. displayed window. The original data in the text file is untouched. ListPM is a
  490. readonly program.
  491. :h4 id='On' res=315.On
  492. Turns word wrapping ON. When turned ON, long text file lines are broken between
  493. words and displayed on multiple window lines. The original data in the text file
  494. is untouched. ListPM is a readonly program.
  495. :h4 id='Off' res=316.Off
  496. Turns word wrapping off. When turned OFF, long lines are truncated in the
  497. displayed window. The original data in the text file is untouched. ListPM is a
  498. readonly program.
  499. :h3 id='Font' res=317.Font
  500. Selects a new 
  501. :i1.font
  502. font to display the text file in the window. The new font will be selected with
  503. an OS/2 font dialog. You will be asked if you want to make the new font the
  504. default fonts when displaying all new files.
  505. :h1 id='Keys' res=321.Keys Help
  506. :p.Ctrl-Ins :link reftype=hd refid='Clipboard'.Copy the selected text to OS/2
  507. clipboard:elink..
  508. :p.F3 :link reftype=hd refid='Close'.Close the Window:elink..
  509. :p.Alt-F4 :link reftype=hd refid='Close'.Close the window:elink..
  510. :p.Alt-X :link reftype=hd refid='Close'.Close the window:elink..
  511. :p.Alt-C :link reftype=hd res=310.Close the window:elink..
  512. :p.<ESC> :link reftype=hd refid='Close'.Close the window:elink..
  513. :p.Alt-N :link reftype=hd refid='New'.Open a new file in a new window:elink..
  514. :p.Alt-R :link reftype=hd refid='Replace'.Replace the file displayed in the
  515. current window:elink..
  516. :p.Alt-T :link reftype=hd refid='Font'.Change the default font:elink..
  517. :p.Alt-S :link reftype=hd refid=ID@27.Search for a text string.:elink.
  518. :p.Ctrl-F :link reftype=hd refid=ID@27.Search for a text string.:elink.
  519. :p.Alt-A :link reftype=hd refid=ID@29.Search for the same text string
  520. again.:elink.
  521. :p.Ctrl-N :link reftype=hd refid=ID@29.Search for the same text string
  522. again.:elink.
  523. :h2 id='Using Keys Help' res=326.Using Keys Help
  524. Keys help tells you about using keystrokes in ListPM.
  525. :h1 id='General Help' res=323.General Help
  526. Select the General Help option for more information on using ListPM.
  527. :h1 id='Help Index' res=324.Help Index
  528. The index provides a list of those topics discussed in the list PM help.
  529. :h1 id='Using Help' res=325.Using Help
  530. Using Help provides information about using Help
  531. :h1 id='Command' res=322.Command Line
  532. ListPM can be invoked from the command line.
  533. :p.ListPM file1 file2 file3 ....
  534. :p.A separate window will be opened for each file specified on the command line.
  535. :p.If ListPM is invoked with no arguments, it will open one empty window.
  536. :p.If you specify a directory on the command line, ListPm will open a Open file
  537. dialog to allow you to specify which text file in the given directory, you wish
  538. to open.
  539. :p.If you specify no arguements, ListPM will take its input
  540. :p.from standard input. i.e. "dir | listpm"
  541. :h1 id='Bugs' res=320.Known Bugs
  542. If you can solve any of these
  543. :i1.bugs
  544. bugs send me some email:
  545. pelliott@io.com
  546. :ol.
  547. :li.Whenever the user resizes list frame window, the new window size is stored
  548. in the application's profile. This should only be done when the user uses shift
  549. drag border window, but I do not know how to detect this case. If you know how
  550. to solve this bug, please send me email.
  551. :li.When doing an IFileDlg to get filename, if you type return or escape, the
  552. dialog does not end. Worked for IBMCPP Version 3.0.
  553. :eol.
  554. :h1 id=ID@34.Change History
  555. Fixed from listpm2.zip:
  556. Fixed search routines so that search for text runs on other
  557. thread. Should end Hour-glass, freezes when searching long file
  558. for text.
  559. Fixed import to determine OS/2 or UNIX format by the way first
  560. line ends, and import accordingly.
  561. Modified for listpm4.zip 9-10-97
  562. Read from standard input if called with 0 parameters.
  563. Put name of displayed file on tasklist entry.
  564. Reduce priority of search thread.
  565. Updated to listpm7.zip to use IBMCPP 40.
  566. Fixed non C++ standard code.
  567. Used IOC IFilesystemEntity to determine if filename string coresponds
  568. to a directory.
  569. changeSwitch noop'ed in case not OS/2.
  570. Use IMultiLineEdit.copy rather than IClipborad.copy for elegance and to avoid
  571. bugs in IClipboard.
  572. When Search window gets focus, set focus to text entry field of the search
  573. dialog.
  574. Added support for controling colors.
  575. :h1 id=ID@30 res=330.Program Author
  576. As of June 30 1996, Paul Elliott is available to help you with your OS/2
  577. software development problems.
  578. Paul Elliott 
  579. PMB # 181
  580. 11900 Metric Blvd, Ste. J
  581. Austin Tx 78758-3117
  582. pelliott@io.com
  583. :h1 id='Color' res=334.Colors
  584. Use this dialog to chose a color for the frame dialog. You may select a color by
  585. clicking on a square with the mouse. You can then refine the color, altering the
  586. Red, Green, and Blue values, by dragging the intensity line.
  587. You can click the OK button to accept the new color, or press
  588. the cancel button to abort the change in color, or press the reset button to go
  589. to listpm's original default color.
  590. You will be asked if you want your chosen color to be a stored default which
  591. will be used when future listpm windows are created.
  592. The most important list window frame colors to change are the text area
  593. background and foreground color select these colors so that the display will be
  594. less fatiguing.
  595. The "Colors" options is found on the "options" menu that hangs of the Menu bar.
  596. :euserdoc.