Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Pod nesting needs some clarity #4217

Closed
p6rt opened this issue May 11, 2015 · 5 comments
Closed

Pod nesting needs some clarity #4217

p6rt opened this issue May 11, 2015 · 5 comments

Comments

@p6rt
Copy link

p6rt commented May 11, 2015

Migrated from rt.perl.org#125153 (status was 'resolved')

Searchable as RT125153$

@p6rt
Copy link
Author

p6rt commented May 11, 2015

From @drforr

It's not clear which =begin is not terminated here, based on the error.
Maybe '=begin at line 1 not terminated by matching '=end pod' would be a
clearer error statement.

--cut here--
=begin pod

=begin Documentation

=end pod
--cut here--

===SORRY!=== Error while compiling /home/jgoff/bug.pm
'=begin' not terminated by matching '=end Documentation'
at /home/jgoff/bug.pm​:5
------> <BOL>⏏=end pod
  expecting any of​:
  horizontal whitespace
  whitespace

--cut here--
=begin pod

=begin Documentation

=end Documentation
--cut here--
===SORRY!=== Error while compiling /home/jgoff/bug.pm
'=begin' not terminated by matching '=end pod'
at /home/jgoff/bug.pm​:6
------> <BOL>⏏<EOL>
  expecting any of​:
  horizontal whitespace
  whitespace

@p6rt
Copy link
Author

p6rt commented May 11, 2015

From @moritz

On 05/11/2015 02​:47 PM, (via RT) wrote​:

# New Ticket Created by
# Please include the string​: [perl #​125153]
# in the subject line of all future correspondence about this issue.
# <URL​: https://rt-archive.perl.org/perl6/Ticket/Display.html?id=125153 >

It's not clear which =begin is not terminated here, based on the error.
Maybe '=begin at line 1 not terminated by matching '=end pod' would be a
clearer error statement.

I think the clearest error message would be

Expected "=end Documentation" to terminate "=begin Documentation"; found
"=end pod" instead.

--cut here--
=begin pod

=begin Documentation

=end pod
--cut here--

===SORRY!=== Error while compiling /home/jgoff/bug.pm
'=begin' not terminated by matching '=end Documentation'
at /home/jgoff/bug.pm​:5
------> <BOL>⏏=end pod
expecting any of​:
horizontal whitespace
whitespace

--cut here--
=begin pod

=begin Documentation

=end Documentation
--cut here--
===SORRY!=== Error while compiling /home/jgoff/bug.pm
'=begin' not terminated by matching '=end pod'
at /home/jgoff/bug.pm​:6
------> <BOL>⏏<EOL>
expecting any of​:
horizontal whitespace
whitespace

@p6rt
Copy link
Author

p6rt commented May 11, 2015

The RT System itself - Status changed from 'new' to 'open'

@p6rt
Copy link
Author

p6rt commented May 29, 2015

From @hoelzro

On Mon May 11 06​:44​:19 2015, moritz wrote​:

On 05/11/2015 02​:47 PM, (via RT) wrote​:

# New Ticket Created by
# Please include the string​: [perl #​125153]
# in the subject line of all future correspondence about this issue.
# <URL​: https://rt-archive.perl.org/perl6/Ticket/Display.html?id=125153 >

It's not clear which =begin is not terminated here, based on the error.
Maybe '=begin at line 1 not terminated by matching '=end pod' would be a
clearer error statement.

I think the clearest error message would be

Expected "=end Documentation" to terminate "=begin Documentation"; found
"=end pod" instead.

--cut here--
=begin pod

=begin Documentation

=end pod
--cut here--

===SORRY!=== Error while compiling /home/jgoff/bug.pm
'=begin' not terminated by matching '=end Documentation'
at /home/jgoff/bug.pm​:5
------> <BOL>⏏=end pod
expecting any of​:
horizontal whitespace
whitespace

--cut here--
=begin pod

=begin Documentation

=end Documentation
--cut here--
===SORRY!=== Error while compiling /home/jgoff/bug.pm
'=begin' not terminated by matching '=end pod'
at /home/jgoff/bug.pm​:6
------> <BOL>⏏<EOL>
expecting any of​:
horizontal whitespace
whitespace

I've pushed some code that makes this error message happen.

@p6rt
Copy link
Author

p6rt commented Jun 2, 2015

@hoelzro - Status changed from 'open' to 'resolved'

@p6rt p6rt closed this as completed Jun 2, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant