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 Stas Bekman <st...@stason.org> on 2004/06/23 15:07:36 UTC
Re: Apache::Request
Kreimendahl, Chad J wrote:
> I think (at least from those I work with), that the main API docs for mp2 could fit them in (link to apache's libapreq site) as if they were a part of it... with notes below stating that they're from an external package. I'd agree with what I expect some responses to be, that people may be confused to see documentation about a product which isn't truely a part of 2.0 (is it supposed to be in the future?).
>
> Maybe give it its own section -- Part VI: Apache's libapreq --
>
> http://perl.apache.org/docs/2.0/api/index.html
That's an excellent idea, Chad J. Joe, any chance A-R docs appear online so we
can link to them from the above URL?
Actually I don't mind if they appear in the modperl-docs repository and be
part of the mod_perl docs. But that means that they will need to be separated
from apreq-2 package, in order to keep a single source. Then apreq-2 can check
out the docs into the source, like we do with modperl-2.0/docs (which isn't
really a part of modperl-2.0 repository, but a map to modperl-docs/src/docs/2.0
> -----Original Message-----
> From: Stas Bekman [mailto:stas@stason.org]
> Sent: Sat 6/19/2004 3:50 PM
> To: Kreimendahl, Chad J
> Cc: David Hofmann; modperl@perl.apache.org
> Subject: Re: Apache::Request
>
>
>
> Kreimendahl, Chad J wrote:
> > You're right. Looks like I was on a different (newer) machine when I
> > did a find for Request. Had only ever seen newer apache2/mp2/etc. I
> > checked around the perl.apache.org site and had a very hard time finding
> > documentation that would lead me to the url I posted below. I believe
> > it took google to get me there.
> >
> > Any chance in the 2.0 docs you can put a link to what looks like
> > Apache::Request and Apache::Cookie and just link them off to that url?
>
> Good idea, Chad J. I'm not sure where it the best location to do that. Ideas?
>
> > -CJK
> >
> >
> > -----Original Message-----
> > From: Stas Bekman [mailto:stas@stason.org]
> > Sent: Thursday, June 17, 2004 6:09 AM
> > To: Kreimendahl, Chad J
> > Cc: David Hofmann; modperl@perl.apache.org
> > Subject: Re: Apache::Request
> >
> > Kreimendahl, Chad J wrote:
> >
> >>http://httpd.apache.org/apreq/
> >>
> >>Install using one of the following methods:
> >>
> >>(easiest way)
> >>perl Makefile.PL --with-apache2-apxs=/path/to/apache2/bin/apxs
> >>
> >>(or, same thing, different method)
> >>./configure --with-apache2-apxs=/path/to/apache2/bin/apxs
> >>--enable-perl-glue --with-perl=/path/to/perl/binary
> >>
> >>(then, the standard)
> >>make
> >>make test
> >>make install
> >>
> >>This appears to install over top of the existing module, unlike
> >>installing in an Apache2 directory (like those of us who had mp1 and
> >
> > mp2
> >
> >>running). So there may be problems in mp1 once this is done... I'd
> >
> > test
> >
> >>it, but my mp1 is long gone.
> >
> >
> > That's strange. I get it installed under Apache2/ subdir (assuming that
> > you
> > had mp2 installed into Apache2/ subdir). You may want to report all the
> > details to the apreq-dev mailing list.
> >
>
>
> --
> __________________________________________________________________
> Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
> http://stason.org/ mod_perl Guide ---> http://perl.apache.org
> mailto:stas@stason.org http://use.perl.org http://apacheweek.com
> http://modperlbook.org http://apache.org http://ticketmaster.com
>
>
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Done:
http://perl.apache.org/docs/2.0/api/index.html
(at the very end of the page)
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
--
Report problems: http://perl.apache.org/bugs/
Mail list info: http://perl.apache.org/maillist/modperl.html
List etiquette: http://perl.apache.org/maillist/email-etiquette.html
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Done:
http://perl.apache.org/docs/2.0/api/index.html
(at the very end of the page)
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: Apache::Request
Posted by Joe Schaefer <jo...@sunstarsys.com>.
Stas Bekman <st...@stason.org> writes:
> Joe Schaefer wrote:
> > Stas Bekman <st...@stason.org> writes:
> > [...]
> >
> >>I was thinking to link to each manpage (there used to be only 2), but
> >>now their number is growing. Should I just link to the root of the
> >> apreq docs instead?
> > +1.
>
> +1 for what? to link to the root?
+1
--
Joe Schaefer
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
> [...]
>
>
>>I was thinking to link to each manpage (there used to be only 2), but
>>now their number is growing. Should I just link to the root of the
>>apreq docs instead?
>
>
> +1.
+1 for what? to link to the root?
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
> [...]
>
>
>>I was thinking to link to each manpage (there used to be only 2), but
>>now their number is growing. Should I just link to the root of the
>>apreq docs instead?
>
>
> +1.
+1 for what? to link to the root?
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
--
Report problems: http://perl.apache.org/bugs/
Mail list info: http://perl.apache.org/maillist/modperl.html
List etiquette: http://perl.apache.org/maillist/email-etiquette.html
Re: Apache::Request
Posted by Joe Schaefer <jo...@sunstarsys.com>.
Stas Bekman <st...@stason.org> writes:
[...]
> I was thinking to link to each manpage (there used to be only 2), but
> now their number is growing. Should I just link to the root of the
> apreq docs instead?
+1.
--
Joe Schaefer
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Joe Schaefer <jo...@sunstarsys.com> writes:
>
>
>>Stas Bekman <st...@stason.org> writes:
>>
>>[...]
>>
>>
>>>I'll be just lazy and wait for you to make the perm link and then add
>>>it at once :) just let me know when it's ready...
>>
>>+1- my sentiments all along :-)
>
>
> Stas, try http://httpd.apache.org/apreq/docs/libapreq2/
> This will be the permanent location, but for now it'll redirect
> to my homepage docs. It should be ok to link directly to
> modules.html, but I wouldn't go any deeper because the doxyen-
> generated file names may change in the future.
I was thinking to link to each manpage (there used to be only 2), but now
their number is growing. Should I just link to the root of the apreq docs instead?
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Joe Schaefer <jo...@sunstarsys.com> writes:
>
>
>>Stas Bekman <st...@stason.org> writes:
>>
>>[...]
>>
>>
>>>I'll be just lazy and wait for you to make the perm link and then add
>>>it at once :) just let me know when it's ready...
>>
>>+1- my sentiments all along :-)
>
>
> Stas, try http://httpd.apache.org/apreq/docs/libapreq2/
> This will be the permanent location, but for now it'll redirect
> to my homepage docs. It should be ok to link directly to
> modules.html, but I wouldn't go any deeper because the doxyen-
> generated file names may change in the future.
I was thinking to link to each manpage (there used to be only 2), but now
their number is growing. Should I just link to the root of the apreq docs instead?
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
--
Report problems: http://perl.apache.org/bugs/
Mail list info: http://perl.apache.org/maillist/modperl.html
List etiquette: http://perl.apache.org/maillist/email-etiquette.html
Re: Apache::Request
Posted by Joe Schaefer <jo...@sunstarsys.com>.
Joe Schaefer <jo...@sunstarsys.com> writes:
> Stas Bekman <st...@stason.org> writes:
>
> [...]
>
> > I'll be just lazy and wait for you to make the perm link and then add
> > it at once :) just let me know when it's ready...
>
> +1- my sentiments all along :-)
Stas, try http://httpd.apache.org/apreq/docs/libapreq2/
This will be the permanent location, but for now it'll redirect
to my homepage docs. It should be ok to link directly to
modules.html, but I wouldn't go any deeper because the doxyen-
generated file names may change in the future.
--
Joe Schaefer
Re: Apache::Request
Posted by Joe Schaefer <jo...@sunstarsys.com>.
Stas Bekman <st...@stason.org> writes:
[...]
> I'll be just lazy and wait for you to make the perm link and then add
> it at once :) just let me know when it's ready...
+1- my sentiments all along :-)
--
Joe Schaefer
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
> [...]
>
>
>>I think pod is just fine for now. At least the link won't change when a new
>>version is released. When you get a permanent location for HTML files I'll
>>change the links to point there.
>
>
> Since the permanent location will be available for the next release,
> it really makes no difference which location you link to. Either way
> you'll need to reset the link once 2.04-dev comes out.
I'll be just lazy and wait for you to make the perm link and then add it at
once :) just let me know when it's ready...
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
--
Report problems: http://perl.apache.org/bugs/
Mail list info: http://perl.apache.org/maillist/modperl.html
List etiquette: http://perl.apache.org/maillist/email-etiquette.html
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
> [...]
>
>
>>I think pod is just fine for now. At least the link won't change when a new
>>version is released. When you get a permanent location for HTML files I'll
>>change the links to point there.
>
>
> Since the permanent location will be available for the next release,
> it really makes no difference which location you link to. Either way
> you'll need to reset the link once 2.04-dev comes out.
I'll be just lazy and wait for you to make the perm link and then add it at
once :) just let me know when it's ready...
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: Apache::Request
Posted by Joe Schaefer <jo...@sunstarsys.com>.
Stas Bekman <st...@stason.org> writes:
[...]
> I think pod is just fine for now. At least the link won't change when a new
> version is released. When you get a permanent location for HTML files I'll
> change the links to point there.
Since the permanent location will be available for the next release,
it really makes no difference which location you link to. Either way
you'll need to reset the link once 2.04-dev comes out.
--
Joe Schaefer
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
> [...]
>
>
>>Temporarily we could link to cvs.apache.org, e.g.:
>>http://cvs.apache.org/viewcvs.cgi/*checkout*/httpd-apreq-2/glue/perl/xsbuilder/Apache/Cookie/Cookie_pod
>
>
> Probably you want the html version, in which case it's best to just link
>
> http://cvs.apache.org/~joes/libapreq2-2.04-dev/docs/html/modules.html
>
> A more permanent link on the apreq website will be available before the
> next release.
I think pod is just fine for now. At least the link won't change when a new
version is released. When you get a permanent location for HTML files I'll
change the links to point there.
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
--
Report problems: http://perl.apache.org/bugs/
Mail list info: http://perl.apache.org/maillist/modperl.html
List etiquette: http://perl.apache.org/maillist/email-etiquette.html
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
> [...]
>
>
>>Temporarily we could link to cvs.apache.org, e.g.:
>>http://cvs.apache.org/viewcvs.cgi/*checkout*/httpd-apreq-2/glue/perl/xsbuilder/Apache/Cookie/Cookie_pod
>
>
> Probably you want the html version, in which case it's best to just link
>
> http://cvs.apache.org/~joes/libapreq2-2.04-dev/docs/html/modules.html
>
> A more permanent link on the apreq website will be available before the
> next release.
I think pod is just fine for now. At least the link won't change when a new
version is released. When you get a permanent location for HTML files I'll
change the links to point there.
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: Apache::Request
Posted by Joe Schaefer <jo...@sunstarsys.com>.
Stas Bekman <st...@stason.org> writes:
[...]
> Temporarily we could link to cvs.apache.org, e.g.:
> http://cvs.apache.org/viewcvs.cgi/*checkout*/httpd-apreq-2/glue/perl/xsbuilder/Apache/Cookie/Cookie_pod
Probably you want the html version, in which case it's best to just link
http://cvs.apache.org/~joes/libapreq2-2.04-dev/docs/html/modules.html
A more permanent link on the apreq website will be available before the
next release.
--
Joe Schaefer
--
Report problems: http://perl.apache.org/bugs/
Mail list info: http://perl.apache.org/maillist/modperl.html
List etiquette: http://perl.apache.org/maillist/email-etiquette.html
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
>
>>That's an excellent idea, Chad J. Joe, any chance A-R docs appear
>>online so we can link to them from the above URL?
>
>
> Yes, soon I hope.
>
> [...]
>
>
>>Actually I don't mind if they appear in the modperl-docs repository
>>and be part of the mod_perl docs. But that means that they will need
>>to be separated from apreq-2 package, in order to keep a single
>>source. Then apreq-2 can check out the docs into the source, like we
>>do with modperl-2.0/docs (which isn't really a part of modperl-2.0
>>repository, but a map to modperl-docs/src/docs/2.0
>
>
> The apreq2 docs contain lots of C API docs as well, and most of my
> doc efforts lately have gone towards that. The pods for Apache::Request
> and friends are at httpd-apreq-2/glue/perl/xs/Apache/*/*_pod; if you
> can't wait for them to find a proper url, feel free to temporarily
> include them on the mp2 site.
Temporarily we could link to cvs.apache.org, e.g.:
http://cvs.apache.org/viewcvs.cgi/*checkout*/httpd-apreq-2/glue/perl/xsbuilder/Apache/Cookie/Cookie_pod
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: Apache::Request
Posted by Stas Bekman <st...@stason.org>.
Joe Schaefer wrote:
> Stas Bekman <st...@stason.org> writes:
>
>
>>That's an excellent idea, Chad J. Joe, any chance A-R docs appear
>>online so we can link to them from the above URL?
>
>
> Yes, soon I hope.
>
> [...]
>
>
>>Actually I don't mind if they appear in the modperl-docs repository
>>and be part of the mod_perl docs. But that means that they will need
>>to be separated from apreq-2 package, in order to keep a single
>>source. Then apreq-2 can check out the docs into the source, like we
>>do with modperl-2.0/docs (which isn't really a part of modperl-2.0
>>repository, but a map to modperl-docs/src/docs/2.0
>
>
> The apreq2 docs contain lots of C API docs as well, and most of my
> doc efforts lately have gone towards that. The pods for Apache::Request
> and friends are at httpd-apreq-2/glue/perl/xs/Apache/*/*_pod; if you
> can't wait for them to find a proper url, feel free to temporarily
> include them on the mp2 site.
Temporarily we could link to cvs.apache.org, e.g.:
http://cvs.apache.org/viewcvs.cgi/*checkout*/httpd-apreq-2/glue/perl/xsbuilder/Apache/Cookie/Cookie_pod
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
--
Report problems: http://perl.apache.org/bugs/
Mail list info: http://perl.apache.org/maillist/modperl.html
List etiquette: http://perl.apache.org/maillist/email-etiquette.html
Re: Apache::Request
Posted by Joe Schaefer <jo...@sunstarsys.com>.
Stas Bekman <st...@stason.org> writes:
> That's an excellent idea, Chad J. Joe, any chance A-R docs appear
> online so we can link to them from the above URL?
Yes, soon I hope.
[...]
> Actually I don't mind if they appear in the modperl-docs repository
> and be part of the mod_perl docs. But that means that they will need
> to be separated from apreq-2 package, in order to keep a single
> source. Then apreq-2 can check out the docs into the source, like we
> do with modperl-2.0/docs (which isn't really a part of modperl-2.0
> repository, but a map to modperl-docs/src/docs/2.0
The apreq2 docs contain lots of C API docs as well, and most of my
doc efforts lately have gone towards that. The pods for Apache::Request
and friends are at httpd-apreq-2/glue/perl/xs/Apache/*/*_pod; if you
can't wait for them to find a proper url, feel free to temporarily
include them on the mp2 site.
--
Joe Schaefer