Differences between revisions 7 and 10 (spanning 3 versions)
⇤ ← Revision 7 as of 2014-01-25 01:06:58 →
Size: 3409
Editor: Pierre-YvesDavid
Comment:
← Revision 10 as of 2014-01-25 01:31:17 → ⇥
Size: 4067
Editor: Pierre-YvesDavid
Comment:
Deletions are marked like this. Additions are marked like this.
Line 27: Line 27:
    x ← pruned changeset     ✕ ← pruned changeset
Line 30: Line 30:
    ◌ ← changeset that does not exist locally but are present in marker history
    ⇠ ← obsolescence marker from that point
Line 39: Line 41:
    ⇠◔ A
     |
     ● O
}}}

Marker exist from:

 * A

Command run:

 * hg push -r A
 * hg push

Expected exchange:

 * chain from A

==== A.1.2 pushing a multiple changeset into a single head ====

{{{
     ◔ B
     |
    ⇠◔ A
     |
     ● O
}}}

Marker exist from:

 * A

Command run:

 * hg push -r B
 * hg push

Expected exchange:

 * chain from A


=== A.2 Two heads ===

{{{
     ○ B
  ⇠◔ | A
   |/
   ● O
}}}

Marker exist from:

 * A

Command run:

 * hg push -r A

Expected exchange:

 * chain from A

Expected Exclude:

 * chain from B

== B. Deletion Case ==

=== B.1 Pruned changeset atop the pushed set ===

{{{
    ✕ B
    |
Line 41: Line 117:
    ●  O
}}}

Marker exist from:

 * A		     ● O
}}}

Marker exist from:

 * B (prune)
Line 55: Line 131:
 * chain from A

==== A.1.2 pushing a multiple changeset into a single head ====

{{{
    ◔ B
    |
    ◔ A
    |
    ● O
}}}

Marker exist from:

 * A

Command run:

 * hg push -r B
 * hg push

Expected exchange:

 * chain from A


=== A.2 Two heads ===

{{{
  ○ B
  | ◔ A
  |/
  ● O
}}}

Marker exist from:

 * A

Command run:

 * hg push -r A

Expected exchange:

 * chain from A

Expected Exclude:

 * chain from B

== B. Deletion Case ==

=== B.1 Pruned changeset atop the pushed set ===

{{{
    x B
    |
    ◔ A
    |
    ● O
}}}

Marker exist from:

 * B (prune)

Command run:

 * hg push -r A
 * hg push

Expected exchange:
Line 134: Line 136:
    x A     ✕ A
Line 155: Line 157:
  x C   ✕ C
Line 183: Line 185:
  x C   ✕ C
Line 209: Line 211:
  x B   ✕ B
Line 211: Line 213:
  x A   ✕ A
Line 234: Line 236:
  B x   B ✕
Line 259: Line 261:
  B x
    |
  A ø⇠◔ A'		   B ✕
    |
  A ø⇠✕ A'
Line 274: Line 276:
 * hg push -r O  * hg push -r A'
 * hg push

Expected exchange:

 * `A ø⇠✕ A'`
 * A (prune)
 * B (prune)

== D. Partial Information Case ==

From then we have changeset missing from the repo but still referenced in
obsolescence marker. This has an impact on the knowledge we have from the graph
topology.

=== D.1 Pruned changeset based on a missing precursors of something we miss ===

  B ✕
    |
  A ◌⇠◔ A'
    |/
    ● O

Marker exist from:

 * A' succeed to A
 * B (prune)

Command run:

 * hg push -r A'
Line 281: Line 313:

== D. Partial Information Case ==

List of case and expected behavior when exchanging obsolesence marker

/!\ This page is intended for developer

Contents

  1. Definition
  2. A. Simple Case
    1. A.1 pushing a single heads
      1. A.1.1 pushing a single head
      2. A.1.2 pushing a multiple changeset into a single head
    2. A.2 Two heads
  3. B. Deletion Case
    1. B.1 Pruned changeset atop the pushed set
    2. B.2 Pruned changeset on head. nothing pushed
    3. B.3 Pruned changeset on non-pushed part of the history
    4. B.4 Pruned changeset on common part of history
  4. C. Advance Case
    1. C.1 Multiple pruned changeset atop each other
    2. C.2 Pruned changeset on precursors
    3. C.3 Pruned changeset on precursors of another pruned one
  5. D. Partial Information Case
    1. D.1 Pruned changeset based on a missing precursors of something we miss

1. Definition

1. You want all markers **relevant** changeset common between source and destination to be exchanged 2. Marker **relevant to a changeset** are:

  • marker that use this changeset as successors
  • prune marker of direct children on this changeset.
  • recursive application of the two rules on successors store in those marker

?. What shall we do on partial split push… 

    ○ ← a changeset,
    ● ← a changeset that exist remotly before the push.
    ✕ ← pruned changeset
    ø ← obsolete changeset with a precursors
    ◔ ← changeset being pushed
    ◌ ← changeset that does not exist locally but are present in marker history
    ⇠ ← obsolescence marker from that point

2. A. Simple Case

2.1. A.1 pushing a single heads

2.1.1. A.1.1 pushing a single head

    ⇠◔ A
     |
     ●  O

Marker exist from:

  • A

Command run:

  • hg push -r A
  • hg push

Expected exchange:

  • chain from A

2.1.2. A.1.2 pushing a multiple changeset into a single head

     ◔ B
     |
    ⇠◔ A
     |
     ● O

Marker exist from:

  • A

Command run:

  • hg push -r B
  • hg push

Expected exchange:

  • chain from A

2.2. A.2 Two heads

     ○ B
  ⇠◔ | A
   |/
   ● O

Marker exist from:

  • A

Command run:

  • hg push -r A

Expected exchange:

  • chain from A

Expected Exclude:

  • chain from B

3. B. Deletion Case

3.1. B.1 Pruned changeset atop the pushed set

    ✕ B
    |
    ◔ A
    |
    ● O

Marker exist from:

  • B (prune)

Command run:

  • hg push -r A
  • hg push

Expected exchange:

  • prune marker for B

3.2. B.2 Pruned changeset on head. nothing pushed

    ✕ A
    |
    ● O

Marker exist from:

  • A (prune)

Command run:

  • hg push -r O
  • hg push

Expected exchange:

  • prune marker for A

3.3. B.3 Pruned changeset on non-pushed part of the history

  ✕ C
  |
  ○ B
  | ◔ A
  |/
  ● O

Marker exist from:

  • C (prune)

Command run:

  • hg push -r A
  • hg push

Expected exchange:

  • ø

Expected Exclude:

  • chain from B

3.4. B.4 Pruned changeset on common part of history

  ✕ C
  | ● B
  | |
  | ● A
  |/
  ● O

Marker exist from:

  • C (prune)

Command run:

  • hg push -r B
  • hg push

Expected exchange:

  • prune for C

4. C. Advance Case

4.1. C.1 Multiple pruned changeset atop each other

  ✕ B
  |
  ✕ A
  |
  ● O

Marker exist from:

  • A (prune)
  • B (prune)

Command run:

  • hg push -r O
  • hg push

Expected exchange:

  • A (prune)
  • B (prune)

4.2. C.2 Pruned changeset on precursors

  B ✕
    |
  A ø⇠◔ A'
    |/
    ● O

Marker exist from:

  • A' succeed to A
  • B (prune)

Command run:

  • hg push -r A'
  • hg push

Expected exchange:

  • A ø⇠o A'

  • B (prune)

4.3. C.3 Pruned changeset on precursors of another pruned one

  B ✕
    |
  A ø⇠✕ A'
    |/
    ● O

Marker exist from:

  • A' succeed to A
  • A' (prune
  • B (prune)

Command run:

  • hg push -r A'
  • hg push

Expected exchange:

  • A ø⇠✕ A'

  • A (prune)
  • B (prune)

5. D. Partial Information Case

From then we have changeset missing from the repo but still referenced in obsolescence marker. This has an impact on the knowledge we have from the graph topology.

5.1. D.1 Pruned changeset based on a missing precursors of something we miss

  • B ✕
    • |
    A ◌⇠◔ A'
    • |/ ● O

Marker exist from:

  • A' succeed to A
  • B (prune)

Command run:

  • hg push -r A'
  • hg push

Expected exchange:

  • A ø⇠o A'

  • B (prune)

CEDObsmarkersExchange (last edited 2018-03-04 20:25:36 by BorisFeld)