Perl 5.0 Docs. ASCII Please!!
Ricardo Nassif
-> In article <Duncan_McIntyre/HP6300_Q2....@desk.hp.com> Duncan_McIntyre/HP63...@desk.hp.com (Duncan McIntyre) writes:
-> >Is there any chance of putting a version of the 5.0 docs out there in ftp-land
-> >as plain-text ASCII (or PCL) files?
-> >
-> Umm, maybe a pod2text converter is called for.
-> Anyone fancy having a go?
Why not, at least temporarily, simply convert perl5.000-doc.ps to
ascii?
--
|"There is grandeur ||||||||||||||||||||||||||||||| Ricardo Nassif |||||||
| in this view ||||||||||||||||||||||||||||||| r...@netcom.com |||||||
| of life" |Web >> URL:ftp://ftp.netcom.com/pub/rn0/ricardo.html|
| C. Darwin, 1859 |||||||||||||||||||||||||||||||||||||||||||[*GO GNU*]|
Jeff Licquia
>Tim Bunce (Tim....@ig.co.uk) wrote:
>-> In article <Duncan_McIntyre/HP6300_Q2....@desk.hp.com> Duncan_McIntyre/HP63...@desk.hp.com (Duncan McIntyre) writes:
>-> >Is there any chance of putting a version of the 5.0 docs out there in ftp-land
>-> >as plain-text ASCII (or PCL) files?
>-> >
>-> Umm, maybe a pod2text converter is called for.
>-> Anyone fancy having a go?
> Why not, at least temporarily, simply convert perl5.000-doc.ps to
>ascii?
Or, if you want:
#!/bin/sh
pod2man
for thisfile in `ls *.man`
do
groff -mandoc -Tascii $thisfile > $thisfile.txt
done
# and, for a final twist if necessary
cat *.txt > perl5.000.doc.ascii
Oops! Did I just write a shell script? Not a perl script?
BLESS ME LARRY, FOR I HAVE SINNED!!!
:-)
Duncan McIntyre
I don't have access to a PostScript printer, ghostscript is too slow, and even
if I could send to a PS printer, experience tells me that 240 odd pages-worth
will crash halfway through and I'll never manage to get the lot printed :-(
Thanks!
________________________________________________________________________________
Duncan_McIntyre @grenoble.hp.com
"I am drunk, and you madam are ugly, but in the morning I shall be sober...."
______________________________________________________________
Daniel Faken
> -> In article <Duncan_McIntyre/HP6300_Q2....@desk.hp.com>
Duncan_McIntyre/HP63...@desk.hp.com (Duncan McIntyre) writes:
> -> >Is there any chance of putting a version of the 5.0 docs out there in
ftp-land
> -> >as plain-text ASCII (or PCL) files?
> -> >
> -> Umm, maybe a pod2text converter is called for.
>
> -> Anyone fancy having a go?
>
> Why not, at least temporarily, simply convert perl5.000-doc.ps to
> ascii?
Maybe someone has already said this, but why not just read the .pod files???
This is what I do.
Daniel Faken
absi...@u.washington.edu
BIU
>In article <Duncan_McIntyre/HP6300_Q2....@desk.hp.com> Duncan_McIntyre/HP63...@desk.hp.com (Duncan McIntyre) writes:
>>as plain-text ASCII (or PCL) files?
>>
>
whats wrong with pod2man followed by 'nroff -man'
(and optionally followed by perl -ne 's/_\cH//;print;')
--
Jack j...@biu.icnet.uk
If you only have a hammer, you tend to see every problem as a nail.
-- Maslow
Duncan McIntyre
>Subject: Re: Perl 5.0 Docs. ASCII Please!!
>Date: Mon, 24 Oct 1994 13:04:48 +0000
>In article <Duncan_McIntyre/HP6300_Q2....@desk.hp.com>
>Duncan_McIntyre/HP63...@desk.hp.com (Duncan McIntyre) writes:
>>Is there any chance of putting a version of the 5.0 docs out there in ftp-land
>>as plain-text ASCII (or PCL) files?
>>
>Umm, maybe a pod2text converter is called for.
>Anyone fancy having a go?
>>Duncan_McIntyre @grenoble.hp.com
>Regards,
>Tim Bunce.
Someone here was able to print it for me (merci Dominique). But I do
think an ASCII version would be a nice thing to make available - not everyone
has access to Postscript printers.
BTW. Good job on the docs. They're really readable. I can't wait to try some
of it out!
Jerry Whelan
-} In article <Duncan_McIntyre/HP6300_Q2....@desk.hp.com> Duncan_McIntyre/HP63...@desk.hp.com (Duncan McIntyre) writes:
-} >Is there any chance of putting a version of the 5.0 docs out there in ftp-land
-} >as plain-text ASCII (or PCL) files?
-} >
-} Umm, maybe a pod2text converter is called for.
-}
-} Anyone fancy having a go?
This is simple:
pod2man file.pod | nroff -man | col -b > file.txt
Philip Hazel
|>
|> I don't have access to a PostScript printer, ghostscript is too slow, and even
|> if I could send to a PS printer, experience tells me that 240 odd pages-worth
|> will crash halfway through and I'll never manage to get the lot printed :-(
It is not difficult to chop the PostScript up into chunks of, say, 30
pages, as I did when printing this large file.
--
Philip Hazel University Computing Service,
ph...@cus.cam.ac.uk New Museums Site, Cambridge CB2 3QG,
P.H...@ucs.cam.ac.uk England. Phone: +44 1223 334714
Eric Silber
a perl program could be compiled into a portable intermediate binary format?
I.e. compiled into some kind of byte code? This could allow for:
1) the runtime performance boost of a compiled program
2) a non-transparent format than can be delivered to the end user without
explicitly making the src visible.
3) a machine-independent compiled format
I don't know how this might be implemented. I suspect it's not feasible
(would require major changes in perl internals ???? )
Tim Bunce
I'm very well aware of this but it requires nroff (not readily
available on VMS, MS-DOS, AmigaDOS etc).
This is one of the reasons Larry moved away from *roff format for the
Perl 5 documentation. The P in pod can also stand for portable.
Regards,
Tim Bunce.
Edward Hartnett
>> pod2man file.pod | nroff -man | col -b > file.txt
T> I'm very well aware of this but it requires nroff (not readily
T> available on VMS, MS-DOS, AmigaDOS etc).
T> This is one of the reasons Larry moved away from *roff format for the
T> Perl 5 documentation. The P in pod can also stand for portable.
Sorry if I appear to be a yokal, but what is this pod stuff anyway?
I've never heard of it before now.
--
Edward Hartnett e...@larry.gsfc.nasa.gov
(301) 286-2396 fax: (301) 286-1754
"Tut! Tut!" cried Sherlock Holmes. "You must act, man, or you are
lost. Nothing but energy can save you. This is no time for dispair."
Walter Tautz
: e...@larry.gsfc.nasa.gov (Edward Hartnett) writes:
: Sorry if I appear to be a yokal, but what is this pod stuff anyway?
: I've never heard of it before now.
: plain old documentation. it's a format larry designed recently
: for use by perl5. the ideas are it's easy of use, and that you
: write some translator from pod to some other markup language
: (two of these exist currently - pod2man and pod2html), so you
: can read it how ever you want.
: .mrg.
How about a pod2latex translator. Walter
Larry Wall
: How about a pod2latex translator. Walter
Nothing gets done without someone doing it.
Larry