Mailing List Archive

On Sun, 19 Jan 2003, Stas Bekman wrote:

> randyk@apache.org wrote:
> > randyk 2003/01/17 21:16:50
> >
> > Modified: src/docs/general/os/win32 faq.pod
> > Log:
> > added entry about upgrading CGI.pm under mod_perl 2.0.

> Randy, can you please move this item to
> 2.0/user/troubleshooting.pod? This problem is mod_perl
> 2.0-specific and not specific to win32. Thanks.
>
> Also it's probably a good idea to specify which is the minimal
> CGI.pm version that they should be good with.

Thanks Stas - I added that to the troubleshooting section. I
thought it an idea though for the time being to also leave it
mentioned in the Win32 section, as judging by some emails I get,
some find it hard to believe problems they have aren't Win32
specific ...

--
best regards,
randy


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

Randy Kobes wrote:
> On Sun, 19 Jan 2003, Stas Bekman wrote:
>
>
>>randyk@apache.org wrote:
>>
>>>randyk 2003/01/17 21:16:50
>>>
>>> Modified: src/docs/general/os/win32 faq.pod
>>> Log:
>>> added entry about upgrading CGI.pm under mod_perl 2.0.
>>
>
>>Randy, can you please move this item to
>>2.0/user/troubleshooting.pod? This problem is mod_perl
>>2.0-specific and not specific to win32. Thanks.
>>
>>Also it's probably a good idea to specify which is the minimal
>>CGI.pm version that they should be good with.
>
>
> Thanks Stas - I added that to the troubleshooting section. I
> thought it an idea though for the time being to also leave it
> mentioned in the Win32 section, as judging by some emails I get,
> some find it hard to believe problems they have aren't Win32
> specific ...

But that's why it has the link to the main troubleshooting section.

In fact I think the 'See also' section should read:

"If you haven't found a solution for your problem in this document please
check the main troubleshooting document, where non-win32 specific problems
and their solutions are listed."

In that case there is no reason to duplicate items, since it'll make the
reader check two documents.

I'd also add a link to 'See also' (which is at the bottom of doc) at the
beginning of the document, in the second para of the description.

Finally I suggest to drop the link to 1.0's troubleshooting doc, since
it's pretty much irrelevant and just will make the reader more confused
and lost.

__________________________________________________________________
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

stas@apache.org wrote:
> stas 2003/01/19 16:20:04
>
> Modified: src/docs/general/os/win32 faq.pod
> Log:
> an attempt to make the list of other references to be less confusing

Hope that this is cool with you, Randy. More space and clear separation
for 1.0 and 2.0 sections will hopefully be helpfull to our readers.

__________________________________________________________________
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

On Mon, 20 Jan 2003, Stas Bekman wrote:

> stas@apache.org wrote:
> > stas 2003/01/19 16:20:04
> >
> > Modified: src/docs/general/os/win32 faq.pod
> > Log:
> > an attempt to make the list of other references to be less confusing
>
> Hope that this is cool with you, Randy. More space and clear separation
> for 1.0 and 2.0 sections will hopefully be helpfull to our readers.

That's a great idea - thanks, Stas!

--
best regards,
randy


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