Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

MFC r266416:
------------------------------------------------------------------------
r266416 | bjk | 2014-05-18 17:05:54 -0400 (Sun, 18 May 2014) | 14 lines

Document some user-settable make variables in ports.7

This is not a comprehensive list, as the variables themselves are spread
out over multiple files, but it is a start.

Add a section to make.conf noting that variables may be set there that
affect ports builds, but refer to ports.7 and elsewhere for the actual
listing; any listing in make.conf.5 would likely become out of date
fairly quickly.

PR: docs/189199
Reviewed by: bdrewery (previous version)
Approved by: hrs (mentor)

------------------------------------------------------------------------

PR: 189199
Approved by: hrs (mentor)

MFC r267160:
Dereference portaudit(1), as it is now deprecated and its
functionality exists in pkg-audit(8).

Sponsored by: The FreeBSD Foundation

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Ports switched from dialog to dialog4ports some time ago.

PR: docs/179785
Repored by: Kevin Oberman <rkoberman@gmail.com>
Submitted by: "Ilya A. Arkhipov" <rum1cro@yandex.ru>
MFC After: 3 days

Modernize some portions of the ports man page.
Stop documenting other operating systems's default patha

Approved by: bcr (mentor)

Modernize parts of the ports.7 manual page.

Approved by: bcr (mentor)
MFC after: 3 days

Fix date from r231111.

Pointy-hat to: gjb (myself, approver of r231111)

ports(7) currently makes no mention of LOCALBASE: fix that

PR: docs/159551
Submitted by: Matthew Seaman <m.seaman@infracaninophile.co.uk>
Approved by: gjb
MFC after: 3 days

Add a short description about NO_CHECKSUM.

PR: docs/155980
Submitted by KOIE Hidetaka (koie at suri co jp)
MFC after: 7 days

Add a description to the checksum target about not only
being able to verify, but also having the ability to
fetch distfiles that are missing or failed the checksum
calculation

PR: docs/138887
Submitted by: Radim Kolar (hsn at sendmail dot cz)
MFC after: 5 days

Document TRYBROKEN in ports(7).

PR: docs/153542
Submitted by: Eitan Adler <lists@eitanadler.com>
MFC after: 3 days

- Document targets run-depends-list and build-depends-list

PR: docs/127575
Submitted by: Walter Venable <walt relnor.com>
Approved by: keramida
MFC after: 3 days

Correct a typo.

The config-recursive target is not run during the normal install process, move
it down to where it belongs.

Document 'all-depends-list' target and bump doc date.

PR: 119519
Submitted by: Yuri Pankov <yuri.pankov@gmail.com>
Reviewed by: flz

Document the 'maintainer' target.

PR: 119699
Submitted by: Warren Block <wblock@wonkity.com>
MFC after: 3 days

- Remove incomplete sentence fragment

PR: docs/117451
Submitted by: Warren Block <wblock@wonkity.com>
MFC after: 3 days

- Document PORT_DBDIR

PR: docs/114731
Submitted by: Matthew Seaman <m.seaman@infracaninophile.co.uk>

- Document icase variable of make search, which can be used to control
case-sensitivity

PR: docs/117593
Submitted by: Nikolay Bachiyski <nbachiyski@developer.bg>

- Fix origin of the portcheckout port as we have it in the port-mgmt
category now

PR: docs/115193
Submitted by: Tomas Mozes <hydrapolic at gmail dot com>
Approved by: re (bmah),
keramida (mentor)
MFC after: 0 days

Stop mentioning /usr/X11R6.

Approved by: re (hrs)

- Update portaudit location

Submitted by: Dominique Goncalves <dominique.goncalves@gmail.com>
MFC after: 3 days
Approved by: re (hrs)

Remove reference to a man page of pib, an obscure third-party tool, whose port
does not install any manpages.

MFC after: 3 days

Reduce our pointy-hat pool capacity by one (i.e. bump manpage date,
after the last change to this manpage).

Reminded by: ru

Document NO_IGNORE and its interation with FORBIDDEN.

Triggered by: a question by Panagiotis Hadgis <hadgis@ceid.upatras.gr>

o Document 'make quicksearch'.

PR: docs/103162
Submitted by: Lars Engels
MFC after: 1 week

- Document RANDOMIZE_MASTER_SITES, MASTER_SORT
- Remove OPTIONS, it's no user settable variable

- Document new missing target

Document config-recursive target.

PR: docs/82586
Submitted by: Imobach González Sosa <imobachgs@banot.net>
Approved by: trhodes (mentor)
MFC after: 1 week

- Remove MLINKS to nonexistant manpages
- Change some section numbers to match reality
- For MLINKS to manpages from ports, mention which port installs them

MFC after: 3 days

Introduce three new targets for ports collection:
showconfig-recursive, rmconfig-recursive and config-conditional.

MFC after: 3 days

Sort sections.

Introduce new variables FETCHINDEX, MASTER_SITE_INDEX and add
description for MASTER_SITE_BACKUP.

Based on PR: ports/74709
Submitted by: Valentin Nechayev <netch@netch.kiev.ua>
Reviewed by: ru
MFC after: 3 days

- Fix typo in portaudit reference.
- Bump document date for last commit.

Pointed out by: ceri, ru
Pointy hat to: simon

- Document the DISABLE_VULNERABILITIES knob.
- Don't say this manual page is too long, it's not that long.
- s/man page/manual page/g

MFC after: 3 days

Add descriptions for new path, info, maint, cat, bdeps, and
rdeps variables and some new examples for "make search".

Approved by: josef (mentor)
MFC after: 2 days

- Remove leading zero from document date [1]
- Remove entry which tells about periodical INDEX updates in
the CVS repository
- Add description for fetchindex target

Requested by: ru [1]
Approved by: josef (mentor)

- Bump the document date

Requested by: ru
Approved by: ru, josef (mentor)

- Mention new targets from bsd.port.mk:
* config
* showconfig
* rmconfig
* describe
- Add OPTIONS description
- Word smithing

PR: docs/67342
Reviewed by: ru
Approved by: josef (mentor)

Correct the on-disc path to the porters-handbook

Document the 'fetch-recursive-list' and 'deinstall-all' targets.

No MFC reminder, I'll sync this page with the one in -stable in
a couple of days.

PR: docs/46181
Patch submitted by: Sergey Matveychuk <sem@ciam.ru>

Add the 'package-recursive' option

PR: 57838
Submitted by: Alexander Haderer <alexander.haderer@charite.de>
MFC after: 5 days

asami is no longer our ports lead, so remove a statement saying
the ports collection is maintained by asami and the ports team.

MASTER_SITE_OVERRIDE can list several sites.

Packages have been in .tbz format for some time now, thus s/tgz/tbz/

X-MFC after: re-approval

mdoc(7) police: Deal with self-xrefs.

Add description of fetch-recursive target.

Refer to doc/en_US.ISO8859-1 for documentation.

Correct links to Handbook's pages, old URLs does not work anymore.

MFC after: 1 week

mdoc(7) police: tidy up.

Point readers to the Porter's Handbook instead of the non-existant
"Porting Applications" section of the FreeBSD Handbook.

MFC After: 2 days

mdoc(7) police: s/BSD/.Bx/ where appropriate.

mdoc(7) police: s/NetBSD/.Nx/ where appropriate.

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

mdoc(7) police: removed HISTORY info from the .Os call.

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

Remove duplicate words.

Reword a few things and document the `search' and `index' make targets.

PR: 26690
Submitted by: Pete Fritchman <petef@databits.net>

Prepare for mdoc(7)NG.

mdoc(7) police: removed history info from the .Os FreeBSD call.

mdoc(7) police: do not split author names in the AUTHORS section.

Use Fx macro wherever possible.

.Xr pkg_version 1

$Id$ -> $FreeBSD$

The "depends-list" target disappeared in r.1.300 (Dec. 12, 1998) of
bsd.port.mk. Replace its occurrence in this file with a synonym.

PR: docs/13255

Various man page cleanup:

- Sort xrefs
- FreeBSD.ORG -> FreeBSD.org
- Be consistent with section names as outlined in mdoc(7).
- Other misc mdoc cleanup.

PR: doc/13144
Submitted by: Alexey M. Zelkin <phantom@cris.net>

Add portlint(1) and sort "SEE ALSO"'s.

- FreeBSD.ORG => FreeBSD.org

- Don't discourage people from using "make readmes"

- Document WRKDIRPREFIX.

Missed a ref to /usr/share/mk/bsd.port.mk

The bsd.port.mk has moved.

-make clear need to use the upgrade kit
-add "depends" to list of recursive targets
-consistent capitilization of FreeBSD.ORG
-remove description of PATCH_DEBUG
-add .Xr to portcheckout(1) and pib(1)

SEE ALSO http://www.FreeBSD.ORG/ports

Grammar touch-up.

.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs.
Use .An/.Aq.

Change documentation for `make package' (Thanks (indirectly) O'Brien!).

Document `make readmes'. This is getting old, and the intent is to
stop questions regarding it; however, I have a suspicion documenting it
will work counter to ending questions about it and am mentally prepared
to see it go-ooooooooo.......

Fill-in and fill-out a little.
Correct a small misfact. :)

Get the year right. ;)

Explains targets and environ vars much better.

Mostly submitted by: imp

Add an introductory manpage for the ports system.