Subject: Developers of Sympa
List archive
Re: [sympa-developpers] POD at the end of files or before the functions it describes?
- 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
-
[sympa-developpers] POD at the end of files or before the functions it describes?,
Luc Didry, 06/07/2019
-
Re: [sympa-developpers] POD at the end of files or before the functions it describes?,
Stefan Hornburg (Racke), 06/08/2019
- Re: [sympa-developpers] POD at the end of files or before the functions it describes?, Luc Didry, 06/08/2019
-
Re: [sympa-developpers] POD at the end of files or before the functions it describes?,
IKEDA Soji, 06/08/2019
- Re: [sympa-developpers] POD at the end of files or before the functions it describes?, Stefan Hornburg (Racke), 06/08/2019
-
Re: [sympa-developpers] POD at the end of files or before the functions it describes?,
Stefan Hornburg (Racke), 06/08/2019
Archive powered by MHonArc 2.6.19+.