man pages for a specific kernel version

man pages for a specific kernel version

[Ram Gupta]

Does any one know for a way to get accurate man pages for a particular
kernel version? I am aware that changelogs for man pages of system
calls are available on the web
http://www.kernel.org/doc/man-pages/changelog.html but they don't
correspond to any particular kernel version. So it is hard to
determine what options for a system call are really available in the
version someone is using. As kernel keeps evolving man pages keep
changing too but they don't change at the same time so it is hard to
determine their accuracy in respect to a particular kernel version. If
someone is aware of a mechanism to find it out please share.

Thanks,
Ram Gupta
--
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

Re: man pages for a specific kernel version

[Stefan Puiu]

Hi,

Maybe http://kernelnewbies.org/LinuxChanges is what you're looking
for? You have changelogs for specific kernel versions, plus a link to
the LWN list of kernel API changes.

HTH,
Stefan.

On Sat, Mar 19, 2011 at 4:01 AM, Ram Gupta <ram.gupta5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> Does any one know for a way to get accurate man pages for a particular
> kernel version? I am aware that changelogs for man pages of system
> calls are available on the web
> http://www.kernel.org/doc/man-pages/changelog.html but they don't
> correspond to any particular kernel version. So it is hard to
> determine what options for a system call are really available in the
> version someone is using. As kernel keeps evolving man pages keep
> changing too but they don't change at the same time so it is hard to
> determine their accuracy in respect to a particular kernel version. If
> someone is aware of a mechanism to find it out please share.
>
> Thanks,
> Ram Gupta
> --
> 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
>
--
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

Re: man pages for a specific kernel version

[Ram Gupta]

Thanks for the reply.I am actually looking for system calls man pages
for kernel 2.6.34 version.So far I have found that the man pages are
maintained separately from kernel. In this way it is uncertain whether
the behavior described by man pages applies to this specific version
or not.This is particularly true for the errors code returned by
kernel.

Regards,
Ram

On Sat, Mar 19, 2011 at 4:44 AM, Stefan Puiu <stefan.puiu-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> Hi,
>
> Maybe http://kernelnewbies.org/LinuxChanges is what you're looking
> for? You have changelogs for specific kernel versions, plus a link to
> the LWN list of kernel API changes.
>
> HTH,
> Stefan.
>
> On Sat, Mar 19, 2011 at 4:01 AM, Ram Gupta <ram.gupta5-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
>> Does any one know for a way to get accurate man pages for a particular
>> kernel version? I am aware that changelogs for man pages of system
>> calls are available on the web
>> http://www.kernel.org/doc/man-pages/changelog.html but they don't
>> correspond to any particular kernel version. So it is hard to
>> determine what options for a system call are really available in the
>> version someone is using. As kernel keeps evolving man pages keep
>> changing too but they don't change at the same time so it is hard to
>> determine their accuracy in respect to a particular kernel version. If
>> someone is aware of a mechanism to find it out please share.
>>
>> Thanks,
>> Ram Gupta
>> --
>> 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
>>
>
--
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

Re: man pages for a specific kernel version

[Jonathan Nieder]

Hi,

Ram Gupta wrote:

> Does any one know for a way to get accurate man pages for a particular
> kernel version?
[...]
> As kernel keeps evolving man pages keep
> changing too

Sorry for a late response.  The intent is for the man-pages package to
document all kernel versions.  So when there are relevant differences
between versions that it does not explain, do please feel free to let
us know (ideally in the form of a patch, but a friendly comment is
fine, too).

Of course, like most documentation, these manpages are not perfect, so
if you need reliable information I'd suggest looking at the kernel
source.

Good luck,
Jonathan
--
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

Re: man pages for a specific kernel version

[Michael Kerrisk]

On Mon, Jul 4, 2011 at 9:51 AM, Jonathan Nieder <jrnieder-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> Hi,
>
> Ram Gupta wrote:
>
>> Does any one know for a way to get accurate man pages for a particular
>> kernel version?
> [...]
>> As kernel keeps evolving man pages keep
>> changing too
>
> Sorry for a late response.  The intent is for the man-pages package to
> document all kernel versions.  So when there are relevant differences
> between versions that it does not explain, do please feel free to let
> us know (ideally in the form of a patch, but a friendly comment is
> fine, too).
>
> Of course, like most documentation, these manpages are not perfect, so
> if you need reliable information I'd suggest looking at the kernel
> source.

Ack. Jonathan's summary is precisely accurate.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
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