Prev: FAQ 4.59 How can I know how many entries are in a hash?
Next: FAQ 5.12 How can I write() into a string?
From: Mumia W. on 18 Apr 2010 11:31
I have a problem with the POD docs on my system.

Most of the time when I try to get documentation on a
perl-tk widget or function, the POD has errors that cause
the example code to be missing, e.g.

Whenever "S< >" is used, the entire line containing it
is removed from the output, and an error message appears
at the bottom of the rendered file:

Unterminated S<...> sequence

Obviously, this is not how POD is supposed to work; how can
I get the S sequences to display properly. I'm using Debian Lenny
with Perl 5.10.0 and perldoc 3.14.02.

From: Mumia W. on 20 Apr 2010 13:51
On 04/20/2010 09:01 AM, Steve C wrote:
>>> What type of window are you in? (eg. xterm, text console, emacs
>>> shell, etc.)
>>>
>>
>> urxvt
>
> eh?
>
> perldoc Tk::Scrolled works fine on perl 5.10.0 in a Kconsole window
> with LANG either en_US or en_US.utf8
>
> So sounds like a TERM / termcap / emulation problem with urxvt to me.

I don't know. I seems to be deeper than that.

Here is the Scrolled.pod on my system:
http://home.earthlink.net/~mumia.w.18.spam/docs/Scrolled.pod

And here is the output of "perldoc ./Scrolled.pod > Scrolled.txt":
http://home.earthlink.net/~mumia.w.18.spam/docs/Scrolled.txt

I tried it using a simpler POD file of my own:
http://home.earthlink.net/~mumia.w.18.spam/docs/mine.pod

Here is the output:
http://home.earthlink.net/~mumia.w.18.spam/docs/mine.txt

As you see, the normal "S" construct usage is fine, but the one where
there is empty space between the angle brackets generates an error, and
no output is shown for that line. Many of the PODs on my system have the
"S" construct as seen in the Scrolled.pod that I posted above.

I get the same error with gnome-terminal and at a virtual terminal (VT).
BTW, what O/S are you using?
From: Steve C on 20 Apr 2010 14:34
Mumia W. wrote:
> On 04/20/2010 09:01 AM, Steve C wrote:
>>>> What type of window are you in? (eg. xterm, text console, emacs
>>>> shell, etc.)
>>>>
>>>
>>> urxvt
>>
>> eh?
>>
>> perldoc Tk::Scrolled works fine on perl 5.10.0 in a Kconsole window
>> with LANG either en_US or en_US.utf8
>>
>> So sounds like a TERM / termcap / emulation problem with urxvt to me.
>
> I don't know. I seems to be deeper than that.
>
> Here is the Scrolled.pod on my system:
> http://home.earthlink.net/~mumia.w.18.spam/docs/Scrolled.pod
>
> And here is the output of "perldoc ./Scrolled.pod > Scrolled.txt":
> http://home.earthlink.net/~mumia.w.18.spam/docs/Scrolled.txt
>
> I tried it using a simpler POD file of my own:
> http://home.earthlink.net/~mumia.w.18.spam/docs/mine.pod
>
> Here is the output:
> http://home.earthlink.net/~mumia.w.18.spam/docs/mine.txt
>
> As you see, the normal "S" construct usage is fine, but the one where
> there is empty space between the angle brackets generates an error, and
> no output is shown for that line. Many of the PODs on my system have the
> "S" construct as seen in the Scrolled.pod that I posted above.
>
> I get the same error with gnome-terminal and at a virtual terminal (VT).
> BTW, what O/S are you using?

On this system I'm running
Linux 2.6.27.38-170.2.113.fc10.i686 #1 SMP Wed Nov 4 17:55:39 EST 2009 i686 athlon i386 GNU/Linux
hmmm. Looks like it's time to update.

Most likely then it is the formatter perldoc uses: nroff troff groff or whatever.
I have groff-1.18.1.4-16.fc10.i386
From: Mumia W. on 19 Apr 2010 15:45
On 04/19/2010 07:31 AM, Steve C wrote:
> Mumia W. wrote:
>> I have a problem with the POD docs on my system.
>>
>> Most of the time when I try to get documentation on a
>> perl-tk widget or function, the POD has errors that cause
>> the example code to be missing, e.g.
>>
>> Whenever "S< >" is used, the entire line containing it
>> is removed from the output, and an error message appears
>> at the bottom of the rendered file:
>>
>> Unterminated S<...> sequence
>>
>> Obviously, this is not how POD is supposed to work; how can
>> I get the S sequences to display properly. I'm using Debian Lenny
>> with Perl 5.10.0 and perldoc 3.14.02.
>>
>
> Most likely not a perl issue, but...
> What specific command fails?

perldoc Tk::Scrolled

> What do you have LANG set to?

en_US.UTF-8

> What shell are you using?

bash

> What type of window are you in? (eg. xterm, text console, emacs shell,
> etc.)
>

urxvt

Thanks for any help you can give me.

From: Steve C on 19 Apr 2010 08:31
Mumia W. wrote:
> I have a problem with the POD docs on my system.
>
> Most of the time when I try to get documentation on a
> perl-tk widget or function, the POD has errors that cause
> the example code to be missing, e.g.
>
> Whenever "S< >" is used, the entire line containing it
> is removed from the output, and an error message appears
> at the bottom of the rendered file:
>
> Unterminated S<...> sequence
>
> Obviously, this is not how POD is supposed to work; how can
> I get the S sequences to display properly. I'm using Debian Lenny
> with Perl 5.10.0 and perldoc 3.14.02.
>

Most likely not a perl issue, but...
What specific command fails?
What do you have LANG set to?
What shell are you using?
What type of window are you in? (eg. xterm, text console, emacs shell, etc.)

 |  Next  |  Last
Pages: 1 2
Prev: FAQ 4.59 How can I know how many entries are in a hash?
Next: FAQ 5.12 How can I write() into a string?