Re: author emails in manpages
On Jul 16 10:26:52, h...@stare.cz wrote: > usr/games > > Index: bs.6 > === > RCS file: /cvs/src/games/bs/bs.6,v > retrieving revision 1.13 > diff -u -p -r1.13 bs.6 > --- bs.6 20 May 2008 14:42:09 - 1.13 > +++ bs.6 16 Jul 2013 07:09:19 - > @@ -85,7 +85,7 @@ Visual user interface, > .Sq closepack > option, code rewrite > and manual page by > -.An Eric S. Raymond Aq e...@snark.thyrsus.com , > +.An Eric S. Raymond Aq Mt e...@snark.thyrsus.com , > August 1989. > .Sh NOTES > The algorithm the computer uses once it has found a ship to sink is provably Come to think of it, there is also Salvo mode added by Chuck A. DeGaul (cbosgd!cad). Do we have a markup for that, or should it just stay like this, or should it just be removed?
Re: author emails in manpages
usr/games Index: bs.6 === RCS file: /cvs/src/games/bs/bs.6,v retrieving revision 1.13 diff -u -p -r1.13 bs.6 --- bs.620 May 2008 14:42:09 - 1.13 +++ bs.616 Jul 2013 07:09:19 - @@ -85,7 +85,7 @@ Visual user interface, .Sq closepack option, code rewrite and manual page by -.An Eric S. Raymond Aq e...@snark.thyrsus.com , +.An Eric S. Raymond Aq Mt e...@snark.thyrsus.com , August 1989. .Sh NOTES The algorithm the computer uses once it has found a ship to sink is provably
Re: author emails in manpages
On Jul 16 00:15:49, h...@stare.cz wrote: > On Jul 15 23:23:57, h...@stare.cz wrote: > > Here is a diff for /usr/src/usr.bin: > > Here is another for usr/src/sbin; And here is another for usr/src/usr.sbin Index: amd/amd/amd.8 === RCS file: /cvs/src/usr.sbin/amd/amd/amd.8,v retrieving revision 1.21 diff -u -p -u -p -r1.21 amd.8 --- amd/amd/amd.8 12 Aug 2009 13:21:17 - 1.21 +++ amd/amd/amd.8 16 Jul 2013 07:56:34 - @@ -209,7 +209,7 @@ The utility first appeared in .Bx 4.4 . .Sh AUTHORS -.An Jan-Simon Pendry Aq j...@doc.ic.ac.uk , +.An Jan-Simon Pendry Aq Mt j...@doc.ic.ac.uk , Department of Computing, Imperial College, London, UK. .Sh CAVEATS Some care may be required when creating a mount map. Index: amd/amq/amq.8 === RCS file: /cvs/src/usr.sbin/amd/amq/amq.8,v retrieving revision 1.12 diff -u -p -u -p -r1.12 amq.8 --- amd/amq/amq.8 31 May 2007 19:20:21 - 1.12 +++ amd/amq/amq.8 16 Jul 2013 07:56:34 - @@ -107,7 +107,7 @@ protocol description .Sh SEE ALSO .Xr amd 8 .Sh AUTHORS -.An Jan-Simon Pendry Aq j...@doc.ic.ac.uk , +.An Jan-Simon Pendry Aq Mt j...@doc.ic.ac.uk , Department of Computing, Imperial College, London, UK. .\" .Sh HISTORY .\" .Nm amq Index: cron/cron.8 === RCS file: /cvs/src/usr.sbin/cron/cron.8,v retrieving revision 1.30 diff -u -p -u -p -r1.30 cron.8 --- cron/cron.8 31 May 2007 19:20:23 - 1.30 +++ cron/cron.8 16 Jul 2013 07:56:48 - @@ -210,7 +210,7 @@ to check for crontab changes immediately .Xr syslog 3 , .Xr crontab 5 .Sh AUTHORS -.An Paul Vixie Aq vi...@isc.org +.An Paul Vixie Aq Mt vi...@isc.org .Sh CAVEATS .Xr crontab 5 files will be ignored if they do not have the proper file mode. Index: cron/crontab.1 === RCS file: /cvs/src/usr.sbin/cron/crontab.1,v retrieving revision 1.28 diff -u -p -u -p -r1.28 crontab.1 --- cron/crontab.1 31 Jan 2011 19:13:31 - 1.28 +++ cron/crontab.1 16 Jul 2013 07:56:48 - @@ -48,7 +48,7 @@ they are not intended to be edited direc .Pp The first form of this command is used to install a new crontab from some named file, or standard input if the pseudo-filename -.Sq Fl +.Sq - is given. .Pp If the @@ -167,4 +167,4 @@ The flag .Op Fl u is an extension to that specification. .Sh AUTHORS -.An Paul Vixie Aq vi...@isc.org +.An Paul Vixie Aq Mt vi...@isc.org Index: cron/crontab.5 === RCS file: /cvs/src/usr.sbin/cron/crontab.5,v retrieving revision 1.24 diff -u -p -u -p -r1.24 crontab.5 --- cron/crontab.5 19 Nov 2010 17:16:48 - 1.24 +++ cron/crontab.5 16 Jul 2013 07:56:48 - @@ -411,4 +411,4 @@ All of the commands that can appear in place of the first five fields are extensions. .Sh AUTHORS -.An Paul Vixie Aq vi...@isc.org +.An Paul Vixie Aq Mt vi...@isc.org Index: crunchgen/crunchgen.8 === RCS file: /cvs/src/usr.sbin/crunchgen/crunchgen.8,v retrieving revision 1.5 diff -u -p -u -p -r1.5 crunchgen.8 --- crunchgen/crunchgen.8 8 Aug 2010 20:22:31 - 1.5 +++ crunchgen/crunchgen.8 16 Jul 2013 07:56:49 - @@ -299,8 +299,8 @@ can be copied onto an install floppy and hard-linked to the names of the component programs. .Sh AUTHORS .Nm -was written by James da Silva -.Aq j...@cs.umd.edu . +was written by +.An James da Silva Aq Mt j...@cs.umd.edu . .Pp Copyright (c) 1994 University of Maryland. All Rights Reserved. .Sh CAVEATS Index: dhcpd/dhcp-options.5 === RCS file: /cvs/src/usr.sbin/dhcpd/dhcp-options.5,v retrieving revision 1.16 diff -u -p -u -p -r1.16 dhcp-options.5 --- dhcpd/dhcp-options.515 Jul 2013 07:56:43 - 1.16 +++ dhcpd/dhcp-options.516 Jul 2013 07:56:53 - @@ -656,8 +656,8 @@ Addresses should be listed in order of p .An -nosplit .Xr dhcpd 8 was written by -.An Ted Lemon Aq mel...@vix.com +.An Ted Lemon Aq Mt mel...@vix.com under a contract with Vixie Labs. .Pp The current implementation was reworked by -.An Henning Brauer Aq henn...@openbsd.org . +.An Henning Brauer Aq Mt henn...@openbsd.org . Index: dhcpd/dhcpd.8 === RCS file: /cvs/src/usr.sbin/dhcpd/dhcpd.8,v retrieving revision 1.20 diff -u -p -u -p -r1.20 dhcpd.8 --- dhcpd/dhcpd.8 14 Jul 2013 19:44:38 - 1.20 +++ dhcpd/dhcpd.8 16 Jul 2013 07:56:56 - @@ -502,11 +502,11 @@ DHCPD lease file. .An -nosplit .Nm was written by -.An Ted Lemon Aq mel...@vix.com +.An Ted Lemon Aq Mt mel...@vix.com under a contract with Vixie Labs. .Pp The current implementation was reworked by -.An Henning Br
Re: author emails in manpages
ok, but watch out for the spurious scan_ffs change. jmc On Tue, Jul 16, 2013 at 12:15:50AM +0200, Jan Stary wrote: > On Jul 15 23:23:57, h...@stare.cz wrote: > > Here is a diff for /usr/src/usr.bin: > > Here is another for usr/src/sbin; > while in there, remove a forgotten > man(7) line from scan_ffs(8) > > > Index: bioctl/bioctl.8 > === > RCS file: /cvs/src/sbin/bioctl/bioctl.8,v > retrieving revision 1.90 > diff -u -p -u -p -r1.90 bioctl.8 > --- bioctl/bioctl.8 22 Sep 2012 20:09:43 - 1.90 > +++ bioctl/bioctl.8 15 Jul 2013 22:11:24 - > @@ -318,7 +318,7 @@ command first appeared in > The > .Nm > interface was written by > -.An Marco Peereboom Aq ma...@openbsd.org . > +.An Marco Peereboom Aq Mt ma...@openbsd.org . > .Sh CAVEATS > Only devices with 512-byte sectors are supported. > .Pp > Index: dhclient/dhclient.8 > === > RCS file: /cvs/src/sbin/dhclient/dhclient.8,v > retrieving revision 1.22 > diff -u -p -u -p -r1.22 dhclient.8 > --- dhclient/dhclient.8 14 Jul 2013 19:44:38 - 1.22 > +++ dhclient/dhclient.8 15 Jul 2013 22:11:26 - > @@ -350,9 +350,9 @@ database of acquired leases > .An -nosplit > .Nm > was written by > -.An Ted Lemon Aq mel...@fugue.com > +.An Ted Lemon Aq Mt mel...@fugue.com > and > -.An Elliot Poger Aq ell...@poger.com . > +.An Elliot Poger Aq Mt ell...@poger.com . > .Pp > The current implementation was reworked by > -.An Henning Brauer Aq henn...@openbsd.org . > +.An Henning Brauer Aq Mt henn...@openbsd.org . > Index: dhclient/dhclient.conf.5 > === > RCS file: /cvs/src/sbin/dhclient/dhclient.conf.5,v > retrieving revision 1.29 > diff -u -p -u -p -r1.29 dhclient.conf.5 > --- dhclient/dhclient.conf.5 2 Mar 2013 07:11:19 - 1.29 > +++ dhclient/dhclient.conf.5 15 Jul 2013 22:11:27 - > @@ -459,8 +459,8 @@ file \- the defaults are usually fine. > .An -nosplit > .Xr dhclient 8 > was written by > -.An Ted Lemon Aq mel...@vix.com > +.An Ted Lemon Aq Mt mel...@vix.com > under a contract with Vixie Labs. > .Pp > The current implementation was reworked by > -.An Henning Brauer Aq henn...@openbsd.org . > +.An Henning Brauer Aq Mt henn...@openbsd.org . > Index: dhclient/dhclient.leases.5 > === > RCS file: /cvs/src/sbin/dhclient/dhclient.leases.5,v > retrieving revision 1.8 > diff -u -p -u -p -r1.8 dhclient.leases.5 > --- dhclient/dhclient.leases.524 Feb 2013 12:18:43 - 1.8 > +++ dhclient/dhclient.leases.515 Jul 2013 22:11:27 - > @@ -96,8 +96,8 @@ Current lease file. > .An -nosplit > .Xr dhclient 8 > was written by > -.An Ted Lemon Aq mel...@vix.com > +.An Ted Lemon Aq Mt mel...@vix.com > under a contract with Vixie Labs. > .Pp > The current implementation was reworked by > -.An Henning Brauer Aq henn...@openbsd.org . > +.An Henning Brauer Aq Mt henn...@openbsd.org . > Index: growfs/growfs.8 > === > RCS file: /cvs/src/sbin/growfs/growfs.8,v > retrieving revision 1.10 > diff -u -p -u -p -r1.10 growfs.8 > --- growfs/growfs.8 28 Nov 2008 00:15:54 - 1.10 > +++ growfs/growfs.8 15 Jul 2013 22:11:29 - > @@ -123,9 +123,9 @@ The > utility first appeared in > .Fx 4.4 . > .Sh AUTHORS > -.An Christoph Herrmann Aq c...@freebsd.org > -.An Thomas-Henning von Kamptz Aq toms...@freebsd.org > -.An The GROWFS team Aq gro...@tomsoft.com > +.An Christoph Herrmann Aq Mt c...@freebsd.org > +.An Thomas-Henning von Kamptz Aq Mt toms...@freebsd.org > +.An The GROWFS team Aq Mt gro...@tomsoft.com > .Sh BUGS > Filesystems must be checked with > .Xr fsck 8 > Index: iked/iked.8 > === > RCS file: /cvs/src/sbin/iked/iked.8,v > retrieving revision 1.14 > diff -u -p -u -p -r1.14 iked.8 > --- iked/iked.8 29 Jun 2013 09:08:41 - 1.14 > +++ iked/iked.8 15 Jul 2013 22:11:29 - > @@ -152,7 +152,7 @@ program first appeared in > The > .Nm > program was written by > -.An Reyk Floeter Aq r...@openbsd.org . > +.An Reyk Floeter Aq Mt r...@openbsd.org . > .Sh CAVEATS > .Nm > is not yet finished and is missing some important security features. > Index: iked/iked.conf.5 > === > RCS file: /cvs/src/sbin/iked/iked.conf.5,v > retrieving revision 1.24 > diff -u -p -u -p -r1.24 iked.conf.5 > --- iked/iked.conf.5 22 May 2013 10:32:09 - 1.24 > +++ iked/iked.conf.5 15 Jul 2013 22:11:30 - > @@ -851,4 +851,4 @@ file format first appeared in > The > .Xr iked 8 > program was written by > -.An Reyk Floeter Aq r...@openbsd.org . > +.An Reyk Floeter Aq Mt r...@openbsd.org . > Index: iopctl/iopctl.8 > ==
Re: author emails in manpages
On Jul 15 23:23:57, h...@stare.cz wrote: > Here is a diff for /usr/src/usr.bin: Here is another for usr/src/sbin; while in there, remove a forgotten man(7) line from scan_ffs(8) Index: bioctl/bioctl.8 === RCS file: /cvs/src/sbin/bioctl/bioctl.8,v retrieving revision 1.90 diff -u -p -u -p -r1.90 bioctl.8 --- bioctl/bioctl.8 22 Sep 2012 20:09:43 - 1.90 +++ bioctl/bioctl.8 15 Jul 2013 22:11:24 - @@ -318,7 +318,7 @@ command first appeared in The .Nm interface was written by -.An Marco Peereboom Aq ma...@openbsd.org . +.An Marco Peereboom Aq Mt ma...@openbsd.org . .Sh CAVEATS Only devices with 512-byte sectors are supported. .Pp Index: dhclient/dhclient.8 === RCS file: /cvs/src/sbin/dhclient/dhclient.8,v retrieving revision 1.22 diff -u -p -u -p -r1.22 dhclient.8 --- dhclient/dhclient.8 14 Jul 2013 19:44:38 - 1.22 +++ dhclient/dhclient.8 15 Jul 2013 22:11:26 - @@ -350,9 +350,9 @@ database of acquired leases .An -nosplit .Nm was written by -.An Ted Lemon Aq mel...@fugue.com +.An Ted Lemon Aq Mt mel...@fugue.com and -.An Elliot Poger Aq ell...@poger.com . +.An Elliot Poger Aq Mt ell...@poger.com . .Pp The current implementation was reworked by -.An Henning Brauer Aq henn...@openbsd.org . +.An Henning Brauer Aq Mt henn...@openbsd.org . Index: dhclient/dhclient.conf.5 === RCS file: /cvs/src/sbin/dhclient/dhclient.conf.5,v retrieving revision 1.29 diff -u -p -u -p -r1.29 dhclient.conf.5 --- dhclient/dhclient.conf.52 Mar 2013 07:11:19 - 1.29 +++ dhclient/dhclient.conf.515 Jul 2013 22:11:27 - @@ -459,8 +459,8 @@ file \- the defaults are usually fine. .An -nosplit .Xr dhclient 8 was written by -.An Ted Lemon Aq mel...@vix.com +.An Ted Lemon Aq Mt mel...@vix.com under a contract with Vixie Labs. .Pp The current implementation was reworked by -.An Henning Brauer Aq henn...@openbsd.org . +.An Henning Brauer Aq Mt henn...@openbsd.org . Index: dhclient/dhclient.leases.5 === RCS file: /cvs/src/sbin/dhclient/dhclient.leases.5,v retrieving revision 1.8 diff -u -p -u -p -r1.8 dhclient.leases.5 --- dhclient/dhclient.leases.5 24 Feb 2013 12:18:43 - 1.8 +++ dhclient/dhclient.leases.5 15 Jul 2013 22:11:27 - @@ -96,8 +96,8 @@ Current lease file. .An -nosplit .Xr dhclient 8 was written by -.An Ted Lemon Aq mel...@vix.com +.An Ted Lemon Aq Mt mel...@vix.com under a contract with Vixie Labs. .Pp The current implementation was reworked by -.An Henning Brauer Aq henn...@openbsd.org . +.An Henning Brauer Aq Mt henn...@openbsd.org . Index: growfs/growfs.8 === RCS file: /cvs/src/sbin/growfs/growfs.8,v retrieving revision 1.10 diff -u -p -u -p -r1.10 growfs.8 --- growfs/growfs.8 28 Nov 2008 00:15:54 - 1.10 +++ growfs/growfs.8 15 Jul 2013 22:11:29 - @@ -123,9 +123,9 @@ The utility first appeared in .Fx 4.4 . .Sh AUTHORS -.An Christoph Herrmann Aq c...@freebsd.org -.An Thomas-Henning von Kamptz Aq toms...@freebsd.org -.An The GROWFS team Aq gro...@tomsoft.com +.An Christoph Herrmann Aq Mt c...@freebsd.org +.An Thomas-Henning von Kamptz Aq Mt toms...@freebsd.org +.An The GROWFS team Aq Mt gro...@tomsoft.com .Sh BUGS Filesystems must be checked with .Xr fsck 8 Index: iked/iked.8 === RCS file: /cvs/src/sbin/iked/iked.8,v retrieving revision 1.14 diff -u -p -u -p -r1.14 iked.8 --- iked/iked.8 29 Jun 2013 09:08:41 - 1.14 +++ iked/iked.8 15 Jul 2013 22:11:29 - @@ -152,7 +152,7 @@ program first appeared in The .Nm program was written by -.An Reyk Floeter Aq r...@openbsd.org . +.An Reyk Floeter Aq Mt r...@openbsd.org . .Sh CAVEATS .Nm is not yet finished and is missing some important security features. Index: iked/iked.conf.5 === RCS file: /cvs/src/sbin/iked/iked.conf.5,v retrieving revision 1.24 diff -u -p -u -p -r1.24 iked.conf.5 --- iked/iked.conf.522 May 2013 10:32:09 - 1.24 +++ iked/iked.conf.515 Jul 2013 22:11:30 - @@ -851,4 +851,4 @@ file format first appeared in The .Xr iked 8 program was written by -.An Reyk Floeter Aq r...@openbsd.org . +.An Reyk Floeter Aq Mt r...@openbsd.org . Index: iopctl/iopctl.8 === RCS file: /cvs/src/sbin/iopctl/iopctl.8,v retrieving revision 1.11 diff -u -p -u -p -r1.11 iopctl.8 --- iopctl/iopctl.8 26 Jun 2008 05:42:06 - 1.11 +++ iopctl/iopctl.8 15 Jul 2013 22:11:31 - @@ -97,8 +97,8 @@ support was added in The .Nm command was written by -.An Andrew Doran Aq a...@netbsd.org , +.An Andrew Doran Aq Mt a...@netbsd.org , and porte
Re: author emails in manpages
On Jul 12 14:04:03, h...@stare.cz wrote: > Authors' emails in manpages are generally written as .e.g. > > .An Damien Miller Aq d...@openbsd.org > > Should these be like > > .An Damien Miller Aq Mt d...@openbsd.org > On Jul 12 15:42:58, slash...@gmail.com wrote: > Looks like this is almost exclusively used in mandoc/mdocml for most > BSDs. Apparently nobody got the memo. ;) I should have been more specific: I mean our tree, which uses mdocml (as do some other BSDs), which introduces .Mt - why don't we use it for authors' emails?
Re: author emails in manpages
Hi, Franco Fichtner wrote on Fri, Jul 12, 2013 at 03:42:58PM +0200: > On Jul 12, 2013, at 3:16 PM, Jason McIntyre wrote: >> On Fri, Jul 12, 2013 at 02:04:03PM +0200, Jan Stary wrote: >>> Authors' emails in manpages are generally written as .e.g. >>> >>> .An Damien Miller Aq d...@openbsd.org >>> >>> Should these be like >>> >>> .An Damien Miller Aq Mt d...@openbsd.org >> perhaps. either Mt is fairly new, The first implementation i could find so far was committed to the groff CVS on March 23, 2001, and it was released with groff 1.17 on May 2, 2001. I can't exclude it appeared earlier elsewehere. Neither the final CSRG code nor Heirloom troff appear to support .Mt, though. >> or i never noticed it before. we could >> wholesale change stuff, but haven;t yet. I think i'd like that, even though we would have to touch large numbers of pages. I'd indeed prefer the following style, using pkg-config(1) as an example: .Sh AUTHORS .Nm was written by .An Chris Kuethe Aq Mt ckue...@openbsd.org as a replacement for the original freedesktop.org .Nm implementation. It was later extended and kept in sync (where relevant) with the original version by .An Marc Espie Aq Mt es...@openbsd.org and .An Jasper Lievisse Adriaanse Aq Mt jas...@openbsd.org . Note that so far, the mandoc manuals themselves use just `Mt' and not `Aq Mt', but i think `Aq Mt' reads better and i should probably change the mandoc manuals, too. >> it probably does make sense for >> folks who want stuff like html pages. Exactly. >> i did add an Mt fairly recently, but there can;t be many in tree. > Looks like this is almost exclusively used in mandoc/mdocml for most > BSDs. Apparently nobody got the memo. ;) Maybe, but groff has been supporting it for a long time and that was the de-facto reference implementation of mdoc(7) before mandoc was written. So i think it's just that nobody did the work of adding the markup, yet. Yours, Ingo
Re: author emails in manpages
On Jul 12, 2013, at 3:16 PM, Jason McIntyre wrote: > perhaps. either Mt is fairly new, or i never noticed it before. we could > wholesale change stuff, but haven;t yet. it probably does make sense for > folks who want stuff like html pages. > > i did add an Mt fairly recently, but there can;t be many in tree. Looks like this is almost exclusively used in mandoc/mdocml for most BSDs. Apparently nobody got the memo. ;)
Re: author emails in manpages
On Fri, Jul 12, 2013 at 02:04:03PM +0200, Jan Stary wrote: > Authors' emails in manpages are generally written as .e.g. > > .An Damien Miller Aq d...@openbsd.org > > Should these be like > > .An Damien Miller Aq Mt d...@openbsd.org > > ? > perhaps. either Mt is fairly new, or i never noticed it before. we could wholesale change stuff, but haven;t yet. it probably does make sense for folks who want stuff like html pages. i did add an Mt fairly recently, but there can;t be many in tree. jmc
