From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from youngberry.canonical.com (youngberry.canonical.com [91.189.89.112]) by dpdk.org (Postfix) with ESMTP id A800B2BAE for ; Wed, 31 Aug 2016 09:50:16 +0200 (CEST) Received: from 1.general.paelzer.uk.vpn ([10.172.196.172] helo=localhost.localdomain) by youngberry.canonical.com with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.76) (envelope-from ) id 1bf0Ho-00011w-C9; Wed, 31 Aug 2016 07:50:16 +0000 From: Christian Ehrhardt To: christian.ehrhardt@canonical.com, thomas.monjalon@6wind.com, dev@dpdk.org Date: Wed, 31 Aug 2016 09:50:08 +0200 Message-Id: <1472629812-4397-1-git-send-email-christian.ehrhardt@canonical.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: References: Subject: [dpdk-dev] [PATCH v2 0/4] provide man pages for binaries provided by DPDK X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Aug 2016 07:50:16 -0000 *Updates in v2* - rebased to latest upstream - moved tools to their own guide section - fixed some wording and indents - properly marked fixed-width text elements - fixed some rst issues in devbind doc Hi, this is about providing manpages for the binaries installed by DPDK. Eventually people using commands expect at least something reasonable avalable behind "man command". Still it is a try to stick to the rst/sphinx based doc creation. I found that for three of the 5 binaries that are usually installed the current rst files are sufficient to make a meaningful man page: - testpmd - dpdk-pdump - dpd-procinfo To be clear, this is only meant for the binaries installed by DPDK, there is no reason to render all the guides and howto's as one huge manpage. Also this series doesn't strive to render the api doc as man pages, while this certainly might be possible and even reasonable for section "3 Library calls (functions within program libraries)". Finally I must beg a pardon - I'm no makefile magician and sometimes even prefer things that work compared to long cryptic lines with many special chars. Yet if someone has something reasonable to unify the copy&paste in patch #4 please let me know. Christian Ehrhardt (4): doc: move tool guides in their own subdirectory doc: rendering and installation of man pages doc: add basic invocation info for dpdk-pmdinfo doc: add basic invocation info for dpdk-devbind doc/guides/conf.py | 12 +++ doc/guides/index.rst | 1 + doc/guides/sample_app_ug/index.rst | 2 - doc/guides/sample_app_ug/pdump.rst | 144 --------------------------------- doc/guides/sample_app_ug/proc_info.rst | 71 ---------------- doc/guides/tools/devbind.rst | 143 ++++++++++++++++++++++++++++++++ doc/guides/tools/index.rst | 42 ++++++++++ doc/guides/tools/pdump.rst | 144 +++++++++++++++++++++++++++++++++ doc/guides/tools/pmdinfo.rst | 57 +++++++++++++ doc/guides/tools/proc_info.rst | 71 ++++++++++++++++ mk/rte.sdkdoc.mk | 2 +- mk/rte.sdkinstall.mk | 11 +++ 12 files changed, 482 insertions(+), 218 deletions(-) delete mode 100644 doc/guides/sample_app_ug/pdump.rst delete mode 100644 doc/guides/sample_app_ug/proc_info.rst create mode 100644 doc/guides/tools/devbind.rst create mode 100644 doc/guides/tools/index.rst create mode 100644 doc/guides/tools/pdump.rst create mode 100644 doc/guides/tools/pmdinfo.rst create mode 100644 doc/guides/tools/proc_info.rst -- 2.7.4