You are viewing a plain text version of this content. The canonical link for it is here.
Posted to apreq-dev@httpd.apache.org by Joe Schaefer <jo...@sunstarsys.com> on 2002/05/01 19:11:08 UTC

Re: Non-listing of the project?

Rodent of Unusual Size <Ke...@Golux.Com> writes:

> Is it my imagination, or is the apreq project concealed from
> the public eye?  :-)

I guess so.  We'd certainly appreciate more publicity
for the project, since very few people outside of
the mod_perl and mod_dtcl communities know about it.

> Is there any reason it *shouldn't* be listed alongside the 
> other HTTP sub-projects?

No-  it's probably just an oversight.  Do you know
how to get it listed?

-- 
Joe Schaefer

Re: Non-listing of the project?

Posted by Jim Winstead <ji...@apache.org>.
On Mon, Jul 08, 2002 at 03:28:38PM -0400, Rodent of Unusual Size wrote:
> Rodent of Unusual Size wrote:
> > 
> > Any road, until this is hammered out on the site-dev list, I'll
> > work within the current framework and hook in the apreq project
> > page.
> 
> Done; see the <URL:http://httpd.apache.org/> and subordinate
> pages.

great, thanks for taking care of this.

jim

Re: Non-listing of the project?

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Rodent of Unusual Size wrote:
> 
> Any road, until this is hammered out on the site-dev list, I'll
> work within the current framework and hook in the apreq project
> page.

Done; see the <URL:http://httpd.apache.org/> and subordinate
pages.
-- 
#ken	P-)}

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

"Millennium hand and shrimp!"

Re: Non-listing of the project?

Posted by Joshua Slive <jo...@slive.ca>.
On Thu, 11 Jul 2002, Rodent of Unusual Size wrote:
> I guess I just object to 'docs' being part of the directory names;
> overloading 'documents' and 'documentation', particularly when the
> httpd docco is in the /docs/ and /docs-2.0/ Web locations.

I agree.  I would have no objection to using "source" and "generated" or
some other more descriptive pair of names to replace "docs" and "xdocs".

Joshua.


Re: Non-listing of the project?

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Joshua Slive wrote:
> 
> No, I don't think so.  The docs/ and xdocs/ directories are really
> just a hack that allows us to keep the generated html and the
> source xml in the same tree.  The docs/ tree is what is checked
> out onto the actual site, so all "final version" files need to go
> in there unless you want to create a new checkout.

I guess I just object to 'docs' being part of the directory names;
overloading 'documents' and 'documentation', particularly when the
httpd docco is in the /docs/ and /docs-2.0/ Web locations.
-- 
#ken	P-)}

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

"Millennium hand and shrimp!"

Re: Non-listing of the project?

Posted by Joshua Slive <jo...@slive.ca>.
On Mon, 8 Jul 2002, Rodent of Unusual Size wrote:
> I'm just concerned that there's a mismatch here.  The test, docs-project,
> and apreq projects all have subdirectories at httpd-site/ *and* at
> httpd-site/docs/.  Only the latter actually contain any files.  Since
> the httpd-site/docs/ directory contains a bunch o' stuff specific to
> the HTTP server main project, and its documentation in particular, I think
> what happened is that the other projects got cloned from the docs-project,
> which wasn't initially set up to share the tree with anyone else.

No, I don't think so.  The docs/ and xdocs/ directories are really just a
hack that allows us to keep the generated html and the source xml in the
same tree.  The docs/ tree is what is checked out onto the actual site, so
all "final version" files need to go in there unless you want to create a
new checkout.

Joshua.


Re: Non-listing of the project?

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
[ccing the site-dev list because it looks broader than just apreq]

Jim Winstead wrote:
> 
> On Mon, Jul 08, 2002 at 10:11:56AM -0400, Rodent of Unusual Size wrote:
> >
> > First off, I find that they're under httpd-dist/docs/apreq/ rather
> > than httpd-dist/apreq/ as I would expect.  Is there a reason for
> > this and/or would anyone object to my moving them out from under
> > the 'docs' directory?
> 
> actually, i believe the correct files to modify are in
> httpd-site/xdocs/apreq, and then the ./build.sh script is run to
> generate (copy) the httpd-site/docs/apreq from there. people more
> involved with httpd-site maintenance should know for sure.

I'm just concerned that there's a mismatch here.  The test, docs-project,
and apreq projects all have subdirectories at httpd-site/ *and* at
httpd-site/docs/.  Only the latter actually contain any files.  Since
the httpd-site/docs/ directory contains a bunch o' stuff specific to
the HTTP server main project, and its documentation in particular, I think
what happened is that the other projects got cloned from the docs-project,
which wasn't initially set up to share the tree with anyone else.

> i don't see anything related to apreq in httpd-dist. the current apreq
> pages show up at httpd.apache.org/apreq/ as i'd expect, so i don't
> believe they're in the wrong place.

You're probably not seeing the httpd-site/apreq directory because
you have -P on your cvs update options; it gets pruned since it's
empty.

I don't mind all the source files being at httpd-site/xdocs/* (although
I think the 'docs' and 'xdocs' names are now become confusing), but
I think the generated files should be located up one level.  That is,
httpd-site/xdocs/apreq/* produces httpd-site/apreq/*.  Perhaps the
docs and xdocs directories should be renamed to xml and html,
respectively -- then the level difference wouldn't be so weird.  Having
everything (including main project files) live under 'docs' is, IMHO,
a bit confusing and not entirely appropriate.

Any road, until this is hammered out on the site-dev list, I'll
work within the current framework and hook in the apreq project
page.
-- 
#ken	P-)}

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

"Millennium hand and shrimp!"

Re: Non-listing of the project?

Posted by Jim Winstead <ji...@apache.org>.
On Mon, Jul 08, 2002 at 10:11:56AM -0400, Rodent of Unusual Size wrote:
> Okey, I'm upgrading one of my boxes now, and I have some cycles free
> to work on the apreq site pages.
> 
> First off, I find that they're under httpd-dist/docs/apreq/ rather
> than httpd-dist/apreq/ as I would expect.  Is there a reason for
> this and/or would anyone object to my moving them out from under
> the 'docs' directory?

actually, i believe the correct files to modify are in
httpd-site/xdocs/apreq, and then the ./build.sh script is run to
generate (copy) the httpd-site/docs/apreq from there. people more
involved with httpd-site maintenance should know for sure.

i don't see anything related to apreq in httpd-dist. the current apreq
pages show up at httpd.apache.org/apreq/ as i'd expect, so i don't
believe they're in the wrong place.

jim

Re: Non-listing of the project?

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Okey, I'm upgrading one of my boxes now, and I have some cycles free
to work on the apreq site pages.

First off, I find that they're under httpd-dist/docs/apreq/ rather
than httpd-dist/apreq/ as I would expect.  Is there a reason for
this and/or would anyone object to my moving them out from under
the 'docs' directory?
-- 
#ken	P-)}

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

"Millennium hand and shrimp!"

Re: Non-listing of the project?

Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Joe Schaefer wrote:
> 
> Rodent of Unusual Size <Ke...@Golux.Com> writes:
> 
> > Is it my imagination, or is the apreq project concealed from
> > the public eye?  :-)
> 
> I guess so.  We'd certainly appreciate more publicity
> for the project, since very few people outside of
> the mod_perl and mod_dtcl communities know about it.

H'm.  Okey, I'll take that as an action item.

> No-  it's probably just an oversight.  Do you know
> how to get it listed?

Yep; I'll work on it in my copious free cycles. :-)
-- 
#ken	P-)}

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

"Millennium hand and shrimp!"