Bug 31562

Summary:	a wrong date is shown in the manpage
Product:	Sisyphus	Reporter:	Ivan Zakharyaschev <imz>
Component:	apt-repo	Assignee:	Andrey Cherepanov <cas>
Status:	CLOSED FIXED	QA Contact:	qa-sisyphus
Severity:	minor
Priority:	P3	CC:	cas
Version:	unstable
Hardware:	all
OS:	Linux

Description Ivan Zakharyaschev 2015-11-29 16:07:21 MSK

$ rpm -qf /usr/share/man/man8/apt-repo.8.gz 
apt-repo-1.2.0-alt1
$ man apt-repo | tail
mdoc warning: Empty input line #194
           apt-repo add 39115

SEE ALSO
     sources.list(5), apt-cache(8), apt-get(8)

AUTHORS
     Andrey Cherepanov cas@altlinux.org


                               November 29, 2015
$ 

I had a look into the source:

.Os Linux
.Dd "November 06, 2013"
.ds volume-operating-system Linux
.Dt apt\-repo 8
.\"
.Sh NAME
.Nm apt\-repo
.Nd Manipulate APT repository list
.\"
.Sh SYNOPSIS

Another example of the code from apt-config(8) (which specifies the date differently):

.TH "APT-CONFIG" "8" "12 March 2001" "" ""
.SH NAME
apt-config \- APT Configuration Query program
.SH SYNOPSIS

And for this page, man shows the date from the source:

$ man apt-config | tail
BUGS
       See the APT bug page <URL:http://bugs.debian.org/src:apt>.  If you wish to report a bug in APT, please see /usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command.

AUTHOR
       APT was written by the APT team <apt@packages.debian.org>.




                                                                                                                   12 March 2001                                                                                                     APT-CONFIG(8)


I do not know much about this format, so have no idea what could be a correction.

Comment 1 Ivan Zakharyaschev 2015-11-29 21:36:12 MSK

However, in the source of the manpage, /usr/share/man/man8/idmapd.8.gz (from nfs-clients-1.2.8-alt1) has a similar expression for the date:

.Dd February 3, 2003
.Dt RPC.IDMAPD 8
.Os
.Sh NAME
.Nm rpc.idmapd
.Nd NFSv4 ID <-> Name Mapper
.Sh SYNOPSIS


and the date is printed correctly (unlike in the case of apt-repo):

$ man idmapd | tail
mdoc warning: Empty input line #98
     /etc/idmapd.conf

SEE ALSO
     idmapd.conf(5)

AUTHORS
     The rpc.idmapd software has been developed by Marius Aamodt Eriksen ⟨marius@citi.umich.edu⟩.


BSD                            February 3, 2003                            BSD

Comment 2 Ivan Zakharyaschev 2015-11-30 11:27:44 MSK

The fix was actually a simple one:

---------------------------------- apt-repo.8 ----------------------------------
index 39fb4af..16f637f 100644
@@ -8,7 +8,7 @@
 .\" version 3 or later.
 .\"
 .Os Linux
-.Dd "November 06, 2013"
+.Dd November 06, 2013
 .ds volume-operating-system Linux
 .Dt apt\-repo 8
 .\"

Committed in apt-repo-1.2.1-alt1