Bug 219858 - handbook: "23.5.1. Quick Start" is missing a step
Summary: handbook: "23.5.1. Quick Start" is missing a step
Status: Closed Works As Intended
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-06-08 09:56 UTC by Lutz Donnerhacke
Modified: 2017-06-08 21:26 UTC (History)
1 user (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Lutz Donnerhacke freebsd_committer freebsd_triage 2017-06-08 09:56:53 UTC 
The website https://www.freebsd.org/doc/handbook/makeworld.html states, that the following steps need to be performed:

---------------------------------
# svn update /usr/src  1
check /usr/src/UPDATING  2
# cd /usr/src          3
# make -j4 buildworld  4
# make -j4 kernel      5
# shutdown -r now      6
# cd /usr/src          7
# make installworld    8
# mergemaster -Ui      9
# shutdown -r now      10
---------------------------------

Between step 5 and 6, the step
 "# make installkernel"
is missing.
Comment 1 Lutz Donnerhacke freebsd_committer freebsd_triage 2017-06-08 10:47:59 UTC 
"make kernel" is a synonym for "make buildkernel installkernel"
So technically, the part is correct.

It's only misleading.
Comment 2 Warren Block freebsd_committer freebsd_triage 2017-06-08 13:53:01 UTC 
This is mentioned in the explanation for step #5:

5 Compile and install the kernel. This is equivalent to buildkernel installkernel.

I could change that to a more explicit command:

5 Compile and install the kernel. This is equivalent to *make buildkernel installkernel*.
Comment 3 Lutz Donnerhacke freebsd_committer freebsd_triage 2017-06-08 15:25:32 UTC 
Thank you.
Comment 4 commit-hook freebsd_committer freebsd_triage 2017-06-08 21:26:32 UTC 
A commit references this bug:

Author: wblock
Date: Thu Jun  8 21:26:06 UTC 2017
New revision: 50339
URL: https://svnweb.freebsd.org/changeset/doc/50339

Log:
  Make it more clear that the "kernel" target equates to "buildkernel
  installkernel".

  PR:		219858
  Submitted by:	lutz@donnerhacke.de

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