-bool LyXFind(BufferView *,
- string const & searchstr, bool forward,
- bool frominset = false, bool casesens = true,
- bool matchwrd = false);
+/**
+ * This function is called as a general interface to find some
+ * text from the actual cursor position in whatever direction
+ * we want to go. This does also update the screen.
+ */
+bool find(BufferView *,
+ std::string const & searchstr, bool forward,
+ bool casesens = true, bool matchwrd = false);
+
+/**
+ * This function does search from the cursor position inside the
+ * passed LyXText parameter and regards this LyXText as the root
+ * LyXText. It will NOT update any screen stuff. It will however
+ * set the cursor to the new position inside LyXText, before
+ * returning to the calling function.
+ */
+
+SearchResult find(BufferView *, LyXText * text,
+ std::string const & searchstr, bool forward,
+ bool casesens = true, bool matchwrd = false);
+
+/// find the next change in the buffer
+bool findNextChange(BufferView * bv);
+
+SearchResult findNextChange(BufferView * bv, LyXText * text, lyx::pos_type & length);
+
+SearchResult nextChange(BufferView * bv, LyXText * text, lyx::pos_type & length);
+
+} // namespace find
+} // namespace lyx