Page MenuHomeFreeBSD

kerberos(8): Replace dead link to FAQ
Changes PlannedPublic

Authored by ygy on Dec 18 2020, 12:31 PM.

Details

Reviewers
None
Group Reviewers
manpages
docs
Summary

I am actually unsure, do we remove this link completely, or try using archive.org (see diff below)?

The link seemed to be dead for a very long time (20 years), but the info there seems complete and useful.

PR: 251854
Submitted by: ktullavik@gmail.com

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Lint Skipped
Unit
Unit Tests Skipped
Build Status
Buildable 35510

Event Timeline

ygy requested review of this revision.Dec 18 2020, 12:31 PM

For something as specific as kerberos, I think it makes sense to link to the internet archive of the page, rather than getting rid of the link as it's not typically something that people would easily find on their own.

@bjk: Can you comment on this? When I think "Kerberos and FreeBSD", you come to mind. ;-)

BTW there is also http://www.faqs.org/faqs/kerberos-faq/general/ but I am not sure which link is more authoritative.

BTW there is also http://www.faqs.org/faqs/kerberos-faq/general/ but I am not sure which link is more authoritative.

Nice find! Though, the archive.org one has a slightly better interface (with links) and is less likely to go away soon (IMO).

If I hear no objections in a week, I am going to commit the change with the internet archive version ;)

In D27668#618491, @bcr wrote:

@bjk: Can you comment on this? When I think "Kerberos and FreeBSD", you come to mind. ;-)

Yes, I can comment :-)

First, I note that this file is from Heimdal upstream and so whatever we do it would be good to also contribute it back. Pull requests to https://github.com/heimdal/heimdal are well-received (the file is lib/krb5/kerberos.8).

Second, I took a look through the archive.org version and I'd say that about half of the entries are so old/stale so as to be harmful. Furthermore, the FAQ focuses on MIT krb5 when giving configuration snippets and commands, many of which are not applicable to the Heimdal implementation that is supposed to be getting documented.

So, my recommendation would be to link to the informal introduction at https://web.mit.edu/kerberos/dialogue.html and the tutorial at https://kerberos.org/software/tutorial.html in lieu of Ken Hornstein's FAQ (whether at archive.org or faqs.org). I can try to write up a patch to do that if you want.

In D27668#619201, @bjk wrote:

First, I note that this file is from Heimdal upstream and so whatever we do it would be good to also contribute it back. Pull requests to https://github.com/heimdal/heimdal are well-received (the file is lib/krb5/kerberos.8).

Second, I took a look through the archive.org version and I'd say that about half of the entries are so old/stale so as to be harmful. Furthermore, the FAQ focuses on MIT krb5 when giving configuration snippets and commands, many of which are not applicable to the Heimdal implementation that is supposed to be getting documented.

So, my recommendation would be to link to the informal introduction at https://web.mit.edu/kerberos/dialogue.html and the tutorial at https://kerberos.org/software/tutorial.html in lieu of Ken Hornstein's FAQ (whether at archive.org or faqs.org). I can try to write up a patch to do that if you want.

Thanks for the useful comment! I've opened an issue at https://github.com/heimdal/heimdal/issues/766, if you feel like writing a patch to get it merged upstream, I would be happy to import it back ;)

ygy planned changes to this revision.Dec 25 2020, 6:35 PM