From owner-svn-src-all@freebsd.org Wed May 23 18:43:42 2018 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 47792EAD7A3; Wed, 23 May 2018 18:43:42 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from smtp.freebsd.org (unknown [IPv6:2610:1c1:1:606c::24b:4]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "smtp.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id EBD2478C1B; Wed, 23 May 2018 18:43:41 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from ralph.baldwin.cx (ralph.baldwin.cx [66.234.199.215]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) (Authenticated sender: jhb) by smtp.freebsd.org (Postfix) with ESMTPSA id B4853A0BB; Wed, 23 May 2018 18:43:41 +0000 (UTC) (envelope-from jhb@freebsd.org) From: John Baldwin To: Eitan Adler Cc: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r334073 - head Date: Wed, 23 May 2018 09:27 -0700 Message-ID: <3609973.viVQJQYxmB@ralph.baldwin.cx> User-Agent: KMail/4.14.10 (FreeBSD/11.1-STABLE; KDE/4.14.30; amd64; ; ) In-Reply-To: <201805230409.w4N491iB057004@repo.freebsd.org> References: <201805230409.w4N491iB057004@repo.freebsd.org> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 May 2018 18:43:42 -0000 On Wednesday, May 23, 2018 04:09:01 AM Eitan Adler wrote: > Author: eadler > Date: Wed May 23 04:09:01 2018 > New Revision: 334073 > URL: https://svnweb.freebsd.org/changeset/base/334073 > > Log: > README: Reduce the textdump; describe the project > > Rework the README to make it a little easier for new users. This is the > first file many will see when persuing the FreeBSD source code so > > - remove some of the text describes how to build. This is better covered > in the linked documentation. > - add a small blurb for what FreeBSD is. Some users might find this > document through features such as github search so they may not even > know what the project is > > generally, gear this file for the new, accidental, or casual user rather > than towards someone seeking fuller documentation. > > Modified: > head/README > head/README.md > > Modified: head/README > ============================================================================== > --- head/README Wed May 23 03:41:22 2018 (r334072) > +++ head/README Wed May 23 04:09:01 2018 (r334073) > @@ -2,35 +2,25 @@ This is the top level of the FreeBSD source directory. > - > -The kernel configuration files reside in the sys//conf > -sub-directory. GENERIC is the default configuration used in release builds. > -NOTES contains entries and documentation for all possible > -devices, not just those commonly used. I do think this paragraph is still useful as part of the Source Roadmap and not really part of the build instructions. > - > - > Source Roadmap: > --------------- > > @@ -69,6 +59,8 @@ share Shared resources. > stand Boot loader sources. > > sys Kernel sources. > + > +sys//conf Kernel configuration file > > tests Regression tests which can be run by Kyua. See tests/README > for additional information. > -- John Baldwin