anchor.diff:  
   === Erlang.mk configuration
   
  -Default Erlang.mk settings are equivalent to adding to project's makefile
  -following lines:
  +Erlang.mk defaults to the following configuration:
   
   [source,make]
   SPHINX_FORMATS = html
   SPHINX_SOURCE = doc
   
  -To change the location of Sphinx sources, you need to set `$(SPHINX_SOURCE)`
  -variable. 'conf.py' file should also be placed in that directory, unless you
  +To change the location of Sphinx sources, you need to set the `$(SPHINX_SOURCE)`
  +variable. The 'conf.py' file should also be placed in that directory, unless you
   specify `$(SPHINX_CONFDIR)`.
   
  -Variable `$(SPHINX_OPTS)` allows to provide options to `sphinx-build`, which
  +The variable `$(SPHINX_OPTS)` allows to provide options to `sphinx-build`, which
   is particularly useful for `-D name=value` options. You can even forego
  -'doc/conf.py' file, using `-D name=value` in combination with `-C` option,
  -though you will need to manually call `make sphinx` or add `sphinx` target to
  -dependencies of `docs`.
  +'doc/conf.py' file, using `-D name=value` in combination with the `-C` option,
  +though in this case you will need to manually call `make sphinx` or add the
  +`sphinx` target to dependencies of `docs`.
   
  -`$(SPHINX_FORMATS)` variable lists formats to generate. By default only HTML
  -is generated, but it can also include man pages or LaTeX document for building
  -PDF. See
  -http://www.sphinx-doc.org/en/stable/invocation.html#cmdoption-sphinx-build-b[description of `-b` option]
  -for `sphinx-build` for list of known formats.
  +The `$(SPHINX_FORMATS)` variable lists formats to generate. By default only HTML
  +is generated, but it can also build man pages or LaTeX documents which can later
  +be converted to PDF. See the
  +http://www.sphinx-doc.org/en/stable/invocation.html#cmdoption-sphinx-build-b[description of the `-b` option]
  +for `sphinx-build` for a list of known formats.
   
   Formats are by default generated to a directory called after the format
   ('html' for HTML, 'man' for man pages, and so on). To change this behaviour
  -for specific format, you can set `$(sphinx_$(format)_output)` variable, e.g.
  +for a specific format, you can set the `$(sphinx_$(format)_output)` variable, e.g.
   `$(sphinx_html_output)` for 'html' or `$(sphinx_man_output)` for 'man'.
   There are also `$(sphinx_$(format)_opts)` variables for setting `sphinx-build`
   options for a single format only.
  
positive.code: === Generating man pages
  
  To generate man pages, you need to include `man` in `$(SPHINX_FORMATS)` in
  your makefile and define `man_pages` option in 'doc/conf.py':
  
  [source,python]
  ----
  
negative.code: [[sphinx]]
  == Sphinx documentation
  
  Erlang.mk includes targets for running the
  http://www.sphinx-doc.org/[Sphinx documentation generator], which can produce
  documentation in various formats, like HTML, man pages, Texinfo, LaTeX, and
  others.
  
  === Writing Sphinx documentation
  
  Sphinx generates documentation from a set of
  http://www.sphinx-doc.org/en/stable/rest.html[reST] documents. There is
  a http://www.sphinx-doc.org/en/stable/tutorial.html[quick start guide] on
  Sphinx' website. For Erlang.mk, we'll set up a minimal environment instead.
  
  === Basic setup
  
  By default, Erlang.mk expects Sphinx documentation to be placed in the 'doc'
  directory, with 'doc/conf.py' config file in particular. The file contains
  information about the project, among the other things.
  
  