Re: [PATCH] doc: flat-table directive

[Jani Nikula]

On Thu, 30 Jun 2016, Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxx> wrote:
> Em Thu, 30 Jun 2016 13:05:11 -0600
> Jonathan Corbet <corbet@xxxxxxx> 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. 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
> 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

This is just because there isn't a DocBook called linux_tv. DOCBOOKS
means nothing to Sphinx, it's only relevant for DocBook build. Top level
'make help' lists the valid values for DOCBOOKS.

BR,
Jani.


-- 
Jani Nikula, Intel Open Source Technology Center