platform-ui-home/R3_1/undo-redo-proposal/undo-redo support.html

Parent Directory | Revision Log | Patch

-revision 1.3, Mon Dec 20 21:55:06 2004 UTC
+revision 1.4, Mon Dec 20 22:54:58 2004 UTC
 Line 17
   <o:DocumentProperties>
    <o:Author>IBM_USER</o:Author>
    <o:LastAuthor>IBM_USER</o:LastAuthor>
-   <o:Revision>7</o:Revision>
+   <o:Revision>8</o:Revision>
-   <o:TotalTime>4518</o:TotalTime>
+   <o:TotalTime>4519</o:TotalTime>
    <o:LastPrinted>2004-11-08T17:14:00Z</o:LastPrinted>
    <o:Created>2004-12-20T21:30:00Z</o:Created>
-   <o:LastSaved>2004-12-20T21:50:00Z</o:LastSaved>
+   <o:LastSaved>2004-12-20T22:54:00Z</o:LastSaved>
    <o:Pages>1</o:Pages>
    <o:Words>6341</o:Words>
    <o:Characters>36147</o:Characters>
 Line 33
   </o:DocumentProperties>
  </xml><![endif]--><!--[if gte mso 9]><xml>
   <w:WordDocument>
+   <w:SpellingState>Clean</w:SpellingState>
+   <w:GrammarState>Clean</w:GrammarState>
    <w:Compatibility>
     <w:BreakWrappedTables/>
     <w:SnapToGridInCell/>
-Line 165
+Line 167
          font-size:10.0pt;
          font-family:"Courier New";
          mso-fareast-font-family:"Times New Roman";}
+ span.SpellE
+         {mso-style-name:"";
+         mso-spl-e:yes;}
+ span.GramE
+         {mso-style-name:"";
+         mso-gram-e:yes;}
  @page Section1
          {size:8.5in 11.0in;
          margin:1.0in .75in .5in 1.0in;
-Line 175
+Line 183
          {page:Section1;}
   /* List Definitions */
   @list l0
-         {mso-list-id:306130254;
-         mso-list-template-ids:-1505884488;}
- @list l0:level1
-         {mso-level-number-format:bullet;
-         mso-level-text:\F0B7;
-         mso-level-tab-stop:.5in;
-         mso-level-number-position:left;
-         text-indent:-.25in;
-         mso-ansi-font-size:10.0pt;
-         font-family:Symbol;}
- @list l1
-         {mso-list-id:322004125;
-         mso-list-template-ids:933166844;}
- @list l2
          {mso-list-id:347761159;
          mso-list-type:hybrid;
          mso-list-template-ids:-1680017606 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
- @list l2:level1
+ @list l0:level1
          {mso-level-number-format:bullet;
          mso-level-text:\F0B7;
          mso-level-tab-stop:.5in;
          mso-level-number-position:left;
          text-indent:-.25in;
          font-family:Symbol;}
- @list l2:level2
+ @list l0:level2
          {mso-level-tab-stop:1.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l2:level3
+ @list l0:level3
          {mso-level-tab-stop:1.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l2:level4
+ @list l0:level4
          {mso-level-tab-stop:2.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l2:level5
+ @list l0:level5
          {mso-level-tab-stop:2.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l2:level6
+ @list l0:level6
          {mso-level-tab-stop:3.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l2:level7
+ @list l0:level7
          {mso-level-tab-stop:3.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l2:level8
+ @list l0:level8
          {mso-level-tab-stop:4.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l2:level9
+ @list l0:level9
          {mso-level-tab-stop:4.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l3
+ @list l1
+         {mso-list-id:364596818;
+         mso-list-template-ids:-488625314;}
+ @list l1:level1
+         {mso-level-number-format:bullet;
+         mso-level-text:\F0B7;
+         mso-level-tab-stop:.5in;
+         mso-level-number-position:left;
+         text-indent:-.25in;
+         mso-ansi-font-size:10.0pt;
+         font-family:Symbol;}
+ @list l2
          {mso-list-id:604456885;
          mso-list-type:hybrid;
          mso-list-template-ids:1734899956 67698703 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
- @list l3:level1
+ @list l2:level1
          {mso-level-tab-stop:.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l3:level2
+ @list l2:level2
          {mso-level-number-format:bullet;
          mso-level-text:o;
          mso-level-tab-stop:1.0in;
          mso-level-number-position:left;
          text-indent:-.25in;
          font-family:"Courier New";}
- @list l3:level3
+ @list l2:level3
          {mso-level-number-format:bullet;
          mso-level-text:\F0A7;
          mso-level-tab-stop:1.5in;
          mso-level-number-position:left;
          text-indent:-.25in;
          font-family:Wingdings;}
- @list l3:level4
+ @list l2:level4
          {mso-level-number-format:bullet;
          mso-level-text:\F0B7;
          mso-level-tab-stop:2.0in;
          mso-level-number-position:left;
          text-indent:-.25in;
          font-family:Symbol;}
- @list l3:level5
+ @list l2:level5
          {mso-level-tab-stop:2.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l3:level6
+ @list l2:level6
          {mso-level-tab-stop:3.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l3:level7
+ @list l2:level7
          {mso-level-tab-stop:3.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l3:level8
+ @list l2:level8
          {mso-level-tab-stop:4.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l3:level9
+ @list l2:level9
          {mso-level-tab-stop:4.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4
+ @list l3
          {mso-list-id:798038152;
          mso-list-type:hybrid;
          mso-list-template-ids:-2087438622 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
- @list l4:level1
+ @list l3:level1
          {mso-level-tab-stop:39.0pt;
          mso-level-number-position:left;
          margin-left:39.0pt;
          text-indent:-.25in;}
- @list l4:level2
+ @list l3:level2
          {mso-level-tab-stop:1.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4:level3
+ @list l3:level3
          {mso-level-tab-stop:1.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4:level4
+ @list l3:level4
          {mso-level-tab-stop:2.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4:level5
+ @list l3:level5
          {mso-level-tab-stop:2.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4:level6
+ @list l3:level6
          {mso-level-tab-stop:3.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4:level7
+ @list l3:level7
          {mso-level-tab-stop:3.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4:level8
+ @list l3:level8
          {mso-level-tab-stop:4.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l4:level9
+ @list l3:level9
          {mso-level-tab-stop:4.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5
+ @list l4
          {mso-list-id:1085106306;
          mso-list-type:hybrid;
          mso-list-template-ids:1015583604 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
- @list l5:level1
+ @list l4:level1
          {mso-level-tab-stop:.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level2
+ @list l4:level2
          {mso-level-tab-stop:1.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level3
+ @list l4:level3
          {mso-level-tab-stop:1.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level4
+ @list l4:level4
          {mso-level-tab-stop:2.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level5
+ @list l4:level5
          {mso-level-tab-stop:2.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level6
+ @list l4:level6
          {mso-level-tab-stop:3.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level7
+ @list l4:level7
          {mso-level-tab-stop:3.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level8
+ @list l4:level8
          {mso-level-tab-stop:4.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l5:level9
+ @list l4:level9
          {mso-level-tab-stop:4.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
+ @list l5
+         {mso-list-id:1167818358;
+         mso-list-template-ids:-1827253532;}
  @list l6
+         {mso-list-id:1292246357;
+         mso-list-template-ids:24384264;}
+ @list l7
          {mso-list-id:1478297229;
          mso-list-type:hybrid;
          mso-list-template-ids:-438127954 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
- @list l6:level1
+ @list l7:level1
          {mso-level-number-format:bullet;
          mso-level-text:\F0B7;
          mso-level-tab-stop:.5in;
          mso-level-number-position:left;
          text-indent:-.25in;
          font-family:Symbol;}
- @list l6:level2
+ @list l7:level2
          {mso-level-tab-stop:1.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l6:level3
+ @list l7:level3
          {mso-level-tab-stop:1.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l6:level4
+ @list l7:level4
          {mso-level-tab-stop:2.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l6:level5
+ @list l7:level5
          {mso-level-tab-stop:2.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l6:level6
+ @list l7:level6
          {mso-level-tab-stop:3.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l6:level7
+ @list l7:level7
          {mso-level-tab-stop:3.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l6:level8
+ @list l7:level8
          {mso-level-tab-stop:4.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l6:level9
+ @list l7:level9
          {mso-level-tab-stop:4.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l7
-         {mso-list-id:1644238654;
-         mso-list-template-ids:-1891084734;}
  @list l8
+         {mso-list-id:1631007561;
+         mso-list-template-ids:1365561448;}
+ @list l8:level1
+         {mso-level-number-format:bullet;
+         mso-level-text:\F0B7;
+         mso-level-tab-stop:.5in;
+         mso-level-number-position:left;
+         text-indent:-.25in;
+         mso-ansi-font-size:10.0pt;
+         font-family:Symbol;}
+ @list l9
          {mso-list-id:1723091313;
          mso-list-type:hybrid;
          mso-list-template-ids:-1797201838 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
- @list l8:level1
+ @list l9:level1
          {mso-level-tab-stop:.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level2
+ @list l9:level2
          {mso-level-tab-stop:1.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level3
+ @list l9:level3
          {mso-level-tab-stop:1.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level4
+ @list l9:level4
          {mso-level-tab-stop:2.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level5
+ @list l9:level5
          {mso-level-tab-stop:2.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level6
+ @list l9:level6
          {mso-level-tab-stop:3.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level7
+ @list l9:level7
          {mso-level-tab-stop:3.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level8
+ @list l9:level8
          {mso-level-tab-stop:4.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l8:level9
+ @list l9:level9
          {mso-level-tab-stop:4.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9
+ @list l10
          {mso-list-id:1731031428;
          mso-list-type:hybrid;
          mso-list-template-ids:1886447558 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
- @list l9:level1
+ @list l10:level1
          {mso-level-tab-stop:39.0pt;
          mso-level-number-position:left;
          margin-left:39.0pt;
          text-indent:-.25in;}
- @list l9:level2
+ @list l10:level2
          {mso-level-tab-stop:1.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9:level3
+ @list l10:level3
          {mso-level-tab-stop:1.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9:level4
+ @list l10:level4
          {mso-level-tab-stop:2.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9:level5
+ @list l10:level5
          {mso-level-tab-stop:2.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9:level6
+ @list l10:level6
          {mso-level-tab-stop:3.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9:level7
+ @list l10:level7
          {mso-level-tab-stop:3.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9:level8
+ @list l10:level8
          {mso-level-tab-stop:4.0in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l9:level9
+ @list l10:level9
          {mso-level-tab-stop:4.5in;
          mso-level-number-position:left;
          text-indent:-.25in;}
- @list l10
-         {mso-list-id:1830093817;
-         mso-list-template-ids:672403872;}
  @list l11
-         {mso-list-id:1943487606;
+         {mso-list-id:1917208525;
-         mso-list-template-ids:1313531012;}
+         mso-list-template-ids:2040176132;}
- @list l11:level1
-         {mso-level-number-format:bullet;
-         mso-level-text:\F0B7;
-         mso-level-tab-stop:.5in;
-         mso-level-number-position:left;
-         text-indent:-.25in;
-         mso-ansi-font-size:10.0pt;
-         font-family:Symbol;}
  ol
          {margin-bottom:0in;}
  ul
-Line 534
+Line 542
  <h1>Generalized Undo Support in Eclipse</h1>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Last
- updated:<span style='mso-spacerun:yes'>� </span></span><st1:date Month="12"
+ updated:<span style='mso-spacerun:yes'>� </span></span><st1:date Year="2004"
- Day="17" Year="2004"><span style='font-size:10.0pt;font-family:Arial'>Dec. 17,
+ Day="17" Month="12"><span style='font-size:10.0pt;font-family:Arial'>Dec. 17,
 </span></st1:date><span style='font-size:10.0pt;font-family:Arial'><o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Status:<span
  style='mso-spacerun:yes'>� </span>Proposal <o:p></o:p></span></p>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>(see also </span><a
+ <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>(<span
+ class=GramE>see</span> also </span><a
  href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=37716">37716</a>)<span
  style='font-size:10.0pt;font-family:Arial'><o:p></o:p></span></p>
  <h2>Problem Description</h2>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>In R3.0.1
+ <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>In R3.0.1 of
- of the Eclipse SDK, there is no generalized support for undoing user
+ the Eclipse SDK, there is no generalized support for undoing user actions.<span
- actions.<span style='mso-spacerun:yes'>� </span>Each plug-in is left to
+ style='mso-spacerun:yes'>� </span>Each plug-in is left to implement its own
- implement its own strategy for undo, if at all.<span style='mso-spacerun:yes'>�
+ strategy for undo, if at all.<span style='mso-spacerun:yes'>� </span>This
- </span>This approach can cause problems for both Eclipse users and plug-in
+ approach can cause problems for both Eclipse users and plug-in developers:<o:p></o:p></span></p>
- developers:<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><span
  style='mso-spacerun:yes'>�</span><o:p></o:p></span></p>
  <ul style='margin-top:0in' type=disc>
-  <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l0 level1 lfo3;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>Undo and redo actions appear in
       different menus, causing user confusion and UI clutter<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l0 level1 lfo3;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>Undo and redo implementations
       may have different semantics.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l0 level1 lfo3;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>Plug-ins that depend on other
       plug-ins which implement their own undo strategy are forced to choose
       between different implementations and possibly write integration code to
-Line 589
+Line 597
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>The
  proposed framework defines an interface for describing work, called an
- �operation� (IOperation), that can be executed, undone, and redone.<span
+ �operation� (<span class=SpellE>IOperation</span>), that can be executed,
- style='mso-spacerun:yes'>� </span>Operations are created, executed, and added
+ undone, and redone.<span style='mso-spacerun:yes'>� </span>Operations are
- to an operations history (IOperationHistory).<span style='mso-spacerun:yes'>�
+ created, executed, and added to an operations history (<span class=SpellE>IOperationHistory</span>).<span
- </span>Operations which are comprised of distinct steps are represented as
+ style='mso-spacerun:yes'>� </span>Operations which are comprised of distinct
- compound operations.<span style='mso-spacerun:yes'>� </span>Compound operations
+ steps are represented as compound operations.<span style='mso-spacerun:yes'>�
- must be executed, undone, or redone as a unit, and can never be partially
+ </span>Compound operations must be executed, undone, or redone as a unit, and
- undone.<span style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
+ can never be partially undone.<span style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Operations
- can be assigned one or more contexts (IOperationContext) to which they
+ can be assigned one or more contexts (<span class=SpellE>IOperationContext</span>)
- apply.<span style='mso-spacerun:yes'>� </span>An operation<span
+ to which they apply.<span style='mso-spacerun:yes'>� </span>An operation<span
  style='mso-spacerun:yes'>� </span>context describes the context in which the
  user is working when an operation is performed, undone, or redone.<span
  style='mso-spacerun:yes'>� </span>Contexts can be used by workbench parts to
-Line 628
+Line 636
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l9 level1 lfo5;
+ <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l10 level1 lfo5;
  tab-stops:list 39.0pt'><![if !supportLists]><span style='font-size:10.0pt;
  font-family:Arial;mso-fareast-font-family:Arial'><span style='mso-list:Ignore'>1.<span
  style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
-Line 638
+Line 646
  the editor can assign its context to the operation before adding it to the
  history.<span style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l9 level1 lfo5;
+ <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l10 level1 lfo5;
  tab-stops:list 39.0pt'><![if !supportLists]><span style='font-size:10.0pt;
  font-family:Arial;mso-fareast-font-family:Arial'><span style='mso-list:Ignore'>2.<span
  style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
-Line 676
+Line 684
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
  <ol style='margin-top:0in' start=1 type=1>
-  <li class=MsoNormal style='mso-list:l8 level1 lfo8;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l9 level1 lfo8;tab-stops:list .5in'><span
-      style='font-size:10.0pt;font-family:Arial'>Existing command/undo
+      style='font-size:10.0pt;font-family:Arial'>Existing command/undo frameworks
-      frameworks can implement the IOperation interface on their existing
+      can implement the <span class=SpellE>IOperation</span> interface on their
-      command objects, while still maintaining their individual strategies for
+      existing command objects, while still maintaining their individual
-      managing undo stacks or histories.<span style='mso-spacerun:yes'>�
+      strategies for managing undo stacks or histories.<span
-      </span>If there is a substantial investment in an existing model-based
+      style='mso-spacerun:yes'>� </span>If there is a substantial investment in
-      operation or command framework, wrappers could be used to map IOperation
+      an existing model-based operation or command framework, wrappers could be
-      protocol to the existing protocol.<span style='mso-spacerun:yes'>�
+      used to map <span class=SpellE>IOperation</span> protocol to the existing
-      </span>The commands/operations need not be assigned a context or added to
+      protocol.<span style='mso-spacerun:yes'>� </span>The commands/operations
-      a common operation history.<span style='mso-spacerun:yes'>� </span>This
+      need not be assigned a context or added to a common operation
-      level of integration allows command hierarchies built in different
+      history.<span style='mso-spacerun:yes'>� </span>This level of integration
-      frameworks to be treated the same by plug-ins that depend upon these different
+      allows command hierarchies built in different frameworks to be treated the
-      frameworks.<span style='mso-spacerun:yes'>� </span>Clients of existing
+      same by plug-ins that depend upon these different frameworks.<span
-      command frameworks may then use the workbench operation history, assign
+      style='mso-spacerun:yes'>� </span>Clients of existing command frameworks
-      contexts to operations as needed, and even add operations to the history,
+      may then use the workbench operation history, assign contexts to
-      while still using commands built on earlier frameworks.<o:p></o:p></span></li>
+      operations as needed, and even add operations to the history, while still
-  <li class=MsoNormal style='mso-list:l8 level1 lfo8;tab-stops:list .5in'><span
+      using commands built on earlier frameworks.<o:p></o:p></span></li>
+  <li class=MsoNormal style='mso-list:l9 level1 lfo8;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>Existing command/undo
       frameworks may use the listener interfaces provided by the operations
       history to listen for operations that are of interest.<span
-Line 702
+Line 711
       integration allows views and editors to appear more tightly integrated
       with the operations framework, since workbench operations of interest can
       be undone or redone from private undo implementations.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l8 level1 lfo8;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l9 level1 lfo8;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>Full integration is achieved by
       using the workbench operation history to record the undo and redo history
       as operations occur.<span style='mso-spacerun:yes'>� </span>Once all
-Line 714
+Line 723
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Framework
- interfaces will be defined in the org.eclipse.core.operations package.<span
+ interfaces will be defined in the <span class=SpellE>org.eclipse.core.operations</span>
- style='mso-spacerun:yes'>� </span>This package will be contained in a plug-in
+ package.<span style='mso-spacerun:yes'>� </span>This package will be contained
- that has no dependencies on the Eclipse runtime, so that raw JFace users may
+ in a plug-in that has no dependencies on the Eclipse runtime, so that raw <span
- make use of it.<span style='mso-spacerun:yes'>� </span>(The exact plug-in
+ class=SpellE>JFace</span> users may make use of it.<span
- containing the framework package is not defined at this time, as these packages
+ style='mso-spacerun:yes'>� </span>(The exact plug-in containing the framework
- may be combined with other packages that provide similar headless
+ package is not defined at this time, as these packages may be combined with
- infrastructure.)<o:p></o:p></span></p>
+ other packages that provide similar headless infrastructure.)<o:p></o:p></span></p>
  <h2>Framework interfaces</h2>
- <h3>IOperation</h3>
+ <h3><span class=SpellE>IOperation</span></h3>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>IOperation
+ <p class=MsoNormal><span class=SpellE><span style='font-size:10.0pt;font-family:
+ Arial'>IOperation</span></span><span style='font-size:10.0pt;font-family:Arial'>
  defines an operation that can be executed, undone, and redone.<span
- style='mso-spacerun:yes'>� </span>Operations typically have fully defined parameters.
+ style='mso-spacerun:yes'>� </span>Operations typically have fully defined
- That is, they are usually created after the user has been queried for any input
+ parameters. That is, they are usually created after the user has been queried
- needed to define the operation.<o:p></o:p></span></p>
+ for any input needed to define the operation.<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
-Line 742
+Line 752
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <pre>public void addContext(IOperationContext context)</pre>
+ <pre>public void <span class=SpellE>addContext</span>(<span class=SpellE>IOperationContext</span> context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Add
  the specified context to the operation. If the context is already present, do
-Line 754
+Line 764
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>context</span></code><span
  style='font-size:10.0pt'> - - the context to be added<o:p></o:p></span></p>
- <pre><a name="removeContext(org.eclipse.core.operation"></a>public void removeContext(IOperationContext context)</pre>
+ <pre><a name="removeContext(org.eclipse.core.operation"></a>public void <span
+ class=SpellE>removeContext</span>(<span class=SpellE>IOperationContext</span> context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Remove
  the specified context from the operation. This method has no effect if the
-Line 766
+Line 777
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>context</span></code><span
  style='font-size:10.0pt'> - - the context to be removed<o:p></o:p></span></p>
- <pre><a name="hasContext(org.eclipse.core.operations.I"></a>public boolean <b>hasContext</b>(IOperationContext context)</pre>
+ <pre><a name="hasContext(org.eclipse.core.operations.I"></a>public <span
+ class=SpellE>boolean</span> <span class=SpellE><b>hasContext</b></span>(<span
+ class=SpellE>IOperationContext</span> context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether the operation has the specified context. <o:p></o:p></span></p>
-Line 785
+Line 798
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  it is not.<o:p></o:p></span></p>
- <pre><a name="getContexts()"></a>public IOperationContext [] <b>getContexts</b>()</pre>
+ <pre><a name="getContexts()"></a>public <span class=SpellE>IOperationContext</span> [] <span
+ class=SpellE><b>getContexts</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  the array of contexts that have been assigned to the operation. <o:p></o:p></span></p>
-Line 793
+Line 807
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the array
- array of contexts<o:p></o:p></span></p>
+ of contexts<o:p></o:p></span></p>
- <pre><a name="canExecute()"></a>public boolean <b>canExecute</b>()</pre>
+ <pre><a name="canExecute()"></a>public <span class=SpellE>boolean</span> <span
+ class=SpellE><b>canExecute</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether the operation can be executed in its current state. <o:p></o:p></span></p>
-Line 809
+Line 824
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'>
  otherwise.<o:p></o:p></span></p>
- <pre><a name="canRedo()"></a>public boolean <b>canRedo</b>()</pre>
+ <pre><a name="canRedo()"></a>public <span class=SpellE>boolean</span> <span
+ class=SpellE><b>canRedo</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether the operation can be redone in its current state. <o:p></o:p></span></p>
-Line 822
+Line 838
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'>
  otherwise.<o:p></o:p></span></p>
- <pre><a name="canUndo()"></a>public boolean <b>canUndo</b>()</pre>
+ <pre><a name="canUndo()"></a>public <span class=SpellE>boolean</span> <span
+ class=SpellE><b>canUndo</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether the operation can be undone in its current state. <o:p></o:p></span></p>
-Line 835
+Line 852
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'>
  otherwise.<o:p></o:p></span></p>
- <pre><a name="execute(org.eclipse.core.runtime.IProgre"></a>public org.eclipse.core.runtime.IStatus <b>execute</b>(org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre><a name="execute(org.eclipse.core.runtime.IProgre"></a>public <span
+ class=SpellE>org.eclipse.core.runtime.IStatus</span> <b>execute</b>(<span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Execute
  the operation. This method should only be called the first time that an
-Line 850
+Line 869
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus of the execution. The status severity should be set to </span><code><span
+ class=SpellE>IStatus</span> of the execution. The status severity should be set
- style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'> if the
+ to </span><code><span style='font-size:10.0pt'>OK</span></code><span
- operation was successful, and </span><code><span style='font-size:10.0pt'>ERROR</span></code><span
+ style='font-size:10.0pt'> if the operation was successful, and </span><code><span
- style='font-size:10.0pt'> if it was not. Any other status is assumed to
+ style='font-size:10.0pt'>ERROR</span></code><span style='font-size:10.0pt'> if
- represent an incompletion of the execution.<o:p></o:p></span></p>
+ it was not. Any other status is assumed to represent an incompletion of the
+ execution.<o:p></o:p></span></p>
- <pre><a name="redo(org.eclipse.core.runtime.IProgressM"></a>public org.eclipse.core.runtime.IStatus <b>redo</b>(org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre><a name="redo(org.eclipse.core.runtime.IProgressM"></a>public <span
+ class=SpellE>org.eclipse.core.runtime.IStatus</span> <b>redo</b>(<span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Redo
  the operation. This method should only be called after an operation has been
-Line 872
+Line 894
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus of the redo. The status severity should be set to </span><code><span
+ class=SpellE>IStatus</span> of the redo. The status severity should be set to </span><code><span
  style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'> if the
  redo was successful, and </span><code><span style='font-size:10.0pt'>ERROR</span></code><span
  style='font-size:10.0pt'> if it was not. Any other status is assumed to
  represent an incompletion of the redo.<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>undo</b>(org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <b>undo</b>(<span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Undo
  the operation. This method should only be called after an operation has been
-Line 894
+Line 917
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus of the undo. The status severity should be set to </span><code><span
+ class=SpellE>IStatus</span> of the undo. The status severity should be set to </span><code><span
  style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'> if the
  redo was successful, and </span><code><span style='font-size:10.0pt'>ERROR</span></code><span
  style='font-size:10.0pt'> if it was not. Any other status is assumed to
-Line 905
+Line 928
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Dispose
  of the operation. This method is used when the operation is no longer kept in
- the history. Implementers of this method typically unregister any listeners. <o:p></o:p></span></p>
+ the history. Implementers of this method typically <span class=SpellE>unregister</span>
+ any listeners. <o:p></o:p></span></p>
- <pre>public java.lang.String <b>getLabel</b>()</pre>
+ <pre>public <span class=SpellE>java.lang.String</span> <span class=SpellE><b>getLabel</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
  the label that should be used to show the name of the operation to the user.
-Line 920
+Line 944
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
  label<o:p></o:p></span></p>
- <pre>public java.lang.String <b>getDescription</b>()</pre>
+ <pre>public <span class=SpellE>java.lang.String</span> <span class=SpellE><b>getDescription</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
  the description that should be used to further describe this operation to the
-Line 933
+Line 957
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
  description<o:p></o:p></span></p>
- <h3>IOperationHistory</h3>
+ <h3><span class=SpellE>IOperationHistory</span></h3>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>IOperationHistory
+ <p class=MsoNormal><span class=SpellE><span style='font-size:10.0pt;font-family:
- tracks a history of operations that can be undone or redone. Operations are
+ Arial'>IOperationHistory</span></span><span style='font-size:10.0pt;font-family:
- added to the history once they have been initially executed. Clients may choose
+ Arial'> tracks a history of operations that can be undone or redone. Operations
- whether to have the operations history perform the initial execution or simply
+ are added to the history once they have been initially executed. Clients may
- add the operation to the history. Once operations are added to the history, the
+ choose whether to have the operations history perform the initial execution or
- methods canRedo() and canUndo() are used to determine whether there is an
+ simply add the operation to the history. Once operations are added to the
+ history, the methods <span class=SpellE>canRedo</span>() and <span
+ class=SpellE>canUndo</span>() are used to determine whether there is an
  operation available for undo and redo in a given operation context.<span
  style='mso-spacerun:yes'>� </span>The context-based protocol implies that there
  is only one operation that can be undone or redone at a given time in a given
-Line 957
+Line 983
  protocol allows direct undo and redo of a specified operation, regardless of
  its position in the history. When a more flexible undo model is supported,
  these methods can be implemented to undo and redo directly specified
- operations. If an implementer of IOperationHistory does not allow direct undo
+ operations. If an implementer of <span class=SpellE>IOperationHistory</span>
- and redo, these methods can return a status indicating that it is not allowed.<o:p></o:p></span></p>
+ does not allow direct undo and redo, these methods can return a status
+ indicating that it is not allowed.<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Listeners
+ <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Listeners (<span
- (IOperationHistoryListener) can listen for notifications about changes in the
+ class=SpellE>IOperationHistoryListener</span>) can listen for notifications
- history (operations added or removed), and for notification before and after
+ about changes in the history (operations added or removed), and for
- any operation is executed, undone or redone. Notification of operation
+ notification before and after any operation is executed, undone or redone.
- execution only occurs when clients direct the history to execute the operation.
+ Notification of operation execution only occurs when clients direct the history
- If the operation is added after it is executed, there can be no notification of
+ to execute the operation. If the operation is added after it is executed, there
- its execution.<o:p></o:p></span></p>
+ can be no notification of its execution.<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>IOperationApprover
+ <p class=MsoNormal><span class=SpellE><span style='font-size:10.0pt;font-family:
- defines an interface for approving an undo or redo before it occurs. This is
+ Arial'>IOperationApprover</span></span><span style='font-size:10.0pt;
- useful for injecting policy-decisions into the model - whether direct undo and
+ font-family:Arial'> defines an interface for approving an undo or redo before
- redo are supported, or warning the user about certain kinds of operations. It
+ it occurs. This is useful for injecting policy-decisions into the model -
- can also be used when objects have state related to the operation and need to
+ whether direct undo and redo are supported, or warning the user about certain
- determine whether an undo or redo will cause any conflicts with their local
+ kinds of operations. It can also be used when objects have state related to the
- state.<o:p></o:p></span></p>
+ operation and need to determine whether an undo or redo will cause any
+ conflicts with their local state.<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <pre>public void <b>add</b>(IOperation operation)</pre>
+ <pre>public void <b>add</b>(<span class=SpellE>IOperation</span> operation)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Add
- the specified operation to the history without executing it. The operation
+ the specified operation to the history without executing it. The operation should
- should have already been executed by the time it is added to the history.
+ have already been executed by the time it is added to the history. Listeners
- Listeners will be notified that the operation was added to the history. <o:p></o:p></span></p>
+ will be notified that the operation was added to the history. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 995
+Line 1023
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>operation</span></code><span
  style='font-size:10.0pt'> - - the operation to be added to the history<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>execute</b>(IOperation operation,</pre><pre><span style='mso-spacerun:yes'>����������������������������������������������� </span>org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <b>execute</b>(<span
+ class=SpellE>IOperation</span> operation,</pre><pre><span style='mso-spacerun:yes'>����������������������������������������������� </span><span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Execute
- the specified operation and add it to the operations history if successful. This
+ the specified operation and add it to the operations history if successful.
- method is used by clients who wish operation history listeners to receive
+ This method is used by clients who wish operation history listeners to receive
  notifications before and after the execution of the operation. Listeners will
- be notified before ( </span><code><span style='font-size:10.0pt'>aboutToExecute</span></code><span
+ be notified before ( </span><span class=SpellE><code><span style='font-size:
- style='font-size:10.0pt'>) and after (</span><code><span style='font-size:10.0pt'>done</span></code><span
+.0pt'>aboutToExecute</span></code></span><span style='font-size:10.0pt'>) and
- style='font-size:10.0pt'> or </span><code><span style='font-size:10.0pt'>operationNotOK</span></code><span
+ after (</span><code><span style='font-size:10.0pt'>done</span></code><span
+ style='font-size:10.0pt'> or </span><span class=SpellE><code><span
+ style='font-size:10.0pt'>operationNotOK</span></code></span><span
  style='font-size:10.0pt'>). If the operation successfully executes, an
- additional notification that the operation has been added to the history (</span><code><span
+ additional notification that the operation has been added to the history (</span><span
- style='font-size:10.0pt'>operationAdded</span></code><span style='font-size:
+ class=SpellE><code><span style='font-size:10.0pt'>operationAdded</span></code></span><span
-.0pt'>) will be sent. <o:p></o:p></span></p>
+ style='font-size:10.0pt'>) will be sent. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1019
+Line 1051
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus indicating whether the execution succeeded. The severity code in the
+ class=SpellE>IStatus</span> indicating whether the execution succeeded. The
- returned status describes whether the operation succeeded and whether it was
+ severity code in the returned status describes whether the operation succeeded
- added to the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
+ and whether it was added to the history. </span><code><span style='font-size:
- style='font-size:10.0pt'> severity indicates that the execute operation was
+.0pt'>OK</span></code><span style='font-size:10.0pt'> severity indicates that
- successful and that the operation has been added to the history. Listeners will
+ the execute operation was successful and that the operation has been added to
- receive the </span><code><span style='font-size:10.0pt'>done</span></code><span
+ the history. Listeners will receive the </span><code><span style='font-size:
- style='font-size:10.0pt'> notification. </span><code><span style='font-size:
+.0pt'>done</span></code><span style='font-size:10.0pt'> notification. </span><code><span
-.0pt'>CANCEL</span></code><span style='font-size:10.0pt'> severity indicates
+ style='font-size:10.0pt'>CANCEL</span></code><span style='font-size:10.0pt'>
- that the user cancelled the operation and that the operation was not added to
+ severity indicates that the user cancelled the operation and that the operation
- the history. </span><code><span style='font-size:10.0pt'>ERROR</span></code><span
+ was not added to the history. </span><code><span style='font-size:10.0pt'>ERROR</span></code><span
  style='font-size:10.0pt'> severity indicates that the operation did not
- successfully execute and that it was not added to the history. Any other
+ successfully execute and that it was not added to the history. Any other severity
- severity code is not specifically interpreted by the history, and the operation
+ code is not specifically interpreted by the history, and the operation will not
- will not be added to the history. For all severities other than </span><code><span
+ be added to the history. For all severities other than </span><code><span
  style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'>,
- listeners will receive the </span><code><span style='font-size:10.0pt'>operationNotOK</span></code><span
+ listeners will receive the </span><span class=SpellE><code><span
+ style='font-size:10.0pt'>operationNotOK</span></code></span><span
  style='font-size:10.0pt'> notification instead of the </span><code><span
  style='font-size:10.0pt'>done</span></code><span style='font-size:10.0pt'>
  notification.<o:p></o:p></span></p>
- <pre>public void <b>remove</b>(IOperation operation)</pre>
+ <pre>public void <b>remove</b>(<span class=SpellE>IOperation</span> operation)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Remove
  the specified operation from the history. Listeners will be notified of the
-Line 1053
+Line 1086
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>operation</span></code><span
  style='font-size:10.0pt'> - - the operation to be removed from the history<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>redo</b>(IOperationContext&nbsp;context,</pre><pre><span style='mso-spacerun:yes'>�������������������������������������������� </span>org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <b>redo</b>(<span
+ class=SpellE>IOperationContext</span>&nbsp;context,</pre><pre><span style='mso-spacerun:yes'>�������������������������������������������� </span><span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Redo
  the most recently undone operation in the given context <o:p></o:p></span></p>
-Line 1072
+Line 1107
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus indicating whether the redo succeeded. The severity code in the
+ class=SpellE>IStatus</span> indicating whether the redo succeeded. The severity
- returned status describes whether the operation succeeded and whether it
+ code in the returned status describes whether the operation succeeded and
- remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
+ whether it remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
  style='font-size:10.0pt'> severity indicates that the redo operation was
- successful and that the operation has been placed on the undo history.
+ successful and that the operation has been placed on the undo history. Listeners
- Listeners will receive the </span><code><span style='font-size:10.0pt'>redone</span></code><span
+ will receive the </span><code><span style='font-size:10.0pt'>redone</span></code><span
  style='font-size:10.0pt'> notification. </span><code><span style='font-size:
 .0pt'>CANCEL</span></code><span style='font-size:10.0pt'> severity indicates
  that the user cancelled the operation and that the operation remains in the
-Line 1089
+Line 1124
  is not specifically interpreted by the history, and is simply passed back to
  the caller. For all severities other than </span><code><span style='font-size:
 .0pt'>OK</span></code><span style='font-size:10.0pt'>, listeners will receive
- the </span><code><span style='font-size:10.0pt'>operationNotOK</span></code><span
+ the </span><span class=SpellE><code><span style='font-size:10.0pt'>operationNotOK</span></code></span><span
  style='font-size:10.0pt'> notification instead of the </span><code><span
  style='font-size:10.0pt'>redone</span></code><span style='font-size:10.0pt'>
  notification.<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>redoOperation</b>(IOperation operation,</pre><pre><span style='mso-spacerun:yes'>����������������������������������������������������� </span>org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <span
+ class=SpellE><b>redoOperation</b></span>(<span class=SpellE>IOperation</span> operation,</pre><pre><span style='mso-spacerun:yes'>����������������������������������������������������� </span><span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Redo
  the specified operation <o:p></o:p></span></p>
-Line 1112
+Line 1149
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus indicating whether the redo succeeded. The severity code in the
+ class=SpellE>IStatus</span> indicating whether the redo succeeded. The severity
- returned status describes whether the operation succeeded and whether it
+ code in the returned status describes whether the operation succeeded and
- remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
+ whether it remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
  style='font-size:10.0pt'> severity indicates that the redo operation was
  successful and that the operation has been placed on the undo history.
  Listeners will receive the </span><code><span style='font-size:10.0pt'>redone</span></code><span
-Line 1129
+Line 1166
  severity code is not interpreted by the history, and is simply passed back to
  the caller. For all severities other than </span><code><span style='font-size:
 .0pt'>OK</span></code><span style='font-size:10.0pt'>, listeners will receive
- the </span><code><span style='font-size:10.0pt'>operationNotOK</span></code><span
+ the </span><span class=SpellE><code><span style='font-size:10.0pt'>operationNotOK</span></code></span><span
  style='font-size:10.0pt'> notification instead of the </span><code><span
  style='font-size:10.0pt'>redone</span></code><span style='font-size:10.0pt'>
  notification.<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>undo</b>(IOperationContext&nbsp; context,</pre><pre><span style='mso-spacerun:yes'>�������������������������������������������� </span>org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <b>undo</b>(<span
+ class=SpellE>IOperationContext</span>&nbsp; context,</pre><pre><span style='mso-spacerun:yes'>�������������������������������������������� </span><span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Undo
  the most recently undone operation in the given context <o:p></o:p></span></p>
-Line 1153
+Line 1192
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus indicating whether the undo succeeded. The severity code in the
+ class=SpellE>IStatus</span> indicating whether the undo succeeded. The severity
- returned status describes whether the operation succeeded and whether it
+ code in the returned status describes whether the operation succeeded and
- remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
+ whether it remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
  style='font-size:10.0pt'> severity indicates that the undo operation was
  successful and that the operation has been placed on the redo history.
  Listeners will receive the </span><code><span style='font-size:10.0pt'>undone</span></code><span
-Line 1169
+Line 1208
  will be notified that the operation was removed. Any other severity code is not
  interpreted by the history, and is simply passed back to the caller. For all
  severities other than </span><code><span style='font-size:10.0pt'>OK</span></code><span
- style='font-size:10.0pt'>, listeners will receive the </span><code><span
+ style='font-size:10.0pt'>, listeners will receive the </span><span
- style='font-size:10.0pt'>operationNotOK</span></code><span style='font-size:
+ class=SpellE><code><span style='font-size:10.0pt'>operationNotOK</span></code></span><span
-.0pt'> notification instead of the </span><code><span style='font-size:10.0pt'>undone</span></code><span
+ style='font-size:10.0pt'> notification instead of the </span><code><span
- style='font-size:10.0pt'> notification.<o:p></o:p></span></p>
+ style='font-size:10.0pt'>undone</span></code><span style='font-size:10.0pt'>
+ notification.<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>undoOperation</b>(IOperation operation,</pre><pre><span style='mso-spacerun:yes'>���������������������������������������� </span><span style='mso-spacerun:yes'>�������������</span>org.eclipse.core.runtime.IProgressMonitor&nbsp;monitor)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <span
+ class=SpellE><b>undoOperation</b></span>(<span class=SpellE>IOperation</span> operation,</pre><pre><span style='mso-spacerun:yes'>����������������������������������������������������� </span><span
+ class=SpellE>org.eclipse.core.runtime.IProgressMonitor</span>&nbsp;monitor)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Undo
  the specified operation <o:p></o:p></span></p>
-Line 1192
+Line 1234
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus indicating whether the undo succeeded. The severity code in the
+ class=SpellE>IStatus</span> indicating whether the undo succeeded. The severity
- returned status describes whether the operation succeeded and whether it
+ code in the returned status describes whether the operation succeeded and
- remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
+ whether it remains in the history. </span><code><span style='font-size:10.0pt'>OK</span></code><span
  style='font-size:10.0pt'> severity indicates that the undo operation was
  successful and that the operation has been placed on the redo history.
  Listeners will receive the </span><code><span style='font-size:10.0pt'>undone</span></code><span
-Line 1203
+Line 1245
 .0pt'>CANCEL</span></code><span style='font-size:10.0pt'> severity indicates
  that the user cancelled the operation and that the operation remains in the
  undo history. </span><code><span style='font-size:10.0pt'>ERROR</span></code><span
- style='font-size:10.0pt'> severity indicates that the operation could not
+ style='font-size:10.0pt'> severity indicates that the operation could not successfully
- successfully be undone. The operation will remain at its current location in
+ be undone. The operation will remain at its current location in the history,
- the history, and callers must explicitly remove it if desired. Any other
+ and callers must explicitly remove it if desired. Any other severity code is
- severity code is not interpreted by the history, and is simply passed back to
+ not interpreted by the history, and is simply passed back to the caller. For
- the caller. For all severities other than </span><code><span style='font-size:
+ all severities other than </span><code><span style='font-size:10.0pt'>OK</span></code><span
-.0pt'>OK</span></code><span style='font-size:10.0pt'>, listeners will receive
+ style='font-size:10.0pt'>, listeners will receive the </span><span
- the </span><code><span style='font-size:10.0pt'>operationNotOK</span></code><span
+ class=SpellE><code><span style='font-size:10.0pt'>operationNotOK</span></code></span><span
  style='font-size:10.0pt'> notification instead of the </span><code><span
  style='font-size:10.0pt'>undone</span></code><span style='font-size:10.0pt'>
  notification.<o:p></o:p></span></p>
- <pre>public boolean <b>canRedo</b>(IOperationContext&nbsp; context)</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>canRedo</b></span>(<span
+ class=SpellE>IOperationContext</span>&nbsp; context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
- whether there is a redoable operation available in the given context. <o:p></o:p></span></p>
+ whether there is a <span class=SpellE>redoable</span> operation available in
+ the given context. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1230
+Line 1274
  style='font-size:10.0pt'> <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>true</span></code><span
- style='font-size:10.0pt'> if there is a redoable operation, </span><code><span
+ style='font-size:10.0pt'> if there is a <span class=SpellE>redoable</span>
- style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'>
+ operation, </span><code><span style='font-size:10.0pt'>false</span></code><span
- otherwise.<o:p></o:p></span></p>
+ style='font-size:10.0pt'> otherwise.<o:p></o:p></span></p>
- <pre>public boolean <b>canUndo</b>(IOperationContext&nbsp; context)</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>canUndo</b></span>(<span
+ class=SpellE>IOperationContext</span>&nbsp; context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
  whether there is an undoable operation available in the given context <o:p></o:p></span></p>
-Line 1254
+Line 1299
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'>
  otherwise.<o:p></o:p></span></p>
- <pre>public void <b>addOperationApprover</b>(IOperationApprover&nbsp;approver)</pre>
+ <pre>public void <span class=SpellE><b>addOperationApprover</b></span>(<span
+ class=SpellE>IOperationApprover</span>&nbsp;approver)</pre>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Add
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Add the
- the specified approver to the operation history. <o:p></o:p></span></p>
+ specified approver to the operation history. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>approver</span></code><span
- style='font-size:10.0pt'> - - the IOperationApprover that will be consulted
+ style='font-size:10.0pt'> - - the <span class=SpellE>IOperationApprover</span>
- before any operation in the history is undone or redone<o:p></o:p></span></p>
+ that will be consulted before any operation in the history is undone or redone<o:p></o:p></span></p>
- <pre>public void <b>addOperationHistoryListener</b>(IOperationHistoryListener listener)</pre>
+ <pre>public void <span class=SpellE><b>addOperationHistoryListener</b></span>(<span
+ class=SpellE>IOperationHistoryListener</span> listener)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Add
  the specified listener to the operation history. <o:p></o:p></span></p>
-Line 1275
+Line 1322
  style='font-size:10.0pt'> <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>listener</span></code><span
- style='font-size:10.0pt'> - - the IOperationHistoryListener to receive
+ style='font-size:10.0pt'> - - the <span class=SpellE>IOperationHistoryListener</span>
- notifications about changes in the history or operations that are executed,
+ to receive notifications about changes in the history or operations that are
- undone, or redone<o:p></o:p></span></p>
+ executed, undone, or redone<o:p></o:p></span></p>
- <pre>public void <b>removeOperationApprover</b>(IOperationApprover&nbsp; approver)</pre>
+ <pre>public void <span class=SpellE><b>removeOperationApprover</b></span>(<span
+ class=SpellE>IOperationApprover</span>&nbsp; approver)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Remove
  the specified operation approver from the operation history. <o:p></o:p></span></p>
-Line 1288
+Line 1336
  style='font-size:10.0pt'> <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>approver</span></code><span
- style='font-size:10.0pt'> - - the IOperationApprover to be removed<o:p></o:p></span></p>
+ style='font-size:10.0pt'> - - the <span class=SpellE>IOperationApprover</span>
+ to be removed<o:p></o:p></span></p>
- <pre>public void <b>removeOperationHistoryListener</b>(IOperationHistoryListener listener)</pre>
+ <pre>public void <span class=SpellE><b>removeOperationHistoryListener</b></span>(<span
+ class=SpellE>IOperationHistoryListener</span> listener)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Remove
  the specified listener from the operation history. <o:p></o:p></span></p>
-Line 1299
+Line 1349
  style='font-size:10.0pt'> <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>listener</span></code><span
- style='font-size:10.0pt'> - - The IOperationHistoryListener to be removed<o:p></o:p></span></p>
+ style='font-size:10.0pt'> - - The <span class=SpellE>IOperationHistoryListener</span>
+ to be removed<o:p></o:p></span></p>
- <pre>public IOperation <b>getRedoOperation</b>(IOperationContext&nbsp; context)</pre>
+ <pre>public <span class=SpellE>IOperation</span> <span class=SpellE><b>getRedoOperation</b></span>(<span
+ class=SpellE>IOperationContext</span>&nbsp; context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Get
  the operation that will next be redone in the given context. This method is
-Line 1322
+Line 1374
  operation to be redone or </span><code><span style='font-size:10.0pt'>null</span></code><span
  style='font-size:10.0pt'> if there is no valid operation available.<o:p></o:p></span></p>
- <pre>public IOperation [] <b>getRedoHistory</b>(IOperationContext&nbsp; context)</pre>
+ <pre>public <span class=SpellE>IOperation</span> [] <span class=SpellE><b>getRedoHistory</b></span>(<span
+ class=SpellE>IOperationContext</span>&nbsp; context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Get
  the array of operations in the redo history for a given context. The operations
-Line 1342
+Line 1395
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
  array of operations in the history<o:p></o:p></span></p>
- <pre>public IOperation <b>getUndoOperation</b>(IOperationContext&nbsp; context)</pre>
+ <pre>public <span class=SpellE>IOperation</span> <span class=SpellE><b>getUndoOperation</b></span>(<span
+ class=SpellE>IOperationContext</span>&nbsp; context)</pre>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Get the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Get
- operation that will next be undone in the given context. This method is used to
+ the operation that will next be undone in the given context. This method is
- retrieve the label or description as needed for the &quot;Undo&quot; menu. <o:p></o:p></span></p>
+ used to retrieve the label or description as needed for the &quot;Undo&quot;
+ menu. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1358
+Line 1413
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the operation
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
- to be undone or </span><code><span style='font-size:10.0pt'>null</span></code><span
+ operation to be undone or </span><code><span style='font-size:10.0pt'>null</span></code><span
  style='font-size:10.0pt'> if there is no operation available.<o:p></o:p></span></p>
- <pre>public IOperation [] <b>getUndoHistory</b>(IOperationContext&nbsp; context)</pre>
+ <pre>public <span class=SpellE>IOperation</span> [] <span class=SpellE><b>getUndoHistory</b></span>(<span
+ class=SpellE>IOperationContext</span>&nbsp; context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Get
  the array of operations that can be undone in the specified context. The
-Line 1382
+Line 1438
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
  array of operations in the history<o:p></o:p></span></p>
- <pre>public void <b>dispose</b>(IOperationContext&nbsp;context,</pre><pre><span style='mso-spacerun:yes'>������������� </span><span style='mso-spacerun:yes'>������</span>boolean&nbsp;flushUndo,</pre><pre><span style='mso-spacerun:yes'>������������������� </span>boolean&nbsp;flushRedo)</pre>
+ <pre>public void <b>dispose</b>(<span class=SpellE>IOperationContext</span>&nbsp;context,</pre><pre><span style='mso-spacerun:yes'>������������������ </span><span style='mso-spacerun:yes'>�</span><span
+ class=SpellE>boolean</span>&nbsp;<span class=SpellE>flushUndo</span>,</pre><pre><span style='mso-spacerun:yes'>������������������� </span><span
+ class=SpellE>boolean</span>&nbsp;<span class=SpellE>flushRedo</span>)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Dispose
  of the specified context in the history. All operations that have only the
-Line 1396
+Line 1454
  style='font-size:10.0pt'> - - the context to be disposed, or null if all
  contexts are to be disposed <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>flushUndo</span></code><span
+ <p class=MsoNormal style='margin-left:.5in'><span class=SpellE><code><span
- style='font-size:10.0pt'> - - </span><code><span style='font-size:10.0pt'>true</span></code><span
+ style='font-size:10.0pt'>flushUndo</span></code></span><span style='font-size:
+.0pt'> - - </span><code><span style='font-size:10.0pt'>true</span></code><span
  style='font-size:10.0pt'> if the context should be flushed from the undo
  history, </span><code><span style='font-size:10.0pt'>false</span></code><span
  style='font-size:10.0pt'> if it should not <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>flushRedo</span></code><span
+ <p class=MsoNormal style='margin-left:.5in'><span class=SpellE><code><span
- style='font-size:10.0pt'> - - </span><code><span style='font-size:10.0pt'>true</span></code><span
+ style='font-size:10.0pt'>flushRedo</span></code></span><span style='font-size:
+.0pt'> - - </span><code><span style='font-size:10.0pt'>true</span></code><span
  style='font-size:10.0pt'> if the context should be flushed from the redo
  history, </span><code><span style='font-size:10.0pt'>false</span></code><span
  style='font-size:10.0pt'> if it should not.<o:p></o:p></span></p>
- <pre>public int <b>getLimit</b>()</pre>
+ <pre>public <span class=SpellE>int</span> <span class=SpellE><b>getLimit</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
  the specified limit on the undo and redo history. <o:p></o:p></span></p>
-Line 1418
+Line 1478
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>limit<o:p></o:p></span></p>
- <pre>public void <b>setLimit</b>(int&nbsp;limit)</pre>
+ <pre>public void <span class=SpellE><b>setLimit</b></span>(<span class=SpellE>int</span>&nbsp;limit)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Set
  the limit on the undo and redo history. <o:p></o:p></span></p>
-Line 1430
+Line 1490
  style='font-size:10.0pt'> - - the maximum number of operations that should be
  kept in the history<o:p></o:p></span></p>
- <h3>IOperationContext</h3>
+ <h3><span class=SpellE>IOperationContext</span></h3>
- <pre>public java.lang.String <b>getLabel</b>()</pre>
+ <pre>public <span class=SpellE>java.lang.String</span> <span class=SpellE><b>getLabel</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Get
- the label that should be used to describe the context in any views. Contexts may
+ the label that should be used to describe the context in any views. Contexts
- be shown when filtered operation histories are shown to the user. <o:p></o:p></span></p>
+ may be shown when filtered operation histories are shown to the user. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1444
+Line 1504
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
  label for the context.<o:p></o:p></span></p>
- <pre>public IContextOperationApprover <b>getOperationApprover</b>()</pre>
+ <pre>public <span class=SpellE>IContextOperationApprover</span> <span
+ class=SpellE><b>getOperationApprover</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Get
  the operation approver that is used to approve undo or redo operations
-Line 1457
+Line 1518
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
  operation approver for the context.<o:p></o:p></span></p>
- <pre>public boolean <b>acceptOperation</b>(IOperation operation)</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>acceptOperation</b></span>(<span
+ class=SpellE>IOperation</span> operation)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
- a boolean that indicates whether this context should be assigned to the specified
+ a <span class=SpellE>boolean</span> that indicates whether this context should
- operation. This method should be overridden by contexts that have complex rules
+ be assigned to the specified operation. This method should be overridden by
- for whether they should be assigned to an operation. Simple contexts generally
+ contexts that have complex rules for whether they should be assigned to an
- answer true. <o:p></o:p></span></p>
+ operation. Simple contexts generally answer true. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>a
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>a <span
- boolean indicating whether this context should be assigned to the operation.<o:p></o:p></span></p>
+ class=SpellE>boolean</span> indicating whether this context should be assigned
+ to the operation.<o:p></o:p></span></p>
- <pre>public boolean <b>equals</b>(IOperationContext&nbsp;context)</pre>
+ <pre>public <span class=SpellE>boolean</span> <b>equals</b>(<span class=SpellE>IOperationContext</span>&nbsp;context)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
  whether this context is equal to the specified context. <o:p></o:p></span></p>
-Line 1492
+Line 1555
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <h3>IOperationApprover</h3>
+ <h3><span class=SpellE>IOperationApprover</span></h3>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>IOperationApprover
+ <p class=MsoNormal><span class=SpellE><span style='font-size:10.0pt;font-family:
- defines an interface for approving the undo or redo of a particular operation
+ Arial'>IOperationApprover</span></span><span style='font-size:10.0pt;
- within an operation history. Operations that are candidates for undo or redo
+ font-family:Arial'> defines an interface for approving the undo or redo of a
- have already been validated against their current state and according to the
+ particular operation within an operation history. Operations that are
- rules of the history.<o:p></o:p></span></p>
+ candidates for undo or redo have already been validated against their current
+ state and according to the rules of the history.<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>By the time
- an IOperationApprover is consulted, the undo has already been requested.
+ an <span class=SpellE>IOperationApprover</span> is consulted, the undo has
- Approvers should true if the operation should proceed, and false if it should
+ already been requested. Approvers should true if the operation should proceed,
- not. When an operation is rejected, it is expected that the object rejecting
+ and false if it should not. When an operation is rejected, it is expected that
- the operation has already consulted the user if necessary or otherwise provided
+ the object rejecting the operation has already consulted the user if necessary
- any necessary information to the user about the rejection.<o:p></o:p></span></p>
+ or otherwise provided any necessary information to the user about the
+ rejection.<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>proceedUndoing</b>(IOperation operation, IOperationHistory history)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <span
+ class=SpellE><b>proceedUndoing</b></span>(<span class=SpellE>IOperation</span> operation, <span
+ class=SpellE>IOperationHistory</span> history)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
  a status indicating whether the specified operation should be undone. Any
- status that does not have severity </span><code><span style='font-size:10.0pt'>IStatus.OK</span></code><span
+ status that does not have severity </span><span class=SpellE><code><span
- style='font-size:10.0pt'> will not be approved. Implementers should not assume
+ style='font-size:10.0pt'>IStatus.OK</span></code></span><span style='font-size:
- that the undo will be performed when the status is </span><code><span
+.0pt'> will not be approved. Implementers should not assume that the undo
- style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'>, since
+ will be performed when the status is </span><code><span style='font-size:10.0pt'>OK</span></code><span
- other operation approvers can veto the undo. <o:p></o:p></span></p>
+ style='font-size:10.0pt'>, since other operation approvers can veto the undo. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1531
+Line 1598
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus describing whether the operation is approved. The undo will not proceed
+ class=SpellE>IStatus</span> describing whether the operation is approved. The
- if the status severity is not </span><code><span style='font-size:10.0pt'>OK</span></code><span
+ undo will not proceed if the status severity is not </span><code><span
- style='font-size:10.0pt'>, and the caller requesting the undo will be returned
+ style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'>, and
- the status that caused the rejection. Any other status severities will not be
+ the caller requesting the undo will be returned the status that caused the
- interpreted by the history.<o:p></o:p></span></p>
+ rejection. Any other status severities will not be interpreted by the history.<o:p></o:p></span></p>
- <pre>public org.eclipse.core.runtime.IStatus <b>proceedRedoing</b>(IOperation operation, IOperationHistory&nbsp;history)</pre>
+ <pre>public <span class=SpellE>org.eclipse.core.runtime.IStatus</span> <span
+ class=SpellE><b>proceedRedoing</b></span>(<span class=SpellE>IOperation</span> operation, <span
+ class=SpellE>IOperationHistory</span>&nbsp;history)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Return
  a status indicating whether the specified operation should be redone. Any
- status that does not have severity </span><code><span style='font-size:10.0pt'>IStatus.OK</span></code><span
+ status that does not have severity </span><span class=SpellE><code><span
- style='font-size:10.0pt'> will not be approved. Implementers should not assume
+ style='font-size:10.0pt'>IStatus.OK</span></code></span><span style='font-size:
- that the redo will be performed when the status is </span><code><span
+.0pt'> will not be approved. Implementers should not assume that the redo
- style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'>, since
+ will be performed when the status is </span><code><span style='font-size:10.0pt'>OK</span></code><span
- other operation approvers may veto the redo. <o:p></o:p></span></p>
+ style='font-size:10.0pt'>, since other operation approvers may veto the redo. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1560
+Line 1629
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the
+ <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>the <span
- IStatus describing whether the operation is approved. The redo will not proceed
+ class=SpellE>IStatus</span> describing whether the operation is approved. The
- if the status severity is no </span><code><span style='font-size:10.0pt'>OK</span></code><span
+ redo will not proceed if the status severity is no </span><code><span
- style='font-size:10.0pt'>, and the caller requesting the redo will be returned
+ style='font-size:10.0pt'>OK</span></code><span style='font-size:10.0pt'>, and
- the status that caused the rejection. Any other status severities will not be
+ the caller requesting the redo will be returned the status that caused the
- interpreted by the history.<o:p></o:p></span></p>
+ rejection. Any other status severities will not be interpreted by the history.<o:p></o:p></span></p>
- <h3>IOperationHistoryListener</h3>
+ <h3><span class=SpellE>IOperationHistoryListener</span></h3>
- <pre>public void <b>historyNotification</b>(OperationHistoryEvent event)</pre>
+ <pre>public void <span class=SpellE><b>historyNotification</b></span>(<span
+ class=SpellE>OperationHistoryEvent</span> event)</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Something
- of note has happened in the IOperationHistory. Listeners should check the
+ of note has happened in the <span class=SpellE>IOperationHistory</span>.
- supplied event for details. <o:p></o:p></span></p>
+ Listeners should check the supplied event for details. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Parameters:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><code><span style='font-size:10.0pt'>event</span></code><span
- style='font-size:10.0pt'> - - the OperationHistoryEvent that describes the
+ style='font-size:10.0pt'> - - the <span class=SpellE>OperationHistoryEvent</span>
- particular notification.<o:p></o:p></span></p>
+ that describes the particular notification.<o:p></o:p></span></p>
- <h3>OperationHistoryEvent</h3>
+ <h3><span class=SpellE>OperationHistoryEvent</span></h3>
- <pre>public IOperationHistory <b>history</b></pre><pre><o:p>&nbsp;</o:p></pre><pre>public IOperation <b>operation</b></pre><pre><o:p>&nbsp;</o:p></pre><pre>public boolean <b>operationAdded</b>()</pre>
+ <pre>public <span class=SpellE>IOperationHistory</span> <b>history</b></pre><pre><o:p>&nbsp;</o:p></pre><pre>public <span
+ class=SpellE>IOperation</span> <b>operation</b></pre><pre><o:p>&nbsp;</o:p></pre><pre>public <span
+ class=SpellE>boolean</span> <span class=SpellE><b>operationAdded</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation was added to the history. Listeners typically use
-Line 1599
+Line 1671
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>operationRemoved</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>operationRemoved</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation was removed from the history. Listeners typically
-Line 1613
+Line 1685
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>aboutToExecute</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>aboutToExecute</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
- whether or not an operation is about to execute. Listeners should prepare for
+ whether or not an operation is about to execute. Listeners should prepare for the
- the execution as appropriate. Listeners will receive a done notification if the
+ execution as appropriate. Listeners will receive a done notification if the
- operation is successful, or an operationNotCompleted notification if the
+ operation is successful, or an <span class=SpellE>operationNotCompleted</span>
- execution is cancelled or otherwise fails. This notification is only received
+ notification if the execution is cancelled or otherwise fails. This
- for those operations executed by the operation history. Operations that are
+ notification is only received for those operations executed by the operation
- added to the history after execution do not trigger these notifications. If the
+ history. Operations that are added to the history after execution do not
- operation successfully executes, clients will also receive a notification that
+ trigger these notifications. If the operation successfully executes, clients
- it has been added to the history. <o:p></o:p></span></p>
+ will also receive a notification that it has been added to the history. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1633
+Line 1705
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>aboutToUndo</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>aboutToUndo</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation is about to be undone. Listeners should prepare for
- the undo as appropriate. Listeners will receive an undone notification if the
+ the undo as appropriate. Listeners will receive an undone notification if the operation
- operation is successful, or an operationNotCompleted notification if the undo
+ is successful, or an <span class=SpellE>operationNotCompleted</span>
- is cancelled or otherwise fails. <o:p></o:p></span></p>
+ notification if the undo is cancelled or otherwise fails. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1649
+Line 1721
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>aboutToRedo</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>aboutToRedo</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation is about to be redone. Listeners should prepare for
  the redo as appropriate. Listeners will receive a redone notification if the
- operation is successful, or an operationNotCompleted notification if the redo
+ operation is successful, or an <span class=SpellE>operationNotCompleted</span>
- is cancelled or otherwise fails. <o:p></o:p></span></p>
+ notification if the redo is cancelled or otherwise fails. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1665
+Line 1737
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>done</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <b>done</b>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation was initially done. Listeners can take appropriate
  action, such as revealing any relevant state in the UI. This notification is
- only received for those operations executed by the operation history. Operations
+ only received for those operations executed by the operation history.
- that are added to the history after execution do not trigger this notification.
+ Operations that are added to the history after execution do not trigger this
- Clients will also receive a notification that the operation has been added to
+ notification. Clients will also receive a notification that the operation has
- the history. <o:p></o:p></span></p>
+ been added to the history. <o:p></o:p></span></p>
  <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:10.0pt'>Returns:</span></b><span
  style='font-size:10.0pt'> <o:p></o:p></span></p>
-Line 1683
+Line 1755
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>undone</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <b>undone</b>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation was undone. Listeners can take appropriate action,
-Line 1697
+Line 1769
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>redone</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <b>redone</b>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation was redone. Listeners can take appropriate action,
-Line 1711
+Line 1783
  style='font-size:10.0pt'>false</span></code><span style='font-size:10.0pt'> if
  not.<o:p></o:p></span></p>
- <pre>public boolean <b>operationNotOK</b>()</pre>
+ <pre>public <span class=SpellE>boolean</span> <span class=SpellE><b>operationNotOK</b></span>()</pre>
  <p class=MsoNormal style='margin-left:.5in'><span style='font-size:10.0pt'>Returns
  whether or not an operation was attempted and not successful. Listeners
-Line 1733
+Line 1805
  <h2>UI Support Classes<span style='font-size:10.0pt'><o:p></o:p></span></h2>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Additional support
+ <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Additional
- classes will be provided in the package org.eclipse.ui.operations.<span
+ support classes will be provided in the package <span class=SpellE>org.eclipse.ui.operations</span>.<span
  style='mso-spacerun:yes'>� </span>These classes handle policy decisions about
  the undo model to be used by the workbench.<span style='mso-spacerun:yes'>�
  </span>Access to the undo and redo commands, as well as the operations history,
-Line 1771
+Line 1843
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Operations
- that are assigned the workspace context will implement a subinterface,
+ that are assigned the workspace context will implement a <span class=SpellE>subinterface</span>,
- IWorkspaceOperation.<span style='mso-spacerun:yes'>� </span>IWorkspaceOperation
+ <span class=SpellE>IWorkspaceOperation</span>.<span style='mso-spacerun:yes'>�
- adds protocol to access the model elements manipulated by an operation
+ </span><span class=SpellE>IWorkspaceOperation</span> adds protocol to access
- (getElements()), so that listeners can decide if the workspace operation
+ the model elements manipulated by an operation (<span class=SpellE>getElements</span>()),
- affects their model.<span style='mso-spacerun:yes'>� </span>This protocol is
+ so that listeners can decide if the workspace operation affects their
- not generalized to IOperation.<span style='mso-spacerun:yes'>� </span>Prior
+ model.<span style='mso-spacerun:yes'>� </span>This protocol is not generalized
- experience with model-based operation frameworks has shown that there needs to
+ to <span class=SpellE>IOperation</span>.<span style='mso-spacerun:yes'>�
- be a very specific contract regarding how and when validation is performed,
+ </span>Prior experience with model-based operation frameworks has shown that
- what underlying model listeners are used to validate the operation, and whether
+ there needs to be a very specific contract regarding how and when validation is
- operations history notifications or internal model notifications are used to
+ performed, what underlying model listeners are used to validate the operation,
- maintain the validity of the operation and the undo stack.<span
+ and whether operations history notifications or internal model notifications
- style='mso-spacerun:yes'>� </span>These details for IWorkspaceOperation will
+ are used to maintain the validity of the operation and the undo stack.<span
- evolve as more workbench operations are created. <o:p></o:p></span></p>
+ style='mso-spacerun:yes'>� </span>These details for <span class=SpellE>IWorkspaceOperation</span>
+ will evolve as more workbench operations are created. <o:p></o:p></span></p>
- <h3>UndoHandler and RedoHandler</h3>
+ <h3><span class=SpellE>UndoHandler</span> and <span class=SpellE>RedoHandler</span></h3>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>The
  Edit&gt;Undo and Edit&gt;Redo commands should be handled by any parts that wish
-Line 1796
+Line 1869
  are responsible for the following:<o:p></o:p></span></p>
  <ul style='margin-top:0in' type=disc>
-  <li class=MsoNormal style='mso-list:l6 level1 lfo11;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l7 level1 lfo11;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>Undo and Redo commands will be
       enabled based on the status of the history.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l6 level1 lfo11;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l7 level1 lfo11;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>The Undo and Redo commands will
       be appended with the label of the operation for the handler�s context.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l6 level1 lfo11;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l7 level1 lfo11;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>The undo and redo history will
       be flushed for the handler�s context whenever the most recent operation in
       the history is invalid.<span style='mso-spacerun:yes'>� </span>This
-Line 1827
+Line 1900
  <h3>Operation Approvers</h3>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>The
- workbench will provide and install an IOperationApprover that consults the
+ workbench will provide and install an <span class=SpellE>IOperationApprover</span>
- contexts of an operation to determine whether undo or redo should proceed.<span
+ that consults the contexts of an operation to determine whether undo or redo
- style='mso-spacerun:yes'>� </span>The policy is described as follows:<o:p></o:p></span></p>
+ should proceed.<span style='mso-spacerun:yes'>� </span>The policy is described
+ as follows:<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
-Line 1848
+Line 1922
  example will help explain this.<span style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
  <ol style='margin-top:0in' start=1 type=1>
-  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l2 level1 lfo14;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>The user makes local edits in
       editor A.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l2 level1 lfo14;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>The user initiates a
       refactoring operation whose context is �A� and �workspace.�<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l2 level1 lfo14;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>The user makes additional local
       edits to editor A.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l3 level1 lfo14;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l2 level1 lfo14;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>The user goes to the navigator
       and selects Undo.<o:p></o:p></span></li>
  </ol>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>In the proposed
+ <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>In the
- implementation, the navigator requests an undo for the workspace context.<span
+ proposed implementation, the navigator requests an undo for the workspace
- style='mso-spacerun:yes'>� </span>The refactoring operation triggered in the
+ context.<span style='mso-spacerun:yes'>� </span>The refactoring operation
- editor is the most recent operation that has the workspace context, but it also
+ triggered in the editor is the most recent operation that has the workspace
- contains context �A.�<span style='mso-spacerun:yes'>� </span>Since subsequent
+ context, but it also contains context �A.�<span style='mso-spacerun:yes'>�
- operations in the history also have context �A,�, the operation will not be
+ </span>Since subsequent operations in the history also have context �A,�, the
- allowed.<span style='mso-spacerun:yes'>� </span>An explanation will be provided
+ operation will not be allowed.<span style='mso-spacerun:yes'>� </span>An
- to the user after the fact:<span style='mso-spacerun:yes'>� </span>�Cannot undo
+ explanation will be provided to the user after the fact:<span
- the refactoring operation because there have been subsequent changes to
+ style='mso-spacerun:yes'>� </span>�Cannot undo the refactoring operation
- A.�<span style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
+ because there have been subsequent changes to A.�<span
+ style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
-Line 1899
+Line 1974
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>Converting
  an existing action to use operations is straightforward, apart from
  implementing the undo and redo behavior for the action.<span
- style='mso-spacerun:yes'>� </span>The run() or runWithEvent method inside the
+ style='mso-spacerun:yes'>� </span>The run() or <span class=SpellE>runWithEvent</span>
- action should create an operation, execute it, and add it to the operations
+ method inside the action should create an operation, execute it, and add it to
- history, rather than run the code inside the method.<span
+ the operations history, rather than run the code inside the method.<span
  style='mso-spacerun:yes'>� </span>The following code shows the existing run()
- method in the EditorAction of the readme tool example
+ method in the <span class=SpellE>EditorAction</span> of the <span class=SpellE>readme</span>
- (org.eclipse.ui.examples.readmetool):<o:p></o:p></span></p>
+ tool example (<span class=SpellE>org.eclipse.ui.examples.readmetool</span>):<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
- <pre>public void run() {</pre><pre><span style='mso-spacerun:yes'>����������� </span>String editorName = MessageUtil.getString(&quot;Empty_Editor_Name&quot;); </pre><pre><span style='mso-spacerun:yes'>������������</span>if (activeEditor != null)</pre><pre><span style='mso-spacerun:yes'>��������������� </span>editorName = activeEditor.getTitle();</pre><pre><span style='mso-spacerun:yes'>����������� </span>MessageDialog</pre><pre><span style='mso-spacerun:yes'>������������������� </span>.openInformation(</pre><pre><span style='mso-spacerun:yes'>��������������������������� </span>shell,</pre><pre><span style='mso-spacerun:yes'>��������������������������� </span>MessageUtil.getString(&quot;Readme_Editor&quot;), </pre><pre><span style='mso-spacerun:yes'>����������������������������</span>MessageUtil.format(&quot;ReadmeEditorActionExecuted&quot;, </pre><pre><span
+ <pre>public void run() {</pre><pre><span style='mso-spacerun:yes'>����������� </span>String <span
- style='mso-tab-count:4'>������������������������������ </span>new Object[] { getText(), editorName })); </pre><pre><span style='mso-spacerun:yes'>��������</span>}</pre><pre><span
+ class=SpellE>editorName</span> = <span class=SpellE>MessageUtil.getString</span>(&quot;<span
+ class=SpellE>Empty_Editor_Name</span>&quot;); </pre><pre><span style='mso-spacerun:yes'>������������</span>if (<span
+ class=SpellE>activeEditor</span> != null)</pre><pre><span style='mso-spacerun:yes'>������ </span><span style='mso-spacerun:yes'>���������</span><span
+ class=SpellE>editorName</span> = <span class=SpellE>activeEditor.getTitle</span>();</pre><pre><span style='mso-spacerun:yes'>����������� </span><span
+ class=SpellE>MessageDialog</span></pre><pre><span style='mso-spacerun:yes'>������������������� </span>.<span
+ class=SpellE>openInformation</span>(</pre><pre><span style='mso-spacerun:yes'>��������������������������� </span>shell,</pre><pre><span style='mso-spacerun:yes'>��������������������������� </span><span
+ class=SpellE>MessageUtil.getString</span>(&quot;<span class=SpellE>Readme_Editor</span>&quot;), </pre><pre><span style='mso-spacerun:yes'>����������������������������</span><span
+ class=SpellE>MessageUtil.format</span>(&quot;<span class=SpellE>ReadmeEditorActionExecuted</span>&quot;, </pre><pre><span
+ style='mso-tab-count:4'>������������������������������ </span>new Object[] { <span
+ class=SpellE>getText</span>(), <span class=SpellE>editorName</span> })); </pre><pre><span style='mso-spacerun:yes'>��������</span>}</pre><pre><span
  style='font-family:Arial'>Using operations, the run method simplifies:<o:p></o:p></span></pre><pre><span
- style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre><pre><span style='mso-spacerun:yes'>������� </span>public void run() {</pre><pre><span style='mso-spacerun:yes'>����������� </span>String editorName = MessageUtil.getString(&quot;Empty_Editor_Name&quot;); </pre><pre><span style='mso-spacerun:yes'>��</span><span style='mso-spacerun:yes'>����������</span>if (activeEditor != null)</pre><pre><span style='mso-spacerun:yes'>��������������� </span>editorName = activeEditor.getTitle();</pre><pre><span style='mso-spacerun:yes'>����������� </span>// create the operation</pre><pre><span style='mso-spacerun:yes'>����������� </span>IOperation operation = new EditorOperation(</pre><pre><span
+ style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre><pre><span style='mso-spacerun:yes'>������� </span>public void run() {</pre><pre><span style='mso-spacerun:yes'>����������� </span>String <span
- style='mso-tab-count:2'>�������������� </span>getText(),shell, editorName);</pre><pre><span style='mso-spacerun:yes'>����������� </span>// execute (and add to the history)</pre><pre><span style='mso-spacerun:yes'>����������� </span>history.execute(operation, null);</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span
+ class=SpellE>editorName</span> = <span class=SpellE>MessageUtil.getString</span>(&quot;<span
+ class=SpellE>Empty_Editor_Name</span>&quot;); </pre><pre><span style='mso-spacerun:yes'>�����������</span><span style='mso-spacerun:yes'>�</span>if (<span
+ class=SpellE>activeEditor</span> != null)</pre><pre><span style='mso-spacerun:yes'>��������������� </span><span
+ class=SpellE>editorName</span> = <span class=SpellE>activeEditor.getTitle</span>();</pre><pre><span style='mso-spacerun:yes'>����������� </span>// create the operation</pre><pre><span style='mso-spacerun:yes'>����������� </span><span
+ class=SpellE>IOperation</span> operation = new <span class=SpellE>EditorOperation</span>(</pre><pre><span
+ style='mso-tab-count:2'>�������������� </span><span class=SpellE>getText</span>(),shell, <span
+ class=SpellE>editorName</span>);</pre><pre><span style='mso-spacerun:yes'>����������� </span>// execute (and add to the history)</pre><pre><span style='mso-spacerun:yes'>�� </span><span style='mso-spacerun:yes'>���������</span><span
+ class=SpellE>history.execute</span>(operation, null);</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span
  style='font-family:Arial'>The operation encapsulates the old run behavior, as well as the undo and redo for the operation:<o:p></o:p></span></pre><pre><span
- style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre><pre>class EditorOperation extends AbstractOperation {</pre><pre><span style='mso-spacerun:yes'>������� </span>Shell fShell;</pre><pre><span style='mso-spacerun:yes'>������� </span>String fEditorName;</pre><pre><span style='mso-spacerun:yes'>������� </span>public EditorOperation(String label, Shell shell, String editorName) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>super(label);</pre><pre><span style='mso-spacerun:yes'>����������� </span>fShell = shell;</pre><pre><span style='mso-spacerun:yes'>����������� </span>fEditorName = editorName;</pre><pre><span style='mso-spacerun:yes'>����������� </span></pre><pre><span style='mso-spacerun:yes'>��������</span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>public IStatus execute(IProgressMonitor monitor) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>MessageDialog.openInformation(</pre><pre><span style='mso-spacerun:yes'>������������������� </span>fShell,</pre><pre><span style='mso-spacerun:yes'>������������������� </span>MessageUtil.getString(&quot;Readme_Editor&quot;), </pre><pre><span style='mso-spacerun:yes'>��������������������</span>MessageUtil.format(&quot;ReadmeEditorActionExecuted&quot;, </pre><pre><span
+ style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre><pre>class <span
- style='mso-tab-count:3'>���������������������� </span>new Object[] { getLabel(), fEditorName }));<span style='mso-spacerun:yes'>� </span></pre><pre><span style='mso-spacerun:yes'>������������</span>return Status.OK_STATUS;</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>public IStatus undo(IProgressMonitor monitor) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>// implement the undo here</pre><pre><span style='mso-spacerun:yes'>����������� </span>return Status.OK_STATUS;</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>public IStatus redo(IProgressMonitor monitor) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>// implement the redo here</pre><pre><span style='mso-spacerun:yes'>����������� </span>return Status.OK_STATUS;</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span style='mso-spacerun:yes'>��� </span>}</pre><pre><o:p>&nbsp;</o:p></pre><pre><span
+ class=SpellE>EditorOperation</span> extends <span class=SpellE>AbstractOperation</span> {</pre><pre><span style='mso-spacerun:yes'>������� </span>Shell <span
- style='font-family:Arial'>If an IHandler is provided for a command instead of using actions, the execute method of the handler is mapped similarly to the run method in an action:<o:p></o:p></span></pre><pre><span
+ class=SpellE>fShell</span>;</pre><pre><span style='mso-spacerun:yes'>������� </span>String <span
- style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre><pre><span style='mso-spacerun:yes'>������� </span>public Object execute(Map params) throws ExecutionException {</pre><pre><span style='mso-spacerun:yes'>������� </span>try {</pre><pre><span
+ class=SpellE>fEditorName</span>;</pre><pre><span style='mso-spacerun:yes'>���� </span><span style='mso-spacerun:yes'>���</span>public <span
- style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span>IEditorPart activeEditor = params.get(&quot;ACTIVE_EDITOR&quot;);</pre><pre><span
+ class=SpellE>EditorOperation</span>(String label, Shell <span class=SpellE>shell</span>, String <span
- style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span>Shell shell = params.get(&quot;SHELL&quot;);</pre><pre><span
+ class=SpellE>editorName</span>) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>super(label);</pre><pre><span style='mso-spacerun:yes'>����������� </span><span
- style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span>String label = params.get(&quot;NAME&quot;);</pre><pre><span
+ class=SpellE>fShell</span> = shell;</pre><pre><span style='mso-spacerun:yes'>����������� </span><span
- style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span>String editorName = MessageUtil.getString(&quot;Empty_Editor_Name&quot;); </pre><pre><span style='mso-spacerun:yes'>������������</span>if (activeEditor != null)</pre><pre><span style='mso-spacerun:yes'>��������������� </span>editorName = activeEditor.getTitle();</pre><pre><span style='mso-spacerun:yes'>����������� </span>// create the operation</pre><pre><span style='mso-spacerun:yes'>����������� </span>IOperation operation =new EditorOperation(label, shell, editorName);</pre><pre><o:p>&nbsp;</o:p></pre><pre><span style='mso-spacerun:yes'>����������� </span>// execute (and add to the history)</pre><pre><span style='mso-spacerun:yes'>����������� </span>history.execute(operation, null);</pre><pre><span style='mso-spacerun:yes'>������� </span>} catch (Exception e) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>throw new ExecutionException(</pre><pre><span style='mso-spacerun:yes'>������������������� </span>&quot;While executing the operation, an exception occurred&quot;, e); </pre><pre><span style='mso-spacerun:yes'>��������</span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>return null;</pre><pre><span style='mso-spacerun:yes'>��� </span>}</pre><pre><span
+ class=SpellE>fEditorName</span> = <span class=SpellE>editorName</span>;</pre><pre><span style='mso-spacerun:yes'>����������� </span></pre><pre><span style='mso-spacerun:yes'>��������</span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>public <span
- style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre><pre><span
+ class=SpellE>IStatus</span> execute(<span class=SpellE>IProgressMonitor</span> monitor) {</pre><pre><span style='mso-spacerun:yes'>������� </span><span style='mso-spacerun:yes'>����</span><span
- style='font-family:Arial'>When an action launches a wizard. then the operation is typically created as part of processing the �Finish� button in the wizard.<span style='mso-spacerun:yes'>� </span>Some restructuring may be required.<span style='mso-spacerun:yes'>� </span>For example, wizards are often implemented in hierarchies and make use of convenience methods in the wizard hierarchy.<span style='mso-spacerun:yes'>� </span>Some of these methods may have to move to a corresponding hierarchy of operations.</span> </pre>
+ class=SpellE>MessageDialog.openInformation</span>(</pre><pre><span style='mso-spacerun:yes'>������������������� </span><span
+ class=SpellE>fShell</span>,</pre><pre><span style='mso-spacerun:yes'>������������������� </span><span
+ class=SpellE>MessageUtil.getString</span>(&quot;<span class=SpellE>Readme_Editor</span>&quot;), </pre><pre><span style='mso-spacerun:yes'>��������������������</span><span
+ class=SpellE>MessageUtil.format</span>(&quot;<span class=SpellE>ReadmeEditorActionExecuted</span>&quot;, </pre><pre><span
+ style='mso-tab-count:3'>���������������������� </span>new Object[] { <span
+ class=SpellE>getLabel</span>(), <span class=SpellE>fEditorName</span> }));<span style='mso-spacerun:yes'>� </span></pre><pre><span style='mso-spacerun:yes'>������������</span>return <span
+ class=SpellE>Status.OK_STATUS</span>;</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>public <span
+ class=SpellE>IStatus</span> undo(<span class=SpellE>IProgressMonitor</span> monitor) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>// implement the undo here</pre><pre><span style='mso-spacerun:yes'>����������� </span>return <span
+ class=SpellE>Status.OK_STATUS</span>;</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>public <span
+ class=SpellE>IStatus</span> redo(<span class=SpellE>IProgressMonitor</span> monitor) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>// implement the redo here</pre><pre><span style='mso-spacerun:yes'>����������� </span>return <span
+ class=SpellE>Status.OK_STATUS</span>;</pre><pre><span style='mso-spacerun:yes'>������� </span>}</pre><pre><span style='mso-spacerun:yes'>��� </span>}</pre><pre><o:p>&nbsp;</o:p></pre><pre><span
+ style='font-family:Arial'>If an <span class=SpellE>IHandler</span> is provided for a command instead of using actions, the execute method of the handler is mapped similarly to the run method in an action:<o:p></o:p></span></pre><pre><span
+ style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre><pre><span style='mso-spacerun:yes'>������� </span>public Object execute(Map <span
+ class=SpellE>params</span>) throws <span class=SpellE>ExecutionException</span> {</pre><pre><span style='mso-spacerun:yes'>������� </span>try {</pre><pre><span
+ style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span><span
+ class=SpellE>IEditorPart</span> <span class=SpellE>activeEditor</span> = <span
+ class=SpellE>params.get</span>(&quot;ACTIVE_EDITOR&quot;);</pre><pre><span
+ style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span>Shell <span
+ class=SpellE>shell</span> = <span class=SpellE>params.get</span>(&quot;SHELL&quot;);</pre><pre><span
+ style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span>String label = <span
+ class=SpellE>params.get</span>(&quot;NAME&quot;);</pre><pre><span
+ style='mso-tab-count:1'>������� </span><span style='mso-spacerun:yes'>��� </span>String <span
+ class=SpellE>editorName</span> = <span class=SpellE>MessageUtil.getString</span>(&quot;<span
+ class=SpellE>Empty_Editor_Name</span>&quot;); </pre><pre><span style='mso-spacerun:yes'>������������</span>if (<span
+ class=SpellE>activeEditor</span> != null)</pre><pre><span style='mso-spacerun:yes'>��������������� </span><span
+ class=SpellE>editorName</span> = <span class=SpellE>activeEditor.getTitle</span>();</pre><pre><span style='mso-spacerun:yes'>����������� </span>// create the operation</pre><pre><span style='mso-spacerun:yes'>����������� </span><span
+ class=SpellE>IOperation</span> operation =new <span class=SpellE>EditorOperation</span>(label, shell, <span
+ class=SpellE>editorName</span>);</pre><pre><o:p>&nbsp;</o:p></pre><pre><span style='mso-spacerun:yes'>����������� </span>// execute (and add to the history)</pre><pre><span style='mso-spacerun:yes'>����������� </span><span
+ class=SpellE>history.execute</span>(operation, null);</pre><pre><span style='mso-spacerun:yes'>������� </span>} catch (Exception e) {</pre><pre><span style='mso-spacerun:yes'>����������� </span>throw new <span
+ class=SpellE>ExecutionException</span>(</pre><pre><span style='mso-spacerun:yes'>������������������� </span>&quot;While executing the operation, an exception occurred&quot;, e); </pre><pre><span style='mso-spacerun:yes'>��������</span>}</pre><pre><span style='mso-spacerun:yes'>������� </span>return null;</pre><pre><span style='mso-spacerun:yes'>��� </span>}</pre><pre><span
+ style='font-family:Arial'><o:p>&nbsp;</o:p></span></pre>
+ <p class=MsoNormal><span class=GramE><span style='font-size:10.0pt;font-family:
+ Arial'>When an action launches a wizard.</span></span><span style='font-size:
+.0pt;font-family:Arial'> <span class=GramE>then</span> the operation is
+ typically created as part of processing the �Finish� button in the wizard.<span
+ style='mso-spacerun:yes'>� </span>Some restructuring may be required.<span
+ style='mso-spacerun:yes'>� </span>For example, wizards are often implemented in
+ hierarchies and make use of convenience methods in the wizard hierarchy.<span
+ style='mso-spacerun:yes'>� </span>Some of these methods may have to move to a
+ corresponding hierarchy of operations. <o:p></o:p></span></p>
  <h3>Refactoring example:<span style='mso-spacerun:yes'>� </span>mapping
- existing protocol to IOperation</h3>
+ existing protocol to <span class=SpellE>IOperation</span></h3>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>In the
+ <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>In the current
- current SDK implementation, org.eclipse.ltk.core.refactoring provides an undo
+ SDK implementation, <span class=SpellE>org.eclipse.ltk.core.refactoring</span>
- framework for undoing refactoring operations.<span style='mso-spacerun:yes'>�
+ provides an undo framework for undoing refactoring operations.<span
- </span>This framework is based on the notion of �Change� objects.<span
+ style='mso-spacerun:yes'>� </span>This framework is based on the notion of
- style='mso-spacerun:yes'>� </span>Change objects that can be undone are
+ �Change� objects.<span style='mso-spacerun:yes'>� </span>Change objects that
- responsible for returning the undo version of a change when they are
+ can be undone are responsible for returning the undo version of a change when
- executed.<span style='mso-spacerun:yes'>� </span>An undo stack is maintained by
+ they are executed.<span style='mso-spacerun:yes'>� </span>An undo stack is
- an internal undo manager.<span style='mso-spacerun:yes'>� </span>This undo
+ maintained by an internal undo manager.<span style='mso-spacerun:yes'>�
- manager invalidates the history whenever an unknown workspace change
+ </span>This undo manager invalidates the history whenever an unknown workspace
- occurs.<span style='mso-spacerun:yes'>� </span>Undo-aware objects send signals
+ change occurs.<span style='mso-spacerun:yes'>� </span>Undo-aware objects send
- to the undo manager as they perform operations, so that the undo manager will
+ signals to the undo manager as they perform operations, so that the undo
- not invalidate the history.<o:p></o:p></span></p>
+ manager will not invalidate the history.<o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
-Line 1947
+Line 2078
  integrated the refactoring change framework with the operations framework as
  follows:<o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l4 level1 lfo16;
+ <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l3 level1 lfo16;
  tab-stops:list 39.0pt'><![if !supportLists]><span style='font-size:10.0pt;
  font-family:Arial;mso-fareast-font-family:Arial'><span style='mso-list:Ignore'>1.<span
  style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
- style='font-size:10.0pt;font-family:Arial'>The change objects were wrappered
+ style='font-size:10.0pt;font-family:Arial'>The change objects were <span
- with a class that implements IOperation (and IWorkspaceOperation) and maps the
+ class=SpellE>wrappered</span> with a class that implements <span class=SpellE>IOperation</span>
- operation protocol to the Change protocol.<o:p></o:p></span></p>
+ (and <span class=SpellE>IWorkspaceOperation</span>) and maps the operation
+ protocol to the Change protocol.<o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l4 level1 lfo16;
+ <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l3 level1 lfo16;
  tab-stops:list 39.0pt'><![if !supportLists]><span style='font-size:10.0pt;
  font-family:Arial;mso-fareast-font-family:Arial'><span style='mso-list:Ignore'>2.<span
  style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
-Line 1963
+Line 2095
  replaced with an alternate implementation that uses the operations history to
  maintain the undo and redo history.<o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l4 level1 lfo16;
+ <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l3 level1 lfo16;
  tab-stops:list 39.0pt'><![if !supportLists]><span style='font-size:10.0pt;
  font-family:Arial;mso-fareast-font-family:Arial'><span style='mso-list:Ignore'>3.<span
  style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
- style='font-size:10.0pt;font-family:Arial'>The workspace listener and
+ style='font-size:10.0pt;font-family:Arial'>The workspace listener and validation
- validation strategy used in the Change framework was maintained since the
+ strategy used in the Change framework was maintained since the timing of the
- timing of the notifications was critical.<span style='mso-spacerun:yes'>�
+ notifications was critical.<span style='mso-spacerun:yes'>� </span>Additional
- </span>Additional integration work could be done to use the operations history
+ integration work could be done to use the operations history listeners for the
- listeners for the same purpose, or to change the validation strategy as more
+ same purpose, or to change the validation strategy as more workspace operations
- workspace operations are supported outside of refactoring.<o:p></o:p></span></p>
+ are supported outside of refactoring.<o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l4 level1 lfo16;
+ <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l3 level1 lfo16;
  tab-stops:list 39.0pt'><![if !supportLists]><span style='font-size:10.0pt;
  font-family:Arial;mso-fareast-font-family:Arial'><span style='mso-list:Ignore'>4.<span
  style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
-Line 1984
+Line 2116
  affected by the workspace operation and determine whether another context
  should be assigned to the operation.<o:p></o:p></span></p>
- <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l4 level1 lfo16;
+ <p class=MsoNormal style='margin-left:39.0pt;text-indent:-.25in;mso-list:l3 level1 lfo16;
  tab-stops:list 39.0pt'><![if !supportLists]><span style='font-size:10.0pt;
  font-family:Arial;mso-fareast-font-family:Arial'><span style='mso-list:Ignore'>5.<span
  style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
-Line 1992
+Line 2124
  undone and redone from any view or editor that installed the undo and redo
  handlers on the workspace context.<o:p></o:p></span></p>
- <h3>Text editor example:<span style='mso-spacerun:yes'>� </span>implementing
+ <h3>Text editor example:<span style='mso-spacerun:yes'>� </span>implementing <span
- IOperation in preexisting commands</h3>
+ class=SpellE>IOperation</span> in preexisting commands</h3>
- <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>The JFace
+ <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>The <span
- text framework supports undo and redo of text editing operations.<span
+ class=SpellE>JFace</span> text framework supports undo and redo of text editing
- style='mso-spacerun:yes'>� </span>This implementation relies on private undo
+ operations.<span style='mso-spacerun:yes'>� </span>This implementation relies
- stacks that are maintained by each editor.<span style='mso-spacerun:yes'>�
+ on private undo stacks that are maintained by each editor.<span
- </span>The JFace IUndoManager listens to text changes coming from the
+ style='mso-spacerun:yes'>� </span>The <span class=SpellE>JFace</span> <span
- underlying widget, and builds a TextCommand for each undoable edit.<span
+ class=SpellE>IUndoManager</span> listens to text changes coming from the
- style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
+ underlying widget, and builds a <span class=SpellE>TextCommand</span> for each
+ undoable edit.<span style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'><o:p>&nbsp;</o:p></span></p>
  <p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial'>A prototype
- integrated the text undo in JFace with the operations framework as follows:<o:p></o:p></span></p>
+ integrated the text undo in <span class=SpellE>JFace</span> with the operations
+ framework as follows:<o:p></o:p></span></p>
  <ol style='margin-top:0in' start=1 type=1>
-  <li class=MsoNormal style='mso-list:l5 level1 lfo19;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l4 level1 lfo19;tab-stops:list .5in'><span
-      style='font-size:10.0pt;font-family:Arial'>The existing TextCommand was
+      style='font-size:10.0pt;font-family:Arial'>The existing <span
-      altered to implement the IOperation interface.<o:p></o:p></span></li>
+      class=SpellE>TextCommand</span> was altered to implement the <span
-  <li class=MsoNormal style='mso-list:l5 level1 lfo19;tab-stops:list .5in'><span
+      class=SpellE>IOperation</span> interface.<o:p></o:p></span></li>
+  <li class=MsoNormal style='mso-list:l4 level1 lfo19;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>Specialized contexts (one
       instance for each text editor) are assigned to the operations.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l5 level1 lfo19;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l4 level1 lfo19;tab-stops:list .5in'><span
-      style='font-size:10.0pt;font-family:Arial'>The existing UndoManager was
+      style='font-size:10.0pt;font-family:Arial'>The existing <span
-      replaced with an alternate implementation that added text commands to the
+      class=SpellE>UndoManager</span> was replaced with an alternate
-      operations history instead of a local stack, and used the operation
+      implementation that added text commands to the operations history instead
-      history protocol when handling undo and redo commands.<o:p></o:p></span></li>
+      of a local stack, and used the operation history protocol when handling
-  <li class=MsoNormal style='mso-list:l5 level1 lfo19;tab-stops:list .5in'><span
+      undo and redo commands.<o:p></o:p></span></li>
+  <li class=MsoNormal style='mso-list:l4 level1 lfo19;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>The undo manager installs a
       listener on the history to monitor new operations that are added to the
       history.<o:p></o:p></span></li>
-  <li class=MsoNormal style='mso-list:l5 level1 lfo19;tab-stops:list .5in'><span
+  <li class=MsoNormal style='mso-list:l4 level1 lfo19;tab-stops:list .5in'><span
       style='font-size:10.0pt;font-family:Arial'>When an �outside� operation is
       added to the history, the undo manager consults the editor�s operation
       context to see if the outside operation is relevant.<span

 Legend:



Removed from v.1.3
 


changed lines


 
Added in v.1.4
 Legend:



Removed from v.1.3
 


changed lines


 
Added in v.1.4
-Removed from v.1.3
+Added in v.1.4

help@eclipse.org	ViewVC Help
Powered by ViewVC 1.0.3