diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index 44c2ad42ed..1599b0c6c5 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -340,6 +340,10 @@ prefix is ``ffmpeg2pass''. The complete file name will be
 @file{PREFIX-N.log}, where N is a number specific to the output
 stream
 
+Note that this option is overwritten by a local option of the same name
+when using @code{-vcodec libx264}. That option maps to the x264 option stats
+which has a different syntax.
+
 @item -vlang @var{code}
 Set the ISO 639 language code (3 letters) of the current video stream.