From patchwork Wed Aug 24 15:36:16 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Markus Heiser X-Patchwork-Id: 36649 Received: from mail.tu-berlin.de ([130.149.7.33]) by www.linuxtv.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bcaEy-00086D-Tg; Wed, 24 Aug 2016 15:37:20 +0000 X-tubIT-Incoming-IP: 209.132.180.67 Received: from vger.kernel.org ([209.132.180.67]) by mail.tu-berlin.de (exim-4.84_2/mailfrontend-5) with esmtp id 1bcaEw-0007L2-7v; Wed, 24 Aug 2016 17:37:20 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754248AbcHXPhK (ORCPT + 1 other); Wed, 24 Aug 2016 11:37:10 -0400 Received: from smtp1.goneo.de ([85.220.129.30]:41446 "EHLO smtp1.goneo.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754192AbcHXPhI (ORCPT ); Wed, 24 Aug 2016 11:37:08 -0400 Received: from localhost (localhost [127.0.0.1]) by smtp1.goneo.de (Postfix) with ESMTP id D3EAA240E18; Wed, 24 Aug 2016 17:37:05 +0200 (CEST) X-Virus-Scanned: by goneo X-Spam-Flag: NO X-Spam-Score: -2.804 X-Spam-Level: X-Spam-Status: No, score=-2.804 tagged_above=-999 tests=[ALL_TRUSTED=-1, AWL=0.096, BAYES_00=-1.9] autolearn=unavailable Received: from smtp1.goneo.de ([127.0.0.1]) by localhost (smtp1.goneo.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id l8K0elAklV6m; Wed, 24 Aug 2016 17:36:30 +0200 (CEST) Received: from ubu1604.fritz.box (dyndsl-095-033-017-022.ewe-ip-backbone.de [95.33.17.22]) by smtp1.goneo.de (Postfix) with ESMTPSA id 6139D2425DB; Wed, 24 Aug 2016 17:36:30 +0200 (CEST) From: Markus Heiser To: Mauro Carvalho Chehab Cc: Markus Heiser , Jonathan Corbet , Jani Nikula , Linux Media Mailing List Subject: [PATCH 3/3] doc-rst:media: build separated PDF books (experimental) Date: Wed, 24 Aug 2016 17:36:16 +0200 Message-Id: <1472052976-22541-4-git-send-email-markus.heiser@darmarit.de> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1472052976-22541-1-git-send-email-markus.heiser@darmarit.de> References: <1472052976-22541-1-git-send-email-markus.heiser@darmarit.de> Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-PMX-Version: 6.0.0.2142326, Antispam-Engine: 2.7.2.2107409, Antispam-Data: 2016.8.24.153020 X-PMX-Spam: Gauge=IIIIIIII, Probability=8%, Report=' MULTIPLE_RCPTS 0.1, HTML_00_01 0.05, HTML_00_10 0.05, BODYTEXTP_SIZE_3000_LESS 0, BODY_SIZE_2000_2999 0, BODY_SIZE_5000_LESS 0, BODY_SIZE_7000_LESS 0, IN_REP_TO 0, LEGITIMATE_NEGATE 0, LEGITIMATE_SIGNS 0, MSG_THREAD 0, MULTIPLE_REAL_RCPTS 0, REFERENCES 0, URI_ENDS_IN_HTML 0, __ANY_URI 0, __CC_NAME 0, __CC_NAME_DIFF_FROM_ACC 0, __CC_REAL_NAMES 0, __CP_URI_IN_BODY 0, __FROM_DOMAIN_IN_ANY_CC2 0, __FROM_DOMAIN_IN_RCPT 0, __HAS_CC_HDR 0, __HAS_FROM 0, __HAS_MSGID 0, __HAS_X_MAILER 0, __HAS_X_MAILING_LIST 0, __HTTPS_URI 0, __INT_PROD_TV 0, __IN_REP_TO 0, __MIME_TEXT_ONLY 0, __MULTIPLE_RCPTS_CC_X2 0, __MULTIPLE_URI_TEXT 0, __REFERENCES 0, __SANE_MSGID 0, __TO_MALFORMED_2 0, __TO_NAME 0, __TO_NAME_DIFF_FROM_ACC 0, __TO_REAL_NAMES 0, __URI_IN_BODY 0, __URI_NS , __URI_WITH_PATH 0' From: Markus Heiser This patch is only to demonstrate, how to build separated PDF books of the media sub-folder and close open links with intersphinx. It is an experimental state (I detected an build error, which I have not yet traced deep). Builds PDFs of: * media_uapi.pdf: Linux Media Infrastructure userspace API * media_kapi.pdf: Media subsystem kernel internal API * dvb_drivers.pdf: Linux Digital TV driver-specific documentation * v4l_drivers.pdf: Video4Linux (V4L) driver-specific documentation It uses the intersphinx extension to close links which refer to content outside of the (small) pdf-book. The intersphinx links refer to the documentation served at url: https://www.linuxtv.org/downloads/v4l-dvb-apis-new/ E.g.: on page 154 of the media_kapi.pdf in paragraph """YUV Formats lists existing packed ...""" the 'YUV Formats' text refer to url: https://www.linuxtv.org/downloads/v4l-dvb-apis-new/media/uapi/v4l/subdev-formats.html#v4l2-mbus-pixelcode-yuv8 This is only a small example to illustrate how we can build small books and link them with intersphinx. Signed-off-by: Markus Heiser --- Documentation/media/conf.py | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/Documentation/media/conf.py b/Documentation/media/conf.py index bef927b..84575de 100644 --- a/Documentation/media/conf.py +++ b/Documentation/media/conf.py @@ -5,6 +5,21 @@ project = 'Linux Media Subsystem Documentation' tags.add("subproject") latex_documents = [ - ('index', 'media.tex', 'Linux Media Subsystem Documentation', + ('media_uapi', 'media_uapi.tex', 'Linux Media Infrastructure userspace API', + 'The kernel development community', 'manual'), + ('media_kapi', 'media_kapi.tex', 'Media subsystem kernel internal API', + 'The kernel development community', 'manual'), + ('dvb-drivers/index', 'dvb_drivers.tex', 'Linux Digital TV driver-specific documentation', + 'The kernel development community', 'manual'), + ('v4l-drivers/index', 'v4l_drivers.tex', 'Video4Linux (V4L) driver-specific documentation', 'The kernel development community', 'manual'), ] + +# Since intersphinx is not activated in the global Documentation/conf.py we +# activate it here. If times comes where it is activated in the global conf.py, +# we may have to drop these two lines. +extensions.append('sphinx.ext.intersphinx') +intersphinx_mapping = {} + +# add intersphinx inventory of the *complete* documentation from linuxtv.org +intersphinx_mapping['media'] = ('https://www.linuxtv.org/downloads/v4l-dvb-apis-new/', None)