From: Laurent Georget Subject: Re: [patch 1/2] adjtimex.2: remove nonexisting reference to adjtimex(8) Date: Sat, 29 Nov 2014 11:22:38 +0100 Message-ID: <54799E6E.2030600@supelec.fr> References: <54788059.6020209@supelec.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: In-Reply-To: Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org Cc: linux-man List-Id: linux-man@vger.kernel.org Hello again, Le 29/11/2014 10:17, Michael Kerrisk (man-pages) a =C3=A9crit : > Hello Laurent, >=20 > On Fri, Nov 28, 2014 at 3:02 PM, Laurent Georget > wrote: >> Hello, >> >> This is a patch I sent to mtk.manpages-Re5JQEeQqe9fmgfxC/sS/w@public.gmane.org It didn't make its= way >> to this mailing-list the first time. It's a trivial fix for an undef= ined >> reference to adjtimex(8). Patch you received before (adjtimex.2: add >> explanation about ADJ_TAI action) is patch 2/2 for adjtimex.2. >=20 > This does not seem correct to me. Certainly on my Fedora system, ther= e > is an "adjtimex" package that installs adjtimex(8) page. So, this > reference seems okay to me. Did I miss something? >=20 Ok, indeed, my mistake. This package is not part of the core system on my distribution so I found it surprising to have a link from a man2 pag= e to a nonexisting man8 page. But now that I give a closer look, the case is the same for request_key.2 linking to request_key.8 for example so I'm wrong. What is the policy to include a link from section 2 to section 1 or 8? = I guess I'm misundestanding something here? Given the case of adjtimex(2) linking to adjtimex(8) because there is an adjtimex package which installs it, should we include a link in inotify_{init,add,...} to inotifywait.1 for example? I've always thought that pages in section 1 (or 8) and 2 should just include a link to a general page in section 7 to remain generic enough through time. Thanks, Laurent > Thanks, >=20 > Michael >=20 >=20 >> diff --git a/man2/adjtimex.2 b/man2/adjtimex.2 >> index eb3fda1..20a2f0b 100644 >> --- a/man2/adjtimex.2 >> +++ b/man2/adjtimex.2 >> @@ -24,6 +24,7 @@ >> .\" Modified 1997-01-31 by Eric S. Raymond >> .\" Modified 1997-07-30 by Paul Slootman >> .\" Modified 2004-05-27 by Michael Kerrisk >> +.\" Modified 2014-11-28 by Laurent Georget >> .\" >> .\" FIXME Document ADJ_TAI (added in Linux 2.6.26) >> .\" commit 153b5d054ac2d98ea0d86504884326b6777f683d >> @@ -163,5 +164,4 @@ method of adjusting the system clock. >> .BR settimeofday (2), >> .BR adjtime (3), >> .BR capabilities (7), >> -.BR time (7), >> -.BR adjtimex (8) >> +.BR time (7) >> -- >> To unsubscribe from this list: send the line "unsubscribe linux-man"= in >> the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org >> More majordomo info at http://vger.kernel.org/majordomo-info.html >=20 >=20 >=20 -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html