It's all about the answers!

Ask a question

Delivering these changes would introduce gaps

Yehia Abo Sedera (1612) | asked Oct 04 '13, 3:55 p.m.
retagged Jun 25 '14, 2:41 p.m. by David Lafreniere (4.8k7)

I have made some changes to some files and created a new change set and marked it as "Complete" however when I try to deliver them it show me this error: "Delivering these changes would introduce gaps in the stream. You are trying to deliver a subset of the outgoing change sets but they need to be delivered together because of dependencies between them."

I am unable to resolve this error

Note: I have some completed change sets(it won't be delivered, unable to suspend or discard them for the same error ), that have the some common files with change sets to be delivered.

Jeff Care commented Oct 04 '13, 4:00 p.m.

I take it that you are trying to selectively deliver? What's the purpose of the change sets that you mentioned in your note at the end?

Those changesets are the source of your problem.

Yehia Abo Sedera commented Oct 04 '13, 4:16 p.m.

Currently I don't need them ... it is just bunch of old code that won't be delivered .. any idea how to discard them ??

Accepted answer

permanent link
Tim Mok (6.6k38) | answered Oct 04 '13, 4:49 p.m.
You can't deliver without the change sets with the old code. SCM is change set based and relies on the information in the previous change set to create a history.

If you truly don't need that code anymore, you'll have to suspend everything and recreate a new change set that doesn't depend on the change sets you didn't want to deliver.

For example:
1. Change fileA and check it in. Complete the change set and call it CS1.
2. Change fileA and check it in. Complete the change set and call it CS2.
3. Attempt to deliver CS2 and discover it will produce a gap.

To maintain a coherent history, your deliver target (ie. your stream) needs to know the state of fileA before and after your delivery. CS2 describes what happened from CS1 to the end. The gap is the part that describes how fileA got to CS1. You can fix this by suspending both CS1 and CS2 and redoing the changes made in CS2.

Take a look at the history of one of your files that exists in the change sets you want to deliver and also in the change sets that you don't want to deliver. You'll see that trying to deliver some of the change sets will create a gap in the history that is not allowed by SCM.
Yehia Abo Sedera selected this answer as the correct answer

David Lafreniere commented Jun 25 '14, 2:38 p.m.

Tim's answer is correct.

However, since this question is about gaps, I'd like to point out some new features related to gaps that were delivered after the above question was created/answered.

In RTC 4.0.5 we delivered additional support when trying to accept change sets which have a gap (often encountered when trying to backport fixes). In a very brief summary of the feature, when you accept change sets with a gap, you can now follow a gap workflow that accepts one change set at a time and, for change sets that contain gaps, creates a new change set (with aided traceability), that contains the equivalent changes. This means users will not have to accept the change sets 'as a patch'. Applying change sets as a patch has limitations compared to the new workflow (as discussed in the article below).
This feature is summarized in the RTC 4.0.5 'New & Noteworthy' page:

<continue reading my next comment below)

David Lafreniere commented Jun 25 '14, 2:38 p.m.

Below are some videos which show this feature:
-Accepting multiple change sets with gaps in the RTC 4.0.5 client for Eclipse IDE:
-Accepting a change set with a gap in the RTC 4.0.5 client for Eclipse IDE:

In RTC 5.0 we added a "fill the gap" feature where the change sets that fill the gap are shown to the user, allowing them to either accept all the change sets or to continue with the gap workflow that was available in RTC 4.0.5.
This feature is summarized in the RTC 5.0 'New & Noteworthy' page:

The classes that are involved for filling the gap include (available in RTC 5.0):
client side: IWorkspaceConnection.findChangeSetsToAcceptToFillGap(...)
server side: IScmQueryService.findChangeSetsToAcceptToFillGap(...)

Both features are explained in detail in the "Improved Gap Handling for SCM" article:

One other answer

permanent link
Jeff Care (1.0k3833) | answered Oct 04 '13, 5:13 p.m.
Are you able to suspend all the change sets? If so then you might be able to resume just the one you want, though you'll probably end up having to do it as a patch.

Your answer

Register or to post your answer.

Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.