Bug 262998 - bectl(8) manual page: mixture of singular and plural; possible excess white space; boot environment with no mountpoint
Summary: bectl(8) manual page: mixture of singular and plural; possible excess white s...
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-bugs (Nobody)
URL: https://github.com/freebsd/freebsd-sr...
Keywords:
Depends on:
Blocks:
 
Reported: 2022-04-02 08:18 UTC by Graham Perrin
Modified: 2022-04-06 22:30 UTC (History)
2 users (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 Graham Perrin freebsd_committer freebsd_triage 2022-04-02 08:18:08 UTC 
<https://github.com/freebsd/freebsd-src/commit/c0f846ff235296249271b1235ff6a52b7d23cefb?diff=unified#diff-c02d05827bafa5f8205b59bd5e53274a6043030b432b47ffcb9bb7907bb5d5f5R395-R396>

> The other style of boot environments in use, frequently called deep boot 
> environments, organizes some or all of the boot environment …

– should probably be: 

> The other style of boot environment in use, frequently called deep boot 
> environment, organizes some or all of the boot environment …

𠄲‒ singular, not plural, in two places. 

Sorry, I should have noticed this during the review <https://reviews.freebsd.org/D34538>, but I find it difficult to read when marked up.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-04-02 08:24:18 UTC 
White space
===========


man /usr/src/sbin/bectl/bectl.8

* appears OK

man -P more 8 bectl

* here, an excess of white space before SEE ALSO
* I guess, I did something wrong, I'll try to fix this for myself. 


     …
     bectl may default to handling both styles and deprecate the various -r
     flags.






SEE ALSO
     libbe(3), beinstall.sh(8), jail(8), zfs(8), zpool(8)
…
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-04-02 08:29:45 UTC 
(In reply to Graham Perrin from comment #1)

man /usr/src/sbin/bectl/bectl.8

* appears OK

man -P more /usr/src/sbin/bectl/bectl.8

* an excess of white space before SEE ALSO
Comment 4 Kyle Evans freebsd_committer freebsd_triage 2022-04-06 03:14:37 UTC 
(In reply to Graham Perrin from comment #3)

Nope. mountpoint on BEs can do no good, it's already assumed by the kernel to be the root and you're more likely to mount over something important by accident.
Comment 5 Kyle Evans freebsd_committer freebsd_triage 2022-04-06 03:20:35 UTC 
(In reply to Graham Perrin from comment #0)

The second instance feels wrong to me, but I can't really point out why.
Comment 6 Graham Perrin freebsd_committer freebsd_triage 2022-04-06 22:30:35 UTC 
Thanks.

(In reply to Kyle Evans from comment #4)

> … mountpoint on BEs can do no good, …

Where bsdinstall sets    /    should it be improved to set    none    ?