Fix a number of bugs and omissions in the AddressList documentation, most
noted by Steve Holden.
This closes SF bug #413876.
diff --git a/Doc/lib/librfc822.tex b/Doc/lib/librfc822.tex
index a31c8c4..2f68bb8 100644
--- a/Doc/lib/librfc822.tex
+++ b/Doc/lib/librfc822.tex
@@ -238,24 +238,36 @@
An \class{AddressList} instance has the following methods:
-\begin{methoddesc}{__len__}{name}
+\begin{methoddesc}{__len__}{}
Return the number of addresses in the address list.
\end{methoddesc}
-\begin{methoddesc}{__str__}{name}
+\begin{methoddesc}{__str__}{}
Return a canonicalized string representation of the address list.
Addresses are rendered in "name" <host@domain> form, comma-separated.
\end{methoddesc}
-\begin{methoddesc}{__add__}{name}
-Return an \class{AddressList} instance that contains all addresses in
-both \class{AddressList} operands, with duplicates removed (set union).
+\begin{methoddesc}{__add__}{alist}
+Return a new \class{AddressList} instance that contains all addresses
+in both \class{AddressList} operands, with duplicates removed (set
+union).
\end{methoddesc}
-\begin{methoddesc}{__sub__}{name}
-Return an \class{AddressList} instance that contains every address in the
-left-hand \class{AddressList} operand that is not present in the right-hand
-address operand (set difference).
+\begin{methoddesc}{__iadd__}{alist}
+In-place version of \method{__add__()}; turns this \class{AddressList}
+instance into the union of itself and the right-hand instance,
+\var{alist}.
+\end{methoddesc}
+
+\begin{methoddesc}{__sub__}{alist}
+Return a new \class{AddressList} instance that contains every address
+in the left-hand \class{AddressList} operand that is not present in
+the right-hand address operand (set difference).
+\end{methoddesc}
+
+\begin{methoddesc}{__isub__}{alist}
+In-place version of \method{__sub__()}, removing addresses in this
+list which are also in \var{alist}.
\end{methoddesc}
@@ -264,5 +276,6 @@
\begin{memberdesc}{addresslist}
A list of tuple string pairs, one per address. In each member, the
first is the canonicalized name part, the second is the
-actual route-address (@-separated username-host.domain pair).
+actual route-address (\character{@}-separated username-host.domain
+pair).
\end{memberdesc}