CVS commit: pkgsrc

["Nia Alarie" <nia%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   nia
Date:           Mon Jan 13 21:05:50 UTC 2020

Added Files:
        pkgsrc: README.md
Removed Files:
        pkgsrc: README

Log Message:
Markdownify README.


To generate a diff of this commit:
cvs rdiff -u -r1.21 -r0 pkgsrc/README
cvs rdiff -u -r0 -r1.1 pkgsrc/README.md

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Added files:

Index: pkgsrc/README.md
diff -u /dev/null pkgsrc/README.md:1.1
--- /dev/null   Mon Jan 13 21:05:50 2020
+++ pkgsrc/README.md    Mon Jan 13 21:05:50 2020
@@ -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)