Mailing-List: contact modperl-help@perl.apache.org; run by ezmlm
Precedence: bulk
Received-SPF: pass (nike.apache.org: domain of aw@ice-sa.com designates
 212.85.38.229 as permitted sender)
Message-ID: <5375D5B4.5080509@ice-sa.com>
Date: Fri, 16 May 2014 11:09:08 +0200
From: =?ISO-8859-1?Q?Andr=E9_Warnier?= <aw@ice-sa.com>
Reply-To: mod_perl list <modperl@perl.apache.org>
User-Agent: Thunderbird 2.0.0.24 (Windows/20100228)
MIME-Version: 1.0
To: mod_perl list <modperl@perl.apache.org>
Subject: Re: API Docs
References: <537401C7.3030403@gmail.com>
In-Reply-To: <537401C7.3030403@gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

Worik Stanton wrote:
> I am still trying to fathom the API.
> 
> I have struck a snag with the documentation.
> 
> 
> https://perl.apache.org/docs/2.0/api/Apache2/Connection.html#Synopsis
> says....
> 
>   use Apache2::Connection ();
>   use Apache2::RequestRec ();
> 
>   my $c = $r->connection;
> 
> 
> What is $r?
> 
> I am missing something obvious, what is the context here I do not get?
> 
Hi.

Maybe you should start here : 
https://perl.apache.org/docs/2.0/user/handlers/intro.html#What_are_Handlers_

$r is the "current request object".  How you obtain it varies a bit depending on where you 
are (in a mod_perl handler, in a cgi-bin script etc..).
Usually, you'll be in some kind of handler() sub, and the usual idiom then is just

sub handler {
  my $r = shift;
..
}

as the request object is the first and usually the only parameter passed in such a sub/method.
It is also usually the starting point for everything else in mod_perl.

If you are a real beginner, a recommendation : persist, you'll soon get the hang of it, 
and it's worth the effort.  Perl is fun; Apache + mod_perl is *a lot* of fun, and 
incredibly powerful.