From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wr1-f66.google.com (mail-wr1-f66.google.com [209.85.221.66]) by dpdk.org (Postfix) with ESMTP id 9B1CB4CA7 for ; Mon, 10 Sep 2018 22:10:04 +0200 (CEST) Received: by mail-wr1-f66.google.com with SMTP id s14-v6so14295259wrw.6 for ; Mon, 10 Sep 2018 13:10:04 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=ys9IJNs+xYGj53wT2wMGuU5uJiXBD+rKnF5jk0EjsP0=; b=EVxVYsTFYblEZMU9h3k0LcRBmPqGJmaiCgkJGtp/E1suaa5NlxJJklWrkug89e2gUH JitajHRh71OoHtcdk0oCgR62yhmh46FhCUgsBMFESZrwCkH9yBAJd0p2c8IL86zPPy9c uht36WW1et0zHm6TqSXPByFLfvR9+StQZTOLBt4HzqOrru0anHN2GbRgFEmWEls2gAHK 4a1Xx1IxQUiy1IWXOlDfCokMLedQgyeuUgLDOtYIJJM9uBk7B6X8wo7ZvRjKE3UxsJIx nTcJraqWeVXVYHCeGRIKMeUOYjF7slyi8Wqkmf5kFcCERFPDGcsx/TKhMH4Ud0KHQZuT E6QA== X-Gm-Message-State: APzg51DQOExEqe/M8YUVn/XkgIT2SbJCk3Z84f6++LLivL7RdEOnjdgI fsJ+sqjYe5zgirXYxJrWmUMWesxhW9c= X-Google-Smtp-Source: ANB0VdY2OiXGNGs+qn5hKFheEYdZC/5Uo0JN82vSRJzXm/5fXgTDVSo9+jS6l4nAdIiujG6RaFT+pA== X-Received: by 2002:a5d:66d2:: with SMTP id k18-v6mr16392949wrw.154.1536610203956; Mon, 10 Sep 2018 13:10:03 -0700 (PDT) Received: from localhost ([2a01:4b00:f419:6f00:8361:8946:ba2b:d556]) by smtp.gmail.com with ESMTPSA id a11-v6sm15228770wrr.81.2018.09.10.13.10.02 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 10 Sep 2018 13:10:02 -0700 (PDT) From: Luca Boccassi To: dev@dpdk.org Cc: bruce.richardson@intel.com, john.mcnamara@intel.com, marko.kovacevic@intel.com, thomas@monjalon.net Date: Mon, 10 Sep 2018 21:09:57 +0100 Message-Id: <20180910201000.11243-1-bluca@debian.org> X-Mailer: git-send-email 2.18.0 In-Reply-To: <20180831182055.30772-1-bluca@debian.org> References: <20180831182055.30772-1-bluca@debian.org> Subject: [dpdk-dev] [PATCH v4 1/4] mk: use script to generate examples.dox X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Sep 2018 20:10:04 -0000 This will make it possible to generate the file in the same way from Meson as well. Signed-off-by: Luca Boccassi Acked-by: Bruce Richardson --- v2: simplified script by using exec > file v4: add acked-by doc/api/generate_examples.sh | 12 ++++++++++++ mk/rte.sdkdoc.mk | 5 +---- 2 files changed, 13 insertions(+), 4 deletions(-) create mode 100755 doc/api/generate_examples.sh diff --git a/doc/api/generate_examples.sh b/doc/api/generate_examples.sh new file mode 100755 index 0000000000..6fcfe513b6 --- /dev/null +++ b/doc/api/generate_examples.sh @@ -0,0 +1,12 @@ +#! /bin/sh -e +# SPDX-License-Identifier: BSD-3-Clause +# Copyright 2018 Luca Boccassi + +EXAMPLES_DIR=$1 +API_EXAMPLES=$2 + +exec > "${API_EXAMPLES}" +printf '/**\n' +printf '@page examples DPDK Example Programs\n\n' +find "${EXAMPLES_DIR}" -type f -name '*.c' -printf '@example examples/%P\n' | LC_ALL=C sort +printf '*/\n' diff --git a/mk/rte.sdkdoc.mk b/mk/rte.sdkdoc.mk index bd2e5763df..d023b720fe 100644 --- a/mk/rte.sdkdoc.mk +++ b/mk/rte.sdkdoc.mk @@ -63,10 +63,7 @@ api-html-clean: $(API_EXAMPLES): api-html-clean $(Q)mkdir -p $(@D) - @printf '/**\n' > $(API_EXAMPLES) - @printf '@page examples DPDK Example Programs\n\n' >> $(API_EXAMPLES) - @find examples -type f -name '*.c' -printf '@example %p\n' | LC_ALL=C sort >> $(API_EXAMPLES) - @printf '*/\n' >> $(API_EXAMPLES) + $(Q)doc/api/generate_examples.sh examples $(API_EXAMPLES) guides-pdf-clean: guides-pdf-img-clean guides-pdf-img-clean: -- 2.18.0