Module Name: src
Committed By: riastradh
Date: Tue Oct 23 15:44:42 UTC 2018
Modified Files:
src: README.md
Log Message:
Tidy up a bit.
- Quote the opening paragraph from netbsd.org.
- Set the suggested commands in teletype.
- Give pointers in a more active voice.
- Omit trailing whitespace.
- Mention the relation of the Git mirror to the main CVS repository.
- Use a list rather than juxtaposition for the final links.
To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/README.md
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/README.md
diff -u src/README.md:1.3 src/README.md:1.4
--- src/README.md:1.3 Mon Oct 22 08:49:00 2018
+++ src/README.md Tue Oct 23 15:44:42 2018
@@ -1,15 +1,17 @@
NetBSD
------
-NetBSD is a complete operating system.
-It supports a wide range of machines from recent aarch64 and amd64
-machines to VAX and M68k.
+NetBSD is a free, fast, secure, and highly portable Unix-like Open
+Source operating system. It is available for a [wide range of
+platforms](https://wiki.NetBSD.org/ports/), from large-scale servers
+and powerful desktop systems to handheld and embedded devices.
Building
--------
-Cross-building is possible from most UNIX-like operating systems.
-To build for amd64 (x86_64), in the src directory:
+You can cross-build NetBSD from most UNIX-like operating systems.
+To build for amd64 (x86_64), in the src directory:
+
./build.sh -U -u -j4 -m amd64 -O ~/obj release
Additional build information available in the [BUILDING](BUILDING) file.
@@ -17,32 +19,38 @@ Additional build information available i
Binaries
--------
-- [Daily builds](https://nycdn.netbsd.org/pub/NetBSD-daily/HEAD/latest/)
+- [Daily builds](https://nycdn.netbsd.org/pub/NetBSD-daily/HEAD/latest/)
- [Releases](https://cdn.netbsd.org/pub/NetBSD/)
Testing
-------
-On a running NetBSD system
+On a running NetBSD system:
+
cd /usr/tests; atf-run | atf-report
Troubleshooting
---------------
-- Bugs and patches can be sent [via web form](https://www.netbsd.org/cgi-bin/sendpr.cgi?gndb=netbsd).
-- Several [mailing lists](https://www.netbsd.org/mailinglists/) exist.
- The [netbsd-users](https://netbsd.org/mailinglists/#netbsd-users) list is a good choice for many problems.
-- A community IRC channel exist on [#netbsd @ freenode](https://webchat.freenode.net/?channels=#netbsd)
+- Send bugs and patches [via web form](https://www.netbsd.org/cgi-bin/sendpr.cgi?gndb=netbsd).
+- Subscribe to the [mailing lists](https://www.netbsd.org/mailinglists/).
+ The [netbsd-users](https://netbsd.org/mailinglists/#netbsd-users) list is a good choice for many problems; watch [current-users](https://netbsd.org/mailinglists/#current-users) if you follow the bleeding edge of NetBSD-current.
+- Join the community IRC channel [#netbsd @ freenode](https://webchat.freenode.net/?channels=#netbsd).
Latest sources
--------------
-To fetch the main CVS repository:
+To fetch the main CVS repository:
+
cvs -d anon...@anoncvs.netbsd.org:/cvsroot checkout -P src
+To work in the Git mirror, which is updated every few hours from CVS:
+
+ git clone https://github.com/NetBSD/src.git
+
Additional Links
----------------
-[The NetBSD Guide](https://www.netbsd.org/docs/guide/en/)
-[NetBSD manual pages](http://man.netbsd.org/)
-[NetBSD Cross-Reference](https://nxr.netbsd.org/)
+- [The NetBSD Guide](https://www.netbsd.org/docs/guide/en/)
+- [NetBSD manual pages](http://man.netbsd.org/)
+- [NetBSD Cross-Reference](https://nxr.netbsd.org/)
