[dpdk-dev] [PATCH 09/11] doc: refresh headers list

Thomas Monjalon thomas.monjalon at 6wind.com
Mon Jan 18 10:47:07 CET 2016


2016-01-16 16:10, David Marchand:
> On Tue, Jan 12, 2016 at 3:06 PM, Mcnamara, John <john.mcnamara at intel.com> wrote:
> > From: dev [mailto:dev-bounces at 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


More information about the dev mailing list