From 437dfd2ac21dca14a2a5d42928b7534c1be9b589 Mon Sep 17 00:00:00 2001 From: Jean Delvare Date: Fri, 9 Feb 2024 11:31:57 +0100 Subject: 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 --- quilt/setup.in | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) 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 -- cgit