Login | Register For Free | Help
Search for: (Advanced)

Mailing List Archive: ModPerl: Docs-dev

Re: svn commit: r111875 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod

 

 

ModPerl docs-dev RSS feed   Index | Next | Previous | View Threaded


stas at stason

Dec 14, 2004, 3:09 PM

Post #1 of 2 (1387 views)
Permalink
Re: svn commit: r111875 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod

gozer [at] apache wrote:

> +To retrieve the contents of a custom "container" directive, use the
> +C<L<Apache::Directive>> object's methods
> +C<L<as_hash|Apache::Directive/C_as_hash_>>
> +or C<L<as_string|Apache::Directive/C_as_string_>> :

Even though I made this kind of linking working some time ago, I prefer
not to use it. It relies on a very specific search pattern, which prefers
2.0 docs at the moment, thus resolving any conflicts if there is the same
filename for 1.0, 2.0, etc. But once a new generation of docs is added
(2.2, 3.0) this will stop working. Therefore I think it's beneficial to
use a fully-qualified links everywhere: i.e. :
C<L<Apache::Directive|docs::2.0::api::Apache::Directive>>
and
C<L<as_hash|docs::2.0::api::Apache::Directive/C_as_hash_>>
even though it's uglier and longer to type.

What do you think?

--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas [at] stason http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com

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


gozer at ectoplasm

Dec 15, 2004, 2:15 PM

Post #2 of 2 (1266 views)
Permalink
Re: svn commit: r111875 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod [In reply to]

Stas Bekman wrote:
> gozer [at] apache wrote:
>
>>+To retrieve the contents of a custom "container" directive, use the
>>+C<L<Apache::Directive>> object's methods
>>+C<L<as_hash|Apache::Directive/C_as_hash_>>
>>+or C<L<as_string|Apache::Directive/C_as_string_>> :
>
> Even though I made this kind of linking working some time ago, I prefer
> not to use it. It relies on a very specific search pattern, which prefers
> 2.0 docs at the moment, thus resolving any conflicts if there is the same
> filename for 1.0, 2.0, etc. But once a new generation of docs is added
> (2.2, 3.0) this will stop working. Therefore I think it's beneficial to
> use a fully-qualified links everywhere: i.e. :
> C<L<Apache::Directive|docs::2.0::api::Apache::Directive>>
> and
> C<L<as_hash|docs::2.0::api::Apache::Directive/C_as_hash_>>
> even though it's uglier and longer to type.
>
> What do you think?

Think you are right. Fixed!

--------------------------------------------------------------------------------
Philippe M. Chiasson m/gozer\@(apache|cpan|ectoplasm)\.org/ GPG KeyID : 88C3A5A5
http://gozer.ectoplasm.org/ F9BF E0C2 480E 7680 1AE5 3631 CB32 A107 88C3A5A5
Attachments: signature.asc (0.25 KB)

ModPerl docs-dev RSS feed   Index | Next | Previous | View Threaded
 
 


Interested in having your list archived? Contact Gossamer Threads
 
  Web Applications & Managed Hosting Powered by Gossamer Threads Inc.