Em Sat, 6 Aug 2016 09:00:31 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:
> Being able to build just the media docs is important for us due to several
> reasons:
>
> 1) Media developers community hosts a copy of the media documentation at
> linuxtv.org
> with the very latest under development documents;
>
> 2) Nitpicking to identify broken references is important to identify
> documentation gaps
> that need to be addressed on future releases;
>
> 3) As media maintainers check patch per patch if a documentation gap is
> introduced, building
> media documentation should be as fast as possible.
>
> This patchset adds a media file adding nitpick support and an extra build
> target that will
> compile only the media documentation. It also groups all media documentation
> into one
> section on the main Kernel document, with is, IMHO, a good thing as we start
> adding more
> stuff there.
>
> Jon,
>
> I'd love to see this patch merged early at the -rc cycle, in order to avoid
> merge
> conflicts when people start converting other docbooks to Sphinx, as it touches
> at the main Makefile and at the Sphinx common stuff. Also, as I'll need to
> patch my
> build scripts to check for documentation issues with Sphinx, I need them on my
> master branch, as otherwise my workflow will be broken until the next Kernel
> release.
>
> So, If you're ok with this patch series, can you submit to Linus on early
> -rc? Or
> if you prefer, I can do it myself, with your ack.
Forgot to comment, but those patches are applied against ustream master
branch. I applied them against my development tree at:
https://git.linuxtv.org//mchehab/experimental.git/log/?h=docs-next
Regards,
Mauro
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
