From mboxrd@z Thu Jan 1 00:00:00 1970 From: Thomas Monjalon Subject: Re: [PATCH v2] doc: add coding standards documentation Date: Thu, 04 Jun 2015 11:49:49 +0200 Message-ID: <6992797.Cr2pidrT3F@xps13> References: <1431531022-29697-2-git-send-email-bruce.richardson@intel.com> <1627508.1SMo23WCxz@xps13> <20150604093330.GA4968@bricha3-MOBL3> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7Bit Cc: dev@dpdk.org To: Bruce Richardson Return-path: Received: from mail-wg0-f48.google.com (mail-wg0-f48.google.com [74.125.82.48]) by dpdk.org (Postfix) with ESMTP id 6FB2DBDC2 for ; Thu, 4 Jun 2015 11:50:41 +0200 (CEST) Received: by wgme6 with SMTP id e6so29277804wgm.2 for ; Thu, 04 Jun 2015 02:50:41 -0700 (PDT) In-Reply-To: <20150604093330.GA4968@bricha3-MOBL3> List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 2015-06-04 10:33, Bruce Richardson: > On Wed, Jun 03, 2015 at 07:35:32PM +0200, Thomas Monjalon wrote: > > 2015-06-03 14:58, Bruce Richardson: > > > Add coding standards document to guides directory. This document > > > codifies the current DPDK C coding conventions, to make it easier for > > > contributors to see the format their code should be in. > > > > > > Signed-off-by: Siobhan Butler > > > Signed-off-by: Bruce Richardson > > > > > > --- > > > > > > Updates in V2: > > > * Fixed file creation mode > > > * Removed blank line at end of file > > > * Adjusted coding blocks to be C language, rather than console, so as to > > > have correct syntax highlighting. > > > * Shortened longer lines by breaking lines at sentence - and > > > occasionally comma - boundaries. > > > --- > > > doc/guides/coding_standards/index.rst | 861 ++++++++++++++++++++++++++++++++++ > > > doc/guides/index.rst | 1 + > > > > This version seems very good. > > However, I have the feeling that coding_standards/ is not a good name: > > - "standards" word is a bit strong ; > > - "coding" seems too restrictive, maybe we would like to put > > more guidelines in this directory (thinking about file tree, compat and tests). > > Do you agree I rename it to guidelines/coding_style.rst? > > No problem, go with it! Acked-by: Thomas Monjalon Applied, thanks