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

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

Closed
p5pRT opened this issue Jul 28, 1999 · 4 comments
Closed

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

p5pRT opened this issue Jul 28, 1999 · 4 comments

Comments

@p5pRT
Copy link

@p5pRT p5pRT commented Jul 28, 1999

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

Searchable as RT1093$

@p5pRT
Copy link
Author

@p5pRT p5pRT commented Jul 28, 1999

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
Copy link
Author

@p5pRT p5pRT commented Jul 29, 1999

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
Copy link
Author

@p5pRT p5pRT commented Jul 29, 1999

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
Copy link
Author

@p5pRT p5pRT commented Mar 28, 2000

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
1 participant