Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: pass (athena.apache.org: domain of bchesneau@gmail.com
 designates 209.85.128.51 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAKmKYaAwfFBijBUY3LPNBxDkgUc-p0JN6m2=9D41Tk6L1yT_+Q@mail.gmail.com>
References: 
 <CAKmKYaB179aGmk13oCPGM4znOG9=p7K8AqCuD+2-vdsP3Ck4wg@mail.gmail.com>
	<CAPaJBx4NGpubbCGBEFH4GwXM53FF7tY0jDRovAUvXgW_zggWcA@mail.gmail.com>
	<CAKmKYaAwfFBijBUY3LPNBxDkgUc-p0JN6m2=9D41Tk6L1yT_+Q@mail.gmail.com>
Date: Mon, 20 May 2013 22:59:25 +0200
Message-ID: 
 <CAJNb-9oFhodU_rTdz=LCSRVxXavnwp2SE7XnNCy7poT_gBa5bA@mail.gmail.com>
Subject: Re: Getting rid of file lists in documentation Makefiles
From: Benoit Chesneau <bchesneau@gmail.com>
To: dev@couchdb.apache.org
Content-Type: multipart/alternative; boundary=20cf3074d22a93f2cd04dd2c9be0

--20cf3074d22a93f2cd04dd2c9be0
Content-Type: text/plain; charset=ISO-8859-1

On May 20, 2013 10:56 PM, "Dirkjan Ochtman" <dirkjan@ochtman.nl> wrote:
>
> On Mon, May 20, 2013 at 5:39 PM, Noah Slater <nslater@apache.org> wrote:
> > I'm torn on this issue.
> >
> > See:
> >
> > http://www.gnu.org/software/automake/manual/automake.html#Wildcards
> >
> > (Please read that whole section.)
> >
> > Summary is:
> >
> >  * Wildcards make it easy to distribute the wrong files (either too
many, or
> > too few)
> >
> >  * Wildcards are not portable
>
> Yes, I understand the concerns. On the other hand, I don't think most
> of those concerns apply cleanly to for example a Sphinx project. In
> particular, Sphinx already complains if src files are either missing
> or unused, so you'll get warnings about that. And Sphinx populates the
> build directory from scratch every time, so problems with the HTML
> output also seem fairly unlikely. On the other hand, forgetting to
> update the file lists in the Makefile.am will have no effect on
> building the docs, but will fail make distcheck. To me, at least, in
> this context, DRY a bigger concern to me.
>
> To be fair, portability is a concern. Dave, does the typical Windows
> build environment already have a find tool available to it? (Either
> just some compiled GNU tools or a full Cygwin environment?)
>
> > Please also consider that with Benoit's rcouch merge, we're moving away
from
> > Autotools entirely (I believe), so we will have the chance to throw off
/
> > simplify a lot of this stuff.
>
> Ah, yes. Do we have a time frame for that?

sometime this month but before the next.

- benoit
>
> > What are your thoughts having read that section?
>
> Still the same, in this particular context, for the reasons explained
above.
>
> Cheers,
>
> Dirkjan

--20cf3074d22a93f2cd04dd2c9be0--