Page MenuHomeFreeBSD

Add another example to USE_GITHUB.
ClosedPublic

Authored by mat on Mar 23 2015, 1:12 PM.
Tags
None
Referenced Files
F132995571: D2118.diff
Tue, Oct 21, 10:12 PM
Unknown Object (File)
Mon, Oct 20, 2:35 PM
Unknown Object (File)
Fri, Oct 17, 1:27 AM
Unknown Object (File)
Thu, Sep 25, 7:38 PM
Unknown Object (File)
Thu, Sep 25, 7:34 PM
Unknown Object (File)
Sep 6 2025, 10:55 PM
Unknown Object (File)
Aug 9 2025, 5:48 PM
Unknown Object (File)
Aug 4 2025, 3:51 AM

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
No Lint Coverage
Unit
No Test Coverage

Event Timeline

mat retitled this revision from to Add another example to USE_GITHUB..
mat updated this object.
mat edited the test plan for this revision. (Show Details)
mat added a reviewer: Doc Committers.
mat added a subscriber: portmgr.

Me, being the king of overlong sentences with huge chains of commas, sees these things in the writing of others, but not in my own. ;-)

en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
1891

I'd stop the sentence here at the , and start a new one in order not to make the sentence too long.
The paragraph should then be like this:
From time to time ... variation from PORTREVISION. For example, if the version ...

1893

... and another stop here. The sentence goes from:
For example, if the version ... the tag is v1.0.2. In those cases, it is possible to use DISTVERSIONPREFIX or DISTVERSIONSUFFIX: ...

In D2118#4, @bcr wrote:

Me, being the king of overlong sentences with huge chains of commas, sees these things in the writing of others, but not in my own. ;-)

This is me.

Split up the first sentence.

Thanks for documenting this piece!

en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
1833

I don't believe DISTVERSIONFULL is documented anywhere. I added it to avoid duplication, but it may be overkill. Either need to define DISTVERSIONFULL in the PH or just expand it out here to {DISTVERSIONPREVIX}{DISTVERSION}{DISTVERSIONSUFFIX}

This comment has been deleted.
en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
1833

Yeah, it's not documented anywhere, I started by expanding it here, but then the last column gets a bit big, and I'm sure the pdf version will look aweful. Maybe we don't really care.

Expand DISTVERSIONFULL, it does not really exist (c)(r)

en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
1892

Add a comma after the word "example", then it is perfect (for me).

mat updated this revision to Diff 4358.

Closed by commit rD46370 (authored by @mat).