From: Thomas Monjalon <thomas.monjalon@6wind.com>
To: Ferruh Yigit <ferruh.yigit@intel.com>
Cc: John McNamara <john.mcnamara@intel.com>, dev@dpdk.org
Subject: Re: [dpdk-dev] [PATCH v2] doc: automate examples file list for API doc
Date: Wed, 08 Feb 2017 13:08:28 +0100 [thread overview]
Message-ID: <1665905.OHHQAK7vyE@xps13> (raw)
In-Reply-To: <20170127173728.21618-1-ferruh.yigit@intel.com>
2017-01-27 17:37, Ferruh Yigit:
> These files are linked to API documentation as usage samples, list of
> files created automatically during doc creation.
>
> Remove manually updated old one.
>
> Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
[...]
> +API_EXAMPLES := $(RTE_OUTPUT)/doc/html/examples.dox
I feel it should be in $(RTE_OUTPUT)/doc/ because the doc could be generated
in another format (not HTML only).
[...]
> @echo 'doxygen for API...'
> $(Q)mkdir -p $(RTE_OUTPUT)/doc/html
> $(Q)(cat $(RTE_SDK)/doc/api/doxy-api.conf && \
> + echo INPUT += $(API_EXAMPLES) && \
> printf 'PROJECT_NUMBER = ' && \
> $(MAKE) -rR showversion && \
It would be nicer to see INPUT here.
> echo OUTPUT_DIRECTORY = $(RTE_OUTPUT)/doc && \
[...]
> +$(API_EXAMPLES):
> + $(Q)mkdir -p $(RTE_OUTPUT)/doc/html
> + @echo "/**" > $(API_EXAMPLES)
> + @echo "@page examples DPDK Example Programs" >> $(API_EXAMPLES)
> + @echo "" >> $(API_EXAMPLES)
> + @find examples -type f -name "*.c" | awk '{ print "@example", $$0 }' >> $(API_EXAMPLES)
May I suggest this simpler syntax?
find examples -type f -name '*.c' -printf '@example %p\n'
Please prefer simple quotes where possible.
next prev parent reply other threads:[~2017-02-08 12:08 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-01-27 11:55 [dpdk-dev] [PATCH] doc: update examples list for API Ferruh Yigit
2017-01-27 13:11 ` De Lara Guarch, Pablo
2017-01-27 15:56 ` Thomas Monjalon
2017-01-27 17:03 ` Ferruh Yigit
2017-01-27 17:37 ` [dpdk-dev] [PATCH v2] doc: automate examples file list for API doc Ferruh Yigit
2017-02-08 12:08 ` Thomas Monjalon [this message]
2017-02-08 17:35 ` Ferruh Yigit
2017-02-08 17:54 ` [dpdk-dev] [PATCH v3] " Ferruh Yigit
2017-02-08 18:12 ` Thomas Monjalon
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1665905.OHHQAK7vyE@xps13 \
--to=thomas.monjalon@6wind.com \
--cc=dev@dpdk.org \
--cc=ferruh.yigit@intel.com \
--cc=john.mcnamara@intel.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).