From mboxrd@z Thu Jan 1 00:00:00 1970 From: Heiko Carstens Subject: Re: [man-pages PATCH 1/5] s390_runtime_instr.2: note that runtime_instr.h is not a public header Date: Mon, 22 Jan 2018 16:11:05 +0100 Message-ID: <20180122151105.GF4806@osiris> References: <20180114185622.GA23506@asgard.redhat.com> <20180120112839.GB6287@osiris> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Content-Disposition: inline In-Reply-To: Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: Eugene Syromyatnikov Cc: Michael Kerrisk-manpages , linux-man , Martin Schwidefsky , linux-s390-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, QingFeng Hao List-Id: linux-man@vger.kernel.org On Mon, Jan 22, 2018 at 01:11:19PM +0000, Eugene Syromyatnikov wrote: > On Sat, Jan 20, 2018 at 11:28 AM, Heiko Carstens > wrote: > > IMHO we shouldn't document the file name of a kernel header that is not > > exported. It's name and location can change anytime. I will move the kernel > > header file to the uapi directory where it should have been since a long > > time. > > In that case, I think it could be rephrased to something like "the > header asm/runtime_instr.h is available for the userspace programs > since Linux 4.15, before that it was located in > arch/s390/include/asm/runtime_instr.h in the kernel's source tree", as > man-pages project (as I understood) tends to reference places in > kernel's source tree if it is deemed useful; it is usually applied to > documentation files, however, although they also have tendency to > migrate over time. Yes, that's ok. However moving the header file to uapi is not going to happen before kernel version 4.16. -- 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