From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by dpdk.space (Postfix) with ESMTP id 793E1A0096 for ; Wed, 5 Jun 2019 12:39:43 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 28B501B9F4; Wed, 5 Jun 2019 12:39:43 +0200 (CEST) Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id C0DD71B9F1 for ; Wed, 5 Jun 2019 12:39:41 +0200 (CEST) X-Amp-Result: UNSCANNABLE X-Amp-File-Uploaded: False Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 05 Jun 2019 03:39:40 -0700 X-ExtLoop1: 1 Received: from bricha3-mobl.ger.corp.intel.com ([10.237.221.51]) by fmsmga005.fm.intel.com with SMTP; 05 Jun 2019 03:39:38 -0700 Received: by (sSMTP sendmail emulation); Wed, 05 Jun 2019 11:39:38 +0100 Date: Wed, 5 Jun 2019 11:39:37 +0100 From: Bruce Richardson To: Thomas Monjalon Cc: bluca@debian.org, dev@dpdk.org Message-ID: <20190605103937.GB1550@bricha3-MOBL.ger.corp.intel.com> References: <15005345.pJipbXyxuh@xps> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <15005345.pJipbXyxuh@xps> User-Agent: Mutt/1.11.4 (2019-03-13) Subject: Re: [dpdk-dev] meson reference guide 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On Wed, Jun 05, 2019 at 12:27:34PM +0200, Thomas Monjalon wrote: > Hi, > > For the make build system, we have doc/build-sdk-quick.txt > which is very short and displayed with "make help" for a quick reference. > > For meson, we have doc/build-sdk-meson.txt which is in reality > a full guide formatted in rst. > Should it be moved in Sphinx guides? Probably. > Do we want a really short guide for the basic commands, including > runnning the tests or build the doc? with other basic tooling? > Yes for a short guide, but not sure I'd include tests and building docs in it. I'd suggest just starting with the first section alone of the existing doc. For further docs, links to the online documentation on dpdk.org should suffice rather than needing instructions on building the docs locally. /Bruce