You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by David Crossley <cr...@apache.org> on 2005/10/20 07:23:05 UTC

ftpserver has broken svn directory on webserver

Trying to do:
ssh people.apache.org
cd /www/incubator.apache.org
svn update
...
svn: Working copy 'projects/ftpserver/images' is missing or not locked

It seems that that directory is missing its .svn directory.
Perhaps it has been manually removed and replaced.
I see that there are more files there than are in the
actual SVN. Could someone please add the missing files
to SVN and checkout that images directory again.

-David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: ftpserver has broken svn directory on webserver

Posted by David Crossley <cr...@apache.org>.
Rana Bhattacharyya wrote:
> 
>    I am terribly sorry and thank you all for helping
> me out. Now I am trying to write what I have
> understood so that I won't mess-up again. Please do
> write your comments.

Thanks Rana. I will add some of your notes to the
Incubator docs, already done some today:
http://incubator.apache.org/howtoparticipate.html#Project+Website+Howto

> 1. The source repository :
> http://svn.apache.org/repos/asf/incubator/ftpserver/trunk/
> 
>    The generated document for the project website :
> http://svn.apache.org/repos/asf/incubator/ftpserver/site/

Generate your documentation, copy it to that directory
which you will have done 'svn co' on your local workstation.
Do the usual verification, then do 'svn commit'.

> 2. The new project site will be
> http://incubator.apache.org/ftpserver
> To update the site, first we have to login into
> people.apache.org and then do a svn update at
> /www/incubator.apache.org/ftpserver directory. The
> cron job will publish these pages later.
> 
> ssh people.apache.org
> cd /www/incubator.apache.org/ftpserver
> svn update

Correct.

> 3. The generated javadoc will not be in SVN. Instead
> an empty directory will be there in SVN. The javadocs
> will be copied manually somewhere under
> /www/incubator.apache.org/ftpserver directory in
> people.apache.org.

Yes, e.g. ftpserver/javadoc/

> 4. STATUS (or status.xml) file has to be added in SVN.
> The location should be
> http://svn.apache.org/repos/asf/incubator/ftpserver/STATUS.
> This file is used by PMC. It is not used in any way to
> update any page.

Sorry, i do not know what that file is.
Look at some of the other incubating projects
to see how they have set their svn space:
http://svn.apache.org/repos/asf/incubator/

> 5. One thing is NOT clear to me. Who can update the
> page
> http://incubator.apache.org/projects/ftpserver.html.
> Or how does it get generated?
> I can see the wiki page :
> /incubator/public/trunk/site-author/projects/ftpserver.cwiki

That is for your PPMC and mentors to update.

The following notes explain how it gets generated:
http://incubator.apache.org/howtoparticipate.html#Updating+the+site

You can just update the source and someone else
will take care of generation and publishing.

> -------------------------------------------------------------------------------
> Now release related issue:
> 
[ snip ]

... i don't know anything about that. Be careful when
asking an unrelated question. They can get easily overlooked
on a busy list. Start a new subject.

-David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Incubation releases

Posted by "Noel J. Bergman" <no...@devtech.com>.
Rana Bhattacharyya wrote:

> So the bottom-line is projects in Incubation cannot
> release without permission from PMC. In case of a
> release, the filename should contain "incubating"
> word.

And have the disclaimer in the directory and in each release package.

Correct.

Please note that the requirement you mentioned is NOT different from any
other ASF project.  No project may put out a release without a PMC vote.
The rules exist for a number of reasons, not least of which is to provide
some legal cover for the person packaing the release.

	--- Noel


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Maintaining the "STATUS" file.

Posted by "Noel J. Bergman" <no...@devtech.com>.
> 4. STATUS (or status.xml) file has to be added in SVN.
> The location should be
> http://svn.apache.org/repos/asf/incubator/ftpserver/STATUS.
> This file is used by PMC. It is not used in any way to
> update any page.

No, but close.  The "STATUS" file that we care about is the other file you
refered to later:

> 5. One thing is NOT clear to me. Who can update the
> page http://incubator.apache.org/projects/ftpserver.html.
> Or how does it get generated?
> I can see the wiki page :
> /incubator/public/trunk/site-author/projects/ftpserver.cwiki

THAT is the Incubation STATUS file for the ftpserver.  There is one for each
project, in either cwiki (older projects) or html (newer projects) format.

You should have the ability to update it.  If not, let us know.  All you
need do is keep it up-to-date.  It will be published for you.

	--- Noel


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: ftpserver has broken svn directory on webserver

Posted by Rana Bhattacharyya <ra...@yahoo.com>.
Hi,

   I am terribly sorry and thank you all for helping
me out. Now I am trying to write what I have
understood so that I won't mess-up again. Please do
write your comments.


1. The source repository :
http://svn.apache.org/repos/asf/incubator/ftpserver/trunk/

   The generated document for the project website :
http://svn.apache.org/repos/asf/incubator/ftpserver/site/


2. The new project site will be
http://incubator.apache.org/ftpserver
To update the site, first we have to login into
people.apache.org and then do a svn update at
/www/incubator.apache.org/ftpserver directory. The
cron job will publish these pages later.

ssh people.apache.org
cd /www/incubator.apache.org/ftpserver
svn update


3. The generated javadoc will not be in SVN. Instead
an empty directory will be there in SVN. The javadocs
will be copied manually somewhere under
/www/incubator.apache.org/ftpserver directory in
people.apache.org.


4. STATUS (or status.xml) file has to be added in SVN.
The location should be
http://svn.apache.org/repos/asf/incubator/ftpserver/STATUS.
This file is used by PMC. It is not used in any way to
update any page.


5. One thing is NOT clear to me. Who can update the
page
http://incubator.apache.org/projects/ftpserver.html.
Or how does it get generated?
I can see the wiki page :
/incubator/public/trunk/site-author/projects/ftpserver.cwiki


-------------------------------------------------------------------------------
Now release related issue:

Podlings are, by definition, not yet fully accepted as
part of the Apache Software Foundation. Podling web
sites MUST include a clear disclaimer on their website
and in all documentation stating that they are in
incubation.

Podlings SHOULD use the following text for all
disclaimers :

<project name> is an effort undergoing incubation at
the Apache Software Foundation (ASF), sponsored by the
<name of sponsor>. Incubation is required of all newly
accepted projects until a further review indicates
that the infrastructure, communications, and decision
making process have stabilized in a manner consistent
with other successful ASF projects. While incubation
status is not necessarily a reflection of the
completeness or stability of the code, it does
indicate that the project has yet to be fully endorsed
by the ASF. 

As podlings are not yet fully accepted as part of the
Apache Software Foundation, any software releases
(including code held in publically available CVS) made
by Podlings will not be endorsed by the ASF.

Podlings in Incubation SHALL NOT perform any releases
of software without the explicit approval of the
Incubator PMC. Such approval SHALL be given only after
the Incubator PMC has followed the process detailed in
(Reference to Charter), and SHALL NOT occur until all
source has been legally transferred to the ASF.

So the bottom-line is projects in Incubation cannot
release without permission from PMC. In case of a
release, the filename should contain "incubating"
word.

Thanks,
Rana Bhattacharyya

--- David Crossley <cr...@apache.org> wrote:

> Sorry if i sound frustrated today. 
> 
> When ftpserver sprang back to life recently
> we started getting svn commit mails coming to
> the general@ list. This was a sign that an old
> project was not configured the same way that the
> newer ones are.
> 
> After one of my messages to general, Rana contacted
> me offlist and i explained what need to happen with
> the website side of things. Not sure about their
> mail lists.
> 
> I also requested not to do offlist email, because
> now i cannot refer back to that effort. Will try
> again:
> 
> The instructions are at
>
http://incubator.apache.org/howtoparticipate.html#Project+Website+Howto
> (Yes they need to be improved. I will try that
> after this message.)
> 
> The source documents for your project website:
>
http://svn.apache.org/repos/asf/incubator/ftpserver/trunk/
> 
> The generated documents for your project website:
>
http://svn.apache.org/repos/asf/incubator/ftpserver/site/
> 
> Make sure that your subversion client is properly
> configured. This vastly reduces the amount of
> traffic
> on the svn email commits, e.g. *.pdf
> http://www.apache.org/dev/#svn
>
http://www.apache.org/dev/version-control.html#https-svn
> 
> ssh people.apache.org
> cd /www/incubator.apache.org/ftpserver
> svn update
> 
> Rana Bhattacharyya wrote:
> > 
> >     It is true that I have not checked-in the
> latest
> > generated project pages in SVN. The reasons are as
> > follows:
> > 
> > 1. The website has javadocs. So do we need to
> commit
> > those things in SVN?
> 
> A lot of projects don't put javadocs in their SVN,
> just manually add them to the webserver each time
> that
> you regenerate them. Just have an empty directory
> in your site svn.
> 
> (If committers want to help with better ways to
> generate and maintain javadocs et al, then come to
> the site-dev mailing list.)
> http://www.apache.org/dev/infra-mail.html
> 
> > I got few mails to minimize the
> > SVN footprint. So I did not commit the generated
> docs
> > in SVN. If I commit everything in SVN, slowly the
> SVN
> > size would be huge and it might be difficult to
> > maintain.
> 
> Why would it be difficult?
> 
> > 2. The site can be generated anytime from the
> source
> > code. Do we really need to put the generated doc
> in
> > SVN?
> 
> Yes. It is then a lot easier for people who
> are unfamiliar with your project or website,
> to help fix it, like we needed to do today.
> 
> > 3. According to
> >
> http://incubator.apache.org/projects/ftpserver.html
> > the project site would be
> > http://incubator.apache.org/projects/ftpserver/.
> So
> > the path should be
> > /www/incubator.apache.org/projects/ftpserver
> 
> Nope, that is old. See above.
> 
> > Please let me know the proper way to update site.
> 
> Hope that helps.
> 
> -David
> 
>
---------------------------------------------------------------------
> To unsubscribe, e-mail:
> general-unsubscribe@incubator.apache.org
> For additional commands, e-mail:
> general-help@incubator.apache.org
> 
> 


		
__________________________________ 
Yahoo! FareChase: Search multiple travel sites in one click.
http://farechase.yahoo.com

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: ftpserver has broken svn directory on webserver

Posted by David Crossley <cr...@apache.org>.
Sorry if i sound frustrated today. 

When ftpserver sprang back to life recently
we started getting svn commit mails coming to
the general@ list. This was a sign that an old
project was not configured the same way that the
newer ones are.

After one of my messages to general, Rana contacted
me offlist and i explained what need to happen with
the website side of things. Not sure about their
mail lists.

I also requested not to do offlist email, because
now i cannot refer back to that effort. Will try again:

The instructions are at
http://incubator.apache.org/howtoparticipate.html#Project+Website+Howto
(Yes they need to be improved. I will try that
after this message.)

The source documents for your project website:
http://svn.apache.org/repos/asf/incubator/ftpserver/trunk/

The generated documents for your project website:
http://svn.apache.org/repos/asf/incubator/ftpserver/site/

Make sure that your subversion client is properly
configured. This vastly reduces the amount of traffic
on the svn email commits, e.g. *.pdf
http://www.apache.org/dev/#svn
http://www.apache.org/dev/version-control.html#https-svn

ssh people.apache.org
cd /www/incubator.apache.org/ftpserver
svn update

Rana Bhattacharyya wrote:
> 
>     It is true that I have not checked-in the latest
> generated project pages in SVN. The reasons are as
> follows:
> 
> 1. The website has javadocs. So do we need to commit
> those things in SVN?

A lot of projects don't put javadocs in their SVN,
just manually add them to the webserver each time that
you regenerate them. Just have an empty directory
in your site svn.

(If committers want to help with better ways to
generate and maintain javadocs et al, then come to
the site-dev mailing list.)
http://www.apache.org/dev/infra-mail.html

> I got few mails to minimize the
> SVN footprint. So I did not commit the generated docs
> in SVN. If I commit everything in SVN, slowly the SVN
> size would be huge and it might be difficult to
> maintain.

Why would it be difficult?

> 2. The site can be generated anytime from the source
> code. Do we really need to put the generated doc in
> SVN?

Yes. It is then a lot easier for people who
are unfamiliar with your project or website,
to help fix it, like we needed to do today.

> 3. According to
> http://incubator.apache.org/projects/ftpserver.html
> the project site would be
> http://incubator.apache.org/projects/ftpserver/. So
> the path should be
> /www/incubator.apache.org/projects/ftpserver

Nope, that is old. See above.

> Please let me know the proper way to update site.

Hope that helps.

-David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Re: ftpserver has broken svn directory on webserver

Posted by Rana Bhattacharyya <ra...@yahoo.com>.
Hi,

    It is true that I have not checked-in the latest
generated project pages in SVN. The reasons are as
follows:

1. The website has javadocs. So do we need to commit
those things in SVN? I got few mails to minimize the
SVN footprint. So I did not commit the generated docs
in SVN. If I commit everything in SVN, slowly the SVN
size would be huge and it might be difficult to
maintain.

2. The site can be generated anytime from the source
code. Do we really need to put the generated doc in
SVN?

3. According to
http://incubator.apache.org/projects/ftpserver.html
the project site would be
http://incubator.apache.org/projects/ftpserver/. So
the path should be
/www/incubator.apache.org/projects/ftpserver

Please let me know the proper way to update site.

Thanks,
Rana Bhattacharyya


--- David Crossley <cr...@apache.org> wrote:

> Trying to do:
> ssh people.apache.org
> cd /www/incubator.apache.org
> svn update
> ...
> svn: Working copy 'projects/ftpserver/images' is
> missing or not locked
> 
> It seems that that directory is missing its .svn
> directory.
> Perhaps it has been manually removed and replaced.
> I see that there are more files there than are in
> the
> actual SVN. Could someone please add the missing
> files
> to SVN and checkout that images directory again.
> 
> -David
> 
>
---------------------------------------------------------------------
> To unsubscribe, e-mail:
> general-unsubscribe@incubator.apache.org
> For additional commands, e-mail:
> general-help@incubator.apache.org
> 
> 



		
__________________________________ 
Start your day with Yahoo! - Make it your home page! 
http://www.yahoo.com/r/hs

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


RE: ftpserver has broken svn directory on webserver

Posted by "Noel J. Bergman" <no...@devtech.com>.
I expect that Rana meant to have that as the project's web site, and didn't
know where it belongs.  The entire structure should be under
/www/incubator.apache.org, not under the projects directory, which should be
status files.

	--- Noel


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org