diff options
Diffstat (limited to 'src/librefetch')
| -rw-r--r-- | src/librefetch/librefetch.8.ronn | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/src/librefetch/librefetch.8.ronn b/src/librefetch/librefetch.8.ronn index 3ed462d..c43a575 100644 --- a/src/librefetch/librefetch.8.ronn +++ b/src/librefetch/librefetch.8.ronn @@ -76,21 +76,21 @@ whitelisted locations. ## CREATE MODE -The principle of `create` mode is that a special `PKGBUILD(5)`, called -`SRCBUILD(5)`, that installs source files to <$pkgdir>, and the -resulting "package" is then used as a source tarball. The `SRCBUILD` -exists in the same directory as the `PKGBUILD`. It can be created -manually, or generated on-the-fly from the `PKGBUILD`. Extra steps -are taken to ensure that as long as the same directory contents go in, -an identical tarball will come out--the checksum of the file should -not change based on when it is built or who builds it. +The principle of `create` mode is that a special `PKGBUILD(5)` (called +`SRCBUILD(5)`) installs source files to <$pkgdir>, and the resulting +"package" is then used as a source tarball. The `SRCBUILD` exists in +the same directory as the `PKGBUILD`. It can be created manually, or +generated on-the-fly from the `PKGBUILD`. Extra steps are taken to +ensure that as long as the same directory contents go in, an identical +tarball will come out--the checksum of the file should not change +based on when it is built or who builds it. The `SRCBUILD` is either created, or sanitized if it already exists, then fed to a modified version of `makepkg(8)`. -The purpose of the modified `makepkg` is so that the resulting tarball -doesn't contain package metadata, doesn't end with a .pkg file -extension, and always produces an identicle tarball. +The reason `makepkg` must be modified is that we need the resulting +tarball to be deterministic (as well as not containing package +metadata). When this documentation speaks of a file being modified, it is a temporary copy of the file that is modified, your original file will |