Re: [PATCH 2/2] Documentation/kconfig: add search jump feature description

2017-02-06 Thread Jim Davis
On Mon, Feb 6, 2017 at 12:46 AM, wrote: > From: Changbin Du > > Kernel menuconfig support direct jumping function from the search > result. This is a very convenient feature but not documented. So > add a short description to the kconfig

making documentation targets on v4.10 with Fedora 25

2017-02-20 Thread Jim Davis
I ran a script like the one below to make the various Sphinx and DocBook documentations targets for v4.10 on my Fedora 25 desktop make O=/tmp/sphinx-out DOCBOOKS="" htmldocs make O=/tmp/sphinx-out DOCBOOKS="" latexdocs make O=/tmp/sphinx-out DOCBOOKS="" pdfdocs make O=/tmp/sphinx-out DOCBOOKS=""

Re: making documentation targets on v4.10 with Fedora 25

2017-02-23 Thread Jim Davis
On Mon, Feb 20, 2017 at 4:20 PM, Jonathan Corbet wrote: >> Exception occurred: >> File "/usr/lib/python3.5/site-packages/docutils/writers/_html_base.py", >> line >> 671, in depart_document >> assert not self.context, 'len(context) = %s' % len(self.context) >>

Re: making documentation targets on v4.10 with Fedora 25

2017-02-22 Thread Jim Davis
On Mon, Feb 20, 2017 at 4:20 PM, Jonathan Corbet <cor...@lwn.net> wrote: > On Mon, 20 Feb 2017 12:19:24 -0700 > Jim Davis <jim.ep...@gmail.com> wrote: > >> pdfdocs (Sphinx or DocBook) has been broken for some time, while >> psdocs hasn't worked in ages. Th

make pdfdocs errors with 4.10-rc8

2017-02-14 Thread Jim Davis
On a Fedora 25 system, [...] build succeeded, 32 warnings. make PDFLATEX=xelatex LATEXOPTS="-interaction=batchmode" -C Documentation/output/./latex; xelatex -interaction=batchmode 'linux-user.tex' This is XeTeX, Version 3.14159265-2.6-0.6 (TeX Live 2016) (preloaded format=xelatex) restricted

[PATCH] Documentation: DocBook/Makefile comment typo

2017-02-13 Thread Jim Davis
Fix a se for so typo. Signed-off-by: Jim Davis <jim.ep...@gmail.com> --- Documentation/DocBook/Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/DocBook/Makefile b/Documentation/DocBook/Makefile index a6eb7dcd4dd5..1f23567bf76e 100644 --- a/Documen

[PATCH] Documentation: make Makefile.sphinx no-ops quieter

2017-02-10 Thread Jim Davis
Silence the "make[1]: Nothing to be done for ..." messages for the no-op targets in Makefile.sphinx. Signed-off-by: Jim Davis <jim.ep...@gmail.com> --- Documentation/Makefile.sphinx | 4 1 file changed, 4 insertions(+) diff --git a/Documentation/Makefile.sphinx

make pdfdoc errors with 4.10-rc7

2017-02-09 Thread Jim Davis
On a Fedora 25 system, make pdfdocs is failing with [jim@krebstar linux-rc]$ grep -v -i 'warning:' /tmp/make-pdfdocs.err /data/linux-rc/Documentation/doc-guide/sphinx.rst:110: ERROR: Unknown target name: "sphinx c domain". ./include/net/cfg80211.h:3154: ERROR: Unexpected indentation.

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Jim Davis
screveu: >> >> > On Mon, 31 Oct 2016 11:51:20 -0700 >> > Jim Davis <jim.ep...@gmail.com> wrote: >> > >> > > Running make pdfdocs on a Ubuntu 16.04 system fails with >> > > >> > > Makefile:58: recipe for target 'media.pdf'

make cleandocs missing files with v4.9-rc3

2016-10-31 Thread Jim Davis
On my Ubuntu 16.04 system, make htmldocs works just fine (hurrah!) but make cleandocs misses a fair number of files: HTMLDocumentation/DocBook/index.html jim@krebstar:~/linux-rc$ make cleandocs jim@krebstar:~/linux-rc$ git status HEAD detached at v4.9-rc3 nothing to commit, working

Re: make pdfdocs fails with v4.9-rc3

2016-11-01 Thread Jim Davis
On Mon, Oct 31, 2016 at 3:41 PM, Mauro Carvalho Chehab <mche...@infradead.org> wrote: > Em Mon, 31 Oct 2016 16:40:02 -0600 > Mauro Carvalho Chehab <mche...@infradead.org> escreveu: > >> Em Mon, 31 Oct 2016 15:04:42 -0700 >> Jim Davis <jim.ep...@gmail.com>

make psdocs fails with v4.9-rc3

2016-10-31 Thread Jim Davis
Running make psdocs on a Ubuntu 16.04 system fails with Documentation/DocBook/Makefile:142: recipe for target 'Documentation/DocBook/kernel-hacking.ps' failed make[1]: *** [Documentation/DocBook/kernel-hacking.ps] Error 9 Makefile:1442: recipe for target 'psdocs' failed make: *** [psdocs] Error 2

make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Jim Davis
Running make pdfdocs on a Ubuntu 16.04 system fails with Makefile:58: recipe for target 'media.pdf' failed make[2]: *** [media.pdf] Error 1 Documentation/Makefile.sphinx:79: recipe for target 'pdfdocs' failed make[1]: *** [pdfdocs] Error 2 Makefile:1442: recipe for target 'pdfdocs' failed make:

make pdfdoc errors with v4.9

2016-12-12 Thread Jim Davis
On my Ubuntu 16.04 desktop, make pdfdocs fails with Makefile:58: recipe for target 'media.pdf' failed make[2]: *** [media.pdf] Error 1 Documentation/Makefile.sphinx:79: recipe for target 'pdfdocs' failed make[1]: *** [pdfdocs] Error 2 Makefile:1450: recipe for target 'pdfdocs' failed make: ***

Re: [PATCH] Docs: add 'lintdocs' target with basic sanity checks

2017-07-06 Thread Jim Davis
On Wed, Jul 5, 2017 at 11:14 PM, Markus Heiser <markus.hei...@darmarit.de> wrote: > >> Am 05.07.2017 um 23:14 schrieb Jim Davis <jim.ep...@gmail.com>: >> >> On Tue, Jul 4, 2017 at 12:39 AM, Markus Heiser >> <markus.hei...@darmarit.de> wrote: >&

Re: [PATCH RFC] scripts/sphinx-pre-install: add a script to check Sphinx install

2017-07-14 Thread Jim Davis
On Fri, Jul 14, 2017 at 10:35 AM, Markus Heiser wrote: > > > Ok, this won't solve TeX installation problems of Linux distros, Which seems to be the thorniest problem. It's one thing to identify which sphinx versions work, and another to figure out which of the metric

Re: [PATCH v2 00/53] Get rid of Docbook

2017-07-14 Thread Jim Davis
On Thu, Jul 6, 2017 at 1:54 AM, Markus Heiser wrote: > 52b3f23 Docs: clean up some DocBook loose ends Speaking of minor loose ends, make SPHINXDIRS=userspace-api pdfdocs works -- though now that it's all sphinx, wouldn't just DIRS be better? -- and make

Re: "make distclean" doesn't get rid of scripts/docproc

2017-07-17 Thread Jim Davis
On Fri, Jul 14, 2017 at 3:16 AM, Robert P. J. Day wrote: > > just noticed that distclean doesn't remove the generated executable > scripts/docproc, whose responsibility is that? It looks like that's been cleaned up now in v4.13-rc1, though

Re: [PATCH v2 00/53] Get rid of Docbook

2017-07-05 Thread Jim Davis
On Fri, Jun 16, 2017 at 7:03 AM, Markus Heiser wrote: > > docproc and some lines in the Makefile & .gitignore > > ./scripts/docproc.c > ./scripts/.docproc.cmd > ./scripts/Makefile > ./scripts/.gitignore With 4.12, running make xmldocs (or any other working target) and

Re: [PATCH] Docs: add 'lintdocs' target with basic sanity checks

2017-07-05 Thread Jim Davis
On Tue, Jul 4, 2017 at 12:39 AM, Markus Heiser wrote: > From: Markus Heiser > > The 'lintdocs' produces no output. The input is only parsed and checked for > consistency. This is useful for basic sanity checks [1]. Is this meant to apply to

Re: [PATCH 0/5] Make PDF builds work again

2017-07-05 Thread Jim Davis
On Mon, Jul 3, 2017 at 5:44 AM, Jonathan Corbet wrote: > On Mon, 3 Jul 2017 10:25:38 +0200 > Daniel Vetter wrote: > >> Only now stumbled over the full thread, but the drm patch is already >> queued up for at least 4.13 (Dave was out and all that). I guess we

make pdfdocs problem with 4.13-rc4

2017-08-09 Thread Jim Davis
On my Fedora 26 workstation, with the latest patches, running make pdfdocs stops with [jim@krebstar ~]$ tail /tmp/make-pdfdocs.out Underfull \hbox (badness 1) in paragraph at lines 3980--3983 []\EU1/DejaVuSans(0)/m/n/10 Threshold below [31] ! Missing \endgroup inserted.

make linkcheckdocs error with 4.13-rc7

2017-08-28 Thread Jim Davis
On my Fedora 26 desktop (with Sphinx 1.6.3), make linkcheckdocs is failing with InputError: [Errno 2] No such file or directory: '/data/linux-rc/Documentation/output/cec.h.rst'. reST markup error: /data/linux-rc/Documentation/media/uapi/cec/cec-header.rst:9: (SEVERE/4) Problems with