Bug 218566

Summary:	Oddly obsolete file list in 23.6.6. Common Questions
Product:	Documentation	Reporter:	Brooks Davis <brooks>
Component:	Books & Articles	Assignee:	Sevan Janiyan <sevan>
Status:	Closed FIXED
Severity:	Affects Only Me	CC:	sevan
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://reviews.freebsd.org/D10452

Description Brooks Davis freebsd_committer

2017-04-11 17:23:29 UTC

The Rebuilding World section contains this peculiarly vintage set of changed files in an example:

src/games/cribbage/instr.c
src/games/sail/pl_main.c
src/release/sysinstall/config.c
src/release/sysinstall/media.c
src/share/mk/bsd.port.mk

One the last one exists and it's almost never changed.  A less obsolete set of files might be more informative.

On a related note, the suggestion that rebuilding world might be a good idea if something changed in lib/libc should probably be stronger.

Comment 1 commit-hook freebsd_committer

2017-04-23 13:17:09 UTC

A commit references this bug:

Author: sevan
Date: Sun Apr 23 13:16:48 UTC 2017
New revision: 50201
URL: https://svnweb.freebsd.org/changeset/doc/50201

Log:
  Replace obsolete files in example output with files currently found in src.
  Make a stronger recommendation about rebuilding world if a key component in src
  has been modified.

  PR:		218566
  Submitted by:	Brooks Davis <Brooks AT FreeBSD DOT org>
  Approved by:	bcr (mentor)
  Differential Revision:	https://reviews.freebsd.org/D10452

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

Comment 2 Sevan Janiyan freebsd_committer

2017-04-23 13:18:24 UTC

Committed, thanks for raising the issue.