Mailing List Archive: Apache: Docs

open doc bugs

Index | Next | Previous | View Threaded

rbowen at rcbowen

Mar 30, 2012, 5:13 AM

Post #1 of 11 (244 views)
Permalink

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 [at] rcbowen :: @rbowen
rbowen [at] apache

rbowen at rcbowen

Mar 30, 2012, 6:44 AM

Post #2 of 11 (229 views)
Permalink

Re: open doc bugs [In reply to]

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 [at] rcbowen :: @rbowen
rbowen [at] apache

DRuggeri at primary

Mar 30, 2012, 7:23 PM

Post #3 of 11 (228 views)
Permalink

Re: open doc bugs [In reply to]

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

Attachments:

ab.patch (4.89 KB)

rbowen at rcbowen

Mar 31, 2012, 4:47 AM

Post #4 of 11 (230 views)
Permalink

Re: open doc bugs [In reply to]

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 <DRuggeri [at] primary> 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 [at] httpd
> For additional commands, e-mail: docs-help [at] httpd

DRuggeri at primary

Mar 31, 2012, 5:40 AM

Post #5 of 11 (231 views)
Permalink

Re: open doc bugs [In reply to]

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 [at] httpd
For additional commands, e-mail: docs-help [at] httpd

rumble at cord

Mar 31, 2012, 6:06 AM

Post #6 of 11 (231 views)
Permalink

Re: open doc bugs [In reply to]

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 [at] httpd
For additional commands, e-mail: docs-help [at] httpd

DRuggeri at primary

Mar 31, 2012, 7:15 AM

Post #7 of 11 (233 views)
Permalink

Re: open doc bugs [In reply to]

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 [at] httpd
For additional commands, e-mail: docs-help [at] httpd

i.galic at brainsware

Mar 31, 2012, 2:52 PM

Post #8 of 11 (231 views)
Permalink

Re: open doc bugs [In reply to]

----- 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 [at] httpd
> For additional commands, e-mail: docs-help [at] httpd
>
>

--
Igor Galić

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

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd

rumble at cord

Mar 31, 2012, 11:20 PM

Post #9 of 11 (231 views)
Permalink

Re: open doc bugs [In reply to]

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" <DRuggeri [at] primary> 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?
>

rbowen at rcbowen

Apr 1, 2012, 11:39 AM

Post #10 of 11 (227 views)
Permalink

Re: open doc bugs [In reply to]

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" <rumble [at] cord> 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" <DRuggeri [at] primary> 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?

nd at perlig

Apr 1, 2012, 11:52 AM

Post #11 of 11 (227 views)
Permalink

Re: open doc bugs [In reply to]

* 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 [at] httpd
For additional commands, e-mail: docs-help [at] httpd

Index | Next | Previous | View Threaded

Interested in having your list archived? Contact Gossamer Threads