update docs

docs/ares_init_options.3

@@ -136,10 +136,7 @@ servers available.  Instead, fail initialization with \fIARES_ENOSERVER\fP.
 .B int \fItimeout\fP;
 .br
 The number of seconds each name server is given to respond to a query on the
-first try.  (After the first try, the timeout algorithm becomes more
-complicated, but scales linearly with the value of \fItimeout\fP.)  The
-default is two seconds. This option is being deprecated by
-\fIARES_OPT_TIMEOUTMS\fP starting in c-ares 1.5.2.
+first try.  See \fIARES_OPT_TIMEOUTMS\fP which this value is converted into.
 .TP 18
 .B ARES_OPT_TIMEOUTMS
 .B int \fItimeout\fP;
@@ -151,6 +148,10 @@ default is two seconds. Note that this option is specified with the same
 struct field as the former \fIARES_OPT_TIMEOUT\fP, it is but the option bits
 that tell c-ares how to interpret the number. This option was added in c-ares
 1.5.2.
+
+As of c-ares 1.32.0, this option is only honored on the first successful query
+to any given server, after that the timeout is automatically calculated based
+on prior query history.
 .TP 18
 .B ARES_OPT_TRIES
 .B int \fItries\fP;