/* Paperyboy support DLL
   This Module reads in the SOUP message format packet as a series
   of files. It then allows the application to easily access area
   names, message headers and message text.
*/

/* VERSION routines */

/*	int MajorVersion(void)
	Returns major version of DLL.
	Major version indicates major changes, and is incompatible
	with previous version
*/

/*	int MinorVersion(void)
	Returns minor version of DLL.
	Minor version indicates changes, but should remain compatible
	with previous MinorVersions within the same MajorVersion
*/

/*	char * VersionDesc(void)
	Gives a string showing the Copyright and module name
*/

/* AREAS support routines */

/*	int LoadAreas (const char * areasfname)
	Loads up the SOUP packet from areasfname, which should be a
	fully qualified drive/directory/filename, the latter usually
	being AREAS. From the AREAS file, we can find the message areas,
	which in turn we can find the subjects.

	Should be called before most other functions in this library.

	Returns 0 on success, an error number on failure (no such file
	or unparseable file)
*/

/*  int GetNumAreas (void)
	Returns the number of message areas. [1..GetNumAreas]
*/

/*	char * GetAreaName (int index)
	Returns the name of the message area given of index
*/

/* 	char * GetAreaEncoding (int index)
	Returns a three character string corresponding to the encoding
	of the specified message area. u?? and [Mm]?? should be the
	most popular
*/

/*	char * GetAreaDesc (int index)
	Returns the description of the specified message area. NULL
	if no description available
*/


/* MESSAGE HEADER support routines */

/*	int GetNumMsgs (int index)
	Returns the number of messages in the area specified by index
	index=[1..GetNumAreas], returns [1..GetNumHdrs]
*/

/*	int ThreadMsgs (int index)
	Sorts the messages in area index, sorting by ascending
	Base Subject (sans RE:), then date.
	More intelligent sorting is possible
*/

/*	void UnThreadMsgs (int index)
	Returns the messages to the order they naturally occur in
*/

/*	char * GetSubject(int areaindex, int msgindex)
	Returns the Subject: line from the message
*/

/*	char * GetAuthor (int areaindex, int msgindex)
	Returns the From: line from the message
*/

/*	char * GetDate	 (int areaindex, int msgindex)
	Returns	the Date: line from the message (FORMAT?)
*/

/*	void GetMsg (int areaindex, int msgindex)
	Loads the message given by the indexes into the common
	lines buffer
*/

/* MESSAGE line routines */

/*	int GetNumLines  (void)
	Returns the number of lines waiting in the lines buffer
	[1..GetNumLines]
*/

/*	char * GetLine (int lineno)	
	Returns the line specified
*/

/* INFO routines */

/*	int GetInfo (void)
	Loads the INFO file (if present) into the message buffer
	Returns 0 if the file exists
*/

/* REPLY routines */
/* LIST routines */
