Page MenuHomeFreeBSD

[Handbook] Clarify when the user needs to reboot the system
ClosedPublic

Authored by carlavilla on Jan 19 2020, 4:13 PM.
Tags
None
Referenced Files
Unknown Object (File)
Feb 21 2024, 4:02 AM
Unknown Object (File)
Jan 2 2024, 3:16 AM
Unknown Object (File)
Dec 20 2023, 2:52 AM
Unknown Object (File)
Dec 2 2023, 5:28 AM
Unknown Object (File)
Nov 10 2023, 3:59 PM
Unknown Object (File)
Nov 10 2023, 12:06 AM
Unknown Object (File)
Nov 3 2023, 3:31 AM
Unknown Object (File)
Nov 1 2023, 4:32 PM
Subscribers

Details

Summary

This patch tries to help the users how to know if they need to reboot or not after an update of the system with the freebsd-update utility.

If you check the updating section in our Handbook freebsd-update you can see that says:

"If the update applies any kernel patches, the system will need a reboot in order to boot into the patched kernel."

With this patch I tried to solve this question.

@emaste you know if that note it's enought? I don't know if there's another easy way to check that.

PR: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=195218

Test Plan

Compile the handbook.

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

A few things that I've found. In general, I like the note and what it conveys.

en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
302 ↗(On Diff #67001)

We generally avoid the use of "you" in the handbook or other docs.
See section 14.1.1 of the FDP.

303 ↗(On Diff #67001)

No sentence stop here, it's one long sentence (which is fine, I think).

305 ↗(On Diff #67001)

s/if differs/if it differs/

Thanks for the advices. There's the new diff.

Two more things, we're getting there.

en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
5 ↗(On Diff #67112)

s/need/needs/

6 ↗(On Diff #67112)

These are still two sentences. Remove the sentence stop here and put a comma there instead to connect it to the "execute the commands ..." sentence.

This revision is now accepted and ready to land.Jan 22 2020, 7:03 PM