[syslinux] [PATCH] Correct outdated and incomplete mailing list info

[Paul Bolle]

On Mon, 2011-01-17 at 14:48 -0800, H. Peter Anvin wrote:
> These days it's probably better to point people to
> the website/wiki and have them get the subscription information from there.

If you prefer to do that, it might make sense to also clean up the
surrounding parts of the manual, ie:
- make the BUGS section much shorter;
- add a COLOPHON section, and mention the site there;
- transform the AUTHOR section into a source code only comment.

Eg, something like this draft (that touches man/syslinux.1 only)

diff --git a/man/syslinux.1 b/man/syslinux.1
index af44979..99136ff 100644
--- a/man/syslinux.1
+++ b/man/syslinux.1
@@ -1,3 +1,7 @@
+.\" This manual page is a modified version of the original syslinux
+.\" documentation by H. Peter Anvin <hpa at zytor.com>. The conversion to a manpage
+.\" was made by Arthur Korn <arthur at korn.ch>.
+.\"
 .TH SYSLINUX 1 "19 July 2010" "SYSLINUX"
 .SH NAME
 syslinux \- install the \s-1SYSLINUX\s+1 bootloader on a FAT filesystem
@@ -387,29 +391,18 @@ launched from a Master Boot Record or another boot loader, just like
 DOS itself would. A sample master boot sector (\fBmbr.bin\fP) is
 included with \s-1SYSLINUX\s+1.
 .SH BUGS
-I would appreciate hearing of any problems you have with \s-1SYSLINUX\s+1.  I
-would also like to hear from you if you have successfully used \s-1SYSLINUX\s+1,
-especially if you are using it for a distribution.
-.PP
-If you are reporting problems, please include all possible information
-about your system and your BIOS; the vast majority of all problems
-reported turn out to be BIOS or hardware bugs, and I need as much
-information as possible in order to diagnose the problems.
-.PP
-There is a mailing list for discussion among \s-1SYSLINUX\s+1 users and for
-announcements of new and test versions. To join, send a message to
-majordomo at linux.kernel.org with the line:
-.P
-.B subscribe syslinux
-.PP
-in the body of the message. The submission address is syslinux at linux.kernel.org.
+The vast majority of all problems reported turn out to be BIOS or
+hardware bugs and the \fBSyslinux\fP Project needs as much information
+as possible in order to diagnose these problems. If you are reporting
+problems, please include all possible information about your hardware
+and your BIOS.
 .SH SEE ALSO
 .BR lilo (8),
 .BR keytab-lilo.pl (8),
 .BR fdisk (8),
 .BR mkfs (8),
 .BR superformat (1).
-.SH AUTHOR
-This manual page is a modified version of the original \fBsyslinux\fP
-documentation by H. Peter Anvin <hpa at zytor.com>. The conversion to a manpage
-was made by Arthur Korn <arthur at korn.ch>.
+.SH COLOPHON
+This manual page is part of the \fBSyslinux\fP Project. A description of
+\fBSyslinux\fP, further documentation, and information about reporting
+bugs, can be found at http://syslinux.zytor.com.