errno "SEE ALSO" link on each page which returns errno values

errno "SEE ALSO" link on each page which returns errno values

[Jon Grant]

Hello

I saw quite a lot of pages have this text:

"in which case errno is set appropriately".

e.g.
http://kernel.org/doc/man-pages/online/pages/man2/close.2.html

Could I ask, it would be useful to have a SEE ALSO link for errno
page, would that be possible?

Best regards, Jon
--
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: errno "SEE ALSO" link on each page which returns errno values

[Michael Kerrisk (man-pages)]

Jon,

On Sat, Oct 29, 2011 at 11:49 AM, Jon Grant <jg-hus3n9K41k0@public.gmane.org> wrote:
> Hello
>
> I saw quite a lot of pages have this text:
>
> "in which case errno is set appropriately".
>
> e.g.
> http://kernel.org/doc/man-pages/online/pages/man2/close.2.html
>
> Could I ask, it would be useful to have a SEE ALSO link for errno
> page, would that be possible?

Since that would be the majority of the pages, what would the purpose be?

Thanks,

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

Re: errno "SEE ALSO" link on each page which returns errno values

[Jon Grant]

On 17/04/12 20:45, Michael Kerrisk (man-pages) wrote:
> Jon,
>
> On Sat, Oct 29, 2011 at 11:49 AM, Jon Grant<jg-hus3n9K41k0@public.gmane.org>  wrote:
>> Hello
>>
>> I saw quite a lot of pages have this text:
>>
>> "in which case errno is set appropriately".
>>
>> e.g.
>> http://kernel.org/doc/man-pages/online/pages/man2/close.2.html
>>
>> Could I ask, it would be useful to have a SEE ALSO link for errno
>> page, would that be possible?
>
> Since that would be the majority of the pages, what would the purpose be?

errno is a relevant link IMHO. Otherwise we have to click out, navigate 
to the page manually.

Regards, Jon
--
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: errno "SEE ALSO" link on each page which returns errno values

[Michael Kerrisk (man-pages)]

On Wed, Apr 18, 2012 at 8:57 AM, Jon Grant <jg-hus3n9K41k0@public.gmane.org> wrote:
>
>
> On 17/04/12 20:45, Michael Kerrisk (man-pages) wrote:
>>
>> Jon,
>>
>> On Sat, Oct 29, 2011 at 11:49 AM, Jon Grant<jg-hus3n9K41k0@public.gmane.org>  wrote:
>>>
>>> Hello
>>>
>>> I saw quite a lot of pages have this text:
>>>
>>> "in which case errno is set appropriately".
>>>
>>> e.g.
>>> http://kernel.org/doc/man-pages/online/pages/man2/close.2.html
>>>
>>> Could I ask, it would be useful to have a SEE ALSO link for errno
>>> page, would that be possible?
>>
>>
>> Since that would be the majority of the pages, what would the purpose be?
>
>
> errno is a relevant link IMHO. Otherwise we have to click out, navigate to
> the page manually.

Okay. I'll add that.

Thanks,

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

Re: errno "SEE ALSO" link on each page which returns errno values

[Jon Grant]

On 18/04/12 21:47, Michael Kerrisk (man-pages) wrote:
> On Wed, Apr 18, 2012 at 8:57 AM, Jon Grant<jg-hus3n9K41k0@public.gmane.org>  wrote:
>>
>> On 17/04/12 20:45, Michael Kerrisk (man-pages) wrote:
[..]
>> errno is a relevant link IMHO. Otherwise we have to click out, navigate to
>> the page manually.
>
> Okay. I'll add that.
>
> Thanks,
>
> Michael

Hi


Will this errno link be on all "SEE ALSO"?

I checked two, but these did not have the link:

http://man7.org/linux/man-pages/man2/close.2.html

http://man7.org/linux/man-pages/man3/fopen.3.html

Regards, Jon
--
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: errno "SEE ALSO" link on each page which returns errno values

[Michael Kerrisk (man-pages)]

On Mon, May 7, 2012 at 3:54 AM, Jon Grant <jg-hus3n9K41k0@public.gmane.org> wrote:
>
>
> On 18/04/12 21:47, Michael Kerrisk (man-pages) wrote:
>>
>> On Wed, Apr 18, 2012 at 8:57 AM, Jon Grant<jg-hus3n9K41k0@public.gmane.org>  wrote:
>>>
>>>
>>> On 17/04/12 20:45, Michael Kerrisk (man-pages) wrote:
>
> [..]
>
>>> errno is a relevant link IMHO. Otherwise we have to click out, navigate
>>> to
>>> the page manually.
>>
>>
>> Okay. I'll add that.
>>
>> Thanks,
>>
>> Michael
>
>
> Hi
>
>
> Will this errno link be on all "SEE ALSO"?
>
> I checked two, but these did not have the link:
>
> http://man7.org/linux/man-pages/man2/close.2.html
>
> http://man7.org/linux/man-pages/man3/fopen.3.html

Hi Jon,

The rendering changes will come out with the 3.41 release. The pages
won't change (there's no point in adding "errno" to the SEE ALSO of
every page), but the html rendering will link errno to errno(3).

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

Re: errno "SEE ALSO" link on each page which returns errno values

[Jon Grant]

On 06/05/12 19:14, Michael Kerrisk (man-pages) wrote:
> On Mon, May 7, 2012 at 3:54 AM, Jon Grant<jg-hus3n9K41k0@public.gmane.org>  wrote:
>>
>>
>> On 18/04/12 21:47, Michael Kerrisk (man-pages) wrote:
>>>
>>> On Wed, Apr 18, 2012 at 8:57 AM, Jon Grant<jg-hus3n9K41k0@public.gmane.org>    wrote:
>>>>
>>>>
>>>> On 17/04/12 20:45, Michael Kerrisk (man-pages) wrote:
>>
>> [..]
>>
>>>> errno is a relevant link IMHO. Otherwise we have to click out, navigate
>>>> to
>>>> the page manually.
>>>
>>>
>>> Okay. I'll add that.
>>>
>>> Thanks,
>>>
>>> Michael
>>
>>
>> Hi
>>
>>
>> Will this errno link be on all "SEE ALSO"?
>>
>> I checked two, but these did not have the link:
>>
>> http://man7.org/linux/man-pages/man2/close.2.html
>>
>> http://man7.org/linux/man-pages/man3/fopen.3.html
>
> Hi Jon,
>
> The rendering changes will come out with the 3.41 release. The pages
> won't change (there's no point in adding "errno" to the SEE ALSO of
> every page), but the html rendering will link errno to errno(3).

Hi Michael

Ok, I see it now. Great, thank you for adding the link.

Regards, Jon
--
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