At 03:10 15/3/01 +0100, Ceki Gülcü wrote:
>>For Ant, I made a separate directory for the webpages (webpage). I had to do
>>this anyway since there was already an index.html file in the Ant docs
>>directory, although I have subsequently moved that.
>
>As Jon pointed out earlier, I do not see the advantage for distinguishing
>between documentation and the web pages. It is quite pleasant to be able to
>browse a project web site locally on a file system without requiring a
network
>connection.
depends on whats on the web-pages. If there is a lot of fluff/volatile
material then it can be confusing. Volatile/non-relevent stuff (ie
bug-reports/ news/ patches-to-apply/ branch statuses etc) should be left
out. Then again all the projects I work on have a www directory that is
identical to docs directory ;)
>>build directory
>>================
>>Many of the Jakarta projects put the build files in the project's root
>>directory and use the build directory for build results, such as build
>>classes which will be jarred up into the distribution
>
>So by build/ you actually mean the dist/ directory of the dirlayout.html
document. As far as I can see there is nothing wrong with that except that if
>we make a choice regardless of what it is we should stick to it, a bit like
>indentation I guess.
Gonna have to disagree. You do whats best when there is no significant
advantage of doing it otherways. Standardizing on a crap standard because
someone decrees it a standard is near lunacy.
A lot of projects use dist/, in my personal projects I use out/ while some
projects use bin/.
>Jon, explained that the build/lib is for building (compiling) and lib/ for
>runtime. I confess that I don't really understand the difference... See also
>the last paragraph of this note.
Other projects use tools/lib/* for build/lib. This is where the jars are
stored for tools that run during build process. None of the jars are
included in compiling classpath or in final distribution.
>>dist
>>=========
>>I believe this should be a distribution "image" and it is therefore not
>>really appropriate to place the distribution binaries (.zip, .gz files) in
>>this location. For Ant, I create the distributions into a directory called
>>distribution. It contains the source and binary distributions, the latter
>>being equivalent to the dist directory.
>
>Why are you making a distinction? What's wrong putting the distribution
>images, src, birnary, documentation or otherwise in dist/ and the javac
>generated classes under dist/classes?
Some projects actually want to run from dist target. So the dist target
should be identical to the one that is included in binary distributions. In
theory you should be able to go
> cd dist/bin
> run.sh
>>dist/classes
>>=============
>>I don't believe we want generally want raw classfiles in the dist directory.
>>Many projects put this into build/classes and place just jars in the dist
>>directory.
>
>Why? What's the rationale? Moreover, in the classes directory there might be
>more classes than in the jars.
Because dist is an image of binary distribution and it is very rare that
raw class files are included in binary distribution (and if they are the
developers should be shot).
>>Other
>>======
>>
>>I think that there should be a recommendation that any file/dir not under
>>CVS control should go into the .cvsignore file.
>
>There is no need to adding any files to .cvsignore if you add files to CVS
control individually as in
>
>> cvs add x.java y.java
>
>instead of
>
>> cvs add *
>
>or am I missing something?
yep - .cvsignore is for removing annoying
? blah
messages during update
>How about:
>
>dist/lib for generated jar files and extraneous libs
>dist/bin/ for scripts (generated or not)
>dist/image for actual project distributions (tar.gz or zip files)
You don't get what is being said. The dist directory is unzipped version of
binary distribution. So that would be liking distributing Log4j-1.0.zip
that contained image/Log4j-1.0.zip inside it. That is why it is good to
make distinction and place distributions in another directory (ie
distributions).
Cheers,
Pete
*-----------------------------------------------------*
| "Faced with the choice between changing one's mind, |
| and proving that there is no need to do so - almost |
| everyone gets busy on the proof." |
| - John Kenneth Galbraith |
*-----------------------------------------------------*
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
