Page MenuHomeFreeBSD
Differential D23263

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

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
View All 23 Files
Subscribers
emaste

Details

Reviewers
bcr
emaste
Commits
rD53811: Clarify when the user needs to reboot the system in the update section
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 Skipped
Unit
Tests Skipped

Event Timeline

carlavilla created this revision.Jan 19 2020, 4:13 PM
bcr added a comment.Jan 20 2020, 7:58 AM

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

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

303

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

305

s/if differs/if it differs/

carlavilla updated this revision to Diff 67112.Jan 21 2020, 7:32 PM

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

bcr added a comment.Jan 21 2020, 9:15 PM

Two more things, we're getting there.

en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
5

s/need/needs/

6

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.

carlavilla updated this revision to Diff 67148.Jan 22 2020, 4:43 PM

Done! Thanks.

bcr accepted this revision.Jan 22 2020, 7:03 PM

Good to go.

This revision is now accepted and ready to land.Jan 22 2020, 7:03 PM
Closed by commit rD53811: Clarify when the user needs to reboot the system in the update section (authored by carlavilla). · Explain WhyJan 23 2020, 8:41 PM
This revision was automatically updated to reflect the committed changes.
carlavilla added a commit: rD53811: Clarify when the user needs to reboot the system in the update section.

Revision Contents
Changeset List

PathSize
en_US.ISO8859-1/
books/
handbook/
cutting-edge/
8 lines

Diff 67112

View Options

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

Loading...