Bug 237794

Summary: Porters Handbook: clarifications for 10.5. Poudriere
Product: Documentation Reporter: vladimir.chukharev
Component: Books & ArticlesAssignee: Rene Ladan <rene>
Status: Closed FIXED    
Severity: Affects Only Me CC: gerald, linimon, rene, salvadore, vsasjason, yklaxds
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   

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 freebsd_triage 2020-03-01 11:00:48 UTC 
Lorenzo, maybe something you can help with?
Comment 2 Rene Ladan freebsd_committer freebsd_triage 2020-07-11 18:31:53 UTC 
I added your suggestions to the Porters Handbook, thanks!
Comment 3 commit-hook freebsd_committer freebsd_triage 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
Comment 4 ykla 2023-03-12 13:58:10 UTC 
This issue also in poudriere-devel-3.3.99.20220831 with freebsd 13.1