Skip to content

Commit fbcfab3

Browse files
committed
Clarify difference between patches and revisions
1 parent ee36387 commit fbcfab3

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

README.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -260,8 +260,15 @@ The revised cabal file will enter the index with the timestamp provided in
260260
# Patches
261261

262262
Foliage also supports patches. Any file with `.patch` extension in
263-
`<package>/<version>/patches` will be applied as a patch to the source
264-
tarball before creating the source distribution.
263+
`<package>/<version>/patches` will be applied as a patch to the package
264+
sources.
265+
266+
Patches are applied very early in the process, and they can modify any file
267+
in the source tree. This means one could use a patch to define a new
268+
package version (by changing the version field in the cabal file).
269+
270+
Revisions are independent of patches, a patched cabal file will be subject
271+
to revisions just like the original cabal file.
265272

266273
:warning: It is not possible to "apply a timestamp" to a patch. A patch
267274
changes the content of the source distribution and the repository can only

0 commit comments

Comments
 (0)