Documentation small mistake?

[cs...@fx.ro]

Hi all,

I found something that looks like a mistake for me in the online docs:
Page:
http://perl.apache.org/docs/1.0/guide/install.html

>>>>>>>>>
The DSO mechanism is provided by Apache's mod_so module which needs to be
compiled into the httpd binary. This is done automatically when DSO is
enabled for module mod_foo via:

  ./configure --enable-module=foo
or by explicitly adding mod_so via:

  ./configure --enable-module=so
<<<<<<<<<

I'd say the line:
  ./configure --enable-module=foo
should be instead:
  ./configure --enable-shared=foo

BTW, maybe a mechanism to signalize docs errors should be present somewhere
on the site, without the need to subscribe to this list. The
subscribe/unsubscribe procedure might discourage the occasional error
finder.

Lian Sebe, M.Sc.
Freelance Analyst-Programmer
www.programEz.net


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

Re: Documentation small mistake?

[Stas Bekman <st...@stason.org>]

csebe@fx.ro wrote:
> Hi all,
> 
> I found something that looks like a mistake for me in the online docs:
> Page:
> http://perl.apache.org/docs/1.0/guide/install.html
> 
> 
> The DSO mechanism is provided by Apache's mod_so module which needs to be
> compiled into the httpd binary. This is done automatically when DSO is
> enabled for module mod_foo via:
> 
>   ./configure --enable-module=foo
> or by explicitly adding mod_so via:
> 
>   ./configure --enable-module=so
> <<<<<<<<<
> 
> I'd say the line:
>   ./configure --enable-module=foo
> should be instead:
>   ./configure --enable-shared=foo

The document is correct. When you add --enable-module=include, mod_so is 
automatically inserted. If you don't enable any DSO modules at this point, but 
want to have mod_so available you need to write --enable-shared=so

> BTW, maybe a mechanism to signalize docs errors should be present somewhere
> on the site, without the need to subscribe to this list. The
> subscribe/unsubscribe procedure might discourage the occasional error
> finder.

Agreed. But you don't have to be subscribed to post the list. If you aren't 
subscribed you post will wait till the moderator will approve it and then 
it'll make it to the list. You can also contact the maintainer of the page if 
you have any corrections.


__________________________________________________________________
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


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