Show a cover letter.

GET /api/covers/44144/
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 44144,
    "url": "http://patches.dpdk.org/api/covers/44144/",
    "web_url": "http://patches.dpdk.org/cover/44144/",
    "project": {
        "id": 1,
        "url": "http://patches.dpdk.org/api/projects/1/",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "dev.dpdk.org",
        "list_email": "dev@dpdk.org",
        "web_url": "http://core.dpdk.org",
        "scm_url": "git://dpdk.org/dpdk",
        "webscm_url": "http://git.dpdk.org/dpdk"
    },
    "msgid": "<20180831182055.30772-1-bluca@debian.org>",
    "date": "2018-08-31T18:20:51",
    "name": "[0/4] Meson: build Doxygen documentation",
    "submitter": {
        "id": 823,
        "url": "http://patches.dpdk.org/api/people/823/",
        "name": "Luca Boccassi",
        "email": "bluca@debian.org"
    },
    "mbox": "http://patches.dpdk.org/cover/44144/mbox/",
    "series": [
        {
            "id": 1148,
            "url": "http://patches.dpdk.org/api/series/1148/",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=1148",
            "date": "2018-08-31T18:20:51",
            "name": "Meson: build Doxygen documentation",
            "version": 1,
            "mbox": "http://patches.dpdk.org/series/1148/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/44144/comments/",
    "headers": {
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "Cc": "bruce.richardson@intel.com, john.mcnamara@intel.com,\n\tmarko.kovacevic@intel.com, thomas@monjalon.net",
        "X-Original-To": "patchwork@dpdk.org",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20161025;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id;\n\tbh=+U32wZS7RKYC3tzk2fGI80enT3ZioJNDdjrEivbn8+k=;\n\tb=l94ZBfCLanyLXZnjo8vK3uhIX32aojyV4UAQKpvpsemjjbbyIaNhTnz5vESzPIkRl5\n\tMye06g6cFG3JPRbIlgQ+Y/BJ9brWtDx5Pfdp1w5jKm6zYoNCYBJ7pw9iMEuYiRGW9G1v\n\tUyVgMU/qwTIjJVrwG/am6tmj/3KOYjCuAiFCgloNLnNsCq3ABBv2BsV63dfOlBsAG0yY\n\t0jrgZVHCvBGKgGDB6U+s8401Ppo+/l4Fz7ti5HDiIytIxI+l6ex6vyIKYVVMhd5qOMxy\n\tpe8EF2abhVHu+OV0ZWSjAPmDW+X67zOgvVMbzbS8OTnF5KSxJvL4zYdfKepMblsqqNkq\n\thDAw==",
        "Date": "Fri, 31 Aug 2018 19:20:51 +0100",
        "Precedence": "list",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailer": "git-send-email 2.18.0",
        "X-Gm-Message-State": "APzg51DyToinZRFkgxv+5wLU6C+QZPriLRTPFaghpeILClfuiqlcdaGB\n\t/yKzOLBpmGe36VI5YQrD6Na+sw+I",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "To": "dev@dpdk.org",
        "Errors-To": "dev-bounces@dpdk.org",
        "X-Google-Smtp-Source": "ANB0VdYuP6D3cd70u72OZuwE6iHkcldWJgzLgiy+DRun3k52m62mLW+h3YKGIgq+Jv6Esy6QNUnTzw==",
        "Received": [
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id AEF4358F6;\n\tFri, 31 Aug 2018 20:21:07 +0200 (CEST)",
            "from mail-wm0-f48.google.com (mail-wm0-f48.google.com\n\t[74.125.82.48]) by dpdk.org (Postfix) with ESMTP id 9F4B84CAB\n\tfor <dev@dpdk.org>; Fri, 31 Aug 2018 20:21:06 +0200 (CEST)",
            "by mail-wm0-f48.google.com with SMTP id o18-v6so6197977wmc.0\n\tfor <dev@dpdk.org>; Fri, 31 Aug 2018 11:21:06 -0700 (PDT)",
            "from localhost ([2a01:4b00:f419:6f00:8361:8946:ba2b:d556])\n\tby smtp.gmail.com with ESMTPSA id\n\t200-v6sm9343422wmv.6.2018.08.31.11.21.04\n\t(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);\n\tFri, 31 Aug 2018 11:21:04 -0700 (PDT)"
        ],
        "From": "Luca Boccassi <bluca@debian.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "Message-Id": "<20180831182055.30772-1-bluca@debian.org>",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "Subject": "[dpdk-dev] [PATCH 0/4] Meson: build Doxygen documentation",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n\t<mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "Return-Path": "<dev-bounces@dpdk.org>",
        "Delivered-To": "patchwork@dpdk.org",
        "X-Received": "by 2002:a1c:ac1:: with SMTP id\n\t184-v6mr5310654wmk.119.1535739666019; \n\tFri, 31 Aug 2018 11:21:06 -0700 (PDT)",
        "X-Mailman-Version": "2.1.15"
    },
    "content": "I have tested this by using diffoscope between the docs built by the\nmakefiles and by this Meson patchset, and verified they are all\nidentical.\n\nThere are both a new \"doc\" target (ninja doc) and a configuration\noption. This is due to the following bug in Meson:\nhttps://github.com/mesonbuild/meson/issues/4107\nbecause of it it's not possible to have simply an optional target,\nas its files will not be installed.\nSo by default the documentation is off, if one wants to just build it\n'ninja doc' can be used, but if one wants to both build and install\nthe config option 'enable_docs' has to be enabled.\n\nA couple of small refactoring was done to the makefile doc build, to\nmake things easier and doable by both build systems.\n\nLuca Boccassi (4):\n  mk: use script to generate examples.dox\n  mk: use templated doxygen config, modified on the fly\n  build: use same version as make showversion in Meson\n  build: generate API documentation with Meson\n\n doc/api/doxy-api.conf        | 87 --------------------------------\n doc/api/doxy-api.conf.in     | 96 ++++++++++++++++++++++++++++++++++++\n doc/api/generate_doxygen.sh  | 10 ++++\n doc/api/generate_examples.sh | 14 ++++++\n doc/api/meson.build          | 51 +++++++++++++++++++\n doc/build-sdk-meson.txt      |  2 +\n doc/meson.build              |  4 ++\n meson.build                  |  5 +-\n meson_options.txt            |  2 +\n mk/rte.sdkdoc.mk             | 21 +++-----\n 10 files changed, 191 insertions(+), 101 deletions(-)\n delete mode 100644 doc/api/doxy-api.conf\n create mode 100644 doc/api/doxy-api.conf.in\n create mode 100755 doc/api/generate_doxygen.sh\n create mode 100755 doc/api/generate_examples.sh\n create mode 100644 doc/api/meson.build\n create mode 100644 doc/meson.build"
}