Skip to Content.
Sympa Menu

devel - Re: [sympa-developpers] POD at the end of files or before the functions it describes?

Subject: Developers of Sympa

List archive

Chronological Thread  
  • From: "Stefan Hornburg (Racke)" <address@concealed>
  • To: address@concealed
  • Subject: Re: [sympa-developpers] POD at the end of files or before the functions it describes?
  • Date: Sat, 8 Jun 2019 07:52:00 +0200

On 6/7/19 5:07 PM, Luc Didry wrote:
> Hello,
>
> I personally don’t like to have POD at the end of the files:
> - it makes you go below the function you’re hacking to see its
> description
> - it can make a huge block of POD to look into. If you add a function,
> you have to search where to insert your POD.
>
> What would you think if I work on moving POD parts just above the
> functions it describes?
>
> It’s purely aesthetic, but I think it could ease Sympa hacking (like
> my tt2 indentation PR).
>
> Spoiler: you can say "I prefer POD at the end", it won’t hurt me 😉
>

Yeah, I definitely second that idea. It is better to have them in context.

Regards
Racke

--
Ecommerce and Linux consulting + Perl and web application programming.
Debian and Sympa administration. Provisioning with Ansible.

Attachment: signature.asc
Description: OpenPGP digital signature




Archive powered by MHonArc 2.6.19+.

Top of Page