| 1 | \cfg{man-identity}{nntpid}{1}{2004-11-21}{Simon Tatham}{Simon Tatham} |
| 2 | |
| 3 | \title Man page for \cw{nntpid} |
| 4 | |
| 5 | \U NAME |
| 6 | |
| 7 | \cw{nntpid} - retrieve a single article from a news server |
| 8 | |
| 9 | \U SYNOPSIS |
| 10 | |
| 11 | \c nntpid [ -v ] message-id |
| 12 | \e bbbbbb bb iiiiiiiiii |
| 13 | \c nntpid [ -v ] newsgroup-name article-number |
| 14 | \e bbbbbb bb iiiiiiiiiiiiii iiiiiiiiiiiiii |
| 15 | |
| 16 | \U DESCRIPTION |
| 17 | |
| 18 | \cw{nntpid} makes a connection to a news server, retrieves a single |
| 19 | article, and displays it. |
| 20 | |
| 21 | You can specify the article you want by either: |
| 22 | |
| 23 | \b giving its Message-ID. Message-IDs are globally unique, so you |
| 24 | don't need to know which newsgroup the article was in. Also, they do |
| 25 | not vary between news servers. |
| 26 | |
| 27 | \b giving a newsgroup name and an article number within that |
| 28 | newsgroup. Article numbers are assigned internally by a particular |
| 29 | news server, so they will be different on other servers carrying the |
| 30 | same group. |
| 31 | |
| 32 | \U ARGUMENTS |
| 33 | |
| 34 | If you specify one argument, \cw{nntpid} assumes it is a Message-ID. |
| 35 | The angle brackets that usually delimit Message-IDs are optional; |
| 36 | \cw{nntpid} will strip them off if it sees them, and will not |
| 37 | complain if it does not. |
| 38 | |
| 39 | If you specify two arguments, \cw{nntpid} will interpret the first |
| 40 | as a newsgroup name, and the second as an article number. |
| 41 | |
| 42 | \U OPTIONS |
| 43 | |
| 44 | \dt \cw{-v} |
| 45 | |
| 46 | \dd Verbose mode. In this mode, \cw{nntpid} will log its entire |
| 47 | conversation with the news server on standard error. |
| 48 | |
| 49 | \U LICENCE |
| 50 | |
| 51 | \cw{nntpid} is free software, distributed under the MIT licence. |
| 52 | Type \cw{nntpid --licence} to see the full licence text. |
| 53 | |
| 54 | \versionid $Id$ |