Bug 195432

Summary:	send-pr(1) links dead as of FreeBSD 10.1-RELEASE
Product:	Documentation	Reporter:	Kim Gräsman <kim.grasman>
Component:	Books & Articles	Assignee:	Jason Helfman <jgh>
Status:	Closed FIXED
Severity:	Affects Many People	CC:	jgh
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any

Description Kim Gräsman 2014-11-26 21:25:38 UTC

I'm about to install FreeBSD for the first time, and started to read the lovely handbook.

I followed the link to send-pr(1) from:
https://www.freebsd.org/doc/handbook/history.html#development-committers

and was surprised to see:
https://www.freebsd.org/cgi/man.cgi?query=send-pr&sektion=1

   Sorry, no data found for `send-pr(1)'. Please try a keyword search.

After some digging, I landed on:
https://www.freebsd.org/releases/10.1R/relnotes.html#userland

which explains it:

   The FreeBSD Project has migrated from the GNATS bug tracking
   system to Bugzilla. The send-pr(1) utility used for submitting
   problem reports has been replaced with a stub shell script that
   instructs to use the Bugzilla web interface. [r267734]

So this is a little tricky -- the latest FreeBSD doesn't use send-pr(1), but older versions do. Should the handbook still refer to send-pr(1)? If so, should the man links somehow reference the last version that supported it?

Thanks!

Comment 1 Jason Helfman freebsd_committer

2014-11-26 23:49:15 UTC

Working on this... You can use this link for submitting bugs. Thanks for the report!

https://bugs.freebsd.org/submit/

Comment 2 Jason Helfman freebsd_committer

2014-12-03 23:22:39 UTC

Committed, thanks!

Comment 3 commit-hook freebsd_committer

2014-12-03 23:22:56 UTC

A commit references this bug:

Author: jgh
Date: Wed Dec  3 23:22:19 UTC 2014
New revision: 46063
URL: https://svnweb.freebsd.org/changeset/doc/46063

Log:
  - address issue of using send-pr to submit bugs
  - add link for using bugzilla for reporting bugs
  - drop committers mailing list and point users to community mailing lists

  PR:		195432
  Differential Revision:	https://reviews.freebsd.org/D1237
  Reported by:	kim.grasman@gmail.com
  Reviewed by:	remko, wblock (mentors)
  Approved by:	wblock (mentor)

Changes:
  head/en_US.ISO8859-1/books/handbook/introduction/chapter.xml

Comment 4 Kim Gräsman 2014-12-04 06:19:23 UTC

Thanks!

Unfortunately the &man.send-pr.1; link is still dead, because send-pr(1) has been pulled out of the latest FreeBSD manuals, to which the generated link points.

Is there a way to point to a pinned rev? You could use a normal <link>, I guess, but it feels a little dirty.