[Bug 263494] beinstall.sh(8) should be in the FreeBSD Handbook

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

            Bug ID: 263494
           Summary: beinstall.sh(8) should be in the FreeBSD Handbook
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://github.com/freebsd/freebsd-doc/blob/main/docum
                    entation/content/en/books/handbook/cutting-edge/_index
                    .adoc#61-quick-start
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Documentation
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@gmail.com
                CC: dch@freebsd.org, will@FreeBSD.org

Essentially, for a run of the script without options, something like these four
steps: 

build world and kernel
pkg bootstrap
cd /usr/src
/usr/src/tools/build/beinstall.sh


Thoughts
========

Use of this FreeBSD-provided script can make a quick start even quicker, so aim
to mention it under (or not too far from)
<https://docs.freebsd.org/en/books/handbook/cutting-edge/#updating-src-quick-start>.


Source, manual pages and background
===================================

<https://github.com/freebsd/freebsd-src/blob/main/tools/build/beinstall.sh>

beinstall.sh(8) 
<https://www.freebsd.org/cgi/man.cgi?query=beinstall.sh&sektion=8&manpath=FreeBSD>

pkg(7) 
<https://www.freebsd.org/cgi/man.cgi?query=pkg&sektion=7&manpath=FreeBSD>
(section 7, not 8; in FreeBSD, not ports). 


<https://forums.freebsd.org/posts/357552> (2017) dch@ wrote: 

>  … if you build from source, there is this amazing gem … 
> Does The Right Thing - creates a boot environment, installs into it, 
> upgrades the packages in the new BE, and finally merges in any changes 
> to /etc for you. …


<https://forums.freebsd.org/posts/393634> (2018): 

> You may want to take a look on beinstall.sh. Currently it is just 
> available on -CURRENT but should work fine on 11.XR …. This basically 
> wrap sysutils/beadm and automatize the process safely. ;) …


building FreeBSD from source into a BE - HackMD
<https://hackmd.io/@dch/r1X8LNVaB> thanks to dch@

> … wrapper around Will Andrews' super-duper beinstall.sh script …

-- 
You are receiving this mail because:
You are the assignee for the bug.