Bug 235761 - freebsd-update(8) refers to stale releases
Summary: freebsd-update(8) refers to stale releases
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Ed Maste
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-02-15 18:20 UTC by Mark Linimon
Modified: 2019-03-12 17:05 UTC (History)
4 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Mark Linimon freebsd_committer freebsd_triage 2019-02-15 18:20:21 UTC
The existing text:

     e.g., FreeBSD 10.3-RELEASE	and FreeBSD 11.0-RELEASE, but not FreeBSD
     10.3-STABLE or FreeBSD 12-CURRENT.

ought to be

     e.g., FreeBSD 11.2-RELEASE	and FreeBSD 12.0-RELEASE, but not FreeBSD
     10.4-STABLE or FreeBSD 13-CURRENT.
Comment 1 Guangyuan Yang freebsd_committer freebsd_triage 2019-02-27 22:06:04 UTC
I don't think we should update this every time a new version is available, as it only serves as an example. Though, 12.0-CURRENT and 10.3-STABLE do not exist anymore, so I understand that this part is technically not correct. Should we switch to more general version references instead (e.g. A.B-STABLE)?
Comment 2 commit-hook freebsd_committer freebsd_triage 2019-03-05 19:17:56 UTC
A commit references this bug:

Author: emaste
Date: Tue Mar  5 19:17:24 UTC 2019
New revision: 344818
URL: https://svnweb.freebsd.org/changeset/base/344818

Log:
  freebsd-update.8: update example to contemporary versions

  PR:		235761
  Reported by:	linimon
  MFC after:	1 week

Changes:
  head/usr.sbin/freebsd-update/freebsd-update.8
Comment 3 Ed Maste freebsd_committer freebsd_triage 2019-03-05 19:19:03 UTC
(In reply to Guangyuan Yang from comment #1)
I agree we don't want to start editing this on every release, but I think it wouldn't be onerous to do it once per major release, and having concrete examples makes it more understandable for users. We could just add this to (the/a) list of files to edit per year/release/etc.
Comment 4 commit-hook freebsd_committer freebsd_triage 2019-03-12 17:04:04 UTC
A commit references this bug:

Author: emaste
Date: Tue Mar 12 17:03:59 UTC 2019
New revision: 345071
URL: https://svnweb.freebsd.org/changeset/base/345071

Log:
  MFC r344818: freebsd-update.8: update example to contemporary versions

  PR:		235761
  Reported by:	linimon

Changes:
_U  stable/12/
  stable/12/usr.sbin/freebsd-update/freebsd-update.8
Comment 5 commit-hook freebsd_committer freebsd_triage 2019-03-12 17:05:08 UTC
A commit references this bug:

Author: emaste
Date: Tue Mar 12 17:04:48 UTC 2019
New revision: 345072
URL: https://svnweb.freebsd.org/changeset/base/345072

Log:
  MFC r344818: freebsd-update.8: update example to contemporary versions

  PR:		235761
  Reported by:	linimon

Changes:
_U  stable/11/
  stable/11/usr.sbin/freebsd-update/freebsd-update.8