From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from www.andreasvoegele.com (_exim@www.andreasvoegele.com [88.198.39.7])
	by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id pA3JIfNf013386
	for <discuss@mdocml.bsd.lv>; Thu, 3 Nov 2011 15:18:42 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=andreasvoegele.com; s=december2010;
	h=Content-Type:In-Reply-To:References:Subject:To:MIME-Version:From:Date:Message-ID; bh=gKWG2Nk6Ert/NG69hclyC91HuXU/Q4l02C38xqeVLp8=;
	b=C9tseAZdxxBXK8dyFOLazgCtENOsdm1gelyedqYzL5/loreENkY9qunYsrQ5H5FETGUEVOKuLFavUzrAtgSyUmwN7kCvzoM6nH6+etuW5QYyM2VosuuclwX23wu4BK1vR+xJRg7U/W//6GWaUYlz55s7POXuFo1v4sGUyjP3ljE=;
Received: from hsi-kbw-109-192-051-187.hsi6.kabel-badenwuerttemberg.de ([109.192.51.187] helo=sophie-scholl.andreasvoegele.com)
	by www.andreasvoegele.com with esmtpsa (TLSv1:AES256-SHA:256)
	(Exim 4.77)
	(envelope-from <mail@andreasvoegele.com>)
	id 1RM2oA-0002Bk-Fp
	for discuss@mdocml.bsd.lv; Thu, 03 Nov 2011 20:18:38 +0100
Message-ID: <4EB2E8F3.9040504@andreasvoegele.com>
Date: Thu, 03 Nov 2011 20:18:11 +0100
From: =?ISO-8859-15?Q?Andreas_V=F6gele?= <mail@andreasvoegele.com>
User-Agent: Mozilla/5.0 (X11; OpenBSD amd64; rv:7.0.1) Gecko/20111028 Thunderbird/7.0.1
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv
MIME-Version: 1.0
To: discuss@mdocml.bsd.lv
Subject: Re: Render POD =head3 $c->uri
References: <4EB2A792.7080508@andreasvoegele.com> <4EB2ABF2.70805@bsd.lv>
In-Reply-To: <4EB2ABF2.70805@bsd.lv>
X-Enigmail-Version: 1.4a1pre
Content-Type: multipart/mixed;
 boundary="------------060900090001040904010007"

This is a multi-part message in MIME format.
--------------060900090001040904010007
Content-Type: text/plain; charset=ISO-8859-15
Content-Transfer-Encoding: 7bit

Hi Kristaps,

>> when I run the following commands, the text "$c->uri" is fully
>> underlined if the manual page is formatted with nroff. If the manual
>> page is formatted with mandoc, only the text "->uri" is underlined.
>>
>> echo '=head3 $c->uri' | pod2man | nroff -man | less -R
>> echo '=head3 $c->uri' | pod2man | mandoc | less -R
> 
> Hi Andreas,
> 
> The enclosed patch fixes this issue: since the 4.9 release, we've become
> more strict.  I've now added the correct magic for `\f(Cx' escapes as
> dictated by groff(7) and your example works fine.

This works very well. I've written a script that compares more than 350
manual pages and with this patch applied there are only few differences
left. Here's one difference. mandoc doesn't underline "isn't".

echo "=head3 What B<isn't> Catalyst?" | pod2man | nroff -man | less -R
echo "=head3 What B<isn't> Catalyst?" | pod2man | mandoc | less -R

And here's another difference. mandoc doesn't emphasise "STRING". Ignore
the error message, that is appended to the output, because of the
missing =over.

echo "=item B<Name: I<STRING>>" | pod2man | nroff -man | less -R
echo "=item B<Name: I<STRING>>" | pod2man | mandoc | less -R

BTW, there's seems to be a bug in groff. Look at the way "is_level()"
and "isLevelEnabled()" are underlined in the attached example. In
groff's output the line stops at the quotation mark and not at the end
of "level".

pod2man Log4perl.pod | mandoc | less -R
pod2man Log4perl.pod | nroff -man | less -R

In 09_FormFu.pod the indented " C<...>" is wrapped differently. I don't
know why that line is indented in the POD file. If the leading space is
removed, groff and mandoc format the output identically.

pod2man 09_FormFu.pod | nroff -man
pod2man 09_FormFu.pod | mandoc

sed 's/^ //' 09_FormFu.pod  | pod2man | nroff -man
sed 's/^ //' 09_FormFu.pod  | pod2man | mandoc

--------------060900090001040904010007
Content-Type: text/plain;
 name="Log4perl.pod"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="Log4perl.pod"

=head2 Log Levels

There are six predefined log levels: C<FATAL>, C<ERROR>, C<WARN>, C<INFO>,
C<DEBUG>, and C<TRACE> (in descending priority). Your configured logging level
has to at least match the priority of the logging message.

If you need to find out if the currently configured logging
level would allow a logger's logging statement to go through, use the
logger's C<is_I<level>()> methods:

    $logger->is_trace()    # True if trace messages would go through

Also available are a series of more Java-esque functions which return
the same values. These are of the format C<isI<Level>Enabled()>,
so C<$logger-E<gt>isDebugEnabled()> is synonymous to 
C<$logger-E<gt>is_debug()>.

=cut

--------------060900090001040904010007
Content-Type: text/plain;
 name="09_FormFu.pod"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="09_FormFu.pod"

=over 4

=item *

If the form is being displayed for the first time (or has failed 
validation and it being redisplayed), we use
 C<$form-E<gt>model-E<gt>default_values> to populate the form with data from the
database.

=back

--------------060900090001040904010007--
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv