Clarify difference between patches and revisions

This commit is contained in:
Andrea Bedini 2022-03-30 16:46:05 +08:00
parent ee36387424
commit fbcfab34e2
No known key found for this signature in database
GPG Key ID: EE8DEB94262733BE

View File

@ -260,8 +260,15 @@ The revised cabal file will enter the index with the timestamp provided in
# Patches # Patches
Foliage also supports patches. Any file with `.patch` extension in Foliage also supports patches. Any file with `.patch` extension in
`<package>/<version>/patches` will be applied as a patch to the source `<package>/<version>/patches` will be applied as a patch to the package
tarball before creating the source distribution. sources.
Patches are applied very early in the process, and they can modify any file
in the source tree. This means one could use a patch to define a new
package version (by changing the version field in the cabal file).
Revisions are independent of patches, a patched cabal file will be subject
to revisions just like the original cabal file.
:warning: It is not possible to "apply a timestamp" to a patch. A patch :warning: It is not possible to "apply a timestamp" to a patch. A patch
changes the content of the source distribution and the repository can only changes the content of the source distribution and the repository can only