home *** CD-ROM | disk | FTP | other *** search
/ Die PSION Power-CD 2 / PsionPowerCD2.iso / PSION-Power-CD / software / Doku / fifinger.txt < prev    next >
Text File  |  2000-10-22  |  7KB  |  216 lines
  1. ---------------------------------------------------------
  2. FlFinger - Finger client for EPOC
  3. (C) 1999, 2000 David Rushall
  4. All rights reserved
  5.  
  6. ---------------------------------------------------------
  7. INTRODUCTION
  8.  
  9. FlFinger is a simple client for the TCP/IP 'finger'
  10. protocol (RFC1288).
  11.  
  12. Using FlFinger you can collect information about the user
  13. of an email address, if the user's server provides the
  14. service.
  15.  
  16. Some servers may provide other information via 'finger',
  17. such as the service status information provided for
  18. Demon Internet subscribers.
  19.  
  20. Features include:
  21.  
  22.   o  Simple interface.
  23.  
  24.   o  Address history.
  25.  
  26.   o  Copy-and-paste responses into other applications.
  27.  
  28. ---------------------------------------------------------
  29. INSTALLATION
  30.  
  31. NOTE: You must have installed and configured Internet
  32.      (TCP/IP) access (e.g. the Message Suite) before
  33.      installing this software. On more modern machines
  34.      (e.g. Series 5mx and Revo) this is installed as
  35.      standard. Consult you machine's manual for more
  36.      information.
  37.  
  38. To install this software on your machine:
  39.  
  40.   1) Close ALL applications on your EPOC device.
  41.  
  42.      If you do not close all applications before
  43.      installing the SIS packages in the next step,
  44.      you may have problems with OPX versions later.
  45.   
  46.   2) Install the main application SIS file:
  47.      
  48.           FlFinger.sis
  49.      
  50.   3) Finally, look in the "Extras" draw on the machine
  51.      for the new "FlFinger" icon, in the normal manner.
  52.  
  53. NOTES:
  54.  
  55.   *  Please consult the manuals for your device for
  56.      details of installing applications packaged in SIS
  57.      files. You will require a PC or Mac running your
  58.      EPOC connect software (i.e. PsiWin 2 or equivalent)
  59.      or the "Add/Remove" icon on the control panel of
  60.      your EPOC device. Double-clicking on the SIS file
  61.      either on the EPOC device or on the PC/Mac connected
  62.      to the EPOC device should do the trick.
  63.      
  64.   *  The supplied OPXs are for ARM-based machines, such
  65.      as the Series 5, Revo, Osaris, Geofox 1, Series 5mx,
  66.      Series 7, etc. If you wish to run this application
  67.      on the Windows EPOC emulator then please contact the
  68.      OPX author, Keith Walker (web address below), for
  69.      the appropriate versions.
  70.  
  71.   *  OPXs are special resources that may be shared by
  72.      many different applications on the EPOC device. If
  73.      these applications do not deliver the OPXs correctly
  74.      in the standard SIS files, they may cause problems
  75.      with other applications when they are installed, or
  76.      even uninstalled. If you find that this application
  77.      fails to start after installing or uninstalling
  78.      another application, perhaps reporting a missing or
  79.      invalid OPX file, please try reinstalling this
  80.      application using the instructions above. This
  81.      should correct the problem.
  82.  
  83. ---------------------------------------------------------
  84. UNINSTALLING
  85.  
  86. If you have finished with this software you can remove
  87. the application as follows:
  88.  
  89.   1) Make sure the FlFinger application is not running.
  90.  
  91.   2) Using the "Add/Remove" icon on the EPOC control
  92.      panel, remove the "FlFinger" application.
  93.  
  94. After you have completed these steps, FlFinger will have
  95. been removed from your machine's memory and "Extras" bar.
  96.  
  97. ---------------------------------------------------------
  98. BASIC USE
  99.  
  100. If you are familiar with using other EPOC TCP/IP
  101. applications (e.g. the Message Suite) and have used
  102. finger clients before, you should find FlFinger easy to
  103. use.
  104.  
  105. Simply run FlFinger, select 'Open connection...' from
  106. the main menu, enter a valid email address (or select
  107. one from the history of recently used addresses) and
  108. FlFinger will do the rest for you.
  109.  
  110. Anything you can't work out should be documented in the
  111. online Help available from the application menu.
  112. Inexperienced users are advised to browse through this
  113. file when they first run FlFinger.
  114.  
  115. ---------------------------------------------------------
  116. SERVING FINGER REQUESTS
  117.  
  118. FlFinger is a finger client only, so it cannot respond
  119. to finger requests (perhaps from another machine).
  120.  
  121. However, you can use the supplied 'flfingerd.opo' sample
  122. program to serve finger requests from your EPOC machine,
  123. and so try FlFinger even when you are disconnected from
  124. the Internet.
  125.  
  126. Simply run the 'flfingerd.opo' program and then use
  127. FlFinger to send a request to 'someone@localhost',
  128. or 'someone@127.0.0.1', where 'someone' is any valid user
  129. name.
  130.  
  131. If you wish, you can customise this OPL sample to serve
  132. your own message, and even use it to serve requests from
  133. other machines when you are connected to the Internet.
  134. See the 'flfingerd.opl' source file for details.
  135.  
  136. ---------------------------------------------------------
  137. CHANGES
  138.  
  139. Version 1.31
  140.  
  141.   *  Repackaged to use shared FlLib OPM.
  142.   
  143. Version 1.3
  144.  
  145.   *  Pioneering 'ping' probe.
  146.   *  Fabulously faster 'finger' fetching.
  147.   *  Long format finger requests.
  148.   *  Improved display on Osaris and colour machines.
  149.   *  Colour application item.
  150.  
  151. Version 1.2
  152.  
  153.   *  Improved Revo support;
  154.   *  "Disconnect from Internet" menu item;
  155.   *  Automatic response dialog preference setting;
  156.   *  More attractive interface;
  157.   *  Installable on drive E:
  158.   *  Sample finger server included;
  159.   *  Minor enhancements.
  160.  
  161. ---------------------------------------------------------
  162. DISCLAIMER AND COPYRIGHT
  163.  
  164.   1) FlFinger is freeware and copyright; it is not
  165.      public domain. The rights to this package remain the
  166.      property of the author.
  167.      
  168.   2) You may use this software, free of charge, for an
  169.      indefinite period and at no obligation to the
  170.      author.
  171.      
  172.   3) Permission is given to publicly distribute this
  173.      software provided the distribution contains all, and
  174.      only, the unaltered files of the original
  175.      distribution, the ownership of the rights to this
  176.      software is clearly stated and any fee charged is
  177.      extremely nominal.
  178.      
  179.   4) Use of this software is entirely at the user's own
  180.      risk. The user must accept responsibility for any 
  181.      direct or indirect loss or damage arising from the 
  182.      use (or misuse) of the package. This software is 
  183.      supplied "as-is".
  184.  
  185.   5) Note: The OPX files employed by this software (and
  186.      included in this distribution) are the copyright of
  187.      Keith Walker. Please see his WWW site,
  188.  
  189.      http://www.starship.freeserve.co.uk/
  190.  
  191.      for more details.
  192.  
  193. ---------------------------------------------------------
  194. CONTACTS
  195.  
  196. If you have any problems, comments or suggestions about
  197. this software, you can contact me at the following email
  198. addresses:
  199.  
  200.      dave@freepoc.de
  201.  
  202.      dave@piecafe.demon.co.uk
  203.  
  204. This application is distributed in association with
  205. FreEPOC:
  206.  
  207.      http://www.freepoc.de/
  208.  
  209. For the latest news of this an my other software, also
  210. visit:
  211.  
  212.      http://www.piecafe.demon.co.uk/
  213.  
  214. ---------------------------------------------------------
  215. Dave Rushall, 2000
  216.