Mailing List Archive: Re: cvs commit: modperl-docs/src/docs/2.0/user/config custom.pod

Re: cvs commit: modperl-docs/src/docs/2.0/user/config custom.pod

Aug 4, 2003, 11:31 PM

Post #1 of 3 (2005 views)

geoff@apache.org wrote:
> geoff 2003/07/31 08:01:56
>
> Modified: src/docs/2.0/user/config custom.pod
> Log:
> add cmd_data and $parms->info docs
> Submitted by: geoff
>
> Revision Changes Path
> 1.6 +50 -0 modperl-docs/src/docs/2.0/user/config/custom.pod
>
> Index: custom.pod

Thanks, Geoff!

There are two minor problems with the code section formatting. Remember that
code sections are rendered as <pre></pre>.

> + use Apache::CmdParms ();
> +
^^
So, we need to avoid empty lines in the code ( I always take the original code
and run it through 'perl -pi -e 's|^| |' file') so the code section is
rendered as a single box.

> + ...
> +
> + sub Location {
> +
> + my ($cfg, $parms, $data) = @_;
> +

second avoid long lines, above you had 100 space chars. trying to keep it
under 74-80 is a good idea. and there is no need for 100 spaces, when 2 will do ;)

Thanks.

__________________________________________________________________
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

Re: cvs commit: modperl-docs/src/docs/2.0/user/config custom.pod [ In reply to ]

geoff at modperlcookbook

Aug 5, 2003, 6:07 AM

Post #2 of 3 (1889 views)

Permalink

> Thanks, Geoff!
>
> There are two minor problems with the code section formatting. Remember
> that code sections are rendered as <pre></pre>.
>
>> + use Apache::CmdParms ();
>> +
>
> ^^
> So, we need to avoid empty lines in the code

you don't really mean to remove all the empty lines from the code, do you?
<pre> preserves empty lines (at least in modern browsers - that's how I've
been formatting my perl.com stuff and it works just fine). and I don't see
the difference between what I put in and the Apache::MyParameters stuff you
had earlier in the doc.

> ( I always take the
> original code and run it through 'perl -pi -e 's|^| |' file') so the
> code section is rendered as a single box.

I'll remember that.

>
>> + ...
>> +
>> + sub Location {
>>
>> +
>> + my ($cfg, $parms, $data) = @_;
>>
>> +
>
>
>
> second avoid long lines, above you had 100 space chars.

chalk that up to editor woes (I'm on a new box and still trying to tweak my
vi settings :)

> trying to keep
> it under 74-80 is a good idea. and there is no need for 100 spaces, when
> 2 will do ;)

indeed :)

--Geoff

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

Re: cvs commit: modperl-docs/src/docs/2.0/user/config custom.pod [ In reply to ]

stas at stason

Aug 5, 2003, 8:42 AM

Post #3 of 3 (1875 views)

Permalink

Geoffrey Young wrote:
>
>> Thanks, Geoff!
>>
>> There are two minor problems with the code section formatting.
>> Remember that code sections are rendered as <pre></pre>.
>>
>>> + use Apache::CmdParms ();
>>> +
>>
>>
>> ^^
>> So, we need to avoid empty lines in the code
>
>
> you don't really mean to remove all the empty lines from the code, do
> you? <pre> preserves empty lines (at least in modern browsers - that's
> how I've been formatting my perl.com stuff and it works just fine). and
> I don't see the difference between what I put in and the
> Apache::MyParameters stuff you had earlier in the doc.

Look at: http://perl.apache.org/docs/2.0/user/config/custom.html#C_cmd_data_
you will see what I mean (the | line on the left of the box is discontinued.)

I didn't say to remove empty lines, but to do: s|^| |' (that's two leading
spaces).

>>> + sub Location {
>>>
>>> +
>>> + my ($cfg, $parms, $data) = @_;
>>>
>>> +

>> second avoid long lines, above you had 100 space chars.
>
>
> chalk that up to editor woes (I'm on a new box and still trying to tweak
> my vi settings :)

;)

Do you want me to fix that?

__________________________________________________________________
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