Perl 5.005_58 perldoc references unknown Pod::Text::pod2text

[p5pRT]

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

Searchable as RT1093$

[p5pRT]

From Paul.Moore@uk.origin-it.com

Perl built OK, and passed all tests. However, using perldoc on anything
(eg, "perldoc utf8") reports

Undefined subroutine &Pod​::Text​::pod2text called at
C​:\Perl\5.00558\Bin/perldoc.bat line 291.

Perl Info

Site configuration information for perl 5.00558:

Summary of my perl5 (revision 5.0 version 5 subversion 58)
configuration:
  Platform:
    osname=MSWin32, osvers=4.0, archname=MSWin32-x86
    uname=''
    config_args='undef'
    hint=recommended, useposix=true, d_sigaction=undef
    usethreads=undef useperlio=undef d_sfio=undef
    use64bits=undef usemultiplicity=undef
  Compiler:
    cc='cl.exe', optimize='-O1 -MD -DNDEBUG', gccversion=
    cppflags='-DWIN32'
    ccflags ='-O1 -MD -DNDEBUG -DWIN32 -D_CONSOLE -DNO_STRICT  '
    stdchar='char', d_stdstdio=define, usevfork=false
    intsize=4, longsize=4, ptrsize=4, doublesize=8
    d_longlong=undef, longlongsize=8, d_longdbl=define, longdblsize=10
    alignbytes=8, usemymalloc=n, prototype=define
  Linker and Libraries:
    ld='link', ldflags ='-nologo -nodefaultlib -release -machine:x86'
    libpth=C:\VisualStudio\VC98\lib
    libs=-DELAYLOAD:wsock32.dll delayimp.lib   oldnames.lib kernel32.lib
user32.lib gdi32.lib  winspool.lib comdlg32.lib advapi32.lib shell32.lib
ole32.lib  oleaut32.lib netapi32.lib uuid.lib wsock32.lib mpr.lib
winmm.lib  version.lib odbc32.lib odbccp32.lib PerlCRT.lib
    libc=PerlCRT.lib, so=dll, useshrplib=yes, libperl=perl.lib
  Dynamic Linking:
    dlsrc=dl_win32.xs, dlext=dll, d_dlsymun=undef, ccdlflags=' '
    cccdlflags=' ', lddlflags='-dll -nologo -nodefaultlib -release
-machine:x86'

Locally applied patches:
    


@INC for perl 5.00558:
    C:/Perl/5.00558/lib/MSWin32-x86
    C:/Perl/5.00558/lib
    C:/Perl/site/5.00558/lib
    .


Environment for perl 5.00558:
    HOME (unset)
    LANG (unset)
    LANGUAGE (unset)
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=C:\WINNT\system32;C:\WINNT;C:\UTILS;C:\Perl\5.00558\Bin;C:\Perl
\5.00558\Bin\MSWin32-x86;C:\VisualStudio\Common\Tools\WinNT;C:\VisualStu
dio\Common\MSDev98\Bin;C:\VisualStudio\Common\Tools;C:\VisualStudio\VC98
\bin;C:\Program
Files\Mts;C:\MSSQL7\BINN;C:\orant\bin;C:\DMINT40\Win32\Bin;C:\Program
Files\CWNT;C:\NTRESKIT
    PERL_BADLANG (unset)
    SHELL (unset)

[p5pRT]

From @gsar

On Wed, 28 Jul 1999 14​:46​:34 BST, "Moore, Paul" wrote​:

Perl built OK, and passed all tests. However, using perldoc on anything
(eg, "perldoc utf8") reports

Undefined subroutine &Pod​::Text​::pod2text called at
C​:\Perl\5.00558\Bin/perldoc.bat line 291.

The new Pod​::(Simple)Text doesn't seem to have a pod2text() function
for compatibility with the old one. Short of someone writing that,
I've added a little workaround that should help.

Sarathy
gsar@​activestate.com

Inline Patch

-----------------------------------8<-----------------------------------
Change 3827 by gsar@auger on 1999/07/29 07:10:00

	band-aid for perldoc -t broken-ness (the new Pod::Text
	really needs a pod2text() compatibility function)

Affected files ...

... //depot/perl/utils/perldoc.PL#36 edit

Differences ...

==== //depot/perl/utils/perldoc.PL#36 (text) ====
Index: perl/utils/perldoc.PL
--- perl/utils/perldoc.PL.~1~	Thu Jul 29 00:10:51 1999
+++ perl/utils/perldoc.PL	Thu Jul 29 00:10:51 1999
@@ -313,10 +313,7 @@
     my $err;
 
     if ($opt_t) {
-	open(TMP,">>$tmp")
-		or warn("Can't open $tmp: $!"), return;
-	Pod::Text::pod2text($file,*TMP);
-	close TMP;
+	Pod::Text->new()->parse_from_file($file,$tmp);
     }
     elsif (not $opt_u) {
 	my $cmd = "pod2man --lax $file | nroff -man";
End of Patch.

Change 3828 by gsar@auger on 1999/07/29 07:19:27

	tweak previous change for multiple hits

Affected files ...

... //depot/perl/utils/perldoc.PL#37 edit

Differences ...

==== //depot/perl/utils/perldoc.PL#37 (text) ====
Index: perl/utils/perldoc.PL
--- perl/utils/perldoc.PL.~1~	Thu Jul 29 00:19:57 1999
+++ perl/utils/perldoc.PL	Thu Jul 29 00:19:57 1999
@@ -313,7 +313,9 @@
     my $err;
 
     if ($opt_t) {
-	Pod::Text->new()->parse_from_file($file,$tmp);
+	open(OUT,">>$tmp") or warn("Can't open $tmp: $!"), return;
+	Pod::Text->new()->parse_from_file($file,\*OUT);
+	close OUT;
     }
     elsif (not $opt_u) {
 	my $cmd = "pod2man --lax $file | nroff -man";
End of Patch.

[p5pRT]

From [Unknown Contact. See original ticket]

Gurusamy Sarathy <gsar@​activestate.com> writes​:

The new Pod​::(Simple)Text doesn't seem to have a pod2text() function
for compatibility with the old one.

Done in the latest version, tested against perldoc from 5.005_02 and it
seems to work fine. pod2text doesn't work because it assumes that
Pod​::Text exports pod2text(), but part of my stuff is a complete
replacement for pod2text anyway.

--
Russ Allbery (rra@​stanford.edu) <URL​:http​://www.eyrie.org/~eagle/>

[p5pRT]

From [Unknown Contact. See original ticket]

My take is to let C<...> simply become \f(CW...\fP and omit any other
markings altogether. That way both nroff :-) and troff will render it
in constant width.

Try running 'pod2man --fixed=B blah.pod | nroff -man | less' on
something and see whether you don't like what you see better than
what you saw. Well, modulo the unneeded `quotes'. But the bold
looks nice there.

--tom