From: MERC::"uunet!WKUVX1.BITNET!FILESERV-Mgr" 29-SEP-1992 12:49:16.04 To: galaxy::gleeve CC: Subj: NEWSRDR.AAAREADME NEWSRDR NEWSRDR is an NNTP client program for VMS systems running CMU-Tek TCP/IP, TGV MultiNet, DEC's VMS/ULTRIX Connection, or any TCP/IP package supporting a Berkeley socket interface. NNTP is the Network News Transfer Protocol, which is used to communicate USENET news over TCP/IP. Since many systems cannot afford the disk space to store all net news locally, this program can be used to communicate with a cooperating news server system to read and post net news. News articles are fetched on an as-needed basis and are stored on the client system only while they are being read. NEWSRDR is not a port of UNIX-based news readers. It is written strictly for VMS and provides an interface that VMS users should find reasonably comfortable. Most of the commands in NEWSRDR should be familiar to VMS MAIL users. NEWSRDR is written entirely in C. It uses the callable MAIL interface, and therefore requires VMS V5.0 or later to run. Through the NETLIB network library routines (provided with the NEWSRDR distribution), NEWSRDR can support CMU-Tek TCP/IP, VMS/ULTRIX Connection, and TGV MultiNet. A module is also provided that can be used with any TCP/IP package that supports Berkeley sockets (has been tested with UCX and MultiNet). Support for Japanese sites using Kanji in news articles is provided through the use of an installable library of character conversion routines which can be mapped in at run-time by NEWSRDR. C source is provided for the Kanji character code conversion routines. Support for username and mail address conversion routines is also provided, also through the use of shareable libraries. Refer to the NEWSRDR documentation for specific system and user requirements. Files included in NEWSRDR.ZIP: ------------------------------ AAAREADME.DOC This file. AAAREADME.TOO More info on NEWSRDR. ADDRESS_CONVERSION.C C source code to mail address conversion routines. BOOKREADER_SETUP.TXT Explanation of how to use the Bookreader-format docs. KANJI_CONVERSION.C C source code to Kanji character conversion routines. KANJI_CONVERSION.OBJ Object code for Kanji character conversion routines. LIBRARY.DECW$BOOKSHELF Bookreader LIBRARY file describing NEWSRDR docs. LINK.COM Command procedure for creating the NEWSRDR executable. MDMLIB.OLB Object library required for linking NEWSRDR image. NAME_CONVERSION.C C source for sample username/mailname mapping routines. NETLIBxxx.A Saveset A of NETLIB installation kit. NETLIBxxx.B Saveset B of NETLIB installation kit. NEWSRDR.DECW$BOOKSHELF Bookreader bookshelf file for NEWSRDR on-line documents. NEWSRDR.OLB The NEWSRDR object library. NEWSRDR_DOC.DECW$BOOK Bookreader version of NEWSRDR user guide. NEWSRDR_DOC.PS PostScript version of NEWSRDR user guide. NEWSRDR_DOC.TXT Plain-ASCII version of NEWSRDR user guide. NEWSRDR_HELP.HLB NEWSRDR help library. NEWSRDR_DOC.DECW$BOOK Bookreader version of NEWSRDR installation guide. NEWSRDR_INST.PS PostScript version of NEWSRDR installation guide. NEWSRDR_INST.TXT Plain-ASCII version of NEWSRDR installation guide. NEWSRDR_LOGIN.COM Sample login command procedure for NEWSRDR users. NEWSRDR_STARTUP.COM Sample startup command procedure for NEWSRDR. SERVER_NETLIB.OBJ Server interface module for use with NETLIB. SERVER_SOCKET.C C source to socket-based server interface module. SERVER_SOCKET.OBJ Server interface module for use with a socket library. SERVER_SOCKET_TCPWARE.OBJ Socket interface for use with PSC's TCPware. Files included in NEWSRDR_SRC.ZIP: ---------------------------------- ADDRESS_CONVERSION.C C source code to mail address conversion routines. ARTICLE.C C source for article-processing routines. CMD_DIRECTORY.C C source for DIRECTORY commands. CMD_MISC.C C source for miscellaneous commands. CMD_POST.C C source for POST/REPLY commands. CMD_PRINT.C C source for PRINT commands. CMD_READ.C C source for READ and related commands. CMD_SETSHO.C C source for SET and SHOW commands. FILEIO.C C source for RMS interface. GROUPS.C C source for the group tree management routines. KANJI_CONVERSION.C C source code to Kanji character conversion routines. MAIL.C C source for VMS MAIL-interface routines. MAKE_ZIP.C Program to assist in building these ZIP files. MAKE_ZIP.CLD CLD for MAKE_ZIP. MAKE_ZIP.OPT Linker options file for MAKE_ZIP. MEM.C C source for memory management routines. MISC.C C source for miscellaneous routines. NAME_CONVERSION.C C source for sample username/mailname mapping routines. NETLIB_SRC.BCK BACKUP saveset containing NETLIB source code (in BLISS). NEWSRC.C C source for routines that deal with newsrc files. NEWSRDR.C C source for NEWSRDR main module. PAGER.C C source for SMG interface routines. PARSE_TABLES.MAR MACRO source for parse tables used with LIB$TPARSE. PARSE822_TABLES.MAR Some more MACRO parse tables. PARSE822.C C source for an RFC822 address parsing routine. PARSING.C C source for various parsing routines. PROFILE.C C source for NEWSRDR profile-processing routines. NEWSRDR.H C header file used by all NEWSRDR source modules. GLOBALS.H C header file with global variable references. CMD_TABLE.CLD Command Language Definition for commands in NEWSRDR. NEWSRDR_CLD.CLD Command Language Definition for NEWSRDR command. NEWS_MSG.MSG Message code definitions used by NEWSRDR. DESCRIP.MMS MMS description file for building NEWSRDR. NEWSRDR_HELP.RNH RUNOFF file for generating NEWSRDR help library. NEWSRDR_DOC.SDML VAX Document source for NEWSRDR user guide. NEWSRDR_INST.SDML VAX Document source for NEWSRDR installation guide. SERVER_NETLIB.C C source to NETLIB-based server interface module. SERVER_SOCKET.C C source to socket-based server interface module. -------------------------------------------------------------------------------- CONTACTING THE AUTHOR Comments, suggestions, and questions about this software can be directed to the author at one of the following addresses: Mail: Matthew Madison TGV, Inc. 603 Mission Street Santa Cruz, CA 95060 Phone: +1 408 427 4366 Fax: +1 408 427 4365 E-Mail: madison@tgv.com COPYRIGHT NOTICE This software is COPYRIGHT ) 1992, MATTHEW D. MADISON. ALL RIGHTS RESERVED. Permission is granted for not-for-profit redistribution, provided all source and object code remain unchanged from the original distribution, and that all copyright notices remain intact. DISCLAIMER This software is provided "AS IS". The author and TGV, Inc. make no representations or warranties with repsect to the software and specifically disclaim any implied warranties of merchantability or fitness for any particular purpose.