diff --git a/doc/codecs.texi b/doc/codecs.texi
index da048b155e90fb60ba41daa22604dd297a957ed3..b481b4a053a0a2228509920d00e9e5f57d707832 100644
--- a/doc/codecs.texi
+++ b/doc/codecs.texi
@@ -817,13 +817,17 @@ for codecs that support it. See also @file{doc/examples/export_mvs.c}.
 Deprecated, use mpegvideo private options instead.
 
 @item threads @var{integer} (@emph{decoding/encoding,video})
+Set the number of threads to be used, in case the selected codec
+implementation supports multi-threading.
 
 Possible values:
 @table @samp
-@item auto
-detect a good number of threads
+@item auto, 0
+automatically select the number of threads to set
 @end table
 
+Default value is @samp{auto}.
+
 @item me_threshold @var{integer} (@emph{encoding,video})
 Set motion estimation threshold.