FAQ
Attached is a patch that adds a warning when a lone =cut is used

--
Renée Bäcker
renee.baecker@smart-websolutions.de

XING: http://www.xing.com/profile/Renee_Baecker
Foo-Magazin: http://foo-magazin.de

Search Discussions

  • Ronald J Kimball at Jun 25, 2008 at 2:52 pm

    On Wed, Jun 25, 2008 at 04:43:09PM +0200, Ren?e B?cker wrote:
    Attached is a patch that adds a warning when a lone =cut is used

    --
    Ren?e B?cker
    renee.baecker@smart-websolutions.de

    XING: http://www.xing.com/profile/Renee_Baecker
    Foo-Magazin: http://foo-magazin.de
    --- perldiag.pod.orig 2008-06-25 12:31:27.000000000 +0200
    +++ perldiag.pod 2008-06-25 12:36:35.000000000 +0200
    @@ -4563,6 +4563,11 @@
    (F) You called a Win32 function with incorrect arguments.
    See L<Win32> for more information.

    +=item Used POD directive '=cut' without other POD directive
    +
    +(W misc) =cut indicates the end of POD, but you used this directive
    +without any other directive in this POD paragraph.
    +
    If I understand this correctly, this warning will be emitted when =cut
    appears as the beginning of a block of Pod. However, I don't think this is
    clear from the suggested text for the warning or the explanation.

    Also, the perlpod documentation uses the capitalization 'Pod' rather than
    'POD'.

    I suggest something like this:

    =item Pod directive '=cut' as beginning of Pod block

    (W misc) =cut indicates the end of a Pod block, but you used this directive
    at the beginning of a Pod block.


    Ronald
  • Renée Bäcker at Jun 25, 2008 at 3:24 pm

    Ronald J Kimball wrote:
    =item Pod directive '=cut' as beginning of Pod block

    (W misc) =cut indicates the end of a Pod block, but you used this directive
    at the beginning of a Pod block.


    Ronald
    Good catch, I have changed the patches...

    --
    Renée Bäcker
    renee.baecker@smart-websolutions.de

    XING: http://www.xing.com/profile/Renee_Baecker
    Foo-Magazin: http://foo-magazin.de
  • Abigail at Jun 25, 2008 at 3:25 pm

    On Wed, Jun 25, 2008 at 04:43:09PM +0200, Renée Bäcker wrote:
    Attached is a patch that adds a warning when a lone =cut is used

    Isn't this more a task for Perl::Critic, instead of perl?

    I've used the fact that =cut toggles POD.

    Abigail
  • Rafael Garcia-Suarez at Jun 26, 2008 at 6:57 am

    2008/6/25 Abigail <abigail@abigail.be>:
    On Wed, Jun 25, 2008 at 04:43:09PM +0200, Renée Bäcker wrote:
    Attached is a patch that adds a warning when a lone =cut is used

    Isn't this more a task for Perl::Critic, instead of perl?
    Or Pod::Checker (if it doesn't already detect it.)
    I've used the fact that =cut toggles POD.
    So did I...
    (Moreover we don't have any POD warning in the core.)
  • Renée Bäcker at Jun 26, 2008 at 7:27 am

    Rafael Garcia-Suarez wrote:
    2008/6/25 Abigail <abigail@abigail.be>:
    On Wed, Jun 25, 2008 at 04:43:09PM +0200, Renée Bäcker wrote:

    Attached is a patch that adds a warning when a lone =cut is used
    Isn't this more a task for Perl::Critic, instead of perl?
    Or Pod::Checker (if it doesn't already detect it.)

    I've used the fact that =cut toggles POD.
    So did I...
    (Moreover we don't have any POD warning in the core.)

    Then this ticket should be marked as "rejected".

    --

    Renée Bäcker
    renee.baecker@smart-websolutions.de

    XING: http://www.xing.com/profile/Renee_Baecker
    Foo-Magazin: http://foo-magazin.de

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
groupperl5-porters @
categoriesperl
postedJun 25, '08 at 2:43p
activeJun 26, '08 at 7:27a
posts6
users4
websiteperl.org

People

Translate

site design / logo © 2022 Grokbase