-> Anyone fancy having a go?
Why not, at least temporarily, simply convert perl5.000-doc.ps to
|"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*]|
>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
Or, if you want:
for thisfile in `ls *.man`
groff -mandoc -Tascii $thisfile > $thisfile.txt
# 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!!!
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 :-(
"I am drunk, and you madam are ugly, but in the morning I shall be sober...."
Maybe someone has already said this, but why not just read the .pod files???
This is what I do.
whats wrong with pod2man followed by 'nroff -man'
(and optionally followed by perl -ne 's/_\cH//;print;')
If you only have a hammer, you tend to see every problem as a nail.
>>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?
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!
This is simple:
pod2man file.pod | nroff -man | col -b > file.txt
It is not difficult to chop the PostScript up into chunks of, say, 30
pages, as I did when printing this large file.
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 ???? )
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.
>> 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.
"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."
: 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.
How about a pod2latex translator. Walter