linux-kernel - Re: [PATCH] doc: flat-table directive

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <A717703E-9E1B-47DE-9A5E-59E77966FB98@darmarit.de>
Date:	Fri, 1 Jul 2016 10:44:27 +0200
From:	Markus Heiser <markus.heiser@...marit.de>
To:	Mauro Carvalho Chehab <mchehab@....samsung.com>
Cc:	Jonathan Corbet <corbet@....net>, jani.nikula@...el.com,
	linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
	hverkuil@...all.nl, daniel.vetter@...ll.ch, airlied@...il.com,
	grant.likely@...retlab.ca, rdunlap@...radead.org, keithp@...thp.com
Subject: Re: [PATCH] doc: flat-table directive


Am 30.06.2016 um 21:44 schrieb Mauro Carvalho Chehab <mchehab@....samsung.com>:

> Em Thu, 30 Jun 2016 13:05:11 -0600
> Jonathan Corbet <corbet@....net> escreveu:
> 
>> Anyway, I don't want to delay this work, so I have gone ahead and applied
>> it; 
> 
> Got already one issue... Maybe on Jeni's changes to the makefiles...
> 
> I want to be able to compile just the book I'm working.

This feature does not exists (yet) for the reST content. Jani and I
discussed it on the ML, but for the start he didn't want to have
books (aka sphinx sub-projects). Anyway, I don't want to restart
the discussion again, just the fact for information: no books
in reST, there is only one HTML site which includes all reST content.

> Using the usual
> syntax to build just one book worked: the build from the *.rst files
> succeeded. Yet, it tried to compile it also as DocBook, causing an
> error at the end.
> 
> See the logs below:
> 
> $ make DOCBOOKS=linux_tv htmldocs
>  SPHINX  htmldocs

As far as I know, there is only the one html-target "htmldocs" building
all HTML from reST & DocBook content. Selecting DocBook-XML books with the
environment "DOCBOOKS=..." is new for me. Did this feature exists in the 
past? I tried it with v4.6 but no success.

> Running Sphinx v1.3.1
> loading pickled environment... done
> building [mo]: targets for 0 po files that are out of date
> building [html]: targets for 1 source files that are out of date
> updating environment: 0 added, 1 changed, 0 removed
> reading sources... [100%] linux_tv/media/dvb/dvbapi                             
> looking for now-outdated files... none found
> pickling environment... done
> checking consistency... done
> preparing documents... done
> writing output... [100%] linux_tv/media/dvb/dvbapi                              
> generating indices... genindex
> writing additional pages... search
> copying images... [100%] linux_tv/media_api_files/typical_media_device.svg      
> copying static files... done
> copying extra files... done
> dumping search index in English (code: en) ... done
> dumping object inventory... done
> build succeeded.
> make[1]: *** No rule to make target 'Documentation/DocBook/linux_tv', needed by 'htmldocs'.  Pare.
> Makefile:1420: recipe for target 'htmldocs' failed
> make: *** [htmldocs] Error 2
> 
> -- 
> Thanks,
> Mauro


-- Markus --