summaryrefslogtreecommitdiff
path: root/src/librefetch
diff options
context:
space:
mode:
Diffstat (limited to 'src/librefetch')
-rw-r--r--src/librefetch/librefetch.8.ronn22
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