From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-ob0-f172.google.com (mail-ob0-f172.google.com [209.85.214.172]) by dpdk.org (Postfix) with ESMTP id 8CA2F8E90 for ; Sat, 16 Jan 2016 16:11:01 +0100 (CET) Received: by mail-ob0-f172.google.com with SMTP id vt7so132458732obb.1 for ; Sat, 16 Jan 2016 07:11:01 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=ZuT2ows1kGIfljtxf/s+IdNKImCPRkmNrTCV9Lmeft0=; b=ffVk2mfZey97wdEL96f4c3muCRYUWS/hHAwWl6+Zotop+Y11ML5lOcIxfZ+GaBLFqS eGGqEVfv0MLhH75imBvwdvcwjSlPxpb1/aY/AzCIdU3nq1Jr0tnHmcRNyhQ+tFudxt6M 9Taksh1v6lLAX0GYOnI77zIZNVzXu+8bYUiDZEXRPAnwJND1WQDU90We0OAMk1Ykh99O 3rNsx7EtI5tGlk8+5Ge+1v/weLc33PK2tjBBTeJfUnmX/4ysmYPr2hU3YSeOCuHt0zaD spDZh7HDbsNfkRWaHWzXpJV/CPADdCAptS7uflCvKjUJegZyohRfe1qzIV4Ssy2diS/W jtOA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc:content-type; bh=ZuT2ows1kGIfljtxf/s+IdNKImCPRkmNrTCV9Lmeft0=; b=UEmp0WS70MGoc6ckLqczcxNpQeFXHoYF/knnjrlDoOxD4x9JhuG+Ov6/VFh4IJpuDd mJdMoKe3LcfC6t44s96uNx0a3/65CQIsa+g0rweIbwyfibDI+p3HZhVX6XO5rcPuw/+y 9ZUzG77MeZ2qgl9z64jpXeYchlUdq82IH/EEvzIukv1b7lwAyP3illLFS+ggZqs+Gdc7 bGS4dXNFhLLe9Co3bBROGjGUxmBICYkIbHZU9uR2YOqHV1JpmKNH5JfVZhvvegiZUnwr l7VMOenCndqjP2FxUmvaS45er7rpj0tCVA4LsqDe+EZryPgyIh5Zn0JP4stZnSVvd5XF EY4A== X-Gm-Message-State: ALoCoQnJbLwphELIOgL6L8JkT6OwnH8PhtuuE4bprhStYrHKZeJBsfm1/h4VKAJ0k/K9efYzHzlU91tCoAanjujJ7O7SM06iLY5AXsx11ngNZh6Gv7j16Zs= X-Received: by 10.182.60.170 with SMTP id i10mr12473773obr.62.1452957061035; Sat, 16 Jan 2016 07:11:01 -0800 (PST) MIME-Version: 1.0 Received: by 10.76.180.72 with HTTP; Sat, 16 Jan 2016 07:10:41 -0800 (PST) In-Reply-To: References: <1452430254-30390-1-git-send-email-david.marchand@6wind.com> <1452430254-30390-10-git-send-email-david.marchand@6wind.com> From: David Marchand Date: Sat, 16 Jan 2016 16:10:41 +0100 Message-ID: To: "Mcnamara, John" Content-Type: text/plain; charset=UTF-8 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: Sat, 16 Jan 2016 15:11:02 -0000 Hello John, On Tue, Jan 12, 2016 at 3:06 PM, Mcnamara, John wrote: >> -----Original Message----- >> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of David Marchand >> Sent: Sunday, January 10, 2016 12:51 PM >> To: dev@dpdk.org >> Cc: thomas.monjalon@dpdk.org >> Subject: [dpdk-dev] [PATCH 09/11] doc: refresh headers list >> >> 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.) Well, we could imagine something automatic (in the build process), but I agree that the quickest solution is to get rid of it. > > In this case you could just remove everything in the console section > after the output from "ls x86_64-native-linuxapp-gcc" like this: > > > Each build directory contains include files, libraries, and applications like the following:: > > $ 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. If we go with this, I will send this patch out of the series since it would not really belong to it. Regards, -- David Marchand