From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?Q?Harald_J=C3=B6rg?= Newsgroups: gmane.emacs.devel Subject: Re: [ELPA] New package: perl-doc Date: Thu, 28 Jul 2022 08:57:39 +0000 Message-ID: <871qu5r4vw.fsf@hajtower> References: <87a68upm3w.fsf@hajtower> <875yjhdg5q.fsf@gmail.com> <83sfmlail1.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24984"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Visuwesh , Eli Zaretskii To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Jul 28 11:19:35 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oGzg6-0006Jh-EK for ged-emacs-devel@m.gmane-mx.org; Thu, 28 Jul 2022 11:19:34 +0200 Original-Received: from localhost ([::1]:49768 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oGzg5-0001U8-1N for ged-emacs-devel@m.gmane-mx.org; Thu, 28 Jul 2022 05:19:33 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57030) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oGzL3-0005sh-Fc for emacs-devel@gnu.org; Thu, 28 Jul 2022 04:57:51 -0400 Original-Received: from mout01.posteo.de ([185.67.36.65]:50013) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oGzKy-0002U2-Is for emacs-devel@gnu.org; Thu, 28 Jul 2022 04:57:46 -0400 Original-Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 7E476240027 for ; Thu, 28 Jul 2022 10:57:40 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.de; s=2017; t=1658998660; bh=lyjZDdiDiX5e6R6EZEBtLc4EkFc1n7A0sMc37ZTP8ck=; h=From:To:Cc:Subject:Date:From; b=L9leEkHywpgfZUwWZOakxWjco1UIlEhHIGikRdSoEivxbxHSm9EJC8iurJnAez16l mUMevWpF42NC4JcfM6HkQ5mvR55m8tCdLWOvC36vXakMMXH4xLht9PHBT4S5R017+m nKI4R4Oj0NSpClEzvGZup76xjcdKVrqKsKY+aVUHVPGGOFELYO31NhFORDI2axvcsu gb2DIkBjU1BVIemSPNmB8t9U6gEpPsp2TcIxqdtk63LslfEiV4Nz0FEZsTbTh6915R 2b5tQf7SZpHxFmUSGgyQTY+UHxHNfeKnIH82l04qN8kjdASMyxNLrE7Wpif517i5Z4 e+7HbneS7J8Vw== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4Ltl0M5ll2z6tnZ; Thu, 28 Jul 2022 10:57:39 +0200 (CEST) In-Reply-To: <83sfmlail1.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 28 Jul 2022 08:53:46 +0300") Received-SPF: pass client-ip=185.67.36.65; envelope-from=haj@posteo.de; helo=mout01.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:292778 Archived-At: Eli Zaretskii writes: >> From: Visuwesh >> Cc: Emacs Developer List >> Date: Thu, 28 Jul 2022 09:47:53 +0530 >>=20 >> [=E0=AE=AA=E0=AF=81=E0=AE=A4=E0=AE=A9=E0=AF=8D =E0=AE=9C=E0=AF=82=E0=AE= =B2=E0=AF=88 27, 2022] Harald J=C3=B6rg wrote: >>=20 >> > the motivation to write this library came from two sources: In a Perl >> > online meeting an Emacs user noted that the usual function to read Perl >> > documentation in Emacs, cperl-perldoc, does not work on Platforms which >> > don't have 'man' (notably, Windows). >>=20 >> What about woman? It should be reasonably fast for most manpages. > > It cannot format many modern man pages because it wasn't extended to > support the roff directives added in recent years. Patches to add > that are welcome. The troubles start before that: The POD to man converter (pod2man) is lossy. It is suited for character terminals or printing, but not so much for interactive viewing in Emacs. What I miss most is clickable links between POD documents. > P.S. A simple clone of 'man' for Windows is available from ezwinports > site. Sure, but the chase doesn't end here! When I tried yesterday on a Windows 11 system and Emacs 27.2, cperl-perldoc perlrun complained that it can't find sed. But the actual problem is "read POD documents" rather than "run man". In my opinion the quality of POD->HTML is better than POD->man. Here's a screenshot with a comparison (Linux, Emacs built from git): https://raw.githubusercontent.com/HaraldJoerg/HaraldJoerg.github.io/main/em= acs_perldoc.png So, as a second step, I consider adding it to cperl-mode.el itself (protected by an (if (fboundp perl-doc ...)) clause) which can improve the user's experience if they decide to install the package, or simply make it work on Windows. Side note: There's also pod-mode.el at https://github.com/renormalist/emacs-pod-mode. This mode is geared towards _authoring_ POD rather than browsing it. --=20 Cheers, haj