← Back to team overview

kicad-developers team mailing list archive

Re: Commit 67230ac8e761d45560ef5611ea3aa8d8152ccb29

 

git clean -f

On Wed, Aug 31, 2016 at 04:25:30AM +1200, Simon Wells wrote:
> I realise this was probably discussed to death back when it was first
> on the list, but i haven't been able to find the previous discussion..
> 
> is there a make clean/similar command that will clear out these
> autogenerated files?
> 
> As if someone awked the generated file and broke it then it could
> require some effort to work out which file is autogenerated, where it
> is and how to clear it out to be able to do a fresh build. As most of
> the documentation recommends out of tree builds most people probably
> believe that trashing the build folder is sufficient for doing this..
> 
> Simon
> 
> 
> 
> On Mon, Aug 29, 2016 at 6:28 PM, jp charras <jp.charras@xxxxxxxxxx> wrote:
> > Le 29/08/2016 à 00:03, Wayne Stambaugh a écrit :
> >> The original decision to do it this way was made for very valid and
> >> logical reasons which I enumerated.  A similar patch has been sent to
> >> the project before and rejected for the same reasons.  Nothing has
> >> changed in regard to the original decision.  This probably happened
> >> before you where part of the project so it is understandable that you
> >> did not know.  I am not upset that it got committed, I am just saying
> >> that it should not have been committed.  I hope that clears things up.
> >> I do understand that some developers have this militant attitude that
> >> there should be *no* generated source in the source tree.  I just don't
> >> agree with that.
> >
> > I also think these generated files, not depending on the compiler, or any version should be in the
> > source tree, like any other .cpp or .h source file, regardless the way they are created, and
> > therefore the commit is not a good idea.
> >
> > Kicad contains roughly 25% of cpp .and .h files (icons and wxFormbuilder files) that are
> > automatically created.
> >
> > "no generated source in the source tree" is not a good idea.
> >
> > You sometimes need to open them with a text editor (especially for dialogs), or grep them.
> > Or they must be found by Poedit.
> >
> > And *yes* I already opened in my editor some auto-generated files like specctra_keywords.cpp and
> > page_layout_reader_lexer.h
> > Not every day, but it happened.
> >
> > So I really prefer to see them in the normal source tree.
> >
> >>
> >> On 8/28/2016 5:47 PM, Chris Pavlina wrote:
> >>> Quick poll. How many other people here think the generated files should
> >>> be in the source tree? Also, how many other people would have considered
> >>> moving them out and putting them with all the _other_ generated files to
> >>> be a potentially controversial commit?
> >>>
> >>> On Sun, Aug 28, 2016 at 05:30:10PM -0400, Wayne Stambaugh wrote:
> >>>> This commit
> >>>>
> >>>> https://git.launchpad.net/kicad/commit/?id=67230ac8e761d45560ef5611ea3aa8d8152ccb29
> >>>>
> >>>> should not have happened without discussion.  I should have nipped it in
> >>>> the bud before it got committed but I was busy visiting family.  This
> >>>> has been discussed before and the decision was made to do it this way
> >>>> because the files generated in the source tree were not configuration
> >>>> dependent and only need to be generated once(except the opengl shader
> >>>> generator which is a separate issue).  If a file is configuration
> >>>> dependent i.e. version.h and config.h, then is should be in the build
> >>>> path because it can be different depending on the build configuration.
> >>>> If it's not configuration dependent i.e. all of the s-expr files, it
> >>>> should stay in the source path because it is the same for every
> >>>> configuration.  It's also nice to be able to grep the s-expr files in
> >>>> the source tree as your writing your new file format rather than having
> >>>> to change to the build path.
> >>>>
> >>>> Please do not make the "there should never be generated source files in
> >>>> the source tree" argument.  This argument is flawed and leans too close
> >>>> to zealotry for my tastes.   The idea that your source tree is going to
> >>>> stay pristine is delusional.  Most editors and the patch command leave
> >>>> plenty of cruft in your source tree.
> >>>>
> >>>> Cheers,
> >>>>
> >>>> Wayne
> >
> >
> > --
> > Jean-Pierre CHARRAS
> >
> > _______________________________________________
> > Mailing list: https://launchpad.net/~kicad-developers
> > Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
> > Unsubscribe : https://launchpad.net/~kicad-developers
> > More help   : https://help.launchpad.net/ListHelp
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~kicad-developers
> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-developers
> More help   : https://help.launchpad.net/ListHelp


References