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

documentation in another format? #761

Closed
p5pRT opened this issue Oct 22, 1999 · 3 comments
Closed

documentation in another format? #761

p5pRT opened this issue Oct 22, 1999 · 3 comments

Comments

@p5pRT
Copy link

p5pRT commented Oct 22, 1999

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

Searchable as RT1685$

@p5pRT
Copy link
Author

p5pRT commented Oct 22, 1999

From joesao@yahoo.com

I'm trying to learn perl and would like to print out the documentation
on your site. However, due to the many <hr> tags, I tried printing the
version changes page
<http​://www.perl.com/pub/doc/manual/html/pod/perldelta.html>
and that gave me 89 pages!

Isn't there the documentation in txt format, without <hr> tags, or in
pdf, etc?

thanks
marcelo

__________________________________________________
Do You Yahoo!?
Bid and sell for free at http​://auctions.yahoo.com

@p5pRT
Copy link
Author

p5pRT commented Oct 22, 1999

From [Unknown Contact. See original ticket]

On Fri, 22 Oct 1999 06​:20​:07 -0700 (PDT)
  "Marcelo P. Lima" <joesao@​yahoo.com> wrote
  in <19991022132007.11705.rocketmail@​web1004.mail.yahoo.com>​:

Dear sir/madam​:

I'm trying to learn perl and would like to print out the documentation
on your site. However, due to the many <hr> tags, I tried printing the
version changes page
<http​://www.perl.com/pub/doc/manual/html/pod/perldelta.html>
and that gave me 89 pages!

Isn't there the documentation in txt format, without <hr> tags, or in
pdf, etc?

The raw documentation for Perl is not in HTM. It is in pod form and is
included wiht every valid Perl distribution. Directions are here​:

% pod2text /usr/src/perl/INSTALL

...

DOCUMENTATION
  Read the manual entries before running perl. The main documentation
  is in the pod/ subdirectory and should have been installed during
  the build process. Type man perl to get started. Alternatively,
  you can type perldoc perl to use the supplied perldoc script. This
  is sometimes useful for finding things in the library modules.

  Under UNIX, you can produce a documentation book in postscript form,
  along with its table of contents, by going to the pod/ subdirectory and
  running (either)​:

  ./roffitall -groff # If you have GNU groff installed
  ./roffitall -psroff # If you have psroff

  This will leave you with two postscript files ready to be
  printed. (You may need to fix the roffitall command to use your
  local troff set-up.)

  Note that you must have performed the installation already before
  running the above, since the script collects the installed files to
  generate the documentation.

But the normal thing to do is simply one of these​:

  % man -t perldelta
  % pod2man /usr/src/perl/pod/perldelta.pod | troff -man | lpr
  % pod2man /usr/src/perl/pod/perldelta.pod | troff -Tps -man | lpr
  % pod2man /usr/src/perl/pod/perldelta.pod | nroff -man | lpr
  % pod2text /usr/src/perl/pod/perldelta.pod | | lpr

--tom

@p5pRT
Copy link
Author

p5pRT commented Oct 22, 1999

From [Unknown Contact. See original ticket]

guys,

ignore my other e-mail. I started manually editing your html files and
removing the <hr> tags so that it prints well. i don't know what's up.
It previews well in Netscape but prints badly in HP 5M.

thanks,
marcelo
__________________________________________________
Do You Yahoo!?
Bid and sell for free at http​://auctions.yahoo.com

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

No branches or pull requests

1 participant