Deciphering a Porter's Handbook paragraph
Warren Block
wblock at wonkity.com
Mon Jan 2 23:06:12 UTC 2012
http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/book.html#PORTING-PREFIX
------
# make clean; make package PREFIX=/var/tmp/`make -V PORTNAME`
If anything is installed outside of PREFIX, the package creation
process will complain that it cannot find the files.
------
Okay so far.
------
This does not test for the existence of internal references, or
correct use of LOCALBASE for references to files from other ports.
------
I want to rewrite that to be more specific about what "this" refers to:
This simple test does not check for incorrect internal references
or the correct use of LOCALBASE for references to files from other
ports.
That seems a bit better. Now for the good one:
------
Testing the installation in /var/tmp/`make -V PORTNAME` to do that
while you have it installed would do that.
------
What? Testing the installation... how? Does "installation" mean
already-installed files, or does it mean the user is supposed to do an
installation? What does "that" in "to do that" refer to? What does the
last "that" refer to?
I think it may mean:
To test for those problems, run the program from the temporary
installation in /var/tmp/`make -V PORTNAME` and verify that it
operates correctly.
The complete rewritten paragraph:
This simple test does not check for incorrect internal references
or the correct use of LOCALBASE for references to files from other
ports. To test for those problems, run the program from the temporary
installation in /var/tmp/`make -V PORTNAME` and verify that it
operates correctly.
Please, someone help me encromulate this.
More information about the freebsd-doc
mailing list