Re: doc build requirements

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Johannes,

Am 31.03.2017 um 08:26 schrieb Johannes Berg <johannes@xxxxxxxxxxxxxxxx>:

> Hi,
> 
> I notice that now - since
> 
> commit ec868e4ee2bcebb9e4c03979d90e0ac0b79fe05a
> Author: Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx>
> Date:   Wed Nov 30 08:00:17 2016 -0200
> 
>    docs-rst: media: build SVG from graphviz files
> 
> was merged, it is strictly necessary to have `dot' installed to build
> documentation - there isn't even any fallback.
> 
> Now, it's not hard to install, so I have no major objection against it,
> but I wanted to take the opportunity to point out that this seems a bit
> arbitrary - last I tried adding new functionality and *didn't* even
> make it a build requirement (logging only a warning if not installed) I
> was told I can't add such a thing.
> 
> Does this mean something has changed and I can try again? :)


no ;) yes, you are right and we have improved it; since ..

--
doc-4.11-images db6ccf23e8ba40fc2e8914ec9c0eb950df71d9fe
Author:     Markus Heiser <markus.heiser@xxxxxxxxxxx>
AuthorDate: Mon Mar 6 14:09:27 2017 +0100

  docs-rst: automatically convert Graphviz and SVG images
--

the situation is much better: for HTML, dot installation is optional
and other requirements are listed in Documentation/process/changes.rst
(see chapter "Kernel documentation").

Mauro also patched his media tree to get rid of the 'dot' and 'convert'
usage in the media/Makefile, see:

--
8fa1bb506fc9b5b0f7b5e42cee4f8213325a98ee
Author:     Mauro Carvalho Chehab <mchehab@xxxxxxxxxx>
AuthorDate: Thu Mar 9 15:14:52 2017 -0300

 docs-rst: Don't use explicit Makefile rules to build SVG and DOT files
--


-- Markus --


--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux