More 'standard conformant blurb' nonsense.

[lyx.git] / src / undo_funcs.h

diff --git a/src/undo_funcs.h b/src/undo_funcs.h
index 0339bbc5f1c11000401eecc604a90f8bc4ae89cd..11b4d51809a0a2594c1974e7bb05a0fd77512440 100644 (file)
--- a/src/undo_funcs.h
+++ b/src/undo_funcs.h
@@ -1,9 +1,9 @@
 // -*- C++ -*-
 /* This file is part of
- * ====================================================== 
- * 
+ * ======================================================
+ *
  *           LyX, The Document Processor
- *        
+ *
  *           Copyright 1995-2001 The LyX Team.
  *
  * ====================================================== */
@@ -11,51 +11,47 @@
 #ifndef UNDO_FUNCS_H
 #define UNDO_FUNCS_H
 
-#ifdef __GNUG__
-#pragma interface
-#endif
-
 #include "undo.h"
+#include "ParagraphList.h"
 
 class BufferView;
 class Paragraph;
-class LyXCursor;
-
-/// returns false if no undo possible
-extern bool textUndo(BufferView *);
-/// returns false if no redo possible
-extern bool textRedo(BufferView *);
-/// used by TextUndo/TextRedo
-extern bool textHandleUndo(BufferView *, Undo * undo);
-/// makes sure the next operation will be stored
-extern void finishUndo();
-/// this is dangerous and for internal use only
-extern void freezeUndo();
-/// this is dangerous and for internal use only
-extern void unFreezeUndo();
-///
-extern void setUndo(BufferView *, Undo::undo_kind kind, 
-                    Paragraph const * first, Paragraph const * behind);
-///
-extern void setRedo(BufferView *, Undo::undo_kind kind,
-                    Paragraph const * first, Paragraph const * behind);
-///
-extern Undo * createUndo(BufferView *, Undo::undo_kind kind,
-                         Paragraph const * first, Paragraph const * behind);
-/// for external use in lyx_cb.C
-extern void setCursorParUndo(BufferView *);
-
-// returns a pointer to the very first Paragraph depending of where we are
-// so it will return the first paragraph of the buffer or the first paragraph
-// of the textinset we're in.
-extern Paragraph * firstUndoParagraph(BufferView *, int inset_arg);
-
-///
-extern LyXCursor const & undoCursor(BufferView * bv);
-
-/// the flag used by FinishUndo();
-extern bool undo_finished;
-/// a flag
+
+/// This will undo the last action - returns false if no undo possible
+bool textUndo(BufferView *);
+
+/// This will redo the last undo - returns false if no redo possible
+bool textRedo(BufferView *);
+
+/// Makes sure the next operation will be stored
+void finishUndo();
+
+/**
+ * Whilst undo is frozen, all actions do not get added
+ * to the undo stack
+ */
+void freezeUndo();
+
+/// Track undos again
+void unFreezeUndo();
+
+/**
+ * Record undo information - call with the first paragraph that will be changed
+ * and the last paragraph that will be changed. So we give an inclusive
+ * range.
+ * This is called before you make the changes to the paragraph, and it
+ * will record the original information of the paragraphs in the undo stack.
+ */
+void recordUndo(BufferView *, Undo::undo_kind kind,
+                   ParagraphList::iterator first, ParagraphList::iterator last);
+/// Convienience: Prepare undo when change in a single paragraph.
+void recordUndo(BufferView *, Undo::undo_kind kind,
+                   ParagraphList::iterator first);
+
+/// Convienience: Prepare undo for the paragraph that contains the cursor
+void recordUndo(BufferView *, Undo::undo_kind kind);
+
+/// Are we avoiding tracking undos currently ?
 extern bool undo_frozen;
 
-#endif
+#endif // UNDO_FUNCS_H