Skip Menu |
 

This queue is for tickets about the podlators CPAN distribution.

Report information
The Basics
Id: 132007
Status: open
Priority: 0/
Queue: podlators

People
Owner: Nobody in particular
Requestors: dima [...] secretsauce.net
Cc:
AdminCc:

Bug Information
Severity: (no value)
Broken in: (no value)
Fixed in: (no value)



MIME-Version: 1.0
X-Spam-Status: No, score=-2 tagged_above=-99.9 required=10 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1] autolearn=ham
X-Me-Proxy: <xmx:UXBYXl5H6EsczgiAqwRZxfgf1HhyQNqK3Gw7Ah5JJqFeRzUPpRJMIQ> <xmx:UXBYXgmQGMw7u3agYKMgfFOHop-kSLyvK_Z0GDZbS2IXibM5pCH_Mg> <xmx:UXBYXm4AhU5dIhEb_H3nCG4U41arrHCXC3IT0JkiiuApIrOZXoazZg> <xmx:UnBYXrj4xlgjrAVyPmUP-PdBkzatICI-yIfss6yzuHsg7BXDtMEpDg>
X-Cpan.org: This message routed through the cpan.org mail forwarding service. Please use PAUSE pause.perl.org to configure your delivery settings.
X-Spam-Flag: NO
content-type: text/plain; charset="utf-8"
Message-ID: <87eeufmqov.fsf [...] secretsauce.net>
X-Virus-Scanned: Debian amavisd-new at bestpractical.com
X-Spam-Score: -2
Received: from localhost (localhost [127.0.0.1]) by hipster.bestpractical.com (Postfix) with ESMTP id C05D62403D4 for <cpan-bug+podlators [...] hipster.bestpractical.com>; Thu, 27 Feb 2020 20:43:55 -0500 (EST)
Received: from hipster.bestpractical.com ([127.0.0.1]) by localhost (hipster.bestpractical.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id XX7bg-ZXVh4D for <cpan-bug+podlators [...] hipster.bestpractical.com>; Thu, 27 Feb 2020 20:43:51 -0500 (EST)
Received: from xx1.develooper.com (xx1.develooper.com [147.75.38.233]) by hipster.bestpractical.com (Postfix) with ESMTPS id 4CFBE2403D3 for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 20:43:51 -0500 (EST)
Received: from localhost (xx1.develooper.com [127.0.0.1]) by localhost (Postfix) with ESMTP id D579F7C0F3 for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 17:43:50 -0800 (PST)
Received: from xx1.develooper.com (xx1.develooper.com [127.0.0.1]) by localhost (Postfix) with SMTP id 0D3387CF3A for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 17:43:47 -0800 (PST)
Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by xx1.develooper.com (Postfix) with ESMTPS id CA3EC7C0F3 for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 17:43:46 -0800 (PST)
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 3B056221A9 for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 20:43:46 -0500 (EST)
Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Thu, 27 Feb 2020 20:43:46 -0500
Received: from scrawny (unknown [128.149.110.161]) by mail.messagingengine.com (Postfix) with ESMTPA id AB7DA3280064 for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 20:43:45 -0500 (EST)
Received: from dima by scrawny with local (Exim 4.92) (envelope-from <dima [...] secretsauce.net>) id 1j7Uh6-00024P-CE for bug-podlators [...] rt.cpan.org; Thu, 27 Feb 2020 17:44:00 -0800
Authentication-Results: hipster.bestpractical.com (amavisd-new); dkim=pass header.i= [...] secretsauce.net
Authentication-Results: hipster.bestpractical.com (amavisd-new); dkim=pass header.i= [...] messagingengine.com
Delivered-To: cpan-bug+podlators [...] hipster.bestpractical.com
Subject: pod2man produces bogus output
User-Agent: mu4e 1.2.0; emacs 28.0.50
Return-Path: <dima [...] secretsauce.net>
X-Me-Sender: <xms:UXBYXpDAqioq2ORvH6pJYuCBFP7BKxuzWQd6nVf56LRkobImuKp9WQ>
X-RT-Mail-Extension: podlators
X-Original-To: cpan-bug+podlators [...] hipster.bestpractical.com
Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=secretsauce.net; h=from:to:subject:date:message-id:mime-version:content-type; s= fm2; bh=EjkPzXWZNIVEzfA2YDgKHkv0xheANuNy6GVjzIIFR78=; b=kZKsA4XN XLUouy9ckiuPZSmdAFXneEa11aEPkUbAOpB74JhP6mS+lXVhfCYvAQ31ikkwcG4J xgVUs+/NX1MfRZ4eA5Hxt4bjU0XmRlrX5IEL3Sl+QLPxVq32kdI9D21Iwm1X1Tut Ky8ua+hFsc+1KUCbKOUopC6q8HJLwlNMSOvXcjDoLXq9Y0Ubj02eU49zpzRTI1ai or2gevJc+Foeg+jnT75SDEUPVfmMqLdS2Jj0GJwYrMjRFvs0PT8t1ynWPQ6zwgP3 MAzqHyPHhjnVwlmKt05hY+D/TqkTLniFidnwnSIEeDwZG0a7I6Kna6SHw5esdJwJ fVCuSdnOwHgRqg==
Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:message-id :mime-version:subject:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm2; bh=EjkPzXWZNIVEzfA2YDgKHkv0xheAN uNy6GVjzIIFR78=; b=F4lgjyuXvD+dyfSkzU74cJPTof/dLfwiqjL2pI0AUrsYX nGQOBTIJ6oB4rtyb4ahuZIMxcHo5+7dMfoPxZu2QjHWye3G6Fdn2w+aPIZvpD7Rh k1zRNrV+H6Zhx7jXDzCJhTkClzzzjm7WQeuPNiJPO7RyROoji8JQoNNRvo3Nh0Gl otlbQvuTv7QhCN3lPRai82pEYcNnKfzfCVcDaS2NpKuh8sRqAk4tyDAe30cyn+sq PeNfa7QYIsnX/UGaW5yt8s4gzbHf4TOWZNTzCiexCz0MtPcH6hBslELdt24FLjKT WzhgnkbB3iq8B6TivEjGXUyRJYl9jJTyBhmp7WqTQ==
X-PMX-Spam: Gauge=IIIIIIII, Probability=8%, Report=' HTML_00_01 0.05, HTML_00_10 0.05, BODYTEXTP_SIZE_3000_LESS 0, BODY_SIZE_1400_1499 0, BODY_SIZE_2000_LESS 0, BODY_SIZE_5000_LESS 0, BODY_SIZE_7000_LESS 0, DATE_TZ_NA 0, DKIM_ALIGNS 0, DKIM_SIGNATURE 0, KNOWN_MTA_TFX 0, NO_CTA_FOUND 0, NO_CTA_URI_FOUND 0, NO_URI_FOUND 0, NO_URI_HTTPS 0, SPF_NONE 0, SXL_IP_TFX_WM 0, __BODY_NO_MAILTO 0, __CT 0, __CT_TEXT_PLAIN 0, __DKIM_ALIGNS_1 0, __DKIM_ALIGNS_2 0, __FRAUD_MONEY_CURRENCY 0, __FRAUD_MONEY_CURRENCY_DOLLAR 0, __HAS_FROM 0, __HAS_MSGID 0, __MIME_TEXT_ONLY 0, __MIME_TEXT_P 0, __MIME_TEXT_P1 0, __MIME_VERSION 0, __NO_HTML_TAG_RAW 0, __SANE_MSGID 0, __SUBJ_ALPHA_END 0, __SUBJ_ALPHA_START 0, __TO_MALFORMED_2 0, __TO_NO_NAME 0, __URI_NO_MAILTO 0, __USER_AGENT 0, __blackholes.mail-abuse.org_ERROR , __zen.spamhaus.org_ERROR '
X-PMX-Perl: Suspicious Attachment
Date: Thu, 27 Feb 2020 17:44:00 -0800
X-Spam-Level:
X-PMX-Version: 5.6.1.2065439, Antispam-Engine: 2.7.2.376379, Antispam-Data: 2019.11.28.70017
To: bug-podlators [...] rt.cpan.org
From: Dima Kogan <dima [...] secretsauce.net>
X-Me-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedrleejgdeflecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepfgfhvffufffkgggtsehttdertddtre dtnecuhfhrohhmpeffihhmrgcumfhoghgrnhcuoeguihhmrgesshgvtghrvghtshgruhgt vgdrnhgvtheqnecukfhppeduvdekrddugeelrdduuddtrdduiedunecuvehluhhsthgvrh fuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepughimhgrsehsvggtrhgvthhs rghutggvrdhnvght
X-RT-Original-Encoding: ascii
X-RT-Interface: Email
Content-Length: 1373
Download (untitled) / with headers
text/plain 1.3k
Hi. Let's say I have this tst.pod file: ====================================================== =head1 abc EVT_...() VT_...() T_...() _...() ...() EVT_...() EVT_..() EVT_.() EVT_() EVT() EVT_...() EVT_...( EVT_... EVT_.. EVT_. ====================================================== I run pod2man: ====================================================== $ pod2man tst.pod ... \&\s-1EVT_...\\fBs0()\fR \&\s-1VT_...\\fBs0()\fR T_...() _...() \&...() \&\s-1EVT_...\\fBs0()\fR \&\s-1EVT_..\\fBs0()\fR \&\s-1EVT_.\\fBs0()\fR \&\s-1\fBEVT_\s0()\fR \&\s-1\fBEVT\s0()\fR \&\s-1EVT_...\\fBs0()\fR \&\s-1EVT_...\s0( \&\s-1EVT_... EVT_.. EVT_.\s0 ... ====================================================== Spaces added for clarity, and only the interesting things kept. Note that sometimes pod2man like to bold things, even I never asked for it (\\fB tags). And note that sometimes pod2man likes to add "s0", which is some sort of leftover code that is not interpreted by the "man" tool: "man" actually displays "s0", which is nowhere in the original text. My understanding is that POD markup is either - lines starting with =something - text such as B<something> or L<something> and such Is there some other type of markup that pod2man is trying to interpret that I'm accidentally including in tst.pod? I don't see anything clear in the "perlpod" manpage. Thanks.
MIME-Version: 1.0
X-Spam-Status: No, score=-5.828 tagged_above=-99.9 required=10 tests=[AWL=0.072, BAYES_00=-1.9, FROM_OUR_RT=-4] autolearn=ham
In-Reply-To: <rt-4.0.18-28047-1582854236-1575.132007-4-0 [...] rt.cpan.org> (Dima Kogan via's message of "Thu, 27 Feb 2020 20:43:57 -0500")
X-Cpan.org: This message routed through the cpan.org mail forwarding service. Please use PAUSE pause.perl.org to configure your delivery settings.
X-Spam-Flag: NO
X-RT-Interface: API
References: <RT-Ticket-132007 [...] rt.cpan.org> <87eeufmqov.fsf [...] secretsauce.net> <rt-4.0.18-28047-1582854236-1575.132007-4-0 [...] rt.cpan.org>
X-Virus-Scanned: Debian amavisd-new at bestpractical.com
Message-ID: <87imjrv1p4.fsf [...] hope.eyrie.org>
content-type: text/plain; charset="utf-8"
Organization: The Eyrie
X-RT-Original-Encoding: utf-8
X-Spam-Score: -5.828
Received: from localhost (localhost [127.0.0.1]) by hipster.bestpractical.com (Postfix) with ESMTP id 4BD8B2403D3 for <cpan-bug+podlators [...] hipster.bestpractical.com>; Thu, 27 Feb 2020 22:25:11 -0500 (EST)
Received: from hipster.bestpractical.com ([127.0.0.1]) by localhost (hipster.bestpractical.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Pcfs1PcrEvsv for <cpan-bug+podlators [...] hipster.bestpractical.com>; Thu, 27 Feb 2020 22:25:09 -0500 (EST)
Received: from xx1.develooper.com (xx1.develooper.com [147.75.38.233]) by hipster.bestpractical.com (Postfix) with ESMTPS id C70E82403CA for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 22:25:08 -0500 (EST)
Received: from localhost (xx1.develooper.com [127.0.0.1]) by localhost (Postfix) with ESMTP id 970E87CF3A for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 19:25:08 -0800 (PST)
Received: from xx1.develooper.com (xx1.develooper.com [127.0.0.1]) by localhost (Postfix) with SMTP id 3E9437C1C3 for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 19:25:06 -0800 (PST)
Received: from haven.eyrie.org (haven.eyrie.org [166.84.7.159]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by xx1.develooper.com (Postfix) with ESMTPS id D7A707CF3B for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 19:25:05 -0800 (PST)
Received: from lothlorien.eyrie.org (unknown [IPv6:2603:3024:160b:400:ae22:bff:fe50:db06]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by haven.eyrie.org (Postfix) with ESMTPS id B650711812E for <bug-podlators [...] rt.cpan.org>; Thu, 27 Feb 2020 19:19:05 -0800 (PST)
Received: by lothlorien.eyrie.org (Postfix, from userid 1000) id 37B8CB418CC; Thu, 27 Feb 2020 19:19:03 -0800 (PST)
Delivered-To: cpan-bug+podlators [...] hipster.bestpractical.com
Subject: Re: [rt.cpan.org #132007] pod2man produces bogus output
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)
Return-Path: <rra [...] cpan.org>
X-Original-To: cpan-bug+podlators [...] hipster.bestpractical.com
X-RT-Mail-Extension: podlators
Date: Thu, 27 Feb 2020 19:19:03 -0800
X-PMX-Perl: Suspicious Attachment
X-PMX-Spam: Gauge=IIIIIIII, Probability=8%, Report=' HTML_00_01 0.05, HTML_00_10 0.05, BODYTEXTP_SIZE_3000_LESS 0, BODY_SIZE_2000_2999 0, BODY_SIZE_5000_LESS 0, BODY_SIZE_7000_LESS 0, DATE_TZ_NA 0, IN_REP_TO 0, KNOWN_MTA_TFX 0, LEGITIMATE_SIGNS 0, MSG_THREAD 0, NO_URI_HTTPS 0, REFERENCES 0, SPF_NONE 0, SXL_IP_TFX_WM 0, __ANY_URI 0, __BODY_NO_MAILTO 0, __BOUNCE_CHALLENGE_SUBJ 0, __BOUNCE_NDR_SUBJ_EXEMPT 0, __CT 0, __CT_TEXT_PLAIN 0, __DQ_NEG_HEUR 0, __DQ_NEG_IP 0, __FRAUD_MONEY_CURRENCY 0, __FRAUD_MONEY_CURRENCY_DOLLAR 0, __HAS_FROM 0, __HAS_MSGID 0, __HAS_REFERENCES 0, __IN_REP_TO 0, __MIME_TEXT_ONLY 0, __MIME_TEXT_P 0, __MIME_TEXT_P1 0, __MIME_VERSION 0, __NO_HTML_TAG_RAW 0, __REFERENCES 0, __SANE_MSGID 0, __STOCK_PHRASE_7 0, __SUBJ_ALPHA_END 0, __SUBJ_ALPHA_NEGATE 0, __SUBJ_REPLY 0, __TO_MALFORMED_2 0, __TO_NAME 0, __TO_NAME_DIFF_FROM_ACC 0, __TO_REAL_NAMES 0, __URI_MAILTO 0, __URI_NO_WWW 0, __URI_NS , __USER_AGENT 0, __zen.spamhaus.org_ERROR '
X-Spam-Level:
X-Greylist: delayed 359 seconds by postgrey-1.34 at xx1.develooper.com; Thu, 27 Feb 2020 19:25:05 PST
X-PMX-Version: 5.6.1.2065439, Antispam-Engine: 2.7.2.376379, Antispam-Data: 2019.11.28.70017
To: "Dima Kogan via RT" <bug-podlators [...] rt.cpan.org>
From: Russ Allbery <rra [...] cpan.org>
RT-Message-ID: <rt-4.0.18-21094-1582860312-1455.132007-0-0 [...] rt.cpan.org>
Content-Length: 2459
Download (untitled) / with headers
text/plain 2.4k
"Dima Kogan via RT" <bug-podlators@rt.cpan.org> writes: Show quoted text
> Spaces added for clarity, and only the interesting things kept. Note > that sometimes pod2man like to bold things, even I never asked for it > (\\fB tags).
Show quoted text
> And note that sometimes pod2man likes to add "s0", which is some sort of > leftover code that is not interpreted by the "man" tool: "man" actually > displays "s0", which is nowhere in the original text.
This is a definite bug in the interaction between magic application of small caps markup and magic application of function bolding. Thanks. Now fixed in Git. Show quoted text
> My understanding is that POD markup is either
Show quoted text
> - lines starting with =something > - text such as B<something> or L<something> and such
Show quoted text
> Is there some other type of markup that pod2man is trying to interpret > that I'm accidentally including in tst.pod? I don't see anything clear > in the "perlpod" manpage.
Pod::Man hints at this, although the documentation is inadequate on the details. Besides the obvious pod conversions, Pod::Man also takes care of formatting func(), func(3), and simple variable references like $foo or @bar so you don't have to use code escapes for them; complex expressions like $fred{'stuff'} will still need to be escaped, though. It also translates dashes that aren't used as hyphens into en dashes, makes long dashes--like this--into proper em dashes, fixes "paired quotes," makes C++ look right, puts a little space between double underscores, makes ALLCAPS a teeny bit smaller in troff, and escapes stuff that *roff treats as special so that you don't have to. This is one of those things that was probably a bad decision but that was made so long ago (it was a feature of Tom Christiansen's original pod2man script when I took it over in 1999, and with which I was trying to remain backward-compatible) that changing it is a substantial break of backward compatibility, so I've been reluctant to do so. I have another long-awaited backward-compatibility break to turn on Unicode output by default. Maybe I should turn guesswork off by default as well and call that a 5.00 release and see what the fallout is. -- #!/usr/bin/perl -- Russ Allbery, Just Another Perl Hacker $^=q;@!>~|{>krw>yn{u<$$<[~||<Juukn{=,<S~|}<Jwx}qn{<Yn{u<Qjltn{ > 0gFzD gD, 00Fz, 0,,( 0hF 0g)F/=, 0> "L$/GEIFewe{,$/ 0C$~> "@=,m,|,(e 0.), 01,pnn,y{ rw} >;,$0=q,$,,($_=$^)=~y,$/ C-~><@=\n\r,-~$:-u/ #y,d,s,(\$.),$1,gee,print


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

Please report any issues with rt.cpan.org to rt-cpan-admin@bestpractical.com.