linux.git/Documentation/Makefile.sphinx, branch v4.8

Merge tag 'doc-4.8-fixes' of git://git.lwn.net/linux

2016-08-07T14:23:17+00:00

Pull documentation fixes from Jonathan Corbet:
 "Three fixes for the docs build, including removing an annoying warning
  on 'make help' if sphinx isn't present"

* tag 'doc-4.8-fixes' of git://git.lwn.net/linux:
  DocBook: use DOCBOOKS="" to ignore DocBooks instead of IGNORE_DOCBOOKS=1
  Documenation: update cgroup's document path
  Documentation/sphinx: do not warn about missing tools in 'make help'

Documentation/sphinx: do not warn about missing tools in 'make help'

2016-08-03T21:41:31+00:00

Simply move the dochelp rule outside of the HAVE_SPHINX check,
overriding the .DEFAULT rule for HAVE_SPHINX=0.

Cc: Jonathan Corbet 
Cc: Christian Kujau 
Signed-off-by: Jani Nikula 
Signed-off-by: Jonathan Corbet

doc-rst: Remove the media docbook

2016-07-28T23:08:19+00:00

Now that all media documentation was converted to Sphinx, we
should get rid of the old DocBook one, as we don't want people
to submit patches against the old stuff.

Signed-off-by: Mauro Carvalho Chehab 
Acked-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

Merge branch 'docs-next' of git://git.lwn.net/linux into devel/docs-next

2016-07-15T10:33:47+00:00

* 'docs-next' of git://git.lwn.net/linux:
  doc-rst: add an option to ignore DocBooks when generating docs
  workqueue: Fix a typo in workqueue.txt
  Doc: ocfs: Fix typo in filesystems/ocfs2-online-filecheck.txt
  Documentation/sphinx: skip build if user requested specific DOCBOOKS
  Documentation: add cleanmediadocs to the documentation targets

doc_rst: rename the media Sphinx suff to Documentation/media

2016-07-08T14:59:40+00:00

The name of the subsystem is "media", and not "linux_tv". Also,
as we plan to add other stuff there in the future, let's
rename also the media uAPI book to media_uapi, to make it
clearer.

No functional changes.

Signed-off-by: Mauro Carvalho Chehab

doc-rst: linux_tv/Makefile: Honor quiet make O=dir

2016-07-08T12:31:05+00:00

To honor the:

  make O=dir [targets] Locate all output files in "dir"

* activate kernel-include directive
* export BUILDDIR=$(BUILDDIR)
* linux_tv: replace '.. include::' with '.. kernel-include:: $BUILDDIR/'

Signed-off-by: Markus Heiser 
Signed-off-by: Mauro Carvalho Chehab

doc-rst: linux_tv/Makefile: Honor quiet mode

2016-07-08T12:31:03+00:00

Cleanup the Makefile and handle the V=1 flag and make it
to work when specifying an output directory with O=dir

Signed-off-by: Mauro Carvalho Chehab

doc-rst: auto-build the frontend.h.rst

2016-07-07T09:36:45+00:00

This file is auto-generated with DocBook, from the uapi header.

Do the same with Sphinx.

Signed-off-by: Mauro Carvalho Chehab

Documentation/sphinx: skip build if user requested specific DOCBOOKS

2016-07-01T22:16:07+00:00

If the user requested specific DocBooks to be built using 'make
DOCBOOKS=foo.xml htmldocs', assume no Sphinx build is desired. This
check is transitional, and can be removed once we drop the DocBook
build.

Cc: Markus Heiser 
Cc: Mauro Carvalho Chehab 
Fixes: 22cba31bae9d ("Documentation/sphinx: add basic working Sphinx configuration and build")
Signed-off-by: Jani Nikula 
Signed-off-by: Jonathan Corbet

Documentation: add cleanmediadocs to the documentation targets

2016-07-01T22:15:31+00:00

This was broken when updating the documentation targets for the Sphinx
build, and moving from %docs target pattern to explicitly listed
targets.

Cc: Markus Heiser 
Cc: Mauro Carvalho Chehab 
Fixes: 22cba31bae9d ("Documentation/sphinx: add basic working Sphinx configuration and build")
Signed-off-by: Jani Nikula 
Signed-off-by: Jonathan Corbet