From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm0-f42.google.com (mail-wm0-f42.google.com [74.125.82.42]) by dpdk.org (Postfix) with ESMTP id 00FF95A32 for ; Mon, 18 Jan 2016 10:48:08 +0100 (CET) Received: by mail-wm0-f42.google.com with SMTP id u188so96339825wmu.1 for ; Mon, 18 Jan 2016 01:48:08 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:organization:user-agent :in-reply-to:references:mime-version:content-transfer-encoding :content-type; bh=ghM16iIDEwmqQ2zfGQQsc6myZKseNmoMoMK2ERB66xI=; b=AtJVj/1rV6TN5KbRpO0cUXRFcfD3f+3hGUh3SKbu/2fu/i2BdFUwQzWYnOth1b+RE9 ytTLAiKdSZyZCvCgkkxIdstafEoXBzRbIVNLjgBveAf29nXn+F8wQRt2kunHT5baIi/7 gNka2YDaWOcJcxUUWB8iisk8pPRWZG7+rbW5DoUKxOSpdz5lKJjMqctYn+P3xBFl6Ry+ twAVx9zOyPNSN9It4GgswyyQrE2JzVj54ttdD2hBYZCSSLKy1hq6x8peHIXYBm3RFcmR ZZW/uc/BFiQV1TdPoiGQYYUCAb2OPSQqV1IYM5kDkc2hp9D+r3L6TqoXy02rhAjQD2p7 4quw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:organization :user-agent:in-reply-to:references:mime-version :content-transfer-encoding:content-type; bh=ghM16iIDEwmqQ2zfGQQsc6myZKseNmoMoMK2ERB66xI=; b=cV537Df+saCi+nRUkJUzuFsEmur+m7d3rpXq6edRMCXyKy/CAl3byasdhQ6+gtYMoJ dwuQP9XwGMTtswhX74EYGaEzyypceRcB1SPtxVEL4Pl2HGxdCT2FIREEa3GZJmq86t0B 2K3i5tbZURixsrwPmb5woaDXEeFImP7bXP68UsUjGWMs5KW0B9ysmb9jOx1FGJsuQAO1 mjs/YRZwq+SerGek7f96oNn0lnKn6xqkrNqZR9b+kbkYuugFSFsuK4lnlR7qo/V15Uu+ dx/EGSaZAWWHNNN3se98YXZszp++Ov0qpE6yJyH7X1uCEOdQbk9CiY0+kVdADciG9QdA xRNQ== X-Gm-Message-State: AG10YOQtngjGFy5voTNJ/lPWADPNEBs72rNafJmpVwA/7gs9PLXmwSN76gWlv1qImspxtFLZ X-Received: by 10.28.63.22 with SMTP id m22mr11330834wma.59.1453110488801; Mon, 18 Jan 2016 01:48:08 -0800 (PST) Received: from xps13.localnet (136-92-190-109.dsl.ovh.fr. [109.190.92.136]) by smtp.gmail.com with ESMTPSA id k130sm15024714wmg.6.2016.01.18.01.48.07 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 18 Jan 2016 01:48:08 -0800 (PST) From: Thomas Monjalon To: David Marchand Date: Mon, 18 Jan 2016 10:47:07 +0100 Message-ID: <132108025.ZOU8cKttrh@xps13> Organization: 6WIND User-Agent: KMail/4.14.10 (Linux/4.1.6-1-ARCH; KDE/4.14.11; x86_64; ; ) In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Cc: dev@dpdk.org Subject: Re: [dpdk-dev] [PATCH 09/11] doc: refresh headers list 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: Mon, 18 Jan 2016 09:48:09 -0000 2016-01-16 16:10, David Marchand: > On Tue, Jan 12, 2016 at 3:06 PM, Mcnamara, John wrote: > > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of David Marchand > >> Since we are going to remove a header in next commit, let's first refresh > >> documentation. > > > > I don't like these parts of the docs that list files since they > > go out of date quite easily and, in general, the same information > > can be conveyed by just listing the directories. (That isn't > > future-proof either but it should be less subject to change.) +1 > > $ ls > > app tools > > config MAINTAINERS > > Makefile GNUmakefile > > drivers mk > > examples pkg > > doc README > > lib scripts > > LICENSE.GPL LICENSE.LGPL > > i686-native-linuxapp-gcc x86_64-native-linuxapp-gcc > > i686-native-linuxapp-icc x86_64-native-linuxapp-icc > > > > $ ls x86_64-native-linuxapp-gcc > > app build include kmod lib Makefile > > > > Well, from my pov, it is the same issue here. > How about just removing all those files listings ? > I am not sure they really help. +1