home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / ipost020.zip / readme.txt < prev   
Text File  |  1995-06-06  |  4KB  |  93 lines
  1.                               iPost/2 v0.20
  2.                               =============
  3.  
  4. what does it do?!?
  5. ------------------
  6. iPost is an NNTP client. It reads articles from the NNTP host and writes them
  7. directly in a Squish messagebase, so you can read them with your favourite
  8. Squish message editor. That's all it does - it's unidirectional. iPost doesn't
  9. care if you write messages in those messagebases.
  10.  
  11. version
  12. -------
  13. This release is very preliminary. The code is a quick and dirty combination
  14. of Souper (which takes up a large part of the source, credit where credit
  15. is due) and my own scriblings.
  16.  
  17. If version 1.00 ever sees daylight, it will have support for e-mail (POP3 and
  18. SMTP client) and bidirectional NNTP. It will problably use ftn type 2+ packets
  19. instead of Squish. Then again, I might just install Fidogate and discover it
  20. does all this already and dump this. :-)
  21.  
  22. requirements
  23. ------------
  24. iPost is a 32-bit OS/2 program. It requires TCP/IP for OS/2 (or the
  25. BonusPak's Internet Access Kit) and the 32-bit Squish API DLL msgapi32.dll.
  26.  
  27. here's the deal
  28. ---------------
  29. The source is absolutely free. I donate my work to the public domain. This
  30. software and its source are provided on an 'as-is' basis. If it blows up your
  31. computer, well tough luck. I will in no way be held responsible.
  32.  
  33. However, your comments and question are very welcome. My e-mail addresses
  34. are listed at the bottom of this file.
  35.  
  36. It has been compiled using IBM CSet/2 (can't get my $%*£ Watcom to work like
  37. it should). The Squish development kit is needed (ibmdev32.zip is the version
  38. I ported to CSet), as well as the TCP/IP programmer's toolkit.
  39.  
  40. configuration and operation
  41. ---------------------------
  42. iPost takes no parameters. Just run the exe. Everything to be configured is
  43. in the configuration file.
  44.  
  45. An iPost.cfg file is required in the current directory. It has the following
  46. configuration directives:
  47.  
  48. from            2:292/608.18
  49.    The from node in the messages.
  50. to              All
  51.    The default value of the 'To:' field. The 'X-To:' RFC-822 kludge is
  52.    recognised, and its value used if it is present.
  53. origin          "My very own private usenet-fidonet gate"
  54.    The default origin line. The 'Organization:' field is used if it is present.
  55. newsserver      news.ping.be
  56.    The name of you news server.
  57.  
  58. You may then specify any number of newsgroup names, followed by the path of the
  59. messagebase the articles from those groups should be written to. A '$' in front
  60. of the path specifies a Squish messagebase. No $ specifies the directory of a
  61. *.msg (stardot, SDM) messagebase. Example:
  62.  
  63. alt.tasteless.jokes                     $d:\msgbase\news\atjokes
  64. rec.food.veg                            $d:\msgbase\news\rfveg
  65. alt.fan.pratchett                       $d:\msgbase\news\afpratch
  66. talk.politics.animals                   $d:\msgbase\news\tpanim
  67. comp.os.os2.networking.tcp-ip           $d:\msgbase\news\coontcp
  68.  
  69. You also need a newsrc file. From this file, it is decided which newsgroups
  70. will be downloaded. iPost also uses this file to keep the count of the last
  71. message read. It takes one name of a newsgroup per line, followed by a colon
  72. ':' and a list of the numbers of the messages that have already been read. No
  73. list instructs iPost to start reading from the first message available.
  74. Example:
  75.  
  76. alt.tasteless.jokes:
  77. rec.food.veg:
  78. alt.fan.pratchett:
  79. talk.politics.animals:
  80. comp.os.os2.networking.tcp-ip:
  81.  
  82. that's all folks
  83. ----------------
  84. Good luck and happy reading. Although this is a preliminary version, I've been
  85. using it myself for over a month at the time of this writing. I've had no
  86. problems with it whatsoever.
  87.  
  88. Wouter/2 (Zombie3 on IRC), 06/06/95
  89.  
  90. Wouter Cloetens                                     wouter.cloetens@ping.be
  91. Team OS/2 - OS/2 User Group Belgium           http://www.ping.be/~ping0203/
  92. PGP key on demand                    2:292/608.18@fidonet 81:432/109@os2net
  93.