Hi,

the file /usr/share/misc/man.template is horribly outdated and
incomplete, compare it to mdoc.template in the same directory.

I think deleting it completely is better than updating it, because
nobody is supposed to manually write new man(7) manuals, certainly
not in OpenBSD, but nowehere else, either, really.  If you do need
man(7) code, you can generate it with mandoc -Tman from mdoc(7)
input, like it is done in the portable sudo(8) build system.

People do continue to write and maintain tools to generate man(7)
code, think of pod2man(1) or mandoc -Tman.  But man.template
is not helping with such tasks at all.

I got an OK from jmc@ for zapping it, but want to make sure
people don't regard it as still useful for reasons we missed.

Objections, OKs?
  Ingo


Index: Makefile
===================================================================
RCS file: /cvs/src/share/misc/Makefile,v
retrieving revision 1.11
diff -u -p -r1.11 Makefile
--- Makefile    1 Aug 2007 21:31:45 -0000       1.11
+++ Makefile    16 Feb 2014 14:27:23 -0000
@@ -2,7 +2,7 @@
 #      from: @(#)Makefile      5.13 (Berkeley) 5/7/91
 
 FILES= airport ascii birthtoken countrycodes eqnchar getopt \
-       inter.phone license.template man.template mdoc.template \
+       inter.phone license.template mdoc.template \
        na.phone operator scsi_modes usb_hid_usages usb_hid_usages \
        zipcodes 
 
Index: man.template
===================================================================
RCS file: man.template
diff -N man.template
--- man.template        18 Oct 1995 08:44:44 -0000      1.1.1.1
+++ /dev/null   1 Jan 1970 00:00:00 -0000
@@ -1,8 +0,0 @@
-.TH NAME SECTION local
-.SH NAME
-.SH SYNOPSIS
-.SH DESCRIPTION
-.SH FILES
-.SH SEE ALSO
-.SH DIAGNOSTICS
-.SH BUGS

Reply via email to