[pkgsrc/trunk]: pkgsrc Markdownify README.

[nia <nia%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/c41d0f21dd26
branches:  trunk
changeset: 408943:c41d0f21dd26
user:      nia <nia%pkgsrc.org@localhost>
date:      Mon Jan 13 21:05:50 2020 +0000

description:
Markdownify README.

diffstat:

 README    |  24 ------------------------
 README.md |  62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 62 insertions(+), 24 deletions(-)

diffs (94 lines):

diff -r b2a670ef343d -r c41d0f21dd26 README
--- a/README    Mon Jan 13 20:52:04 2020 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,24 +0,0 @@
-$NetBSD: README,v 1.21 2019/01/29 03:11:03 gutteridge Exp $
-
-pkgsrc is a framework for building software on UNIX-like systems.
-
-To use, bootstrap using:
-    cd pkgsrc/bootstrap/
-    ./bootstrap
-
-build packages, use:
-    cd pkgsrc/category/package-name
-    $PREFIX/bin/bmake install
-
-Where $PREFIX is where you've chosen to install packages (typically /usr/pkg)
-
-Bugs and patches can be filed in the following link (use category 'pkg'):
-https://www.netbsd.org/cgi-bin/sendpr.cgi?gndb=netbsd
-
-To fetch the main CVS repository:
-    cvs -d anoncvs%anoncvs.NetBSD.org@localhost:/cvsroot checkout -P pkgsrc
-
-It's also possible to contribute through pkgsrc wip (work in progress), for
-more information, see http://pkgsrc.org/wip/users/
-
-Please see doc/pkgsrc.txt for information.
diff -r b2a670ef343d -r c41d0f21dd26 README.md
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/README.md Mon Jan 13 21:05:50 2020 +0000
@@ -0,0 +1,62 @@
+pkgsrc
+======
+
+[pkgsrc](https://pkgsrc.org) is a framework for building software for a
+variety of UNIX-like systems.
+
+It produces binary packages, which can be managed with tools such as
+[pkgin](http://pkgin.net/).
+
+Bootstrapping
+-------------
+
+To use pkgsrc on operating systems other than NetBSD, you first need to
+bootstrap:
+
+       cd pkgsrc/bootstrap
+       ./bootstrap
+
+Note that this is only for the most simple case, using pkgsrc's defaults.
+Please consult `bootstrap/README` and `bootstrap/README.OS` for detailed
+information about bootstrapping.
+
+Building packages
+-----------------
+
+       cd pkgsrc/category/package-name
+       $PREFIX/bin/bmake install
+
+Where `$PREFIX` is where you've chosen to install packages (typically`/usr/pkg`)
+
+On NetBSD, `bmake` is simply the built-in `make` tool.
+
+To build packages in bulk, tools such as `pkgtools/pbulk` and
+`pkgtools/pkg_comp` can be used.
+
+Troubleshooting
+---------------
+
+- Join the community IRC channel [#pkgsrc @ freenode](https://webchat.freenode.net/?channels=#pkgsrc).
+- Subscribe to the [pkgsrc-users](https://netbsd.org/mailinglists/#pkgsrc-users) mailing list
+- Send bugs and patches [via web form](https://www.netbsd.org/cgi-bin/sendpr.cgi?gndb=netbsd) (use the `pkg` category).
+
+Latest sources
+--------------
+
+To fetch the main CVS repository:
+
+       cvs -d anoncvs%anoncvs.NetBSD.org@localhost:/cvsroot checkout -P pkgsrc
+
+To work in the Git mirror, which is updated every few hours from CVS:
+
+       git clone https://github.com/NetBSD/pkgsrc.git
+
+Additional links
+----------------
+
+- [The pkgsrc guide](https://www.netbsd.org/docs/pkgsrc/)
+- [pkgsrc in the NetBSD Wiki](https://wiki.netbsd.org/pkgsrc/)
+- [pkgsrc.se](http://pkgsrc.se/) - a browsable index for pkgsrc packages
+- [pkgsrc-wip](https://pkgsrc.org/wip/) - a project to get more people actively involved with creating packages for pkgsrc
+- [pkgsrc on Twitter](https://twitter.com/pkgsrc)
+- [pkgsrcCon](https://pkgsrc.org/pkgsrcCon)