Details
- Reviewers
gjb wblock - Commits
- rD47054: Document USES=libarchive, libedit and localbase.
Diff Detail
- Repository
- rD FreeBSD doc repository - subversion
- Lint
Lint Not Applicable - Unit
Tests Not Applicable
Event Timeline
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml | ||
---|---|---|
770 ↗ | (On Diff #7099) | s/port/ports/ |
772 ↗ | (On Diff #7099) | "use it" is vague. Maybe: Any port that depends on archivers/libarchive must include this entry. That can probably be done better. Maybe "must include this USES= entry"? |
782 ↗ | (On Diff #7099) | Same as above, both with s/port/ports/ and the rest of the sentence. |
807 ↗ | (On Diff #7099) | I don't know what "Handles enforcing LOCALBASE" means. If I don't include this entry in a port, does that mean it is free to write outside of LOCALBASE? |
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml | ||
---|---|---|
807 ↗ | (On Diff #7099) | Ah, well, LOCALBASE is where what your dependencies are installed, not where you write things, you write things in PREFIX so it was clear for me. ? |
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml | ||
---|---|---|
808 ↗ | (On Diff #7129) | This is better. "Handles enforcing" is still a questionable term, because "handles" can be read as a noun. The actual meaning is not clear, whether this is something that helps the port author, or improves reliability of a port, or what. An example (probably wrong, but...): |
811 ↗ | (On Diff #7129) | The other thing missing here is how the porter knows when they need to add this to their port. Ports that use libraries from the XYZ port must/should/can include this option/macro to ensure that... |
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml | ||
---|---|---|
808 ↗ | (On Diff #7142) | That makes a lot more sense. It doesn't really "force" that, then, it just adjusts the path so that if they are present in LOCALBASE, they will be used in preference to the base ones. |
810 ↗ | (On Diff #7142) | Typos: |
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml | ||
---|---|---|
808 ↗ | (On Diff #7142) | Yes, it doesn't force anything, but explaining it more would mean giving away implementation details that could change while the spirit of it does not. |