You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by Rich Bowen <rb...@rcbowen.com> on 2012/03/30 14:13:20 UTC

open doc bugs

Ladies and gentlemen,

Once again we're down to 20 open doc bugs. Six of them are SSL issues. Four of them are Rewrite issues. The remainder are scattered all over the place.

Please take a look and see if there's a ticket that you can either fix, or provide missing information to help someone else fix it.

Folks who have offered assistance on the SSL documentation, this would be a great place for you to step up and offer your expertise on those tickets.

Thanks.

--
Rich Bowen
rbowen@rcbowen.com :: @rbowen
rbowen@apache.org







Re: open doc bugs

Posted by Rich Bowen <rb...@rcbowen.com>.
Oh did we finally set that up as an svn external?

Run ./build.sh all to build everything. 

--
Rich Bowen, mobile edition


On Apr 1, 2012, at 2:20, "Daniel Gruno" <ru...@cord.dk> wrote:

> There's a build system located inside [branch]/manual/build. You basically just run build.sh, provided you have Java and Apache Ant installed on your system. To build docs for a translation, you just add the translation name to the build command, f.x. "./build.sh fr" for the French translations.
> 
> With regards,
> Daniel.
> 
> On Mar 31, 2012 16:15 "Daniel Ruggeri" <DR...@primary.net> wrote:
>> On 3/31/2012 8:06 AM, Daniel Gruno wrote:
>>> 
>>> Damn you for beating me to the AB ticket ;)
>>> I have back-ported to 2.4 and 2.2 and rebuilt html for it now.
>>> You should probably familiarize yourself with the docs build system if
>>> you haven't already :)
>>> 
>>> With regards,
>>> Daniel.
>> 
>> Yes, definitely. It's almost kind of funny to ask, but is there a doc I
>> can read on how that works?

Re: open doc bugs

Posted by André Malo <nd...@perlig.de>.
* Daniel Gruno wrote:

> There's a build system located inside [branch]/manual/build. You
> basically just runbuild.sh, provided you have Java and Apache Ant
> installed on your system. To build docs for a translation, you just add
> the translation name to the build command, f.x. "./build.sh fr" for the
> French translations.

ant is not needed, just java. everything else is provided.

Aaaand the docs are there:

http://httpd.apache.org/docs-project/docsformat.html

nd
-- 
"Das Verhalten von Gates hatte mir bewiesen, dass ich auf ihn und seine
beiden Gefährten nicht zu zählen brauchte" -- Karl May, "Winnetou III"

Im Westen was neues: <http://pub.perlig.de/books.html#apache2>

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: open doc bugs

Posted by Daniel Gruno <ru...@cord.dk>.
There's a build system located inside [branch]/manual/build. You
basically just runbuild.sh, provided you have Java and Apache Ant
installed on your system. To build docs for a translation, you just add
the translation name to the build command, f.x. "./build.sh fr" for the
French translations.

With regards,
Daniel.

On Mar 31, 2012 16:15 "Daniel Ruggeri" <DR...@primary.net> wrote:

> On 3/31/2012 8:06 AM, Daniel Gruno wrote:
> > > 
> > Damn you for beating me to the AB ticket ;)
> > I have back-ported to 2.4 and 2.2 and rebuilt html for it now.
> > You should probably familiarize yourself with the docs build system
> > if
> > you haven't already :)
> > 
> > With regards,
> > Daniel.
> 
> Yes, definitely. It's almost kind of funny to ask, but is there a doc
> I
> can read on how that works?
> 

Re: open doc bugs

Posted by Daniel Ruggeri <DR...@primary.net>.
On 3/31/2012 8:06 AM, Daniel Gruno wrote:
>>
> Damn you for beating me to the AB ticket ;)
> I have back-ported to 2.4 and 2.2 and rebuilt html for it now.
> You should probably familiarize yourself with the docs build system if
> you haven't already :)
>
> With regards,
> Daniel. 

Yes, definitely. It's almost kind of funny to ask, but is there a doc I
can read on how that works?

-- 
Daniel Ruggeri


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: open doc bugs

Posted by Daniel Gruno <ru...@cord.dk>.
On 31-03-2012 14:40, Daniel Ruggeri wrote:
> On 3/31/2012 6:47 AM, Rich Bowen wrote:
>> Thanks. This is awesome. I have only one comment, and it's entirely a
>> matter of preference. I prefer that documentation not say "this is
>> easy to understand" and statements like that. It makes people feel stupid.
> Good point - definitely not the goal. I've tweaked that line and
> committed to trunk as r1307790.
>
Damn you for beating me to the AB ticket ;)
I have back-ported to 2.4 and 2.2 and rebuilt html for it now.
You should probably familiarize yourself with the docs build system if 
you haven't already :)

With regards,
Daniel.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: open doc bugs

Posted by Igor Galić <i....@brainsware.org>.

----- Original Message -----
> On 3/31/2012 6:47 AM, Rich Bowen wrote:
> > Thanks. This is awesome. I have only one comment, and it's entirely
> > a
> > matter of preference. I prefer that documentation not say "this is
> > easy to understand" and statements like that. It makes people feel
> > stupid.
> 
> Good point - definitely not the goal. I've tweaked that line and
> committed to trunk as r1307790.

We might also want to reference this in the man page.
 
> --
> Daniel Ruggeri
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
> 
> 

-- 
Igor Galić

Tel: +43 (0) 664 886 22 883
Mail: i.galic@brainsware.org
URL: http://brainsware.org/
GPG: 6880 4155 74BD FD7C B515  2EA5 4B1D 9E08 A097 C9AE


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: open doc bugs

Posted by Daniel Ruggeri <DR...@primary.net>.
On 3/31/2012 6:47 AM, Rich Bowen wrote:
> Thanks. This is awesome. I have only one comment, and it's entirely a
> matter of preference. I prefer that documentation not say "this is
> easy to understand" and statements like that. It makes people feel stupid.

Good point - definitely not the goal. I've tweaked that line and
committed to trunk as r1307790.

-- 
Daniel Ruggeri


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: open doc bugs

Posted by Rich Bowen <rb...@rcbowen.com>.
Thanks. This is awesome. I have only one comment, and it's entirely a matter of preference. I prefer that documentation not say "this is easy to understand" and statements like that. It makes people feel stupid.

--
Rich Bowen, mobile edition


On Mar 30, 2012, at 22:23, Daniel Ruggeri <DR...@primary.net> wrote:

> On 3/30/2012 8:44 AM, Rich Bowen wrote:
>> 
>> FYI, that list is here: http://s.apache.org/httpd-doc-bugs
> 
> I took a stab at this one
> https://issues.apache.org/bugzilla/show_bug.cgi?id=52193
> but would appreciate comments on the attached patch before committing. Thoughts?
> 
> -- 
> Daniel Ruggeri
> <ab.patch>
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org

Re: open doc bugs

Posted by Daniel Ruggeri <DR...@primary.net>.
On 3/30/2012 8:44 AM, Rich Bowen wrote:
> FYI, that list is here: *http://s.apache.org/httpd-doc-bugs*

I took a stab at this one
https://issues.apache.org/bugzilla/show_bug.cgi?id=52193
but would appreciate comments on the attached patch before committing.
Thoughts?

-- 
Daniel Ruggeri


Re: open doc bugs

Posted by Rich Bowen <rb...@rcbowen.com>.
On Mar 30, 2012, at 8:13 AM, Rich Bowen wrote:

> Ladies and gentlemen,
> 
> Once again we're down to 20 open doc bugs. Six of them are SSL issues. Four of them are Rewrite issues. The remainder are scattered all over the place.
> 
> Please take a look and see if there's a ticket that you can either fix, or provide missing information to help someone else fix it.
> 
> Folks who have offered assistance on the SSL documentation, this would be a great place for you to step up and offer your expertise on those tickets.


FYI, that list is here: http://s.apache.org/httpd-doc-bugs

--
Rich Bowen
rbowen@rcbowen.com :: @rbowen
rbowen@apache.org