Use angle brackets instead of italic to denote mandatory fields after
"freebsd/developer/" blocks. "freefall name" and "NickServ name" are
also renamed to "freefall username"` and "FreeNode account".
Reviewed by: debdrup, ygy, lwhsu
Approved by: philip (mentor)
Differential Revision: https://reviews.freebsd.org/D29285
Integreate MFC procedures into the committer's handbook. This was originally in
my freebsd-git-docs repo where it was collaberatively created. The changes here
are light edits and a conversion from markdown to asciidoc.
Contributions from: jhb@, lwhsu@, delphij@, Ceri Davies, Alexandre
Fix a number of typos. Note why one would prefer publishing a repo over
phabricator. Try to minimize use of contractions. Clarify the mysterious 'source
of truth' phrase.
Noticed by: Pau Amma (except the contractions)
Vendor branch managed belongs in the comitter guide, as it is relevant to
comitters and not to the larger community of people developing for FreeBSD,
which the developer's guide more genereal development.
It is no longer relevant to the day-to-day operations of the project. It's all
done with git now. We have the old content in the doc repo should someone need
this information in the future.
Steps 1-4 from the Committer's guide:
* Add entries for Ka Ho Ng <khng>
* Add PGP key
Reviewed by: philip
Approved by: philip (mentor)
Differential Revision: https://reviews.freebsd.org/D29282
Pull most of URLs.md from my freebsd-git-docs github repo and reformat to
asciidoc. Copy some of the existing svn info and retarget it to Git.
Submissions on github from: lwshu@, 0mp@, Alexander Richardson, Ryan Libby,
Ceri Davies, Joseph Mingrone
Feedback from: Pau Amma, emaste@
Sponsored by: Netflix, Inc
Differential Revision: https://reviews.freebsd.org/D29252
Upgrade some information about the new git procedures
in cutting-edge chapter.
Upgrade the bsd family tree to point to git instead of svn
PR: 254132
Submitted by: tech-lists (at) zyxst.net
Summary:
In [[https://svnweb.freebsd.org/ports?view=revision&revision=562203|r562203]]
and [[https://svnweb.freebsd.org/ports?view=revision&revision=562203|r562204]] the vuln.xml file was splitted by year.
As stated in the commit message, `pkg(8) audit` does not support entities and hence,
we need to use the vuln-flat.xml file to test changes to the port.
Test Plan:
* Try something like this:
```
$ pkg audit -f ./vuln.xml gitea-1.13.4
pkg: Syntax error while parsing vulnxml
pkg: cannot process vulnxml
```
and then:
```
$ pkg audit -f ./vuln-flat.xml gitea-1.13.4
0 problem(s) in 0 installed package(s) found.
```
After the patch:
* `igor` clean
* The documentation is rendered properly.
Reviewers: 0mp, gbe
Differential Revision: https://reviews.freebsd.org/D29219
doas is a viable alternative to sudo, so it is worth to be
mentioned in our handbook.
Reviewed by: 0mp (early version)
Differential Revision: https://reviews.freebsd.org/D28483
This adds an entity, betarel-current-major which refers to the
latest -STABLE
Reviewed by: gjb
Differential Revision: https://reviews.freebsd.org/D29057
We no longer have any of the "Ports collection Makefile for...." lines,
so they do not need to be explained.
Differential: https://reviews.freebsd.org/D23589
Submitted by: salvadore (based on)
Reviewed by: mat
- Add `Reported by`, `Tested by`, `Fixes`, `MFH`.
- Mention that `Submitted by` is typically not used with git.
- Add more cases to `Approved by`.
- Move `Sponsored by:` to the same place it appears in the template.
Reviewed by: debdrup
Approved by: debdrup
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D28905
Following D26075, (remove cuseeme reference in ipfirewall), give the
handbook a similar treatment.
Approved by: debdrup
Differential Revision: https://reviews.freebsd.org/D26123
The l10n chapter directs people to add things to ~/.csh.login but
testing reveals that ~/.login is the right path.
This has also been corroborated by dtrace, and the csh(1) manual page
also refers to ~/.login.
PR: 253758
The hier(7) man-page lists /usr/share as the location for
architecture-independent files, so fix a few instances where the
documentation referes to /usr/shared instead of /usr/share.
PR: 253760
Provide some guidance on good git commit messages. Based on an article
I wrote, with further editing and feedback by imp in the temporary git
docs repo.
Reviewed by: debdrup, imp
Approved by: debdrup
Differential Revision: https://reviews.freebsd.org/D28815
