[prev in list] [next in list] [prev in thread] [next in thread]
List: incubator-general
Subject: Re: [VOTE] Approve the M1 release of Apache Stonehenge (Second try)
From: Selvaratnam Uthaiyashankar <uthaiyashankar () gmail ! com>
Date: 2009-05-23 14:35:50
Message-ID: 84cacd920905230723m4a257104mc814417710e805d8 () mail ! gmail ! com
[Download RAW message or body]
Hi Sebb,
Thank you very much for the clarifications.
Regards,
Shankar
On Sat, May 23, 2009 at 4:28 PM, sebb <sebbaz@gmail.com> wrote:
> On 23/05/2009, Selvaratnam Uthaiyashankar <uthaiyashankar@gmail.com> wrote:
>> Hi Sebb,
>>
>>
>>
>> >>
>> >> the source archive does not have the
>> >> > documentation source files. The generated site files are included
>> >> > instead. [The binary archive correctly contains the generate site
>> >> > files.]
>> >>
>> >>
>> >> I fixed it and uploaded to
>> >> http://people.apache.org/~shankar/stonehenge/m1/take4/
>> >>
>> >> (Only modification is in the src packs, including documentation source
>> >> files and removing generated site files).
>> >>
>> >> Is it ok, or do we have to go for a re-vote?
>> >
>> > The source archive does not seem to contain the .css files - how do
>> > these end up in the generated site?
>>
>>
>> We don't have any custom css yet. css files are generated by "mvn
>> site" command and site documents are using them.
>>
>
> OK, I see.
>
>>
>> >
>> > It looks like the xdocs/resources directory is missing from SVN and
>> > the source archive.
>>
>>
>> Do we need this, if we are using generated css files?
>>
>
> No.
>
>>
>> >> >
>> >> > The build file for the .NET code assumes that the code is being built
>> >> > from SVN, and tries to update the current directory. This is not
>> >> > appropriate for a source code archive,
>> >>
>> >>
>> >>
>> >> Current build file will check for svn working copy and if it is not an
>> >> svn working copy, it will omit it and continue to build. So, it will
>> >> work in the source release as well. But, you are correct, we have to
>> >> remove it. Do we have to remove it for this release or can we do it
>> >> for next release (since it works)?
>> >>
>> >>
>> >>
>> >> which should be self-contained
>> >> > (apart from any 3rd party dependencies, which should be documented.).
>> >> > The build file should check that any required environment variables
>> >> > are set up and exit with an error if not. Also any required settings
>> >> > should be documented somewhere, preferably in the script as well as in
>> >> > the top-level README or BUILDING file.
>> >> >
>> >>
>> >>
>> >> Installation guide WIKI shows all the dependencies and the settings needed.
>> >
>> > As mentioned above, this information needs to be included in the source archive.
>> >
>>
>>
>> I am bit unclear here. We are including this information in the source
>> archive as the pdf documents (generated from wiki). Do we need to
>> extract the dependencies and put it in BUILDING file?
>
> How does one build the binary archive from the source archive?
> And what dependencies need to be available?
>
> This needs to be documented in the source archive in the README or a
> BUILDING file.
>
> If the process is already described fully elsewhere within the source
> archive, then the README can point to that documentation, e.g.
>
> "To build the binary archive, see section 10.3 in the file xyz.pdf."
>
> But if the instructions are simple and short, it might be helpful to
> extract them to a BUILDING file. That should probably mention where to
> find the installation instructions.
>
>> Regards,
>> Shankar
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic