From 6413833a4fffbe766c95023bc5a065bf3143c14a Mon Sep 17 00:00:00 2001
From: Timotheus Kampik <timotheus.kampik@signavio.com>
Date: Wed, 2 Aug 2017 00:20:49 +0200
Subject: [PATCH]  #3751 work in feedback

---
 doc/man/sphinx-build.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/man/sphinx-build.rst b/doc/man/sphinx-build.rst
index 863f83a55..4866282d4 100644
--- a/doc/man/sphinx-build.rst
+++ b/doc/man/sphinx-build.rst
@@ -103,10 +103,14 @@ Options
 
    **latexpdfja**
      Build LaTeX files and run them through :program:`platex/dvipdfmx`.
+     We recommend using ``latexpdf`` instead.
 
    **info**
      Build Texinfo files and run them through :program:`makeinfo`.
 
+   .. important::
+     Sphinx only recognizes the ``-M`` option if it is placed first.
+
    .. versionadded:: 1.2.1
 
 .. option:: -a