You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by Aaron Bannert <aa...@clove.org> on 2003/03/17 08:28:22 UTC

Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Sorry to be a nag, but are these all just autogenerated from
javadoc? Surely javadoc output need not be in CVS.

-aaron


On Saturday, March 15, 2003, at 04:33  PM, hammant@apache.org wrote:

> hammant     2003/03/15 16:33:22
>
>   Modified:     
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/callback/ 
> socket
>                         package-tree.html
>                 
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/callback/ 
> stream
>                         CallbackEnabledCustomStreamReadWriter.html
>                         CallbackStreamInvocationHandler.html
>                         package-frame.html package-summary.html
>                         package-tree.html
>                 
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/ 
> classretrievers
>                         AbstractClassRetriever.html
>                         AbstractDynamicGeneratorClassRetriever.html
>                         BcelDynamicGeneratorClassRetriever.html
>                         JarFileClassRetriever.html
>                         JavacDynamicGeneratorClassRetriever.html
>                         NoClassRetriever.html PlainClassRetriever.html
>                         package-frame.html package-summary.html
>                         package-tree.html
>                 
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/direct
>                         DirectMarshalledServer.html DirectServer.html
>                         package-frame.html package-summary.html
>                         package-tree.html
>                 
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl
>                         package-frame.html package-summary.html
>                         package-tree.html
>                 
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/piped
>                         AbstractPipedServer.html
>                         PipedCustomStreamServer.html
>                         PipedObjectStreamServer.html
>                         PipedStreamServerConnection.html  
> package-frame.html
>                         package-summary.html package-tree.html
>                 
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/rmi
>                         RmiInovcationAdapter.html RmiServer.html
>                         package-frame.html package-summary.html
>                         package-tree.html
>                 
> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket
>                         AbstractCompleteSocketStreamServer.html
>                         AbstractPartialSocketStreamServer.html
>                         CompleteSocketCustomStreamPipedBinder.html
>                         CompleteSocketCustomStreamPipedConnection.html
>                         CompleteSocketCustomStreamServer.html
>   Log:
>   Updated Altrmi docs


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Nicola Ken Barozzi <ni...@apache.org>.

Michael Wechner wrote, On 19/03/2003 0.24:
> Nicola Ken Barozzi wrote:
...
>> So IMHO we should push these docs to the site by hand and not use the 
>> site CVS for it.
> 
> IMHO what you need is a "CMS" ;-)
> 
> Nicola, please apologize my remark, but I just couldn't help it.

;-P

> btw, the Lenya docs are now based (thanks to Gregor) on document-v11.dtd

Cool! :-)

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: Incubating Lenya for Cocoon

Posted by Michael Wechner <mi...@wyona.org>.
Steven Noels wrote:

> On 15/04/2003 23:15 Michael Wechner wrote:
>
>> Hi
>>
>> We have faxed the signed "contributor license agreements" of all the 
>> proposed Lenya committers
>> to the address below. Christian Egli also sent a list of all active 
>> committers with the proposed Apache
>> email addresses some time ago.
>>
>> So far we haven't received any feedback. Who shall we contact?
>>
>> btw, today the mailing lists lenya-dev@cocoon.apache.org and 
>> lenya-user@cocoon.apache.org have been created.
>>
>> I guess the setup of the actual CVS module and webspace is within the 
>> responsibility of the Cocoon project.
>
>
> see various lists: accounts and CVS module have been requested 
> alongside your enquiry


yeah, I have just seen your emails. A BIG THANK YOU as well

Michael

>
>
> Cheers,
>
> </Steven>




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


Re: Incubating Lenya for Cocoon

Posted by Michael Wechner <mi...@wyona.org>.
Steven Noels wrote:
> On 15/04/2003 23:15 Michael Wechner wrote:
> 

<snip/>

>>
>> I guess the setup of the actual CVS module and webspace is within the 
>> responsibility of the Cocoon project.
> 
> 
> see various lists: accounts and CVS module have been requested alongside 
> your enquiry

Thanks to Sander the accounts are now setup and the CVS module 
"cocoon-lenya" does also exist.

Shall we populate the CVS module from the code tarball we have to 
specify in the license agreement (which we need to fax)?


Concerning the webspace http://cocoon.apache.org/lenya/:
Can we do that on our own (cocoon.apache.org is currently being 
redirected to xml.apache.org/cocoon/) or does anyone have to give us
privileges?

Thanks

Michael

> 
> Cheers,
> 
> </Steven>



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


Re: Incubating Lenya for Cocoon

Posted by Steven Noels <st...@outerthought.org>.
On 15/04/2003 23:15 Michael Wechner wrote:
> Hi
> 
> We have faxed the signed "contributor license agreements" of all the 
> proposed Lenya committers
> to the address below. Christian Egli also sent a list of all active 
> committers with the proposed Apache
> email addresses some time ago.
> 
> So far we haven't received any feedback. Who shall we contact?
> 
> btw, today the mailing lists lenya-dev@cocoon.apache.org and 
> lenya-user@cocoon.apache.org have been created.
> 
> I guess the setup of the actual CVS module and webspace is within the 
> responsibility of the Cocoon project.

see various lists: accounts and CVS module have been requested alongside 
your enquiry

Cheers,

</Steven>
-- 
Steven Noels                            http://outerthought.org/
Outerthought - Open Source, Java & XML Competence Support Center
Read my weblog at            http://blogs.cocoondev.org/stevenn/
stevenn at outerthought.org                stevenn at apache.org


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


Re: Incubating Lenya for Cocoon

Posted by Michael Wechner <mi...@wyona.org>.
Erik Abele wrote:

> Michael Wechner wrote:
>
>> Hi
>>
>> We have faxed the signed "contributor license agreements" of all the 
>> proposed Lenya committers to the address below. Christian Egli also
>
> > sent a list of all active committers with the proposed Apache
>
>> email addresses some time ago.
>>
>> So far we haven't received any feedback. Who shall we contact?
>
>
> Jim Jagielski handles all the CLA stuff. He recently posted a msg on 
> committers@apache.org that he received a bunch of rec'd CLAs that 
> he'll be adding soon, but I don't know if yours are present.
>
> You can just try to ping him directly (jim@apache.org), but I think he 
> should be on this list since he's also the VP of Incubator ...


ok, thanks a lot

Michael

>
>
> If he can confirm that he received all the CLAs, we'll set up the 
> accounts and the CVS repo.
>
> Cheers,
> Erik
>
>
> ---------------------------------------------------------------------
> 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


Re: Incubating Lenya for Cocoon

Posted by Erik Abele <er...@apache.org>.
Michael Wechner wrote:
> Hi
> 
> We have faxed the signed "contributor license agreements" of all the 
> proposed Lenya committers to the address below. Christian Egli also
 > sent a list of all active committers with the proposed Apache
> email addresses some time ago.
> 
> So far we haven't received any feedback. Who shall we contact?

Jim Jagielski handles all the CLA stuff. He recently posted a msg on 
committers@apache.org that he received a bunch of rec'd CLAs that he'll 
be adding soon, but I don't know if yours are present.

You can just try to ping him directly (jim@apache.org), but I think he 
should be on this list since he's also the VP of Incubator ...

If he can confirm that he received all the CLAs, we'll set up the 
accounts and the CVS repo.

Cheers,
Erik


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


Re: Incubating Lenya for Cocoon

Posted by Michael Wechner <mi...@wyona.org>.
Hi

We have faxed the signed "contributor license agreements" of all the 
proposed Lenya committers
to the address below. Christian Egli also sent a list of all active 
committers with the proposed Apache
email addresses some time ago.

So far we haven't received any feedback. Who shall we contact?

btw, today the mailing lists lenya-dev@cocoon.apache.org and 
lenya-user@cocoon.apache.org have been created.

I guess the setup of the actual CVS module and webspace is within the 
responsibility of the Cocoon project.

thanks

Michael



Nicola Ken Barozzi wrote:

>
> The Cocoon project has voted to accept the Lenya proposal, thus Lenya 
> is officially in the Incubator  :-)
>
> First of all, we need to get the legal stuff straight.
>
> 1) License grant
>
> We need to recieve papers that transfer rights to the ASF.
> It is necessary to transfer rights for the package, the core code, and 
> any new code produced by the project.
>
> Attached is the software grant, and an example that has been used for 
> another project.
>
> It has to be printed, signed, and faxed into the ASF (+1-410-803-2258) 
> or mail to:
>
>     The Apache Software Foundation
>     1901 Munsey Drive
>     Forest Hill, MD 21050-2747, U.S.A.
>
>
> 2) Committers
>
> We need a list of all active committers that will work on the project.
> They will have to sign a contributors agreement and send it to the ASF 
> as for the above license grant.
>
> http://incubator.apache.org/forms/ASF_Contributor_License_2_form.pdf
>
>
> Welcome! :-)
>


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


Re: Incubating Lenya for Cocoon

Posted by Michael Wechner <mi...@wyona.org>.
Nicola Ken Barozzi wrote:

>
> The Cocoon project has voted to accept the Lenya proposal, thus Lenya 
> is officially in the Incubator  :-)
>
> First of all, we need to get the legal stuff straight.
>
> 1) License grant
>
> We need to recieve papers that transfer rights to the ASF.
> It is necessary to transfer rights for the package, the core code, and 
> any new code produced by the project.
>
> Attached is the software grant, and an example that has been used for 
> another project.
>
> It has to be printed, signed, and faxed into the ASF (+1-410-803-2258) 
> or mail to:
>
>     The Apache Software Foundation
>     1901 Munsey Drive
>     Forest Hill, MD 21050-2747, U.S.A.
>
>
> 2) Committers
>
> We need a list of all active committers that will work on the project.
> They will have to sign a contributors agreement and send it to the ASF 
> as for the above license grant.
>
> http://incubator.apache.org/forms/ASF_Contributor_License_2_form.pdf
>
>
> Welcome! :-)
>
Thanks a lot for the friendly welcome :-)

Michael






Re: Incubating Lenya for Cocoon

Posted by Michael Wechner <mi...@wyona.org>.
Nicola Ken Barozzi wrote:

>
> The Cocoon project has voted to accept the Lenya proposal, thus Lenya 
> is officially in the Incubator  :-)
>
> First of all, we need to get the legal stuff straight.
>
> 1) License grant
>
> We need to recieve papers that transfer rights to the ASF.
> It is necessary to transfer rights for the package, the core code, and 
> any new code produced by the project.
>
> Attached is the software grant, and an example that has been used for 
> another project.
>
> It has to be printed, signed, and faxed into the ASF (+1-410-803-2258) 
> or mail to:
>
>     The Apache Software Foundation
>     1901 Munsey Drive
>     Forest Hill, MD 21050-2747, U.S.A.
>
>
> 2) Committers
>
> We need a list of all active committers that will work on the project.
> They will have to sign a contributors agreement and send it to the ASF 
> as for the above license grant.
>
> http://incubator.apache.org/forms/ASF_Contributor_License_2_form.pdf
>
>
> Welcome! :-)
>
Thanks a lot for the friendly welcome :-)

Michael






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


Incubating Lenya for Cocoon

Posted by Nicola Ken Barozzi <ni...@apache.org>.
The Cocoon project has voted to accept the Lenya proposal, thus Lenya is 
officially in the Incubator  :-)

First of all, we need to get the legal stuff straight.

1) License grant

We need to recieve papers that transfer rights to the ASF.
It is necessary to transfer rights for the package, the core code, and 
any new code produced by the project.

Attached is the software grant, and an example that has been used for 
another project.

It has to be printed, signed, and faxed into the ASF (+1-410-803-2258) 
or mail to:

     The Apache Software Foundation
     1901 Munsey Drive
     Forest Hill, MD 21050-2747, U.S.A.


2) Committers

We need a list of all active committers that will work on the project.
They will have to sign a contributors agreement and send it to the ASF 
as for the above license grant.

http://incubator.apache.org/forms/ASF_Contributor_License_2_form.pdf


Welcome! :-)

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------

Incubating Lenya for Cocoon

Posted by Nicola Ken Barozzi <ni...@apache.org>.
The Cocoon project has voted to accept the Lenya proposal, thus Lenya is 
officially in the Incubator  :-)

First of all, we need to get the legal stuff straight.

1) License grant

We need to recieve papers that transfer rights to the ASF.
It is necessary to transfer rights for the package, the core code, and 
any new code produced by the project.

Attached is the software grant, and an example that has been used for 
another project.

It has to be printed, signed, and faxed into the ASF (+1-410-803-2258) 
or mail to:

     The Apache Software Foundation
     1901 Munsey Drive
     Forest Hill, MD 21050-2747, U.S.A.


2) Committers

We need a list of all active committers that will work on the project.
They will have to sign a contributors agreement and send it to the ASF 
as for the above license grant.

http://incubator.apache.org/forms/ASF_Contributor_License_2_form.pdf


Welcome! :-)

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------

Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Michael Wechner <mi...@wyona.org>.
Nicola Ken Barozzi wrote:

>
> Rodent of Unusual Size wrote, On 18/03/2003 20.56:
>
>> if the documentation is easily generated from a cvs checkout
>> using tools any user will have available, not putting the
>> generated files in cvs *might* be an option.  if building
>> the docco requires either specialised tools or knowledge,
>> the docco should be under cms control.  mho after doing
>> this shite for twenty years.
>
>
> I agree that putting generated stuff in CVS sucks big time.
> The point is that users and developers like having these on the site.
>
> For example, I might need the docs but have only the jar ATM, or I 
> want to explain a thing on the list with a link to the javadocs.
>
> Anyway, a solution for Java projects seems simple: make the project 
> run under Gump, and these generated files will be published daily.
> But this gives us the latest docs, not the ones of the last release.
>
> So IMHO we should push these docs to the site by hand and not use the 
> site CVS for it.


IMHO what you need is a "CMS" ;-)

Nicola, please apologize my remark, but I just couldn't help it.

btw, the Lenya docs are now based (thanks to Gregor) on document-v11.dtd

All the best

Michael



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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Paul Hammant <pa...@yahoo.com>.
Top add some historical context to this. I merely inherited the avalon-site setup for this
project. I'll go with whatever looks to be the most popular way. That could be build in-situ to
site, make a download, leave off completely (this is incubator), upload via SCP to site.  Looks
like we are not quite settled though.

- Paul

> what are the technical (not philosophical) objections to
> keeping generated data under cms?


__________________________________________________
Do You Yahoo!?
Everything you'll ever need on one web page
from News and Sport to Email and Music Charts
http://uk.my.yahoo.com

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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Nicola Ken Barozzi wrote:
> 
> I agree that putting generated stuff in CVS sucks big time.
> The point is that users and developers like having these on the site.
> 
> For example, I might need the docs but have only the jar ATM, or I want 
> to explain a thing on the list with a link to the javadocs.
> 
> Anyway, a solution for Java projects seems simple: make the project run 
> under Gump, and these generated files will be published daily.
> But this gives us the latest docs, not the ones of the last release.
> 
> So IMHO we should push these docs to the site by hand and not use the 
> site CVS for it.

i think you are missing one important aspect by making
the unconscious assumption that people who want the
documentation are *always* online when they need it,
and can reach the apache site.  from personal experience,
my own and that of others shared with me, i can tell you
that such is far from always being the case.  if they
cannot easily produce it from raw sources in such a
situation, it must be available to them in pre-generated
form as part of a/the download they use to get the sources.

what are the technical (not philosophical) objections to
keeping generated data under cms?
-- 
#ken	P-)}

Ken Coar, Sanagendamgagwedweinini  http://Golux.Com/coar/
Author, developer, opinionist      http://Apache-Server.Com/

"Millennium hand and shrimp!"


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Rodent of Unusual Size wrote, On 18/03/2003 20.56:
> if the documentation is easily generated from a cvs checkout
> using tools any user will have available, not putting the
> generated files in cvs *might* be an option.  if building
> the docco requires either specialised tools or knowledge,
> the docco should be under cms control.  mho after doing
> this shite for twenty years.

I agree that putting generated stuff in CVS sucks big time.
The point is that users and developers like having these on the site.

For example, I might need the docs but have only the jar ATM, or I want 
to explain a thing on the list with a link to the javadocs.

Anyway, a solution for Java projects seems simple: make the project run 
under Gump, and these generated files will be published daily.
But this gives us the latest docs, not the ones of the last release.

So IMHO we should push these docs to the site by hand and not use the 
site CVS for it.

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
if the documentation is easily generated from a cvs checkout
using tools any user will have available, not putting the
generated files in cvs *might* be an option.  if building
the docco requires either specialised tools or knowledge,
the docco should be under cms control.  mho after doing
this shite for twenty years.
-- 
#ken	P-)}

Ken Coar, Sanagendamgagwedweinini  http://Golux.Com/coar/
Author, developer, opinionist      http://Apache-Server.Com/

"Millennium hand and shrimp!"


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Nicola Ken Barozzi <ni...@apache.org>.

Rodent of Unusual Size wrote, On 20/03/2003 16.19:
> Nicola Ken Barozzi wrote:
> 
>>The need: javadocs on site
>>The situation: all site goes in CVS
>>The drawback: javadocs in CVS suck
>>Proposed Solution: javadocs go on site and not in CVS
> 
> 
> can the docs be reproduced locally into the same usable format
> as they exist on the site, using a tool that anyone reading
> the docs would automatically have?  or is the tool something
> that must be obtained separately, or would the generation into
> usable form require manual steps not documented for users?

It's part of the standard JDK, totally documented.

But

  - one must download the source, which is usually not the case
  - the regular docs ususally link to the javadocs
  - it's convenient to be able to reference javadocs in mails
    and have all look at them in the discussion

For example, if you look at the ant mailing list, you will find users 
complaining that they don't find them online BTW IIRC.

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Paul Hammant wrote, On 21/03/2003 14.44:
> Nicola,
> 
> 
>>Well, Gump does it already.
>>
>>Make your build produce the javadocs, add the <javadoc> tag in the 
>>descriptor and it will publish them on the Gump results site every night.
>>
>>It doens't solve the problem that users sometimes need the released 
>>version javadocs, but it's a good start.
>>
>>http://jakarta.apache.org/gump/
> 
> 
> It would be nice if we could gump on CVS labels as well then....

Hmmm, right! :-)

I think we can, haven't tried it though.
It seems we have found the (simple) answer :-)

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Paul Hammant <pa...@yahoo.com>.
Nicola,

> Well, Gump does it already.
> 
> Make your build produce the javadocs, add the <javadoc> tag in the 
> descriptor and it will publish them on the Gump results site every night.
> 
> It doens't solve the problem that users sometimes need the released 
> version javadocs, but it's a good start.
> 
> http://jakarta.apache.org/gump/

It would be nice if we could gump on CVS labels as well then....

Hmmm,

-ph

__________________________________________________
Do You Yahoo!?
Everything you'll ever need on one web page
from News and Sport to Email and Music Charts
http://uk.my.yahoo.com

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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Nicola Ken Barozzi <ni...@apache.org>.

Paul Hammant wrote, On 21/03/2003 14.27:

>  It would be
> nice to have a forrest-gump-cruisecontrol thing to just get latest docs each night and shove them
> to the /home/www/project/subproject site.

Well, Gump does it already.

Make your build produce the javadocs, add the <javadoc> tag in the 
descriptor and it will publish them on the Gump results site every night.

It doens't solve the problem that users sometimes need the released 
version javadocs, but it's a good start.

http://jakarta.apache.org/gump/

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Paul Hammant <pa...@yahoo.com>.
> > can the docs be reproduced locally into the same usable format
> > as they exist on the site, using a tool that anyone reading
> > the docs would automatically have?
> 
> yes.
> 
> with that said, I like having javadocs on a website. For new projects, 
> I will often go look at the online javadocs to get an overview of the 
> code and architecture to determine if I want to go to the effort of 
> downloading it and playing with it further.

It is true. Demonstrated this morning because James emailed me asking for teh api/ link. (Tis not
in the links).

I think we all agree on the fact that docs on site are good. Where Apache differs from, say,
SourceForge, is when we push the generated docs into CVS. Thats xdocs and javadocs. It would be
nice to have a forrest-gump-cruisecontrol thing to just get latest docs each night and shove them
to the /home/www/project/subproject site.

- Paul

__________________________________________________
Do You Yahoo!?
Everything you'll ever need on one web page
from News and Sport to Email and Music Charts
http://uk.my.yahoo.com

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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Peter Royal <pr...@apache.org>.
On Thursday, March 20, 2003, at 10:19  AM, Rodent of Unusual Size wrote:
> can the docs be reproduced locally into the same usable format
> as they exist on the site, using a tool that anyone reading
> the docs would automatically have?

yes.

with that said, I like having javadocs on a website. For new projects, 
I will often go look at the online javadocs to get an overview of the 
code and architecture to determine if I want to go to the effort of 
downloading it and playing with it further.
-pete


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Nicola Ken Barozzi wrote:
> 
> The need: javadocs on site
> The situation: all site goes in CVS
> The drawback: javadocs in CVS suck
> Proposed Solution: javadocs go on site and not in CVS

can the docs be reproduced locally into the same usable format
as they exist on the site, using a tool that anyone reading
the docs would automatically have?  or is the tool something
that must be obtained separately, or would the generation into
usable form require manual steps not documented for users?
-- 
#ken	P-)}

Ken Coar, Sanagendamgagwedweinini  http://Golux.Com/coar/
Author, developer, opinionist      http://Apache-Server.Com/

"Millennium hand and shrimp!"


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Rodent of Unusual Size wrote, On 20/03/2003 15.58:
> Nicola Ken Barozzi wrote:
> 
>>>Surely javadoc output need not be in CVS.

But from user and developer demand they should be on the website.

>>Why? This CVS is of the site, and many users ask for the javadocs to be 
>>online, so...

Since the rule seems to be that all the site has to be in CVS, they were 
committed to CVS.

>>This is one of the reasons why having the generated site in CVS sucks IMHO.

But it sucks to commit all javadocs in CVS.

> i find those two remarks to be contradictory.

The need: javadocs on site
The situation: all site goes in CVS
The drawback: javadocs in CVS suck
Proposed Solution: javadocs go on site and not in CVS

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Nicola Ken Barozzi wrote:
> 
>> Surely javadoc output need not be in CVS.
> 
> Why? This CVS is of the site, and many users ask for the javadocs to be 
> online, so...
> 
> This is one of the reasons why having the generated site in CVS sucks IMHO.

i find those two remarks to be contradictory..
-- 
#ken	P-)}

Ken Coar, Sanagendamgagwedweinini  http://Golux.Com/coar/
Author, developer, opinionist      http://Apache-Server.Com/

"Millennium hand and shrimp!"


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Nicola Ken Barozzi <ni...@apache.org>.

Aaron Bannert wrote, On 17/03/2003 8.28:
> Sorry to be a nag, but are these all just autogenerated from
> javadoc? 

Yes.

> Surely javadoc output need not be in CVS.

Why? This CVS is of the site, and many users ask for the javadocs to be 
online, so...

This is one of the reasons why having the generated site in CVS sucks IMHO.

> -aaron
> 
> 
> On Saturday, March 15, 2003, at 04:33  PM, hammant@apache.org wrote:
> 
>> hammant     2003/03/15 16:33:22
>>
>>   Modified:     
>> build/site/projects/altrmi/api/org/apache/altrmi/server/impl/callback/ 
>> socket
>>                         package-tree.html
>>                 
...
>>   Log:
>>   Updated Altrmi docs
-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
by the way, paul, would you please

ssh www.apache.org
cd /www/incubator.apache.org
find . -user hammant | xargs chmod g+w

?  and change your umask?

:-)
-- 
#ken	P-)}

Ken Coar, Sanagendamgagwedweinini  http://Golux.Com/coar/
Author, developer, opinionist      http://Apache-Server.Com/

"Millennium hand and shrimp!"


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Aaron Bannert <aa...@clove.org>.
On Sunday, March 16, 2003, at 11:42  PM, Paul Hammant wrote:

> Aaron Bannert wrote:
>
>> Sorry to be a nag, but are these all just autogenerated from
>> javadoc? Surely javadoc output need not be in CVS.
>>
>> -aaron
>
> Stricktly speaking, there is no need at all for a xxx-site CVS module 
> for any Apache projects. You could build the lot to the dir it will be 
> served from.
>
> Anyone step in with policy for Javadocs for Incubator?

We don't need policy, we need common sense. Do we really need to be
littering cvs commit mailing lists with hundreds of lines of redundant
diffs (especially things like "This file was autogenerated at 
hh:mm:ss")??

This isn't a black and white issue. There are some cases where it is
useful to have xxx-site CVS modules. I'm just trying to figure out
where this one falls.

-aaron


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


Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html

Posted by Paul Hammant <Pa...@yahoo.com>.
Aaron Bannert wrote:

> Sorry to be a nag, but are these all just autogenerated from
> javadoc? Surely javadoc output need not be in CVS.
>
> -aaron

Stricktly speaking, there is no need at all for a xxx-site CVS module 
for any Apache projects. You could build the lot to the dir it will be 
served from.

Anyone step in with policy for Javadocs for Incubator?

- Paul


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