You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@httpd.apache.org by Ruediger Pluem <rp...@apache.org> on 2009/09/06 14:52:29 UTC

Re: svn commit: r811806 - in /httpd/httpd/trunk: CHANGES docs/man/ab.8 support/ab.c


On 09/06/2009 01:03 PM, minfrin@apache.org wrote:
> Author: minfrin
> Date: Sun Sep  6 11:03:14 2009
> New Revision: 811806
> 
> URL: http://svn.apache.org/viewvc?rev=811806&view=rev
> Log:
> Add support for HTTP PUT to ab.
> Submiited by: Jeff Barnes <jbarnesweb yahoo.com>
> 
> Modified:
>     httpd/httpd/trunk/CHANGES
>     httpd/httpd/trunk/docs/man/ab.8
>     httpd/httpd/trunk/support/ab.c
> 

> Modified: httpd/httpd/trunk/docs/man/ab.8
> URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/ab.8?rev=811806&r1=811805&r2=811806&view=diff
> ==============================================================================
> --- httpd/httpd/trunk/docs/man/ab.8 (original)
> +++ httpd/httpd/trunk/docs/man/ab.8 Sun Sep  6 11:03:14 2009
> @@ -27,7 +27,7 @@
>  .SH "SYNOPSIS"
>   
>  .PP
> -\fBab\fR [ -\fBA\fR \fIauth-username\fR:\fIpassword\fR ] [ -\fBb\fR \fIwindowsize\fR ] [ -\fBc\fR \fIconcurrency\fR ] [ -\fBC\fR \fIcookie-name\fR=\fIvalue\fR ] [ -\fBd\fR ] [ -\fBe\fR \fIcsv-file\fR ] [ -\fBf\fR \fIprotocol\fR ] [ -\fBg\fR \fIgnuplot-file\fR ] [ -\fBh\fR ] [ -\fBH\fR \fIcustom-header\fR ] [ -\fBi\fR ] [ -\fBk\fR ] [ -\fBn\fR \fIrequests\fR ] [ -\fBp\fR \fIPOST-file\fR ] [ -\fBP\fR \fIproxy-auth-username\fR:\fIpassword\fR ] [ -\fBq\fR ] [ -\fBr\fR ] [ -\fBs\fR ] [ -\fBS\fR ] [ -\fBt\fR \fItimelimit\fR ] [ -\fBT\fR \fIcontent-type\fR ] [ -\fBv\fR \fIverbosity\fR] [ -\fBV\fR ] [ -\fBw\fR ] [ -\fBx\fR \fI<table>-attributes\fR ] [ -\fBX\fR \fIproxy\fR[:\fIport\fR] ] [ -\fBy\fR \fI<tr>-attributes\fR ] [ -\fBz\fR \fI<td>-attributes\fR ] [ -\fBZ\fR \fIciphersuite\fR ] [http[s]://]\fIhostname\fR[:\fIport\fR]/\fIpath\fR
> +\fBab\fR [ -\fBA\fR \fIauth-username\fR:\fIpassword\fR ] [ -\fBb\fR \fIwindowsize\fR ] [ -\fBc\fR \fIconcurrency\fR ] [ -\fBC\fR \fIcookie-name\fR=\fIvalue\fR ] [ -\fBd\fR ] [ -\fBe\fR \fIcsv-file\fR ] [ -\fBf\fR \fIprotocol\fR ] [ -\fBg\fR \fIgnuplot-file\fR ] [ -\fBh\fR ] [ -\fBH\fR \fIcustom-header\fR ] [ -\fBi\fR ] [ -\fBk\fR ] [ -\fBn\fR \fIrequests\fR ] [ -\fBp\fR \fIPOST-file\fR ] [ -\fBu\fR \fIPUT-file\fR ] [ -\fBP\fR \fIproxy-auth-username\fR:\fIpassword\fR ] [ -\fBq\fR ] [ -\fBr\fR ] [ -\fBs\fR ] [ -\fBS\fR ] [ -\fBt\fR \fItimelimit\fR ] [ -\fBT\fR \fIcontent-type\fR ] [ -\fBv\fR \fIverbosity\fR] [ -\fBV\fR ] [ -\fBw\fR ] [ -\fBx\fR \fI<table>-attributes\fR ] [ -\fBX\fR \fIproxy\fR[:\fIport\fR] ] [ -\fBy\fR \fI<tr>-attributes\fR ] [ -\fBz\fR \fI<td>-attributes\fR ] [ -\fBZ\fR \fIciphersuite\fR ] [http[s]://]\fIhostname\fR[:\fIport\fR]/\fIpath\fR
>   
>  
>  .SH "SUMMARY"
> 

This is bad. ab.8 is generated from ab.xml. So this change gets lost the next time the documentation
gets regenerated.

Regards

Rüdiger

Re: svn commit: r811806 - in /httpd/httpd/trunk: CHANGES docs/man/ab.8 support/ab.c

Posted by "William A. Rowe, Jr." <wr...@rowe-clan.net>.
Jeff Barnes wrote:
> I obsoleted the .8 file and attached the svn diff for the xml file.
> 
> Should the ab.8 file be removed from svn if it gets overwritten with each documentation generation?

No moreso than the .html files, all generated from xml.  We don't expect
typical developers to install the docs toolchain.

Perhaps it's time we did, but that's a different discussion altogether ;)

Re: svn commit: r811806 - in /httpd/httpd/trunk: CHANGES docs/man/ab.8 support/ab.c

Posted by Jeff Barnes <jb...@yahoo.com>.
I obsoleted the .8 file and attached the svn diff for the xml file.

Should the ab.8 file be removed from svn if it gets overwritten with each documentation generation?

Thanks,
Jeff

--- On Sun, 9/6/09, Ruediger Pluem <rp...@apache.org> wrote:

> From: Ruediger Pluem <rp...@apache.org>
> Subject: Re: svn commit: r811806 - in /httpd/httpd/trunk: CHANGES docs/man/ab.8 support/ab.c
> To: dev@httpd.apache.org
> Date: Sunday, September 6, 2009, 5:52 AM
> 
> 
> On 09/06/2009 01:03 PM, minfrin@apache.org
> wrote:
> > Author: minfrin
> > Date: Sun Sep  6 11:03:14 2009
> > New Revision: 811806
> > 
> > URL: http://svn.apache.org/viewvc?rev=811806&view=rev
> > Log:
> > Add support for HTTP PUT to ab.
> > Submiited by: Jeff Barnes <jbarnesweb
> yahoo.com>
> > 
> > Modified:
> >     httpd/httpd/trunk/CHANGES
> > 
>    httpd/httpd/trunk/docs/man/ab.8
> > 
>    httpd/httpd/trunk/support/ab.c
> > 
> 
> > Modified: httpd/httpd/trunk/docs/man/ab.8
> > URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/ab.8?rev=811806&r1=811805&r2=811806&view=diff
> >
> ==============================================================================
> > --- httpd/httpd/trunk/docs/man/ab.8 (original)
> > +++ httpd/httpd/trunk/docs/man/ab.8 Sun Sep  6
> 11:03:14 2009
> > @@ -27,7 +27,7 @@
> >  .SH "SYNOPSIS"
> >   
> >  .PP
> > -\fBab\fR [ -\fBA\fR
> \fIauth-username\fR:\fIpassword\fR ] [ -\fBb\fR
> \fIwindowsize\fR ] [ -\fBc\fR \fIconcurrency\fR ] [ -\fBC\fR
> \fIcookie-name\fR=\fIvalue\fR ] [ -\fBd\fR ] [ -\fBe\fR
> \fIcsv-file\fR ] [ -\fBf\fR \fIprotocol\fR ] [ -\fBg\fR
> \fIgnuplot-file\fR ] [ -\fBh\fR ] [ -\fBH\fR
> \fIcustom-header\fR ] [ -\fBi\fR ] [ -\fBk\fR ] [ -\fBn\fR
> \fIrequests\fR ] [ -\fBp\fR \fIPOST-file\fR ] [ -\fBP\fR
> \fIproxy-auth-username\fR:\fIpassword\fR ] [ -\fBq\fR ] [
> -\fBr\fR ] [ -\fBs\fR ] [ -\fBS\fR ] [ -\fBt\fR
> \fItimelimit\fR ] [ -\fBT\fR \fIcontent-type\fR ] [ -\fBv\fR
> \fIverbosity\fR] [ -\fBV\fR ] [ -\fBw\fR ] [ -\fBx\fR
> \fI<table>-attributes\fR ] [ -\fBX\fR
> \fIproxy\fR[:\fIport\fR] ] [ -\fBy\fR
> \fI<tr>-attributes\fR ] [ -\fBz\fR
> \fI<td>-attributes\fR ] [ -\fBZ\fR \fIciphersuite\fR ]
> [http[s]://]\fIhostname\fR[:\fIport\fR]/\fIpath\fR
> > +\fBab\fR [ -\fBA\fR
> \fIauth-username\fR:\fIpassword\fR ] [ -\fBb\fR
> \fIwindowsize\fR ] [ -\fBc\fR \fIconcurrency\fR ] [ -\fBC\fR
> \fIcookie-name\fR=\fIvalue\fR ] [ -\fBd\fR ] [ -\fBe\fR
> \fIcsv-file\fR ] [ -\fBf\fR \fIprotocol\fR ] [ -\fBg\fR
> \fIgnuplot-file\fR ] [ -\fBh\fR ] [ -\fBH\fR
> \fIcustom-header\fR ] [ -\fBi\fR ] [ -\fBk\fR ] [ -\fBn\fR
> \fIrequests\fR ] [ -\fBp\fR \fIPOST-file\fR ] [ -\fBu\fR
> \fIPUT-file\fR ] [ -\fBP\fR
> \fIproxy-auth-username\fR:\fIpassword\fR ] [ -\fBq\fR ] [
> -\fBr\fR ] [ -\fBs\fR ] [ -\fBS\fR ] [ -\fBt\fR
> \fItimelimit\fR ] [ -\fBT\fR \fIcontent-type\fR ] [ -\fBv\fR
> \fIverbosity\fR] [ -\fBV\fR ] [ -\fBw\fR ] [ -\fBx\fR
> \fI<table>-attributes\fR ] [ -\fBX\fR
> \fIproxy\fR[:\fIport\fR] ] [ -\fBy\fR
> \fI<tr>-attributes\fR ] [ -\fBz\fR
> \fI<td>-attributes\fR ] [ -\fBZ\fR \fIciphersuite\fR ]
> [http[s]://]\fIhostname\fR[:\fIport\fR]/\fIpath\fR
> >   
> >  
> >  .SH "SUMMARY"
> > 
> 
> This is bad. ab.8 is generated from ab.xml. So this change
> gets lost the next time the documentation
> gets regenerated.
> 
> Regards
> 
> Rüdiger
>