Attempt to fix #8137 (arrived at r40862).

[lyx.git] / src / Undo.h

diff --git a/src/Undo.h b/src/Undo.h
index 8945b58ca328a81a831465ff3fa2891939d90140..d5748a97ea4b116e5ce33e4b6b26653780345afd 100644 (file)
--- a/src/Undo.h
+++ b/src/Undo.h
@@ -5,10 +5,10 @@
  * Licence details can be found in the file COPYING.
  *
  * \author Asger Alstrup
- * \author Lars Gullik Bjønnes
+ * \author Lars Gullik Bjønnes
  * \author John Levon
- * \author André Pönitz
- * \author Jürgen Vigna
+ * \author André Pönitz
+ * \author Jürgen Vigna
  * \author Abdelrazak Younes
  *
  * Full author contact details are available in file CREDITS.
@@ -24,6 +24,7 @@ namespace lyx {
 class Buffer;
 class BufferParams;
 class DocIterator;
+class Inset;
 class MathData;
 class ParagraphList;
 
@@ -52,6 +53,9 @@ public:
 
        ~Undo();
 
+       /// Clear out all undo/redo contents.
+       void clear();
+
        /// this will undo the last action - returns false if no undo possible
        bool textUndo(DocIterator &);
 
@@ -59,7 +63,7 @@ public:
        bool textRedo(DocIterator &);
 
        /// End a sequence of INSERT_UNDO or DELETE_UNDO type of undo
-       /// operations.
+       /// operations (grouping of consecutive characters insertion/deletion).
        void finishUndo();
 
        ///
@@ -67,12 +71,22 @@ public:
        ///
        bool hasRedoStack() const;
 
-       /// open a new group of undo operations. Groups can be nested.
+       /// Mark all the elements of the undo and redo stacks as dirty
+       void markDirty();
+
+       /// open a new group of undo operations.
+       /**
+        *  Groups can be nested. Such a nested group e.g. { {} {} } is undone in
+        *  a single step. This means you can add a group whenever you are not sure.
+        */
        void beginUndoGroup();
 
        /// end the current undo group.
        void endUndoGroup();
 
+       /// end the current undo group and set UndoElement::cur_after if necessary.
+       void endUndoGroup(DocIterator const &);
+
        /// The general case: record undo information for an arbitrary range.
        /**
         * Record undo information - call with the current cursor and
@@ -94,8 +108,9 @@ public:
 
        /// Convenience: record undo information for the inset
        /// containing the cursor.
-       void recordUndoInset(DocIterator const & cur, 
-                            UndoKind kind = ATOMIC_UNDO);
+       void recordUndoInset(DocIterator const & cur,
+                            UndoKind kind = ATOMIC_UNDO,
+                            Inset const * inset = 0);
 
        /// Convenience: prepare undo for the whole buffer
        void recordUndoFullDocument(DocIterator const & cur);