/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / lib1 / nntplib / tex

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 53 74 61 6e 64 61 72 |\section|{Standar|
|00000010| 64 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |d Module| \sectco|
|00000020| 64 65 7b 6e 6e 74 70 6c | 69 62 7d 7d 0a 5c 73 74 |de{nntpl|ib}}.\st|
|00000030| 6d 6f 64 69 6e 64 65 78 | 7b 6e 6e 74 70 6c 69 62 |modindex|{nntplib|
|00000040| 7d 0a 0a 5c 72 65 6e 65 | 77 63 6f 6d 6d 61 6e 64 |}..\rene|wcommand|
|00000050| 7b 5c 69 6e 64 65 78 73 | 75 62 69 74 65 6d 7d 7b |{\indexs|ubitem}{|
|00000060| 28 69 6e 20 6d 6f 64 75 | 6c 65 20 6e 6e 74 70 6c |(in modu|le nntpl|
|00000070| 69 62 29 7d 0a 0a 54 68 | 69 73 20 6d 6f 64 75 6c |ib)}..Th|is modul|
|00000080| 65 20 64 65 66 69 6e 65 | 73 20 74 68 65 20 63 6c |e define|s the cl|
|00000090| 61 73 73 20 5c 63 6f 64 | 65 7b 4e 4e 54 50 7d 20 |ass \cod|e{NNTP} |
|000000a0| 77 68 69 63 68 20 69 6d | 70 6c 65 6d 65 6e 74 73 |which im|plements|
|000000b0| 20 74 68 65 20 63 6c 69 | 65 6e 74 0a 73 69 64 65 | the cli|ent.side|
|000000c0| 20 6f 66 20 74 68 65 20 | 4e 4e 54 50 20 70 72 6f | of the |NNTP pro|
|000000d0| 74 6f 63 6f 6c 2e 20 20 | 49 74 20 63 61 6e 20 62 |tocol.  |It can b|
|000000e0| 65 20 75 73 65 64 20 74 | 6f 20 69 6d 70 6c 65 6d |e used t|o implem|
|000000f0| 65 6e 74 20 61 20 6e 65 | 77 73 20 72 65 61 64 65 |ent a ne|ws reade|
|00000100| 72 0a 6f 72 20 70 6f 73 | 74 65 72 2c 20 6f 72 20 |r.or pos|ter, or |
|00000110| 61 75 74 6f 6d 61 74 65 | 64 20 6e 65 77 73 20 70 |automate|d news p|
|00000120| 72 6f 63 65 73 73 6f 72 | 73 2e 20 20 46 6f 72 20 |rocessor|s.  For |
|00000130| 6d 6f 72 65 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |more inf|ormation|
|00000140| 20 6f 6e 20 4e 4e 54 50 | 0a 28 4e 65 74 77 6f 72 | on NNTP|.(Networ|
|00000150| 6b 20 4e 65 77 73 20 54 | 72 61 6e 73 66 65 72 20 |k News T|ransfer |
|00000160| 50 72 6f 74 6f 63 6f 6c | 29 2c 20 73 65 65 20 49 |Protocol|), see I|
|00000170| 6e 74 65 72 6e 65 74 20 | 52 46 43 20 39 37 37 2e |nternet |RFC 977.|
|00000180| 0a 0a 48 65 72 65 20 61 | 72 65 20 74 77 6f 20 73 |..Here a|re two s|
|00000190| 6d 61 6c 6c 20 65 78 61 | 6d 70 6c 65 73 20 6f 66 |mall exa|mples of|
|000001a0| 20 68 6f 77 20 69 74 20 | 63 61 6e 20 62 65 20 75 | how it |can be u|
|000001b0| 73 65 64 2e 20 20 54 6f | 20 6c 69 73 74 20 73 6f |sed.  To| list so|
|000001c0| 6d 65 0a 73 74 61 74 69 | 73 74 69 63 73 20 61 62 |me.stati|stics ab|
|000001d0| 6f 75 74 20 61 20 6e 65 | 77 73 67 72 6f 75 70 20 |out a ne|wsgroup |
|000001e0| 61 6e 64 20 70 72 69 6e | 74 20 74 68 65 20 73 75 |and prin|t the su|
|000001f0| 62 6a 65 63 74 73 20 6f | 66 20 74 68 65 20 6c 61 |bjects o|f the la|
|00000200| 73 74 20 31 30 0a 61 72 | 74 69 63 6c 65 73 3a 0a |st 10.ar|ticles:.|
|00000210| 0a 5c 73 6d 61 6c 6c 7b | 0a 5c 62 65 67 69 6e 7b |.\small{|.\begin{|
|00000220| 76 65 72 62 61 74 69 6d | 7d 0a 3e 3e 3e 20 73 20 |verbatim|}.>>> s |
|00000230| 3d 20 4e 4e 54 50 28 27 | 6e 65 77 73 2e 63 77 69 |= NNTP('|news.cwi|
|00000240| 2e 6e 6c 27 29 0a 3e 3e | 3e 20 72 65 73 70 2c 20 |.nl').>>|> resp, |
|00000250| 63 6f 75 6e 74 2c 20 66 | 69 72 73 74 2c 20 6c 61 |count, f|irst, la|
|00000260| 73 74 2c 20 6e 61 6d 65 | 20 3d 20 73 2e 67 72 6f |st, name| = s.gro|
|00000270| 75 70 28 27 63 6f 6d 70 | 2e 6c 61 6e 67 2e 70 79 |up('comp|.lang.py|
|00000280| 74 68 6f 6e 27 29 0a 3e | 3e 3e 20 70 72 69 6e 74 |thon').>|>> print|
|00000290| 20 27 47 72 6f 75 70 27 | 2c 20 6e 61 6d 65 2c 20 | 'Group'|, name, |
|000002a0| 27 68 61 73 27 2c 20 63 | 6f 75 6e 74 2c 20 27 61 |'has', c|ount, 'a|
|000002b0| 72 74 69 63 6c 65 73 2c | 20 72 61 6e 67 65 27 2c |rticles,| range',|
|000002c0| 20 66 69 72 73 74 2c 20 | 27 74 6f 27 2c 20 6c 61 | first, |'to', la|
|000002d0| 73 74 0a 47 72 6f 75 70 | 20 63 6f 6d 70 2e 6c 61 |st.Group| comp.la|
|000002e0| 6e 67 2e 70 79 74 68 6f | 6e 20 68 61 73 20 35 39 |ng.pytho|n has 59|
|000002f0| 20 61 72 74 69 63 6c 65 | 73 2c 20 72 61 6e 67 65 | article|s, range|
|00000300| 20 33 37 34 32 20 74 6f | 20 33 38 30 33 0a 3e 3e | 3742 to| 3803.>>|
|00000310| 3e 20 72 65 73 70 2c 20 | 73 75 62 73 20 3d 20 73 |> resp, |subs = s|
|00000320| 2e 78 68 64 72 28 27 73 | 75 62 6a 65 63 74 27 2c |.xhdr('s|ubject',|
|00000330| 20 66 69 72 73 74 20 2b | 20 27 2d 27 20 2b 20 6c | first +| '-' + l|
|00000340| 61 73 74 29 0a 3e 3e 3e | 20 66 6f 72 20 69 64 2c |ast).>>>| for id,|
|00000350| 20 73 75 62 20 69 6e 20 | 73 75 62 73 5b 2d 31 30 | sub in |subs[-10|
|00000360| 3a 5d 3a 20 70 72 69 6e | 74 20 69 64 2c 20 73 75 |:]: prin|t id, su|
|00000370| 62 0a 2e 2e 2e 20 0a 33 | 37 39 32 20 52 65 3a 20 |b.... .3|792 Re: |
|00000380| 52 65 6d 6f 76 69 6e 67 | 20 65 6c 65 6d 65 6e 74 |Removing| element|
|00000390| 73 20 66 72 6f 6d 20 61 | 20 6c 69 73 74 20 77 68 |s from a| list wh|
|000003a0| 69 6c 65 20 69 74 65 72 | 61 74 69 6e 67 2e 2e 2e |ile iter|ating...|
|000003b0| 0a 33 37 39 33 20 52 65 | 3a 20 57 68 6f 20 6c 69 |.3793 Re|: Who li|
|000003c0| 6b 65 73 20 49 6e 66 6f | 20 66 69 6c 65 73 3f 0a |kes Info| files?.|
|000003d0| 33 37 39 34 20 45 6d 61 | 63 73 20 61 6e 64 20 64 |3794 Ema|cs and d|
|000003e0| 6f 63 20 73 74 72 69 6e | 67 73 0a 33 37 39 35 20 |oc strin|gs.3795 |
|000003f0| 61 20 66 65 77 20 71 75 | 65 73 74 69 6f 6e 73 20 |a few qu|estions |
|00000400| 61 62 6f 75 74 20 74 68 | 65 20 4d 61 63 20 69 6d |about th|e Mac im|
|00000410| 70 6c 65 6d 65 6e 74 61 | 74 69 6f 6e 0a 33 37 39 |plementa|tion.379|
|00000420| 36 20 52 65 3a 20 65 78 | 65 63 75 74 61 62 6c 65 |6 Re: ex|ecutable|
|00000430| 20 70 79 74 68 6f 6e 20 | 73 63 72 69 70 74 73 0a | python |scripts.|
|00000440| 33 37 39 37 20 52 65 3a | 20 65 78 65 63 75 74 61 |3797 Re:| executa|
|00000450| 62 6c 65 20 70 79 74 68 | 6f 6e 20 73 63 72 69 70 |ble pyth|on scrip|
|00000460| 74 73 0a 33 37 39 38 20 | 52 65 3a 20 61 20 66 65 |ts.3798 |Re: a fe|
|00000470| 77 20 71 75 65 73 74 69 | 6f 6e 73 20 61 62 6f 75 |w questi|ons abou|
|00000480| 74 20 74 68 65 20 4d 61 | 63 20 69 6d 70 6c 65 6d |t the Ma|c implem|
|00000490| 65 6e 74 61 74 69 6f 6e | 20 0a 33 37 39 39 20 52 |entation| .3799 R|
|000004a0| 65 3a 20 50 52 4f 50 4f | 53 41 4c 3a 20 41 20 47 |e: PROPO|SAL: A G|
|000004b0| 65 6e 65 72 69 63 20 50 | 79 74 68 6f 6e 20 4f 62 |eneric P|ython Ob|
|000004c0| 6a 65 63 74 20 49 6e 74 | 65 72 66 61 63 65 20 66 |ject Int|erface f|
|000004d0| 6f 72 20 50 79 74 68 6f | 6e 20 43 20 4d 6f 64 75 |or Pytho|n C Modu|
|000004e0| 6c 65 73 0a 33 38 30 32 | 20 52 65 3a 20 65 78 65 |les.3802| Re: exe|
|000004f0| 63 75 74 61 62 6c 65 20 | 70 79 74 68 6f 6e 20 73 |cutable |python s|
|00000500| 63 72 69 70 74 73 20 0a | 33 38 30 33 20 52 65 3a |cripts .|3803 Re:|
|00000510| 20 50 4f 53 49 58 20 77 | 61 69 74 20 61 6e 64 20 | POSIX w|ait and |
|00000520| 53 49 47 43 48 4c 44 0a | 3e 3e 3e 20 73 2e 71 75 |SIGCHLD.|>>> s.qu|
|00000530| 69 74 28 29 0a 27 32 30 | 35 20 6e 65 77 73 2e 63 |it().'20|5 news.c|
|00000540| 77 69 2e 6e 6c 20 63 6c | 6f 73 69 6e 67 20 63 6f |wi.nl cl|osing co|
|00000550| 6e 6e 65 63 74 69 6f 6e | 2e 20 20 47 6f 6f 64 62 |nnection|.  Goodb|
|00000560| 79 65 2e 27 0a 3e 3e 3e | 20 0a 5c 65 6e 64 7b 76 |ye.'.>>>| .\end{v|
|00000570| 65 72 62 61 74 69 6d 7d | 0a 7d 0a 0a 54 6f 20 70 |erbatim}|.}..To p|
|00000580| 6f 73 74 20 61 6e 20 61 | 72 74 69 63 6c 65 20 66 |ost an a|rticle f|
|00000590| 72 6f 6d 20 61 20 66 69 | 6c 65 20 28 74 68 69 73 |rom a fi|le (this|
|000005a0| 20 61 73 73 75 6d 65 73 | 20 74 68 61 74 20 74 68 | assumes| that th|
|000005b0| 65 20 61 72 74 69 63 6c | 65 20 68 61 73 0a 76 61 |e articl|e has.va|
|000005c0| 6c 69 64 20 68 65 61 64 | 65 72 73 29 3a 0a 0a 5c |lid head|ers):..\|
|000005d0| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|000005e0| 3e 3e 3e 20 73 20 3d 20 | 4e 4e 54 50 28 27 6e 65 |>>> s = |NNTP('ne|
|000005f0| 77 73 2e 63 77 69 2e 6e | 6c 27 29 0a 3e 3e 3e 20 |ws.cwi.n|l').>>> |
|00000600| 66 20 3d 20 6f 70 65 6e | 28 27 2f 74 6d 70 2f 61 |f = open|('/tmp/a|
|00000610| 72 74 69 63 6c 65 27 29 | 0a 3e 3e 3e 20 73 2e 70 |rticle')|.>>> s.p|
|00000620| 6f 73 74 28 66 29 0a 27 | 32 34 30 20 41 72 74 69 |ost(f).'|240 Arti|
|00000630| 63 6c 65 20 70 6f 73 74 | 65 64 20 73 75 63 63 65 |cle post|ed succe|
|00000640| 73 73 66 75 6c 6c 79 2e | 27 0a 3e 3e 3e 20 73 2e |ssfully.|'.>>> s.|
|00000650| 71 75 69 74 28 29 0a 27 | 32 30 35 20 6e 65 77 73 |quit().'|205 news|
|00000660| 2e 63 77 69 2e 6e 6c 20 | 63 6c 6f 73 69 6e 67 20 |.cwi.nl |closing |
|00000670| 63 6f 6e 6e 65 63 74 69 | 6f 6e 2e 20 20 47 6f 6f |connecti|on.  Goo|
|00000680| 64 62 79 65 2e 27 0a 3e | 3e 3e 20 0a 5c 65 6e 64 |dbye.'.>|>> .\end|
|00000690| 7b 76 65 72 62 61 74 69 | 6d 7d 0a 0a 54 68 65 20 |{verbati|m}..The |
|000006a0| 6d 6f 64 75 6c 65 20 69 | 74 73 65 6c 66 20 64 65 |module i|tself de|
|000006b0| 66 69 6e 65 73 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |fines th|e follow|
|000006c0| 69 6e 67 20 69 74 65 6d | 73 3a 0a 0a 5c 62 65 67 |ing item|s:..\beg|
|000006d0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 4e 4e 54 |in{funcd|esc}{NNT|
|000006e0| 50 7d 7b 68 6f 73 74 5c | 6f 70 74 69 6f 6e 61 6c |P}{host\|optional|
|000006f0| 7b 5c 2c 20 70 6f 72 74 | 7d 7d 0a 52 65 74 75 72 |{\, port|}}.Retur|
|00000700| 6e 20 61 20 6e 65 77 20 | 69 6e 73 74 61 6e 63 65 |n a new |instance|
|00000710| 20 6f 66 20 74 68 65 20 | 5c 63 6f 64 65 7b 4e 4e | of the |\code{NN|
|00000720| 54 50 7d 20 63 6c 61 73 | 73 2c 20 72 65 70 72 65 |TP} clas|s, repre|
|00000730| 73 65 6e 74 69 6e 67 20 | 61 0a 63 6f 6e 6e 65 63 |senting |a.connec|
|00000740| 74 69 6f 6e 20 74 6f 20 | 74 68 65 20 4e 4e 54 50 |tion to |the NNTP|
|00000750| 20 73 65 72 76 65 72 20 | 72 75 6e 6e 69 6e 67 20 | server |running |
|00000760| 6f 6e 20 68 6f 73 74 20 | 5c 76 61 72 7b 68 6f 73 |on host |\var{hos|
|00000770| 74 7d 2c 20 6c 69 73 74 | 65 6e 69 6e 67 20 61 74 |t}, list|ening at|
|00000780| 0a 70 6f 72 74 20 5c 76 | 61 72 7b 70 6f 72 74 7d |.port \v|ar{port}|
|00000790| 2e 20 20 54 68 65 20 64 | 65 66 61 75 6c 74 20 5c |.  The d|efault \|
|000007a0| 76 61 72 7b 70 6f 72 74 | 7d 20 69 73 20 31 31 39 |var{port|} is 119|
|000007b0| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|000007c0| 0a 0a 5c 62 65 67 69 6e | 7b 65 78 63 64 65 73 63 |..\begin|{excdesc|
|000007d0| 7d 7b 65 72 72 6f 72 5f | 72 65 70 6c 79 7d 0a 45 |}{error_|reply}.E|
|000007e0| 78 63 65 70 74 69 6f 6e | 20 72 61 69 73 65 64 20 |xception| raised |
|000007f0| 77 68 65 6e 20 61 6e 20 | 75 6e 65 78 70 65 63 74 |when an |unexpect|
|00000800| 65 64 20 72 65 70 6c 79 | 20 69 73 20 72 65 63 65 |ed reply| is rece|
|00000810| 69 76 65 64 20 66 72 6f | 6d 20 74 68 65 20 73 65 |ived fro|m the se|
|00000820| 72 76 65 72 2e 0a 5c 65 | 6e 64 7b 65 78 63 64 65 |rver..\e|nd{excde|
|00000830| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 65 78 63 64 |sc}..\be|gin{excd|
|00000840| 65 73 63 7d 7b 65 72 72 | 6f 72 5f 74 65 6d 70 7d |esc}{err|or_temp}|
|00000850| 0a 45 78 63 65 70 74 69 | 6f 6e 20 72 61 69 73 65 |.Excepti|on raise|
|00000860| 64 20 77 68 65 6e 20 61 | 6e 20 65 72 72 6f 72 20 |d when a|n error |
|00000870| 63 6f 64 65 20 69 6e 20 | 74 68 65 20 72 61 6e 67 |code in |the rang|
|00000880| 65 20 34 30 30 2d 2d 34 | 39 39 20 69 73 20 72 65 |e 400--4|99 is re|
|00000890| 63 65 69 76 65 64 2e 0a | 5c 65 6e 64 7b 65 78 63 |ceived..|\end{exc|
|000008a0| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 65 78 |desc}..\|begin{ex|
|000008b0| 63 64 65 73 63 7d 7b 65 | 72 72 6f 72 5f 70 65 72 |cdesc}{e|rror_per|
|000008c0| 6d 7d 0a 45 78 63 65 70 | 74 69 6f 6e 20 72 61 69 |m}.Excep|tion rai|
|000008d0| 73 65 64 20 77 68 65 6e | 20 61 6e 20 65 72 72 6f |sed when| an erro|
|000008e0| 72 20 63 6f 64 65 20 69 | 6e 20 74 68 65 20 72 61 |r code i|n the ra|
|000008f0| 6e 67 65 20 35 30 30 2d | 2d 35 39 39 20 69 73 20 |nge 500-|-599 is |
|00000900| 72 65 63 65 69 76 65 64 | 2e 0a 5c 65 6e 64 7b 65 |received|..\end{e|
|00000910| 78 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |xcdesc}.|.\begin{|
|00000920| 65 78 63 64 65 73 63 7d | 7b 65 72 72 6f 72 5f 70 |excdesc}|{error_p|
|00000930| 72 6f 74 6f 7d 0a 45 78 | 63 65 70 74 69 6f 6e 20 |roto}.Ex|ception |
|00000940| 72 61 69 73 65 64 20 77 | 68 65 6e 20 61 20 72 65 |raised w|hen a re|
|00000950| 70 6c 79 20 69 73 20 72 | 65 63 65 69 76 65 64 20 |ply is r|eceived |
|00000960| 66 72 6f 6d 20 74 68 65 | 20 73 65 72 76 65 72 20 |from the| server |
|00000970| 74 68 61 74 20 64 6f 65 | 73 0a 6e 6f 74 20 62 65 |that doe|s.not be|
|00000980| 67 69 6e 20 77 69 74 68 | 20 61 20 64 69 67 69 74 |gin with| a digit|
|00000990| 20 69 6e 20 74 68 65 20 | 72 61 6e 67 65 20 31 2d | in the |range 1-|
|000009a0| 2d 35 2e 0a 5c 65 6e 64 | 7b 65 78 63 64 65 73 63 |-5..\end|{excdesc|
|000009b0| 7d 0a 0a 5c 73 75 62 73 | 65 63 74 69 6f 6e 7b 4e |}..\subs|ection{N|
|000009c0| 4e 54 50 20 4f 62 6a 65 | 63 74 73 7d 0a 0a 4e 4e |NTP Obje|cts}..NN|
|000009d0| 54 50 20 69 6e 73 74 61 | 6e 63 65 73 20 68 61 76 |TP insta|nces hav|
|000009e0| 65 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |e the fo|llowing |
|000009f0| 6d 65 74 68 6f 64 73 2e | 20 20 54 68 65 20 5c 76 |methods.|  The \v|
|00000a00| 61 72 7b 72 65 73 70 6f | 6e 73 65 7d 20 74 68 61 |ar{respo|nse} tha|
|00000a10| 74 20 69 73 0a 72 65 74 | 75 72 6e 65 64 20 61 73 |t is.ret|urned as|
|00000a20| 20 74 68 65 20 66 69 72 | 73 74 20 69 74 65 6d 20 | the fir|st item |
|00000a30| 69 6e 20 74 68 65 20 72 | 65 74 75 72 6e 20 74 75 |in the r|eturn tu|
|00000a40| 70 6c 65 20 6f 66 20 61 | 6c 6d 6f 73 74 20 61 6c |ple of a|lmost al|
|00000a50| 6c 20 6d 65 74 68 6f 64 | 73 0a 69 73 20 74 68 65 |l method|s.is the|
|00000a60| 20 73 65 72 76 65 72 27 | 73 20 72 65 73 70 6f 6e | server'|s respon|
|00000a70| 73 65 3a 20 61 20 73 74 | 72 69 6e 67 20 62 65 67 |se: a st|ring beg|
|00000a80| 69 6e 6e 69 6e 67 20 77 | 69 74 68 20 61 20 74 68 |inning w|ith a th|
|00000a90| 72 65 65 2d 64 69 67 69 | 74 20 63 6f 64 65 2e 0a |ree-digi|t code..|
|00000aa0| 49 66 20 74 68 65 20 73 | 65 72 76 65 72 27 73 20 |If the s|erver's |
|00000ab0| 72 65 73 70 6f 6e 73 65 | 20 69 6e 64 69 63 61 74 |response| indicat|
|00000ac0| 65 73 20 61 6e 20 65 72 | 72 6f 72 2c 20 74 68 65 |es an er|ror, the|
|00000ad0| 20 6d 65 74 68 6f 64 20 | 72 61 69 73 65 73 20 6f | method |raises o|
|00000ae0| 6e 65 20 6f 66 0a 74 68 | 65 20 61 62 6f 76 65 20 |ne of.th|e above |
|00000af0| 65 78 63 65 70 74 69 6f | 6e 73 2e 0a 0a 5c 72 65 |exceptio|ns...\re|
|00000b00| 6e 65 77 63 6f 6d 6d 61 | 6e 64 7b 5c 69 6e 64 65 |newcomma|nd{\inde|
|00000b10| 78 73 75 62 69 74 65 6d | 7d 7b 28 4e 4e 54 50 20 |xsubitem|}{(NNTP |
|00000b20| 6f 62 6a 65 63 74 20 6d | 65 74 68 6f 64 29 7d 0a |object m|ethod)}.|
|00000b30| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000b40| 7d 7b 67 65 74 77 65 6c | 63 6f 6d 65 7d 7b 7d 0a |}{getwel|come}{}.|
|00000b50| 52 65 74 75 72 6e 20 74 | 68 65 20 77 65 6c 63 6f |Return t|he welco|
|00000b60| 6d 65 20 6d 65 73 73 61 | 67 65 20 73 65 6e 74 20 |me messa|ge sent |
|00000b70| 62 79 20 74 68 65 20 73 | 65 72 76 65 72 20 69 6e |by the s|erver in|
|00000b80| 20 72 65 70 6c 79 20 74 | 6f 20 74 68 65 20 69 6e | reply t|o the in|
|00000b90| 69 74 69 61 6c 0a 63 6f | 6e 6e 65 63 74 69 6f 6e |itial.co|nnection|
|00000ba0| 2e 20 20 28 54 68 69 73 | 20 6d 65 73 73 61 67 65 |.  (This| message|
|00000bb0| 20 73 6f 6d 65 74 69 6d | 65 73 20 63 6f 6e 74 61 | sometim|es conta|
|00000bc0| 69 6e 73 20 64 69 73 63 | 6c 61 69 6d 65 72 73 20 |ins disc|laimers |
|00000bd0| 6f 72 20 68 65 6c 70 0a | 69 6e 66 6f 72 6d 61 74 |or help.|informat|
|00000be0| 69 6f 6e 20 74 68 61 74 | 20 6d 61 79 20 62 65 20 |ion that| may be |
|00000bf0| 72 65 6c 65 76 61 6e 74 | 20 74 6f 20 74 68 65 20 |relevant| to the |
|00000c00| 75 73 65 72 2e 29 0a 5c | 65 6e 64 7b 66 75 6e 63 |user.).\|end{func|
|00000c10| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000c20| 6e 63 64 65 73 63 7d 7b | 73 65 74 5f 64 65 62 75 |ncdesc}{|set_debu|
|00000c30| 67 6c 65 76 65 6c 7d 7b | 6c 65 76 65 6c 7d 0a 53 |glevel}{|level}.S|
|00000c40| 65 74 20 74 68 65 20 69 | 6e 73 74 61 6e 63 65 27 |et the i|nstance'|
|00000c50| 73 20 64 65 62 75 67 67 | 69 6e 67 20 6c 65 76 65 |s debugg|ing leve|
|00000c60| 6c 2e 20 20 54 68 69 73 | 20 63 6f 6e 74 72 6f 6c |l.  This| control|
|00000c70| 73 20 74 68 65 20 61 6d | 6f 75 6e 74 20 6f 66 0a |s the am|ount of.|
|00000c80| 64 65 62 75 67 67 69 6e | 67 20 6f 75 74 70 75 74 |debuggin|g output|
|00000c90| 20 70 72 69 6e 74 65 64 | 2e 20 20 54 68 65 20 64 | printed|.  The d|
|00000ca0| 65 66 61 75 6c 74 2c 20 | 30 2c 20 70 72 6f 64 75 |efault, |0, produ|
|00000cb0| 63 65 73 20 6e 6f 20 64 | 65 62 75 67 67 69 6e 67 |ces no d|ebugging|
|00000cc0| 0a 6f 75 74 70 75 74 2e | 20 20 41 20 76 61 6c 75 |.output.|  A valu|
|00000cd0| 65 20 6f 66 20 31 20 70 | 72 6f 64 75 63 65 73 20 |e of 1 p|roduces |
|00000ce0| 61 20 6d 6f 64 65 72 61 | 74 65 20 61 6d 6f 75 6e |a modera|te amoun|
|00000cf0| 74 20 6f 66 20 64 65 62 | 75 67 67 69 6e 67 20 6f |t of deb|ugging o|
|00000d00| 75 74 70 75 74 2c 0a 67 | 65 6e 65 72 61 6c 6c 79 |utput,.g|enerally|
|00000d10| 20 61 20 73 69 6e 67 6c | 65 20 6c 69 6e 65 20 70 | a singl|e line p|
|00000d20| 65 72 20 72 65 71 75 65 | 73 74 20 6f 72 20 72 65 |er reque|st or re|
|00000d30| 73 70 6f 6e 73 65 2e 20 | 20 41 20 76 61 6c 75 65 |sponse. | A value|
|00000d40| 20 6f 66 20 32 20 6f 72 | 0a 68 69 67 68 65 72 20 | of 2 or|.higher |
|00000d50| 70 72 6f 64 75 63 65 73 | 20 74 68 65 20 6d 61 78 |produces| the max|
|00000d60| 69 6d 75 6d 20 61 6d 6f | 75 6e 74 20 6f 66 20 64 |imum amo|unt of d|
|00000d70| 65 62 75 67 67 69 6e 67 | 20 6f 75 74 70 75 74 2c |ebugging| output,|
|00000d80| 20 6c 6f 67 67 69 6e 67 | 20 65 61 63 68 0a 6c 69 | logging| each.li|
|00000d90| 6e 65 20 73 65 6e 74 20 | 61 6e 64 20 72 65 63 65 |ne sent |and rece|
|00000da0| 69 76 65 64 20 6f 6e 20 | 74 68 65 20 63 6f 6e 6e |ived on |the conn|
|00000db0| 65 63 74 69 6f 6e 20 28 | 69 6e 63 6c 75 64 69 6e |ection (|includin|
|00000dc0| 67 20 6d 65 73 73 61 67 | 65 20 74 65 78 74 29 2e |g messag|e text).|
|00000dd0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00000de0| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000df0| 7d 7b 6e 65 77 67 72 6f | 75 70 73 7d 7b 64 61 74 |}{newgro|ups}{dat|
|00000e00| 65 5c 2c 20 74 69 6d 65 | 7d 0a 53 65 6e 64 20 61 |e\, time|}.Send a|
|00000e10| 20 5c 73 61 6d 70 7b 4e | 45 57 47 52 4f 55 50 53 | \samp{N|EWGROUPS|
|00000e20| 7d 20 63 6f 6d 6d 61 6e | 64 2e 20 20 54 68 65 20 |} comman|d.  The |
|00000e30| 5c 76 61 72 7b 64 61 74 | 65 7d 20 61 72 67 75 6d |\var{dat|e} argum|
|00000e40| 65 6e 74 20 73 68 6f 75 | 6c 64 20 62 65 20 61 0a |ent shou|ld be a.|
|00000e50| 73 74 72 69 6e 67 20 6f | 66 20 74 68 65 20 66 6f |string o|f the fo|
|00000e60| 72 6d 20 5c 63 6f 64 65 | 7b 22 5c 76 61 72 7b 79 |rm \code|{"\var{y|
|00000e70| 79 7d 5c 76 61 72 7b 6d | 6d 7d 5c 76 61 72 7b 64 |y}\var{m|m}\var{d|
|00000e80| 64 7d 22 7d 20 69 6e 64 | 69 63 61 74 69 6e 67 20 |d}"} ind|icating |
|00000e90| 74 68 65 0a 64 61 74 65 | 2c 20 61 6e 64 20 5c 76 |the.date|, and \v|
|00000ea0| 61 72 7b 74 69 6d 65 7d | 20 73 68 6f 75 6c 64 20 |ar{time}| should |
|00000eb0| 62 65 20 61 20 73 74 72 | 69 6e 67 20 6f 66 20 74 |be a str|ing of t|
|00000ec0| 68 65 20 66 6f 72 6d 0a | 5c 63 6f 64 65 7b 22 5c |he form.|\code{"\|
|00000ed0| 76 61 72 7b 68 68 7d 5c | 76 61 72 7b 6d 6d 7d 5c |var{hh}\|var{mm}\|
|00000ee0| 76 61 72 7b 73 73 7d 22 | 7d 20 69 6e 64 69 63 61 |var{ss}"|} indica|
|00000ef0| 74 69 6e 67 20 74 68 65 | 20 74 69 6d 65 2e 20 20 |ting the| time.  |
|00000f00| 52 65 74 75 72 6e 20 61 | 20 70 61 69 72 0a 5c 63 |Return a| pair.\c|
|00000f10| 6f 64 65 7b 28 5c 76 61 | 72 7b 72 65 73 70 6f 6e |ode{(\va|r{respon|
|00000f20| 73 65 7d 2c 20 5c 76 61 | 72 7b 67 72 6f 75 70 73 |se}, \va|r{groups|
|00000f30| 7d 29 7d 20 77 68 65 72 | 65 20 5c 76 61 72 7b 67 |})} wher|e \var{g|
|00000f40| 72 6f 75 70 73 7d 20 69 | 73 20 61 20 6c 69 73 74 |roups} i|s a list|
|00000f50| 20 6f 66 0a 67 72 6f 75 | 70 20 6e 61 6d 65 73 20 | of.grou|p names |
|00000f60| 74 68 61 74 20 61 72 65 | 20 6e 65 77 20 73 69 6e |that are| new sin|
|00000f70| 63 65 20 74 68 65 20 67 | 69 76 65 6e 20 64 61 74 |ce the g|iven dat|
|00000f80| 65 20 61 6e 64 20 74 69 | 6d 65 2e 0a 5c 65 6e 64 |e and ti|me..\end|
|00000f90| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00000fa0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 6e 65 77 |in{funcd|esc}{new|
|00000fb0| 6e 65 77 73 7d 7b 67 72 | 6f 75 70 5c 2c 20 64 61 |news}{gr|oup\, da|
|00000fc0| 74 65 5c 2c 20 74 69 6d | 65 7d 0a 53 65 6e 64 20 |te\, tim|e}.Send |
|00000fd0| 61 20 5c 73 61 6d 70 7b | 4e 45 57 4e 45 57 53 7d |a \samp{|NEWNEWS}|
|00000fe0| 20 63 6f 6d 6d 61 6e 64 | 2e 20 20 48 65 72 65 2c | command|.  Here,|
|00000ff0| 20 5c 76 61 72 7b 67 72 | 6f 75 70 7d 20 69 73 20 | \var{gr|oup} is |
|00001000| 61 20 67 72 6f 75 70 20 | 6e 61 6d 65 20 6f 72 0a |a group |name or.|
|00001010| 5c 63 6f 64 65 7b 22 2a | 22 7d 2c 20 61 6e 64 20 |\code{"*|"}, and |
|00001020| 5c 76 61 72 7b 64 61 74 | 65 7d 20 61 6e 64 20 5c |\var{dat|e} and \|
|00001030| 76 61 72 7b 74 69 6d 65 | 7d 20 68 61 76 65 20 74 |var{time|} have t|
|00001040| 68 65 20 73 61 6d 65 20 | 6d 65 61 6e 69 6e 67 20 |he same |meaning |
|00001050| 61 73 20 66 6f 72 0a 5c | 63 6f 64 65 7b 6e 65 77 |as for.\|code{new|
|00001060| 67 72 6f 75 70 73 28 29 | 7d 2e 20 20 52 65 74 75 |groups()|}.  Retu|
|00001070| 72 6e 20 61 20 70 61 69 | 72 20 5c 63 6f 64 65 7b |rn a pai|r \code{|
|00001080| 28 5c 76 61 72 7b 72 65 | 73 70 6f 6e 73 65 7d 2c |(\var{re|sponse},|
|00001090| 0a 5c 76 61 72 7b 61 72 | 74 69 63 6c 65 73 7d 29 |.\var{ar|ticles})|
|000010a0| 7d 20 77 68 65 72 65 20 | 5c 76 61 72 7b 61 72 74 |} where |\var{art|
|000010b0| 69 63 6c 65 73 7d 20 69 | 73 20 61 20 6c 69 73 74 |icles} i|s a list|
|000010c0| 20 6f 66 20 61 72 74 69 | 63 6c 65 20 69 64 73 2e | of arti|cle ids.|
|000010d0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|000010e0| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000010f0| 7d 7b 6c 69 73 74 7d 7b | 7d 0a 53 65 6e 64 20 61 |}{list}{|}.Send a|
|00001100| 20 5c 73 61 6d 70 7b 4c | 49 53 54 7d 20 63 6f 6d | \samp{L|IST} com|
|00001110| 6d 61 6e 64 2e 20 20 52 | 65 74 75 72 6e 20 61 20 |mand.  R|eturn a |
|00001120| 70 61 69 72 20 5c 63 6f | 64 65 7b 28 5c 76 61 72 |pair \co|de{(\var|
|00001130| 7b 72 65 73 70 6f 6e 73 | 65 7d 2c 0a 5c 76 61 72 |{respons|e},.\var|
|00001140| 7b 6c 69 73 74 7d 29 7d | 20 77 68 65 72 65 20 5c |{list})}| where \|
|00001150| 76 61 72 7b 6c 69 73 74 | 7d 20 69 73 20 61 20 6c |var{list|} is a l|
|00001160| 69 73 74 20 6f 66 20 74 | 75 70 6c 65 73 2e 20 20 |ist of t|uples.  |
|00001170| 45 61 63 68 20 74 75 70 | 6c 65 20 68 61 73 20 74 |Each tup|le has t|
|00001180| 68 65 0a 66 6f 72 6d 20 | 5c 63 6f 64 65 7b 28 5c |he.form |\code{(\|
|00001190| 76 61 72 7b 67 72 6f 75 | 70 7d 2c 20 5c 76 61 72 |var{grou|p}, \var|
|000011a0| 7b 6c 61 73 74 7d 2c 20 | 5c 76 61 72 7b 66 69 72 |{last}, |\var{fir|
|000011b0| 73 74 7d 2c 20 5c 76 61 | 72 7b 66 6c 61 67 7d 29 |st}, \va|r{flag})|
|000011c0| 7d 2c 20 77 68 65 72 65 | 0a 5c 76 61 72 7b 67 72 |}, where|.\var{gr|
|000011d0| 6f 75 70 7d 20 69 73 20 | 61 20 67 72 6f 75 70 20 |oup} is |a group |
|000011e0| 6e 61 6d 65 2c 20 5c 76 | 61 72 7b 6c 61 73 74 7d |name, \v|ar{last}|
|000011f0| 20 61 6e 64 20 5c 76 61 | 72 7b 66 69 72 73 74 7d | and \va|r{first}|
|00001200| 20 61 72 65 20 74 68 65 | 20 6c 61 73 74 0a 61 6e | are the| last.an|
|00001210| 64 20 66 69 72 73 74 20 | 61 72 74 69 63 6c 65 20 |d first |article |
|00001220| 6e 75 6d 62 65 72 73 20 | 28 61 73 20 73 74 72 69 |numbers |(as stri|
|00001230| 6e 67 73 29 2c 20 61 6e | 64 20 5c 76 61 72 7b 66 |ngs), an|d \var{f|
|00001240| 6c 61 67 7d 20 69 73 20 | 5c 63 6f 64 65 7b 27 79 |lag} is |\code{'y|
|00001250| 27 7d 0a 69 66 20 70 6f | 73 74 69 6e 67 20 69 73 |'}.if po|sting is|
|00001260| 20 61 6c 6c 6f 77 65 64 | 2c 20 5c 63 6f 64 65 7b | allowed|, \code{|
|00001270| 27 6e 27 7d 20 69 66 20 | 6e 6f 74 2c 20 61 6e 64 |'n'} if |not, and|
|00001280| 20 5c 63 6f 64 65 7b 27 | 6d 27 7d 20 69 66 20 74 | \code{'|m'} if t|
|00001290| 68 65 0a 6e 65 77 73 67 | 72 6f 75 70 20 69 73 20 |he.newsg|roup is |
|000012a0| 6d 6f 64 65 72 61 74 65 | 64 2e 20 20 28 4e 6f 74 |moderate|d.  (Not|
|000012b0| 65 20 74 68 65 20 6f 72 | 64 65 72 69 6e 67 3a 20 |e the or|dering: |
|000012c0| 5c 76 61 72 7b 6c 61 73 | 74 7d 2c 20 5c 76 61 72 |\var{las|t}, \var|
|000012d0| 7b 66 69 72 73 74 7d 2e | 29 0a 5c 65 6e 64 7b 66 |{first}.|).\end{f|
|000012e0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000012f0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 67 72 6f 75 70 |{funcdes|c}{group|
|00001300| 7d 7b 6e 61 6d 65 7d 0a | 53 65 6e 64 20 61 20 5c |}{name}.|Send a \|
|00001310| 73 61 6d 70 7b 47 52 4f | 55 50 7d 20 63 6f 6d 6d |samp{GRO|UP} comm|
|00001320| 61 6e 64 2c 20 77 68 65 | 72 65 20 5c 76 61 72 7b |and, whe|re \var{|
|00001330| 6e 61 6d 65 7d 20 69 73 | 20 74 68 65 20 67 72 6f |name} is| the gro|
|00001340| 75 70 20 6e 61 6d 65 2e | 0a 52 65 74 75 72 6e 20 |up name.|.Return |
|00001350| 61 20 74 75 70 6c 65 20 | 5c 63 6f 64 65 7b 28 5c |a tuple |\code{(\|
|00001360| 76 61 72 7b 72 65 73 70 | 6f 6e 73 65 7d 2c 20 5c |var{resp|onse}, \|
|00001370| 76 61 72 7b 63 6f 75 6e | 74 7d 2c 20 5c 76 61 72 |var{coun|t}, \var|
|00001380| 7b 66 69 72 73 74 7d 2c | 0a 5c 76 61 72 7b 6c 61 |{first},|.\var{la|
|00001390| 73 74 7d 2c 20 5c 76 61 | 72 7b 6e 61 6d 65 7d 29 |st}, \va|r{name})|
|000013a0| 7d 20 77 68 65 72 65 20 | 5c 76 61 72 7b 63 6f 75 |} where |\var{cou|
|000013b0| 6e 74 7d 20 69 73 20 74 | 68 65 20 28 65 73 74 69 |nt} is t|he (esti|
|000013c0| 6d 61 74 65 64 29 20 6e | 75 6d 62 65 72 0a 6f 66 |mated) n|umber.of|
|000013d0| 20 61 72 74 69 63 6c 65 | 73 20 69 6e 20 74 68 65 | article|s in the|
|000013e0| 20 67 72 6f 75 70 2c 20 | 5c 76 61 72 7b 66 69 72 | group, |\var{fir|
|000013f0| 73 74 7d 20 69 73 20 74 | 68 65 20 66 69 72 73 74 |st} is t|he first|
|00001400| 20 61 72 74 69 63 6c 65 | 20 6e 75 6d 62 65 72 20 | article| number |
|00001410| 69 6e 0a 74 68 65 20 67 | 72 6f 75 70 2c 20 5c 76 |in.the g|roup, \v|
|00001420| 61 72 7b 6c 61 73 74 7d | 20 69 73 20 74 68 65 20 |ar{last}| is the |
|00001430| 6c 61 73 74 20 61 72 74 | 69 63 6c 65 20 6e 75 6d |last art|icle num|
|00001440| 62 65 72 20 69 6e 20 74 | 68 65 20 67 72 6f 75 70 |ber in t|he group|
|00001450| 2c 20 61 6e 64 0a 5c 76 | 61 72 7b 6e 61 6d 65 7d |, and.\v|ar{name}|
|00001460| 20 69 73 20 74 68 65 20 | 67 72 6f 75 70 20 6e 61 | is the |group na|
|00001470| 6d 65 2e 20 20 54 68 65 | 20 6e 75 6d 62 65 72 73 |me.  The| numbers|
|00001480| 20 61 72 65 20 72 65 74 | 75 72 6e 65 64 20 61 73 | are ret|urned as|
|00001490| 20 73 74 72 69 6e 67 73 | 2e 0a 5c 65 6e 64 7b 66 | strings|..\end{f|
|000014a0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000014b0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 68 65 6c 70 7d |{funcdes|c}{help}|
|000014c0| 7b 7d 0a 53 65 6e 64 20 | 61 20 5c 73 61 6d 70 7b |{}.Send |a \samp{|
|000014d0| 48 45 4c 50 7d 20 63 6f | 6d 6d 61 6e 64 2e 20 20 |HELP} co|mmand.  |
|000014e0| 52 65 74 75 72 6e 20 61 | 20 70 61 69 72 20 5c 63 |Return a| pair \c|
|000014f0| 6f 64 65 7b 28 5c 76 61 | 72 7b 72 65 73 70 6f 6e |ode{(\va|r{respon|
|00001500| 73 65 7d 2c 0a 5c 76 61 | 72 7b 6c 69 73 74 7d 29 |se},.\va|r{list})|
|00001510| 7d 20 77 68 65 72 65 20 | 5c 76 61 72 7b 6c 69 73 |} where |\var{lis|
|00001520| 74 7d 20 69 73 20 61 20 | 6c 69 73 74 20 6f 66 20 |t} is a |list of |
|00001530| 68 65 6c 70 20 73 74 72 | 69 6e 67 73 2e 0a 5c 65 |help str|ings..\e|
|00001540| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00001550| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00001560| 74 61 74 7d 7b 69 64 7d | 0a 53 65 6e 64 20 61 20 |tat}{id}|.Send a |
|00001570| 5c 73 61 6d 70 7b 53 54 | 41 54 7d 20 63 6f 6d 6d |\samp{ST|AT} comm|
|00001580| 61 6e 64 2c 20 77 68 65 | 72 65 20 5c 76 61 72 7b |and, whe|re \var{|
|00001590| 69 64 7d 20 69 73 20 74 | 68 65 20 6d 65 73 73 61 |id} is t|he messa|
|000015a0| 67 65 20 69 64 20 28 65 | 6e 63 6c 6f 73 65 64 0a |ge id (e|nclosed.|
|000015b0| 69 6e 20 5c 73 61 6d 70 | 7b 3c 7d 20 61 6e 64 20 |in \samp|{<} and |
|000015c0| 5c 73 61 6d 70 7b 3e 7d | 29 20 6f 72 20 61 6e 20 |\samp{>}|) or an |
|000015d0| 61 72 74 69 63 6c 65 20 | 6e 75 6d 62 65 72 20 28 |article |number (|
|000015e0| 61 73 20 61 20 73 74 72 | 69 6e 67 29 2e 0a 52 65 |as a str|ing)..Re|
|000015f0| 74 75 72 6e 20 61 20 74 | 72 69 70 6c 65 20 5c 63 |turn a t|riple \c|
|00001600| 6f 64 65 7b 28 76 61 72 | 7b 72 65 73 70 6f 6e 73 |ode{(var|{respons|
|00001610| 65 7d 2c 20 5c 76 61 72 | 7b 6e 75 6d 62 65 72 7d |e}, \var|{number}|
|00001620| 2c 20 5c 76 61 72 7b 69 | 64 7d 29 7d 20 77 68 65 |, \var{i|d})} whe|
|00001630| 72 65 0a 5c 76 61 72 7b | 6e 75 6d 62 65 72 7d 20 |re.\var{|number} |
|00001640| 69 73 20 74 68 65 20 61 | 72 74 69 63 6c 65 20 6e |is the a|rticle n|
|00001650| 75 6d 62 65 72 20 28 61 | 73 20 61 20 73 74 72 69 |umber (a|s a stri|
|00001660| 6e 67 29 20 61 6e 64 20 | 5c 76 61 72 7b 69 64 7d |ng) and |\var{id}|
|00001670| 20 69 73 20 74 68 65 0a | 61 72 74 69 63 6c 65 20 | is the.|article |
|00001680| 69 64 20 20 28 65 6e 63 | 6c 6f 73 65 64 20 69 6e |id  (enc|losed in|
|00001690| 20 5c 73 61 6d 70 7b 3c | 7d 20 61 6e 64 20 5c 73 | \samp{<|} and \s|
|000016a0| 61 6d 70 7b 3e 7d 29 2e | 0a 5c 65 6e 64 7b 66 75 |amp{>}).|.\end{fu|
|000016b0| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000016c0| 66 75 6e 63 64 65 73 63 | 7d 7b 6e 65 78 74 7d 7b |funcdesc|}{next}{|
|000016d0| 7d 0a 53 65 6e 64 20 61 | 20 5c 73 61 6d 70 7b 4e |}.Send a| \samp{N|
|000016e0| 45 58 54 7d 20 63 6f 6d | 6d 61 6e 64 2e 20 20 52 |EXT} com|mand.  R|
|000016f0| 65 74 75 72 6e 20 61 73 | 20 66 6f 72 20 5c 63 6f |eturn as| for \co|
|00001700| 64 65 7b 73 74 61 74 28 | 29 7d 2e 0a 5c 65 6e 64 |de{stat(|)}..\end|
|00001710| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00001720| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 6c 61 73 |in{funcd|esc}{las|
|00001730| 74 7d 7b 7d 0a 53 65 6e | 64 20 61 20 5c 73 61 6d |t}{}.Sen|d a \sam|
|00001740| 70 7b 4c 41 53 54 7d 20 | 63 6f 6d 6d 61 6e 64 2e |p{LAST} |command.|
|00001750| 20 20 52 65 74 75 72 6e | 20 61 73 20 66 6f 72 20 |  Return| as for |
|00001760| 5c 63 6f 64 65 7b 73 74 | 61 74 28 29 7d 2e 0a 5c |\code{st|at()}..\|
|00001770| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00001780| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001790| 68 65 61 64 7d 7b 69 64 | 7d 0a 53 65 6e 64 20 61 |head}{id|}.Send a|
|000017a0| 20 5c 73 61 6d 70 7b 48 | 45 41 44 7d 20 63 6f 6d | \samp{H|EAD} com|
|000017b0| 6d 61 6e 64 2c 20 77 68 | 65 72 65 20 5c 76 61 72 |mand, wh|ere \var|
|000017c0| 7b 69 64 7d 20 68 61 73 | 20 74 68 65 20 73 61 6d |{id} has| the sam|
|000017d0| 65 20 6d 65 61 6e 69 6e | 67 20 61 73 20 66 6f 72 |e meanin|g as for|
|000017e0| 0a 5c 63 6f 64 65 7b 73 | 74 61 74 28 29 7d 2e 20 |.\code{s|tat()}. |
|000017f0| 20 52 65 74 75 72 6e 20 | 61 20 70 61 69 72 20 5c | Return |a pair \|
|00001800| 63 6f 64 65 7b 28 5c 76 | 61 72 7b 72 65 73 70 6f |code{(\v|ar{respo|
|00001810| 6e 73 65 7d 2c 20 5c 76 | 61 72 7b 6c 69 73 74 7d |nse}, \v|ar{list}|
|00001820| 29 7d 0a 77 68 65 72 65 | 20 5c 76 61 72 7b 6c 69 |)}.where| \var{li|
|00001830| 73 74 7d 20 69 73 20 61 | 20 6c 69 73 74 20 6f 66 |st} is a| list of|
|00001840| 20 74 68 65 20 61 72 74 | 69 63 6c 65 27 73 20 68 | the art|icle's h|
|00001850| 65 61 64 65 72 73 20 28 | 61 6e 20 75 6e 69 6e 74 |eaders (|an unint|
|00001860| 65 72 70 72 65 74 65 64 | 0a 6c 69 73 74 20 6f 66 |erpreted|.list of|
|00001870| 20 6c 69 6e 65 73 2c 20 | 77 69 74 68 6f 75 74 20 | lines, |without |
|00001880| 74 72 61 69 6c 69 6e 67 | 20 6e 65 77 6c 69 6e 65 |trailing| newline|
|00001890| 73 29 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |s)..\end|{funcdes|
|000018a0| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|000018b0| 65 73 63 7d 7b 62 6f 64 | 79 7d 7b 69 64 7d 0a 53 |esc}{bod|y}{id}.S|
|000018c0| 65 6e 64 20 61 20 5c 73 | 61 6d 70 7b 42 4f 44 59 |end a \s|amp{BODY|
|000018d0| 7d 20 63 6f 6d 6d 61 6e | 64 2c 20 77 68 65 72 65 |} comman|d, where|
|000018e0| 20 5c 76 61 72 7b 69 64 | 7d 20 68 61 73 20 74 68 | \var{id|} has th|
|000018f0| 65 20 73 61 6d 65 20 6d | 65 61 6e 69 6e 67 20 61 |e same m|eaning a|
|00001900| 73 20 66 6f 72 0a 5c 63 | 6f 64 65 7b 73 74 61 74 |s for.\c|ode{stat|
|00001910| 28 29 7d 2e 20 20 52 65 | 74 75 72 6e 20 61 20 70 |()}.  Re|turn a p|
|00001920| 61 69 72 20 5c 63 6f 64 | 65 7b 28 5c 76 61 72 7b |air \cod|e{(\var{|
|00001930| 72 65 73 70 6f 6e 73 65 | 7d 2c 20 5c 76 61 72 7b |response|}, \var{|
|00001940| 6c 69 73 74 7d 29 7d 0a | 77 68 65 72 65 20 5c 76 |list})}.|where \v|
|00001950| 61 72 7b 6c 69 73 74 7d | 20 69 73 20 61 20 6c 69 |ar{list}| is a li|
|00001960| 73 74 20 6f 66 20 74 68 | 65 20 61 72 74 69 63 6c |st of th|e articl|
|00001970| 65 27 73 20 62 6f 64 79 | 20 74 65 78 74 20 28 61 |e's body| text (a|
|00001980| 6e 0a 75 6e 69 6e 74 65 | 72 70 72 65 74 65 64 20 |n.uninte|rpreted |
|00001990| 6c 69 73 74 20 6f 66 20 | 6c 69 6e 65 73 2c 20 77 |list of |lines, w|
|000019a0| 69 74 68 6f 75 74 20 74 | 72 61 69 6c 69 6e 67 20 |ithout t|railing |
|000019b0| 6e 65 77 6c 69 6e 65 73 | 29 2e 0a 5c 65 6e 64 7b |newlines|)..\end{|
|000019c0| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|000019d0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 61 72 74 69 |n{funcde|sc}{arti|
|000019e0| 63 6c 65 7d 7b 69 64 7d | 0a 53 65 6e 64 20 61 20 |cle}{id}|.Send a |
|000019f0| 5c 73 61 6d 70 7b 41 52 | 54 49 43 4c 45 7d 20 63 |\samp{AR|TICLE} c|
|00001a00| 6f 6d 6d 61 6e 64 2c 20 | 77 68 65 72 65 20 5c 76 |ommand, |where \v|
|00001a10| 61 72 7b 69 64 7d 20 68 | 61 73 20 74 68 65 20 73 |ar{id} h|as the s|
|00001a20| 61 6d 65 20 6d 65 61 6e | 69 6e 67 20 61 73 0a 66 |ame mean|ing as.f|
|00001a30| 6f 72 20 5c 63 6f 64 65 | 7b 73 74 61 74 28 29 7d |or \code|{stat()}|
|00001a40| 2e 20 20 52 65 74 75 72 | 6e 20 61 20 70 61 69 72 |.  Retur|n a pair|
|00001a50| 20 5c 63 6f 64 65 7b 28 | 5c 76 61 72 7b 72 65 73 | \code{(|\var{res|
|00001a60| 70 6f 6e 73 65 7d 2c 20 | 5c 76 61 72 7b 6c 69 73 |ponse}, |\var{lis|
|00001a70| 74 7d 29 7d 0a 77 68 65 | 72 65 20 5c 76 61 72 7b |t})}.whe|re \var{|
|00001a80| 6c 69 73 74 7d 20 69 73 | 20 61 20 6c 69 73 74 20 |list} is| a list |
|00001a90| 6f 66 20 74 68 65 20 61 | 72 74 69 63 6c 65 27 73 |of the a|rticle's|
|00001aa0| 20 68 65 61 64 65 72 20 | 61 6e 64 20 62 6f 64 79 | header |and body|
|00001ab0| 20 74 65 78 74 20 28 61 | 6e 0a 75 6e 69 6e 74 65 | text (a|n.uninte|
|00001ac0| 72 70 72 65 74 65 64 20 | 6c 69 73 74 20 6f 66 20 |rpreted |list of |
|00001ad0| 6c 69 6e 65 73 2c 20 77 | 69 74 68 6f 75 74 20 74 |lines, w|ithout t|
|00001ae0| 72 61 69 6c 69 6e 67 20 | 6e 65 77 6c 69 6e 65 73 |railing |newlines|
|00001af0| 29 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |)..\end{|funcdesc|
|00001b00| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00001b10| 73 63 7d 7b 73 6c 61 76 | 65 7d 7b 7d 0a 53 65 6e |sc}{slav|e}{}.Sen|
|00001b20| 64 20 61 20 5c 73 61 6d | 70 7b 53 4c 41 56 45 7d |d a \sam|p{SLAVE}|
|00001b30| 20 63 6f 6d 6d 61 6e 64 | 2e 20 20 52 65 74 75 72 | command|.  Retur|
|00001b40| 6e 20 74 68 65 20 73 65 | 72 76 65 72 27 73 20 5c |n the se|rver's \|
|00001b50| 76 61 72 7b 72 65 73 70 | 6f 6e 73 65 7d 2e 0a 5c |var{resp|onse}..\|
|00001b60| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00001b70| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001b80| 78 68 64 72 7d 7b 68 65 | 61 64 65 72 5c 2c 20 73 |xhdr}{he|ader\, s|
|00001b90| 74 72 69 6e 67 7d 0a 53 | 65 6e 64 20 61 6e 20 5c |tring}.S|end an \|
|00001ba0| 73 61 6d 70 7b 58 48 44 | 52 7d 20 63 6f 6d 6d 61 |samp{XHD|R} comma|
|00001bb0| 6e 64 2e 20 20 54 68 69 | 73 20 63 6f 6d 6d 61 6e |nd.  Thi|s comman|
|00001bc0| 64 20 69 73 20 6e 6f 74 | 20 64 65 66 69 6e 65 64 |d is not| defined|
|00001bd0| 20 69 6e 20 74 68 65 20 | 52 46 43 0a 62 75 74 20 | in the |RFC.but |
|00001be0| 69 73 20 61 20 63 6f 6d | 6d 6f 6e 20 65 78 74 65 |is a com|mon exte|
|00001bf0| 6e 73 69 6f 6e 2e 20 20 | 54 68 65 20 5c 76 61 72 |nsion.  |The \var|
|00001c00| 7b 68 65 61 64 65 72 7d | 20 61 72 67 75 6d 65 6e |{header}| argumen|
|00001c10| 74 20 69 73 20 61 20 68 | 65 61 64 65 72 0a 6b 65 |t is a h|eader.ke|
|00001c20| 79 77 6f 72 64 2c 20 65 | 2e 67 2e 20 5c 63 6f 64 |yword, e|.g. \cod|
|00001c30| 65 7b 22 73 75 62 6a 65 | 63 74 22 7d 2e 20 20 54 |e{"subje|ct"}.  T|
|00001c40| 68 65 20 5c 76 61 72 7b | 73 74 72 69 6e 67 7d 20 |he \var{|string} |
|00001c50| 61 72 67 75 6d 65 6e 74 | 20 73 68 6f 75 6c 64 20 |argument| should |
|00001c60| 68 61 76 65 0a 74 68 65 | 20 66 6f 72 6d 20 5c 63 |have.the| form \c|
|00001c70| 6f 64 65 7b 22 5c 76 61 | 72 7b 66 69 72 73 74 7d |ode{"\va|r{first}|
|00001c80| 2d 5c 76 61 72 7b 6c 61 | 73 74 7d 22 7d 20 77 68 |-\var{la|st}"} wh|
|00001c90| 65 72 65 20 5c 76 61 72 | 7b 66 69 72 73 74 7d 20 |ere \var|{first} |
|00001ca0| 61 6e 64 0a 5c 76 61 72 | 7b 6c 61 73 74 7d 20 61 |and.\var|{last} a|
|00001cb0| 72 65 20 74 68 65 20 66 | 69 72 73 74 20 61 6e 64 |re the f|irst and|
|00001cc0| 20 6c 61 73 74 20 61 72 | 74 69 63 6c 65 20 6e 75 | last ar|ticle nu|
|00001cd0| 6d 62 65 72 73 20 74 6f | 20 73 65 61 72 63 68 2e |mbers to| search.|
|00001ce0| 20 20 52 65 74 75 72 6e | 20 61 0a 70 61 69 72 20 |  Return| a.pair |
|00001cf0| 5c 63 6f 64 65 7b 28 5c | 76 61 72 7b 72 65 73 70 |\code{(\|var{resp|
|00001d00| 6f 6e 73 65 7d 2c 20 5c | 76 61 72 7b 6c 69 73 74 |onse}, \|var{list|
|00001d10| 7d 29 7d 2c 20 77 68 65 | 72 65 20 5c 76 61 72 7b |})}, whe|re \var{|
|00001d20| 6c 69 73 74 7d 20 69 73 | 20 61 20 6c 69 73 74 20 |list} is| a list |
|00001d30| 6f 66 0a 70 61 69 72 73 | 20 5c 63 6f 64 65 7b 28 |of.pairs| \code{(|
|00001d40| 5c 76 61 72 7b 69 64 7d | 2c 20 5c 76 61 72 7b 74 |\var{id}|, \var{t|
|00001d50| 65 78 74 7d 29 7d 2c 20 | 77 68 65 72 65 20 5c 76 |ext})}, |where \v|
|00001d60| 61 72 7b 69 64 7d 20 69 | 73 20 61 6e 20 61 72 74 |ar{id} i|s an art|
|00001d70| 69 63 6c 65 20 69 64 0a | 28 61 73 20 61 20 73 74 |icle id.|(as a st|
|00001d80| 72 69 6e 67 29 20 61 6e | 64 20 5c 76 61 72 7b 74 |ring) an|d \var{t|
|00001d90| 65 78 74 7d 20 69 73 20 | 74 68 65 20 74 65 78 74 |ext} is |the text|
|00001da0| 20 6f 66 20 74 68 65 20 | 72 65 71 75 65 73 74 65 | of the |requeste|
|00001db0| 64 20 68 65 61 64 65 72 | 20 66 6f 72 0a 74 68 61 |d header| for.tha|
|00001dc0| 74 20 61 72 74 69 63 6c | 65 2e 0a 5c 65 6e 64 7b |t articl|e..\end{|
|00001dd0| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00001de0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 70 6f 73 74 |n{funcde|sc}{post|
|00001df0| 7d 7b 66 69 6c 65 7d 0a | 50 6f 73 74 20 61 6e 20 |}{file}.|Post an |
|00001e00| 61 72 74 69 63 6c 65 20 | 75 73 69 6e 67 20 74 68 |article |using th|
|00001e10| 65 20 5c 73 61 6d 70 7b | 50 4f 53 54 7d 20 63 6f |e \samp{|POST} co|
|00001e20| 6d 6d 61 6e 64 2e 20 20 | 54 68 65 20 5c 76 61 72 |mmand.  |The \var|
|00001e30| 7b 66 69 6c 65 7d 0a 61 | 72 67 75 6d 65 6e 74 20 |{file}.a|rgument |
|00001e40| 69 73 20 61 6e 20 6f 70 | 65 6e 20 66 69 6c 65 20 |is an op|en file |
|00001e50| 6f 62 6a 65 63 74 20 77 | 68 69 63 68 20 69 73 20 |object w|hich is |
|00001e60| 72 65 61 64 20 75 6e 74 | 69 6c 20 45 4f 46 20 75 |read unt|il EOF u|
|00001e70| 73 69 6e 67 20 69 74 73 | 0a 5c 63 6f 64 65 7b 72 |sing its|.\code{r|
|00001e80| 65 61 64 6c 69 6e 65 28 | 29 7d 20 6d 65 74 68 6f |eadline(|)} metho|
|00001e90| 64 2e 20 20 49 74 20 73 | 68 6f 75 6c 64 20 62 65 |d.  It s|hould be|
|00001ea0| 20 61 20 77 65 6c 6c 2d | 66 6f 72 6d 65 64 20 6e | a well-|formed n|
|00001eb0| 65 77 73 20 61 72 74 69 | 63 6c 65 2c 0a 69 6e 63 |ews arti|cle,.inc|
|00001ec0| 6c 75 64 69 6e 67 20 74 | 68 65 20 72 65 71 75 69 |luding t|he requi|
|00001ed0| 72 65 64 20 68 65 61 64 | 65 72 73 2e 20 20 54 68 |red head|ers.  Th|
|00001ee0| 65 20 5c 63 6f 64 65 7b | 70 6f 73 74 28 29 7d 20 |e \code{|post()} |
|00001ef0| 6d 65 74 68 6f 64 0a 61 | 75 74 6f 6d 61 74 69 63 |method.a|utomatic|
|00001f00| 61 6c 6c 79 20 65 73 63 | 61 70 65 73 20 6c 69 6e |ally esc|apes lin|
|00001f10| 65 73 20 62 65 67 69 6e | 6e 69 6e 67 20 77 69 74 |es begin|ning wit|
|00001f20| 68 20 5c 73 61 6d 70 7b | 2e 7d 2e 0a 5c 65 6e 64 |h \samp{|.}..\end|
|00001f30| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00001f40| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 69 68 61 |in{funcd|esc}{iha|
|00001f50| 76 65 7d 7b 69 64 5c 2c | 20 66 69 6c 65 7d 0a 53 |ve}{id\,| file}.S|
|00001f60| 65 6e 64 20 61 6e 20 5c | 73 61 6d 70 7b 49 48 41 |end an \|samp{IHA|
|00001f70| 56 45 7d 20 63 6f 6d 6d | 61 6e 64 2e 20 20 49 66 |VE} comm|and.  If|
|00001f80| 20 74 68 65 20 72 65 73 | 70 6f 6e 73 65 20 69 73 | the res|ponse is|
|00001f90| 20 6e 6f 74 20 61 6e 20 | 65 72 72 6f 72 2c 20 74 | not an |error, t|
|00001fa0| 72 65 61 74 0a 5c 76 61 | 72 7b 66 69 6c 65 7d 20 |reat.\va|r{file} |
|00001fb0| 65 78 61 63 74 6c 79 20 | 61 73 20 66 6f 72 20 74 |exactly |as for t|
|00001fc0| 68 65 20 5c 63 6f 64 65 | 7b 70 6f 73 74 28 29 7d |he \code|{post()}|
|00001fd0| 20 6d 65 74 68 6f 64 2e | 0a 5c 65 6e 64 7b 66 75 | method.|.\end{fu|
|00001fe0| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00001ff0| 66 75 6e 63 64 65 73 63 | 7d 7b 71 75 69 74 7d 7b |funcdesc|}{quit}{|
|00002000| 7d 0a 53 65 6e 64 20 61 | 20 5c 73 61 6d 70 7b 51 |}.Send a| \samp{Q|
|00002010| 55 49 54 7d 20 63 6f 6d | 6d 61 6e 64 20 61 6e 64 |UIT} com|mand and|
|00002020| 20 63 6c 6f 73 65 20 74 | 68 65 20 63 6f 6e 6e 65 | close t|he conne|
|00002030| 63 74 69 6f 6e 2e 20 20 | 4f 6e 63 65 20 74 68 69 |ction.  |Once thi|
|00002040| 73 20 6d 65 74 68 6f 64 | 0a 68 61 73 20 62 65 65 |s method|.has bee|
|00002050| 6e 20 63 61 6c 6c 65 64 | 2c 20 6e 6f 20 6f 74 68 |n called|, no oth|
|00002060| 65 72 20 6d 65 74 68 6f | 64 73 20 6f 66 20 74 68 |er metho|ds of th|
|00002070| 65 20 4e 4e 54 50 20 6f | 62 6a 65 63 74 20 73 68 |e NNTP o|bject sh|
|00002080| 6f 75 6c 64 20 62 65 20 | 63 61 6c 6c 65 64 2e 0a |ould be |called..|
|00002090| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a    |\end{fun|cdesc}. |
+--------+-------------------------+-------------------------+--------+--------+