Re: [MAT-devel] re-organizing the cvs?

[Mario de S. <ms...@fe...>]

Jiri Baum wrote:
> 
> Mario:
> > What exactly does it take to re-organize the cvs? Can we do it ourselves
> > without depending on sourceforge manual intervention?
> 
> Unfortunately it's a fair bit of bother for all involved and would involve
> SF manual intervention.
> 

 Right then, we will have to do without it.


> 
> >   - All Makefile become Makefile.in
> >     This will allow us to start using autoconf.
> 
> I think Makefile.in would be fairly different anyway?

 Yes, we can do this without re-organizing the cvs, we just loose the
history to the Makefile's. I guess it isn't a great loss.


> 
> >   - Create a /doc/web directory for our web page files.
> 
> Right now the entire /doc directory is the web
> 
> In some ways, is there any point in having documentation that's *not* on
> the web? After all, the whole CVS tree is web-browseable and public anyway.
> 

 Right then. Just try to keep the number of files directly under /doc to
a minimum. Is this OK by you?


> >   - rename /doc/smm to /doc/architecture (or something similar). I would
> >     like to reserve this directory for source code documentation.
> 
> Good idea - though I'd suggest a shorter name; also architecture can mean
> the kind of computer it runs on, so something else might be better.
> 

 I don't like architecture myself. I just couldn't think of anything
better...

> We can do this right now, because there's only the two documents in doc/smm

 Yes, but once again: we lose the file history... no big bother...
etc...

> 
> >   - Move the /drivers/modbus.xxx directories to /io/modbus/?????
> >     These are not really device drivers, but a library of functions
> >     implementing the modbus protocol. I think we were reserving the
> >     /drivers directory for device drivers?
> 
> Yes.
> 

 Sine we are not going to re-organize the cvs, let's put this on hold.
The modbus module doesn't compile at the moment, so we might just take
care of this when we eventually get to this module...



 BTW, how about a /doc/whitepapers directory for the lplc-article, and
similar documents?



  Mario.

-- 
----------------------------------------------------------------------------
  Mario J. R. de Sousa                                    
ms...@fe...
----------------------------------------------------------------------------

    The box said it requires Windows 95 or better, so I installed Linux