Hi Stuart,

maybe i was too quick with my commit, but seing a typical case of
mandoc(1) handling broken input more gracefully, i simply deleted
the USE_GROFF.

Stuart Henderson wrote on Fri, Jan 09, 2015 at 01:18:16PM +0000:
> On 2015/01/09 13:44, Jan Stary wrote:

>> The man(7) page of urlview looks OK to me with mandoc.
>> The diff below removes the GROFF dependence.

> They're all wrong :-)
> 
> There is actually a difference in the regular expression displayed
> 
> -       (((https?|ftp|gopher)://|(mailto|file|news):)[^' 
> <>"]+|(www|web|w3).[-a-z0-9.]+)[^' .,;<>":]
> +       (((https?|ftp|gopher)://|(mailto|file|news):)[^' 
> <>"]+|(www|web|w3).[-a-z0-9.]+)[^' .,;<>"):]
> [snip]
> 
> so mandoc is slightly better, but it seems that the manpage source is
> wrong because there should be a couple of backslashes.

Yes.  The source code if of inferior quality in multiple respects.

> The actual DEFAULT_REGEXP is defined here (obviously with C quoting):
> 
> #define DEFAULT_REGEXP "(((https?|ftp|gopher)://|(mailto|file|news):)[^' 
> \t<>\"]+|(www|web|w3)\\.[-a-z0-9.]+)[^' \t.,;<>\"\\):]"
> 
> So I think the diff should be something like this ..

No.  You almost never want \\ in roff(7) source code, unless
you are defining macros.  You certainly don't want \\ in manual
pages.

Seing that you consider this documentation bug bad enough that
it warrants patching, we can as well fix all the bugs instead of
just one of them and provide a patch suitable for upstreaming.

 * properly escape backslashes
 * .ec is not used properly and doesn't belong in a manual anyway
 * an "RR" font exists neither in groff -Tascii nor in groff -Tps,
   no idea what it is supposed to be
 * .TH all caps convention
 * drop a redundant .PP
 * new sentence, new line
 * trailing whitespace

OK?
  Ingo


Index: Makefile
===================================================================
RCS file: /cvs/ports/textproc/urlview/Makefile,v
retrieving revision 1.23
diff -u -p -r1.23 Makefile
--- Makefile    9 Jan 2015 13:21:03 -0000       1.23
+++ Makefile    9 Jan 2015 13:48:44 -0000
@@ -3,7 +3,7 @@
 COMMENT=       curses-based URL ripper
 
 DISTNAME=      urlview-0.9
-REVISION=      5
+REVISION=      6
 CATEGORIES=    textproc
 MASTER_SITES=  ftp://ftp.fu-berlin.de/pub/unix/mail/mutt/contrib/ \
                ftp://ftp.mutt.org/mutt/contrib/ \
@@ -12,7 +12,8 @@ MASTER_SITES= ftp://ftp.fu-berlin.de/pub
 
 # GPLv2
 PERMIT_PACKAGE_CDROM=  Yes
-WANTLIB=               c
+
+WANTLIB += c
 
 CONFIGURE_STYLE= gnu
 
Index: patches/patch-urlview_man
===================================================================
RCS file: patches/patch-urlview_man
diff -N patches/patch-urlview_man
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ patches/patch-urlview_man   9 Jan 2015 13:48:44 -0000
@@ -0,0 +1,111 @@
+$OpenBSD$
+Fix incorrect escaping resulting in incorrectly shown regexp.
+While here, fix various other nits.
+--- urlview.man.orig   Tue Jul  4 12:14:30 2000
++++ urlview.man        Fri Jan  9 14:41:54 2015
+@@ -7,18 +7,18 @@
+ .\" Copyright (c) 1997 Michael Elkins <m...@cs.hmc.edu>
+ .\" Copyright (c) 2000 Thomas Roessler <roess...@does-not-exist.org>
+ .\"
+-.\" This document is free software; you can redistribute it and/or 
++.\" This document is free software; you can redistribute it and/or
+ .\" modify it under the terms of the GNU General Public License as
+ .\" published by the Free Software Foundation; either version 2 of the
+ .\" License, or (at your option) any later version.
+ .\"
+-.TH "urlview" 1 
++.TH URLVIEW 1
+ .SH NAME
+ .PP
+ urlview \- URL extractor/launcher
+ .SH SYNOPSIS
+ .PP
+-.B urlview 
++.B urlview
+ \fIfilename\fP [ \fIfilename\fP ... ]
+ .SH DESCRIPTION
+ .PP
+@@ -29,53 +29,50 @@ specific item.
+ .SH CONFIGURATION
+ .PP
+ .B urlview
+-attempts to read 
++attempts to read
+ .I ~/.urlview
+-upon startup.  If this file
+-doesn't exist, it will try to read a system wide file 
+-in 
++upon startup.
++If this file doesn't exist, it will try to read a system wide file in
+ .IR /etc/urlview.conf .
+ There are two configuration commands (order does not matter):
+ .TP
+ REGEXP \fIregexp\fP
+ .B urlview
+-uses a regular expression to extract URLs from the specified
+-text files.  \\r, \\t, \\n and \\f are all converted to
+-their normal 
++uses a regular expression to extract URLs from the specified text files.
++\er, \et, \en and \ef are all converted to their normal
+ .BR printf (3)
+-meanings.  The default REGEXP is:
++meanings.
++The default REGEXP is:
+ .PP
+-.sp 
+-.ft RR
++.sp
+ .nf
+-(((https?|ftp|gopher)://|(mailto|file|news):)[^' 
\t<>"]+|(www|web|w3)\.[-a-z0-9.]+)[^' \t.,;<>"\):]
++(((https?|ftp|gopher)://|(mailto|file|news):)[^' 
\et<>"]+|(www|web|w3)\e.[-a-z0-9.]+)[^' \et.,;<>"\e):]
+ .fi
+-.ec
+-.ft P
+ .sp
+ .TP
+ COMMAND \fIcommand\fP
+-If the specified command contains a 
++If the specified command contains a
+ .BR %s ,
+ it will be subsituted
+ with the URL that was requested, otherwise the URL is appended to
+-the COMMAND string.  The default COMMAND is:
++the COMMAND string.
++The default COMMAND is:
+ .br
+ .sp
+ url_handler.sh %s
+ .PP
+ .B Note:
+-You should 
++You should
+ .I never
+-put single quotes around the 
++put single quotes around the
+ .BR %s .
+ .B urlview
+ does this for you, and also makes sure that single quotes eventually
+-showing up inside the URL are handled properly.  (Note that this
++showing up inside the URL are handled properly.
++(Note that this
+ shouldn't happen with the default regular expression, which
+ explicitly excludes single quotes.)
+ .SH FILES
+-.PP
+ .IP "/etc/urlview.conf"
+ system-wide urlview configuration file
+ .IP "~/.urlview"
+@@ -83,7 +80,7 @@ urlview configuration file
+ .SH SEE ALSO
+ .PP
+ .BR printf (3),
+-.BR regcomp (3), 
++.BR regcomp (3),
+ .BR regex (7)
+ .SH AUTHOR
+ .PP
+@@ -94,4 +91,3 @@ Modified for Debian by Luis Francisco Gonzalez <luisgh
+ Modified for SuSE by Dr. Werner Fink <wer...@suse.de> and Stepan Kasal 
<ka...@suse.cz>.
+ .PP
+ Changes put together by Thomas Roessler <roess...@does-not-exist.org>.
+-

Reply via email to