[Contributing] Re: all this traffic

["Peter A. J. Pilgrim" <pe...@xenonsoft.demon.co.uk>]

Craig R. McClanahan wrote:
> 
> On Fri, 27 Sep 2002, adam kramer wrote:
> 
> 
>>Date: Fri, 27 Sep 2002 10:17:19 -0400 (EDT)
>>From: adam kramer <ad...@monkey.org>
>>Reply-To: Struts Users Mailing List <st...@jakarta.apache.org>
>>To: Struts Users Mailing List <st...@jakarta.apache.org>
>>Subject: RE: all this traffic
>>
>>
>>There's seems to be alot of resistance to any sort of suggestion that
>>might create better documentation and useability of Struts.
>>
> 
> 
> I can tell you for a fact that there's no resistance from Struts
> *developers* on this.  What we resist, however, is the implication that
> *we* should do all the work. :-)
> 
> Struts is an open source project.  The documentation is part of the source
> code, in easily accessible formats (for Struts, it is XML files that are
> post-processed to produce the HTML), and maintained in the same CVS
> archives that the code is.
> 
> Users are welcome to submit enhancement requests (for either the code or
> the documentation) via the bug tracking system:
> 
>   http://nagoya.apache.org/bugzilla/
> 
> and you can easily attach proposed patches to the enhancement requests.
> The general outline of how to create the patches starts at:
> 
>   http://jakarta.apache.org/site/getinvolved.html
> 

What is the format of the patches that developers /contributer patches submit?
Is it a context difference?

diff -c  acme.java  acme.java.orig

-- 
Peter Pilgrim         +-----\ +-++----++----+
Java Technologist     |     | | ||    ||    | 'n' Shine
                       |  O  | | ||  --+| ---+
         /\            | ._  / | | \  \ |    |
        /  \           | | \ \ | |+--  || ---+ A new day
       /_  _\  "Up"    | | | | | ||    ||    | is coming
         ||            +-+ +-+ +-++----++----+
<home page="http://www.xenonsoft.demon.co.uk/" />


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>

Re: [Contributing] Re: all this traffic

["Craig R. McClanahan" <cr...@apache.org>]

On Mon, 30 Sep 2002, Peter A. J. Pilgrim wrote:

> >
> >   http://jakarta.apache.org/site/getinvolved.html
> >
>
> What is the format of the patches that developers /contributer patches submit?
> Is it a context difference?
>
> diff -c  acme.java  acme.java.orig
>

The specific instructions on submitting patches are on the following page:

  http://jakarta.apache.org/site/bugs.html

which is accessible from the page I quoted above.  You need to use the
*unified* diff format, via one of the following commands:

  cvs diff -u acme.java >> patchfile.txt

  diff -u acme.java.orig acme.java >> patchfile.txt

and then add the patchfile as an attachment to an enhancement request (or
bug report) in the bug tracking system.  The "cvs diff" version is
preferred, because it unambiguously identifies the version of the source
file that your patch is against -- if you use the regular "diff" command,
please be explicit about which version of the source you are patching.


> --
> Peter Pilgrim

Craig


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>