Bug 194584 - poudriere(8) link in "Building Packages with Poudriere" doesn't point to a valid manpage
Summary: poudriere(8) link in "Building Packages with Poudriere" doesn't point to a va...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Jason Helfman
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-10-24 19:04 UTC by Enji Cooper
Modified: 2014-10-31 22:13 UTC (History)
6 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Enji Cooper freebsd_committer freebsd_triage 2014-10-24 19:04:17 UTC 
https://www.freebsd.org/doc/handbook/ports-poudriere.html points to "poudiere(8)",
which doesn't exist in the FreeBSD manpage collection.
Comment 1 John Marino freebsd_committer freebsd_triage 2014-10-31 20:15:07 UTC 
It does exist if ports-mgmt/poudriere or ports-mgmt/poudriere-devel ports are installed though.
Comment 2 Enji Cooper freebsd_committer freebsd_triage 2014-10-31 21:08:42 UTC 
(In reply to John Marino from comment #1)
> It does exist if ports-mgmt/poudriere or ports-mgmt/poudriere-devel ports
> are installed though.

Hmmm... unfortunately the doc page just points users to a link. It doesn't say that "you must install package X in order to access the documentation".

Good catch though -- thanks for the info!
Comment 3 John Marino freebsd_committer freebsd_triage 2014-10-31 21:20:11 UTC 
No problem, 
FYI, Thomas Zander has been working on an extensive update for poudriere for the handbook.  I've seen a draft but I don't know where it stands.  I'm almost positive you'd be interested in it though.  I'm adding him to CC.
Comment 4 Warren Block freebsd_committer freebsd_triage 2014-10-31 21:50:45 UTC 
The link: https://www.freebsd.org/cgi/man.cgi?query=poudriere&sektion=8

The error is because the FreeBSD web site manual page links are not updated very often.
Comment 5 Jason Helfman freebsd_committer freebsd_triage 2014-10-31 22:12:44 UTC 
Thanks for the report!
Committed revision 45897
Comment 6 commit-hook freebsd_committer freebsd_triage 2014-10-31 22:13:05 UTC 
A commit references this bug:

Author: jgh
Date: Fri Oct 31 22:12:21 UTC 2014
New revision: 45897
URL: https://svnweb.freebsd.org/changeset/doc/45897

Log:
  - address concern and point out that ports-mgmt/poudriere or
    ports-mgmt/poudriere-devel need to be installed in order
    for poudriere(8) to be available.

  PR:		194584
  Differential Revision:	https://reviews.freebsd.org/D1057
  Submitted by:	ngie
  Reviewed by:	wblock,remko
  Approved by:	wblock

Changes:
  head/en_US.ISO8859-1/books/handbook/ports/chapter.xml