Hello Juan Francisco,
Juan Francisco Cantero Hurtado wrote on Thu, Jun 20, 2013 at 03:19:11AM +0200:
> On Wed, Jun 19, 2013 at 08:06:52PM -0400, James Turner wrote:
>> I don't think USE_GROFF is needed, included manpages looked fine
>> without it.
You are right, James.
USE_GROFF isn't needed isn't needed in this case.
> mandoc doesn't support ".ce 1".
That is correct, too.
However, the whole effect in this particular case is that
one URL per manual page appears flush-left instead of centered,
which odesn't make the manual neither less useful nor ugly.
This report triggered me to
1) publish the script i'm using to do groff-mandoc comparisons:
http://mdocml.bsd.lv/cgi-bin/cvsweb/gmdiff?cvsroot=mdocml
See below for example output.
2) Update the "mandoc" special topic in the OpenBSD ports FAQ:
http://www.openbsd.org/faq/ports/specialtopics.html#Mandoc
Thanks for working on OpenBSD ports,
Ingo
ischwarze@isnote $ pwd
/usr/ports/pobj/racket-5.3.5/racket-5.3.5/man/man1
ischwarze@isnote $ gmdiff *.1
========== drracket.1 ==========
drracket.1:80:2: ERROR: skipping unknown macro: .ce 1
--- /tmp/groff.out Sat Jun 22 10:29:45 2013
+++ /tmp/mandoc.out Sat Jun 22 10:29:45 2013
@@ -2,11 +2,12 @@
+
NNAAMMEE
drracket - the Racket programming environment
SSYYNNOOPPSSIISS
- ddrrrraacckkeett [ _X_o_p_t_i_o_n _._._. ] [
_f_i_l_e _._._. ]
+ ddrrrraacckkeett [ _X_o_p_t_i_o_n _._._. ] [
_f_i_l_e _._._. ]
DDEESSCCRRIIPPTTIIOONN
DrRacket is the Racket programming environment.
@@ -40,7 +41,7 @@
Alternately, consult the on-line documentation and other information
available at
- http://racket-lang.org/
+ http://racket-lang.org/
AAUUTTHHOORR
========== gracket.1 ==========
gracket.1:50:2: ERROR: skipping unknown macro: .ce 1
--- /tmp/groff.out Sat Jun 22 10:29:45 2013
+++ /tmp/mandoc.out Sat Jun 22 10:29:45 2013
@@ -1,13 +1,14 @@
-
GRACKET(1) OpenBSD Reference Manual GRACKET(1)
+
+
NNAAMMEE
gracket - the GUI Racket implementation
SSYYNNOOPPSSIISS
- ggrraacckkeett [ _o_p_t_i_o_n _._._. ] [
_a_r_g_u_m_e_n_t _._._. ]
+ ggrraacckkeett [ _o_p_t_i_o_n _._._. ] [
_a_r_g_u_m_e_n_t _._._. ]
DDEESSCCRRIIPPTTIIOONN
@@ -41,7 +42,7 @@
Alternately, consult the on-line documentation and other information
available at
- http://racket-lang.org/
+ http://racket-lang.org/
AAUUTTHHOORR
========== mred.1 ==========
mred.1:35:2: ERROR: skipping unknown macro: .ce 1
--- /tmp/groff.out Sat Jun 22 10:29:45 2013
+++ /tmp/mandoc.out Sat Jun 22 10:29:45 2013
[... snip ...]