From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Newsgroups: gmane.emacs.help Subject: Re: Any handy way to read perldoc output Date: Tue, 3 Feb 2009 15:31:13 -0800 (PST) Organization: http://groups.google.com Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1233704495 11121 80.91.229.12 (3 Feb 2009 23:41:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 3 Feb 2009 23:41:35 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Wed Feb 04 00:42:50 2009 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LUUul-0003X6-Nl for geh-help-gnu-emacs@m.gmane.org; Wed, 04 Feb 2009 00:42:47 +0100 Original-Received: from localhost ([127.0.0.1]:53792 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LUUtS-0000fL-WD for geh-help-gnu-emacs@m.gmane.org; Tue, 03 Feb 2009 18:41:27 -0500 Original-Path: news.stanford.edu!newsfeed.stanford.edu!postnews.google.com!w24g2000prd.googlegroups.com!not-for-mail Original-Newsgroups: gnu.emacs.help Original-Lines: 32 Original-NNTP-Posting-Host: 131.225.53.48 Original-X-Trace: posting.google.com 1233703873 11566 127.0.0.1 (3 Feb 2009 23:31:13 GMT) Original-X-Complaints-To: groups-abuse@google.com Original-NNTP-Posting-Date: Tue, 3 Feb 2009 23:31:13 +0000 (UTC) Complaints-To: groups-abuse@google.com Injection-Info: w24g2000prd.googlegroups.com; posting-host=131.225.53.48; posting-account=czAMxQoAAAAUEojshw4CrIvcwSdulymE User-Agent: G2/1.0 X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.0.5) Gecko/2008120122 Firefox/3.0.5,gzip(gfe),gzip(gfe) Original-Xref: news.stanford.edu gnu.emacs.help:166579 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:61892 Archived-At: On Feb 1, 8:56=A0am, k...@freefriends.org (Karl Berry) wrote: > =A0 =A0 Is there any handy way to read perldoc output in emacs? > =A0 =A0 An i (index) search of emacs manual on `perldoc' showed nothing. > > Besides perldoc -t that Xah mentioned, there is a pod2texinfo program > (http://search.cpan.org/~randym/pod2texinfo-1.0/) but it has not been > updated since 1998. =A0 > > I personally would very much like to have the main Perl documentation as > a Texinfo manual, but have never been able to spend the time on it. > Just running pod2texinfo did not suffice, it needed work beyond that. > If anyone finds or produces something for the current perl manuals, > please let me know. > > k...@freefriends.org I made a serious effort to find Perl documentation in texinfo form that was reasonably up-to-date. I concluded that I'd have to do much of the work myself. At "http://www.gnu.org/software/texinfo/ texinfo.html" there is mention of "man2texi", which is an awk script to convert from nroff source code (man pages) to texinfo. I've been using a modified form of "man2texi" to make the conversion, but there is a lot of extra custom effort involved (additional effort is needed for cross-linking references, which are often a matter of taste). Plus I haven't done all the Perl man pages; so far I've concentrated on the ones I regard as most useful. My platform is MS Windows XP. The Perl and Perl man nroff source code come via Cygwin. One extra wrinkle is that I've arranged that the resulting Info files preserve the bolding found on the man pages. Also, it is sometimes necessary to use POD to get nroff source code to feed to "man2texi". A necessary disclosure is that I use XEmacs--due to personal historical reasons.