[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

gEDA-dev: gEDA/gaf CVS changes




Hi all,

I've done a few rather drastic things tonight.  Sorry for the sudden
changes, but I couldn't wait due to greater migration pains later.


1) I've created a brand new toplevel CVS directory in the gEDA repository
   called:  gaf    The full path from the usual CVSROOT is:
   /home/cvspsrv/cvsroot/eda/geda/gaf

   The old geda/devel directory will stick around for a couple of weeks
   and then I will move it to old/devel or such.  Why devel is sticking
   around for a few weeks will be made clear below.  I will send out 
   e-mail before I move the devel directory.

Now why did I do this:

2) I have checked in a patch by Jason Childs that translates all libgeda
   noweb files, documentation and all, into just plain C files.   Why did
   I finally allow this to happen?  Well, mainly because the .nw files
   were scaring away new developers and frightening the existing ones. :)

   Serious, as much as I liked noweb, the new doxygen generated html/latex
   is far more readable and useful to the developers.   The noweb
   experiment was interesting, but it's time to get back to plain C
   files again.  (plus I'm tired of answering "What the heck is a
   .nw file?" and unless you used emacs, editing noweb files was painful).

   Here is a temp link to the generated documentation (it can be generated
   by installing the new CVS release, installing doxygen, graphwiz, and
   running: make doxygen   in libgeda/docs):

   http://geda.seul.org/misc/libgeda_doxygen_20060704

   I will put all generated docs in a sane place on the website once
   the gschem conversion is complete.

Other changes:

3) I have removed the geda targets from the toplevel Makefile.  This means
   that the gmanager (geda) program is no longer going to be built or 
   distributed. 

4) More changes to come: I have a patch to the glib slice problem that
   I too need to migrate to the C files, gschem's use of noweb removal,
   removal/reorg of the docs package to use content from the wiki pages,
   cygwin/mingw update patches, and a few others I can't remember
   right now.
    

Here's the migration plan:

1) New developers should switch to checking out geda/gaf:  

   cvs co geda/gaf

   as soon as possible. I have updated the devel webpage to reflect this.
   http://geda.seul.org/developer.html

2) Existing developers have two choices:

   - Migrate their in progress changes to the new src/*.c files themselves
     in geda/gaf and then stop usin geda/devel and start using geda/gaf.

   -or-

   - Check them into the old devel repository and send Ales an e-mail
     to migrate the changes.  Yes, I'm volunteering to help other developers
     migrate over their changes, especially since I created this 
     disturbance in the CVS repository.


Thank you, Jason, for the noweb removal patch, doxygen integration, and
C source files that preserves all the embedded noweb documentation in
one form or another.  This is a ton of work and it is greatly appreciated.

If people are wondering why I did this so suddenly, mainly because I
didn't want the noweb files to get too much out of sync with C files
that Jason created.  I had to migrate the changes that Mike and I made
in the past few days and I want to get all such migrations done within
the next few weeks.

Please send all comments, suggestions, "What the ?", and flames my way.  

-Ales

_______________________________________________
geda-dev mailing list
geda-dev@moria.seul.org
http://www.seul.org/cgi-bin/mailman/listinfo/geda-dev