summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJean Delvare <jdelvare@suse.de>2024-02-09 11:31:57 +0100
committerJean Delvare <jdelvare@suse.de>2024-02-09 11:31:57 +0100
commit437dfd2ac21dca14a2a5d42928b7534c1be9b589 (patch)
tree65c1df42abd583ae342191c48f44ce77a1f24a2d
parentda0f5f468ad3520b40dfbad41253ec7d61d3eac4 (diff)
downloadquilt-437dfd2ac21dca14a2a5d42928b7534c1be9b589.tar.gz
setup: Improve the documentation on spec file limitations
The paragraph explaining the limitations on spec files wasn't clear to all, so reword one statement and add an example to make it hopefully clearer. Signed-off-by: Jean Delvare <jdelvare@suse.de>
-rw-r--r--quilt/setup.in8
1 files changed, 7 insertions, 1 deletions
diff --git a/quilt/setup.in b/quilt/setup.in
index 3351670..50bd003 100644
--- a/quilt/setup.in
+++ b/quilt/setup.in
@@ -291,8 +291,14 @@ The setup command is only guaranteed to work properly on spec files where
applying all the patches is the last thing done in the %%prep section. This
is a design limitation due to the fact that quilt can only operate on
patches. If other commands in the %%prep section modify the patched files,
-this must happen first, otherwise you won't be able to push the patch
+they must come first, otherwise you won't be able to push the patch
series.
+
+For example, a %%prep section where you first unpack a tarball, then
+apply patches, and lastly perform a tree-wide string substitution, is
+not OK. For \"quilt setup\" to work, it would have to be changed to
+unpacking the tarball, then performing the tree-wide string substitution,
+and lastly applying the patches.
"
exit 0
else