Re: [patch] update kernel documentation references in cgroups(7) and cpuset(7)

[Sven Hoexter <sven@stormbind.net>]

On Mon, Jun 29, 2020 at 01:40:50PM +0200, Michael Kerrisk (man-pages) wrote:
> On Fri, 19 Jun 2020 at 18:35, Sven Hoexter <sven@stormbind.net> wrote:

Hi,

> > cgroups-v1/v2 documentation got moved to the "admin-guide" subfolder
> > and converted from .txt files to .rst
> 
> Thanks for your patch and for the ping, and sorry I did not respond
> earlier. I had not forgotten this patch, but I was still working out
> what to do with it.
> 
> The general philosophy in man-pages is to maintain historical
> information, since the man-pages that are installed on a system may
> not correspond to the kernel running on that system.

Indeed, a valid point I did not consider.


> In the context of
> your patch, what this means is that I would prefer to have text like:
> 
> [[
> The kernel source file
> .IR Documentation/admin\-guide/cgroup\-v2.rst
> (or
> .IR Documentation/admin-guide/cgroup-v2.rst in Linux x.y and earlier)
> ]]
> 
> Would you be willing to revise your patch to that style?

Sure, I will prepare a new version.

Regards,
Sven