"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/internals.txt" between
tin-2.4.3.tar.xz and tin-2.4.4.tar.xz

About: TIN is a threaded NNTP and spool based UseNet newsreader.

internals.txt  (tin-2.4.3.tar.xz):internals.txt  (tin-2.4.4.tar.xz)
skipping to change at line 20 skipping to change at line 20
It supports the use of 'q' to abort the operation and 'Q' to exit tin It supports the use of 'q' to abort the operation and 'Q' to exit tin
without error recovery. without error recovery.
tin_errno will be set to !0 to flag errors. Currently the only tin_errno will be set to !0 to flag errors. Currently the only
supported error is 'user aborted with q'. supported error is 'user aborted with q'.
Closing data streams should be done with TIN_FCLOSE(fp) as the NNTP Closing data streams should be done with TIN_FCLOSE(fp) as the NNTP
socket should be kept open, whereas local spool fd's must be closed. socket should be kept open, whereas local spool fd's must be closed.
TIN_FCLOSE() takes care of this. TIN_FCLOSE() takes care of this.
If you wish to quit reading a NNTP stream, then call drain_buffer(fp) to If you wish to quit reading an NNTP stream, then call drain_buffer(fp) to
clear out any pending data on the NNTP socket. clear out any pending data on the NNTP socket.
nntp_command(command, valid_response, rest_of_data) should be used for nntp_command(command, valid_response, rest_of_data) should be used for
sending all generic NNTP command. It returns a fd to the open stream sending all generic NNTP command. It returns an fd to the open stream
for reading the rest of the data. for reading the rest of the data.
Example of a typical exchange: Example of a typical exchange:
if ((fp = nntp_command ("GROUP comp.thing", OK_GROUP, NULL)) != NULL) { if ((fp = nntp_command ("GROUP comp.thing", OK_GROUP, NULL)) != NULL) {
while ((ptr = tin_fgets(fp, FALSE)) != NULL) while ((ptr = tin_fgets(fp, FALSE)) != NULL)
process_data(ptr); process_data(ptr);
#ifdef NNTP_ABLE #ifdef NNTP_ABLE
 End of changes. 2 change blocks. 
2 lines changed or deleted 2 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)