Bug 237794 - Porters Handbook: clarifications for 10.5. Poudriere
Summary: Porters Handbook: clarifications for 10.5. Poudriere
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Rene Ladan
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-05-08 09:36 UTC by vladimir.chukharev
Modified: 2020-07-11 18:32 UTC (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description vladimir.chukharev 2019-05-08 09:36:12 UTC
Two clarifications are needed in section '10.5. Poudriere' of the Porters Handbook.

1. Poudriere does not creates a directory DISTFILES_CACHE if does not exist, see https://github.com/freebsd/poudriere/issues/285
I suggest to add at the end of DISTFILES_CACHE description (in "10.5.2. Setting Up Poudriere") something like the following.
You might need to create the directory manually if poudriere complains that it does not exist.

2. There are changes in how to use manually managed ports, see https://github.com/freebsd/poudriere/wiki/use_system_ports_tree . I think, this is to be reflected in '10.5.6. Using Manually Managed Ports Trees with Poudriere'.
(I did not use the new method myself. I made a symlink before I found the description, but I cannot recommend doing that...)
Comment 1 Gerald Pfeifer freebsd_committer 2020-03-01 11:00:48 UTC
Lorenzo, maybe something you can help with?
Comment 2 Rene Ladan freebsd_committer 2020-07-11 18:31:53 UTC
I added your suggestions to the Porters Handbook, thanks!
Comment 3 commit-hook freebsd_committer 2020-07-11 18:32:13 UTC
A commit references this bug:

Author: rene
Date: Sat Jul 11 18:31:26 UTC 2020
New revision: 54331
URL: https://svnweb.freebsd.org/changeset/doc/54331

Log:
  Porters Handbook: add some clarifications for Poudreire:

  - add a hint to create the distfiles directory if it does not already exist
  - add the new-style syntax to use a custom ports tree

  PR:		237794
  Submitted by:	vladimir.chukharev@gmail.com
  Event:		July 2020 Bugathon

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