From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 44CD8A0509; Wed, 6 Apr 2022 19:10:39 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B195F42852; Wed, 6 Apr 2022 19:10:33 +0200 (CEST) Received: from mail-lf1-f51.google.com (mail-lf1-f51.google.com [209.85.167.51]) by mails.dpdk.org (Postfix) with ESMTP id BEB6A4014F for ; Wed, 6 Apr 2022 19:10:31 +0200 (CEST) Received: by mail-lf1-f51.google.com with SMTP id t25so5212775lfg.7 for ; Wed, 06 Apr 2022 10:10:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=o36aRFEl77hR+F6pvDZpVJ5cRqKfmPSpnhDyp1iyr44=; b=JDtfOTyHgp1WoVSelxkyj7hH/6IwEDT6GQNVB3+Zcx48COJ9NmBbwVAD/VYbuRFP8v +odoFHXHddNmRlWjpCaMsO8AArl+c8F4cPaIdruqIX2lcinba8LixlJ9TAuI3+5QvTPy Q1jz06uRzUYt0EkIwvjjQLyCXMM8IkRKaizTIVAr6RNTZyRMrA6ePDGITdF2aY4CRjvK fJBunKhoS+S3xH79maOj25ejcauxSoamhj6eD5wyiFY6hgHvitQvlRcmzlIOnrmRGxDO h0SpEDLyE3UAnViQwHzuGok6YR8qUJGgDUQEv9Y54U1mRM6S7AMO1aP3Ho1kO7kKSr/6 NT1w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=o36aRFEl77hR+F6pvDZpVJ5cRqKfmPSpnhDyp1iyr44=; b=RLCLqHiGPb92VXZGaTvdYwKX+r4pvRuJhgUDvGIQzfdPGmD8FOKN6J8SJrAbURbCgY 2AWANI86+myU2B565+9aI8JZ2KyAks1ng/k6KRVE4ZYZy5Fd6IaVDPxCeH6+clJc1pO7 9zuPV90nGP6fEt9jn79gTg9+npL4PvNMloUBODzPmRNoREdAHcgRLWirpMMeYJTfwE99 BkP/q0LDOvqhWkDcajLdr/78Tuhi/9JGCHIA2I4lQAAYpnBHM6jDD7+H8ob+/F8qnRuw yp3cd4pasX26P3XWBMg3I5jTcfGWXOTMxMZ2fV5UEnbnG3QWuq/NAWAESaXIxB23Yti7 MprA== X-Gm-Message-State: AOAM532jq5MREDSda1p51UB/zMzGTjnlqNqjhcMDZ01nfG5MJnr9bn9K LdtXBR6bxhYOV3BAdqIbS/16oAX5Hko= X-Google-Smtp-Source: ABdhPJwbVdAB35mBFdVH2rIO7ck+nGlOBjcOqXE2lLMBqzTlhg+cwVK0psk8Q3ICSwEbrVOE3Tzavw== X-Received: by 2002:a05:6512:3da1:b0:44a:2aeb:28e4 with SMTP id k33-20020a0565123da100b0044a2aeb28e4mr6410908lfv.579.1649265031007; Wed, 06 Apr 2022 10:10:31 -0700 (PDT) Received: from sovereign.. (broadband-37-110-65-23.ip.moscow.rt.ru. [37.110.65.23]) by smtp.gmail.com with ESMTPSA id e23-20020a196757000000b0044a27dced95sm1887769lfj.3.2022.04.06.10.10.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 06 Apr 2022 10:10:30 -0700 (PDT) From: Dmitry Kozlyuk To: dev@dpdk.org Cc: Vipin Varghese , Dmitry Kozlyuk Subject: [PATCH v2 1/3] doc: simplify CSS customization for Doxygen Date: Wed, 6 Apr 2022 20:10:10 +0300 Message-Id: <20220406171012.87759-2-dmitry.kozliuk@gmail.com> X-Mailer: git-send-email 2.29.3 In-Reply-To: <20220406171012.87759-1-dmitry.kozliuk@gmail.com> References: <20220331212830.708912-1-dmitry.kozliuk@gmail.com> <20220406171012.87759-1-dmitry.kozliuk@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org CSS for API documentation was customized by a shell script modifying the file that Doxygen produces. This way CSS code is kept in a script and an extra build step is added. Move custom style to a plain CSS file. Use Doxygen capability to attach this extra stylesheet. Signed-off-by: Dmitry Kozlyuk --- doc/api/custom.css | 6 ++++++ doc/api/doxy-api.conf.in | 1 + doc/api/doxy-html-custom.sh | 8 -------- doc/api/generate_doxygen.sh | 3 --- doc/api/meson.build | 3 +-- 5 files changed, 8 insertions(+), 13 deletions(-) create mode 100644 doc/api/custom.css delete mode 100755 doc/api/doxy-html-custom.sh diff --git a/doc/api/custom.css b/doc/api/custom.css new file mode 100644 index 0000000000..66360f9b48 --- /dev/null +++ b/doc/api/custom.css @@ -0,0 +1,6 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright 2013 6WIND S.A. + */ + +/* space between item and its comment */ +dd td:first-child { padding-right: 2em; } diff --git a/doc/api/doxy-api.conf.in b/doc/api/doxy-api.conf.in index db2ca9b6ed..8e961cbc8c 100644 --- a/doc/api/doxy-api.conf.in +++ b/doc/api/doxy-api.conf.in @@ -102,6 +102,7 @@ ALPHABETICAL_INDEX = NO HTML_TIMESTAMP = NO HTML_DYNAMIC_SECTIONS = YES +HTML_EXTRA_STYLESHEET = @TOPDIR@/doc/api/custom.css SEARCHENGINE = YES SORT_MEMBER_DOCS = NO SOURCE_BROWSER = YES diff --git a/doc/api/doxy-html-custom.sh b/doc/api/doxy-html-custom.sh deleted file mode 100755 index 3802007c8c..0000000000 --- a/doc/api/doxy-html-custom.sh +++ /dev/null @@ -1,8 +0,0 @@ -#! /bin/sh -e -# SPDX-License-Identifier: BSD-3-Clause -# Copyright 2013 6WIND S.A. - -CSS=$1 - -# space between item and its comment -echo 'dd td:first-child {padding-right: 2em;}' >> $CSS diff --git a/doc/api/generate_doxygen.sh b/doc/api/generate_doxygen.sh index 1350e50491..1940ea46e2 100755 --- a/doc/api/generate_doxygen.sh +++ b/doc/api/generate_doxygen.sh @@ -4,12 +4,9 @@ DOXYCONF=$1 OUTDIR=$2 -SCRIPTCSS=$3 OUT_FILE=$(dirname $OUTDIR)/doxygen.out # run doxygen, capturing all the header files it processed doxygen "${DOXYCONF}" > $OUT_FILE echo "$OUTDIR: $(awk '/Preprocessing/ {printf("%s ", substr($2, 1, length($2) - 3))}' $OUT_FILE)" > $OUTDIR.d - -"${SCRIPTCSS}" "${OUTDIR}"/doxygen.css diff --git a/doc/api/meson.build b/doc/api/meson.build index 5c25b92092..53338a02d6 100644 --- a/doc/api/meson.build +++ b/doc/api/meson.build @@ -13,7 +13,6 @@ endif # script to run the CSS modification afterwards generate_doxygen = find_program('generate_doxygen.sh') generate_examples = find_program('generate_examples.sh') -generate_css = find_program('doxy-html-custom.sh') htmldir = join_paths(get_option('datadir'), 'doc', 'dpdk') @@ -52,7 +51,7 @@ doxy_build = custom_target('doxygen', input: doxy_conf, output: 'html', depfile: 'html.d', - command: [generate_doxygen, '@INPUT@', '@OUTPUT@', generate_css], + command: [generate_doxygen, '@INPUT@', '@OUTPUT@'], install: get_option('enable_docs'), install_dir: htmldir, build_by_default: get_option('enable_docs')) -- 2.29.3