Lack of sshfs(1) man page

Lack of sshfs(1) man page

[Piotr Dobrogost]

Hi!

I was looking for sshfs man page at
http://man7.org/linux/man-pages/dir_section_1.html but it's not there.
At the same time there is such a page at
http://linux.die.net/man/1/sshfs
Am I missing something?
Also should I prefer man7.org/linux/man-pages/ man pages to
http://linux.die.net/man/ ones?


Regards,
Piotr Dobrogost
--
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: Lack of sshfs(1) man page

[Michael Kerrisk (man-pages)]

Hello Piotr,

On 11/24/2014 03:20 PM, Piotr Dobrogost wrote:
> Hi!
> 
> I was looking for sshfs man page at
> http://man7.org/linux/man-pages/dir_section_1.html but it's not there.

I've added it to my scripts, so it'll go out with the next site refresh.
(See http://blog.man7.org/2013/05/adding-further-man-pages-to-html.html)

> At the same time there is such a page at
> http://linux.die.net/man/1/sshfs
> Am I missing something?

No. The set at man7.org is not as extensive as at linux.die.net...

> Also should I prefer man7.org/linux/man-pages/ man pages to
> http://linux.die.net/man/ ones?

It depends, and obviously I am biased. The pages rendered
at man7.org tend to be (*much*) more up to date, and the
COLOPHON tells you exactly where the page came from, and
when. That info is not available on most other sites that
provide HTML renderings, and the pages on some of those
sites are years out of date. As outlined in the blog post,
I am open to add projects to the rendered set, which currently
comprises around 100 projects.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
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: Lack of sshfs(1) man page

[Piotr Dobrogost]

On Tue, Dec 23, 2014 at 4:38 PM, Michael Kerrisk (man-pages)
<mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:

Hello Michael,

I've already lost hope to see any reply to my post but here it is.
Thanks for taking time to write your answers.

>> I was looking for sshfs man page at
>> http://man7.org/linux/man-pages/dir_section_1.html but it's not there.
>
> I've added it to my scripts, so it'll go out with the next site refresh.
> (See http://blog.man7.org/2013/05/adding-further-man-pages-to-html.html)

Thanks.

>> Also should I prefer man7.org/linux/man-pages/ man pages to
>> http://linux.die.net/man/ ones?
>
> It depends, and obviously I am biased. The pages rendered
> at man7.org tend to be (*much*) more up to date, and the
> COLOPHON tells you exactly where the page came from, and
> when. That info is not available on most other sites that
> provide HTML renderings, and the pages on some of those
> sites are years out of date. As outlined in the blog post,
> I am open to add projects to the rendered set, which currently
> comprises around 100 projects.

Thanks for info. Reading http://blog.man7.org/ I see you're maintainer
of man-pages project and at https://www.kernel.org/doc/man-pages/ page
there's a link ("Online man pages") to man7.org. Is there any
"official" relation between these two projects (man-pages and
man7.org)?

Am I right to think that providing up to date man pages online for all
"popular" projects seems to be very valuable service to the GNU/Linux
community? If so does man7.org receive support from major
institutions, projects and communities in the GNU/Linux world?  Is
there any chance man7 and linux.die.net/man/ would cooperate so that
it would be easier to find up to date online man pages? Also curious
to know where does the name of "man7" come from?


Regards,
Piotr
--
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: Lack of sshfs(1) man page

[Michael Kerrisk (man-pages)]

Hello Piotr,

>>> Also should I prefer man7.org/linux/man-pages/ man pages to
>>> http://linux.die.net/man/ ones?
>>
>> It depends, and obviously I am biased. The pages rendered
>> at man7.org tend to be (*much*) more up to date, and the
>> COLOPHON tells you exactly where the page came from, and
>> when. That info is not available on most other sites that
>> provide HTML renderings, and the pages on some of those
>> sites are years out of date. As outlined in the blog post,
>> I am open to add projects to the rendered set, which currently
>> comprises around 100 projects.
> 
> Thanks for info. Reading http://blog.man7.org/ I see you're maintainer
> of man-pages project and at https://www.kernel.org/doc/man-pages/ page
> there's a link ("Online man pages") to man7.org. Is there any
> "official" relation between these two projects (man-pages and
> man7.org)?

No, the link is only personal. man7.org is my personal site.

> Am I right to think that providing up to date man pages online for all
> "popular" projects seems to be very valuable service to the GNU/Linux
> community? 

It is certainly very useful, in my opinion at least.

> If so does man7.org receive support from major
> institutions, projects and communities in the GNU/Linux world?  

Not as such, but I've not asked for such either. Some people help
by pointing out errors or projects that might usefully be
included in the set.

> Is
> there any chance man7 and linux.die.net/man/ would cooperate so that
> it would be easier to find up to date online man pages?

Well, the man7.org pages are easy to find already ;-).
But, aside from that, I suspect that the man pages at
die.net are created by just dumping all of the pages off
a particular distribution install. Thus, it's not always
clear where the pages come from, or how old they are. Indeed
they seem to go to some effort to obscure that information, 
removing the page timestamps, and even, looking at
http://linux.die.net/man/2/prctl for example, stripping out
the COLOPHON that I place in the pages of the man-pages
project. That COLOPHON notes which release of man-pages the
page belongs to and has a pointer to a URL for information
on the project and how to report bugs. I'm not impressed
that they remove it. Mainly, I think those renderings are 
about driving a few ad clicks... (I'm not really sure there's
much to be gained from any sort of cooperation.)

> Also curious
> to know where does the name of "man7" come from?

I took over man-pages maintenance in 2004. Since that time,
I've expanded the remit of that section to include pages that
give overviews/big pictures of how APIs are related, so that
now we have pages such as:

aio(7)
credentials(7)
fanotify(7)
feature_test_macros(7)
inotify(7)
libc(7)
mq_overview(7)
namespaces(7)
numa(7)
pid_namespaces(7)
pipe(7)
pthreads(7)
pty(7)
rtld-audit(7)
sched(7)
sem_overview(7)
shm_overview(7)
sigevent(7)
standards(7)
user_namespaces(7)
 
So, man7 for me is about giving the big picture about Linux APIs,
and was the inspiration for the domain name.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
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