]> git.lyx.org Git - lyx.git/blobdiff - src/Buffer.h
* gcc does not like missing characters in keywords
[lyx.git] / src / Buffer.h
index 4ee955b5814c61a64d9f7319a691db32c4fba319..de5421ffc99fd5bc6bd626eef3661210010ea7a8 100644 (file)
 #ifndef BUFFER_H
 #define BUFFER_H
 
-#include "ErrorList.h"
-#include "InsetList.h"
-
-#include "DocIterator.h"
+#include "insets/InsetCode.h"
 
 #include "support/FileName.h"
-#include "support/limited_stack.h"
-#include "support/types.h"
 #include "support/docstring.h"
 #include "support/docstream.h"
-
-#include <boost/scoped_ptr.hpp>
-#include <boost/signal.hpp>
+#include "support/types.h"
 
 #include <iosfwd>
 #include <string>
-#include <map>
 #include <utility>
 #include <vector>
 
 namespace lyx {
 
 class BufferParams;
+class EmbeddedFiles;
 class ErrorItem;
+class ErrorList;
 class FuncRequest;
 class Inset;
-class InsetText;
 class Font;
+class Format;
 class Lexer;
 class LyXRC;
-class LyXText;
+class Text;
 class LyXVC;
 class LaTeXFeatures;
 class Language;
@@ -52,24 +46,27 @@ class OutputParams;
 class ParConstIterator;
 class ParIterator;
 class ParagraphList;
-class StableDocIterator;
 class TeXErrors;
 class TexRow;
 class TocBackend;
 class Undo;
 
+namespace frontend {
+class GuiBufferDelegate;
+class WorkAreaManager;
+}
 
 /** The buffer object.
  * This is the buffer object. It contains all the informations about
  * a document loaded into LyX.
- * The buffer object owns the LyXText (wrapped in an InsetText), which
+ * The buffer object owns the Text (wrapped in an InsetText), which
  * contains the individual paragraphs of the document.
  *
  *
  * I am not sure if the class is complete or
  * minimal, probably not.
  * \author Lars Gullik Bjønnes
 */
+ */
 class Buffer {
 public:
        /// What type of log will \c getLogName() return?
@@ -85,6 +82,22 @@ public:
                wrongversion ///< The version of the file does not match ours
        };
 
+       /// Method to check if a file is externally modified, used by 
+       /// isExternallyModified()
+       /**
+        * timestamp is fast but inaccurate. For example, the granularity
+        * of timestamp on a FAT filesystem is 2 second. Also, various operations
+        * may touch the timestamp of a file even when its content is unchanged.
+        *
+        * checksum is accurate but slow, which can be a problem when it is 
+        * frequently used, or used for a large file on a slow (network) file
+        * system.
+        */
+       enum CheckMethod {
+               checksum_method,  ///< Use file check sum
+               timestamp_method, ///< Use timestamp, and checksum if timestamp has changed
+       };
+       
        /** Constructor
            \param file
            \param b  optional \c false by default
@@ -128,25 +141,8 @@ public:
        /// do we have a paragraph with this id?
        bool hasParWithID(int id) const;
 
-       /// This signal is emitted when the buffer is changed.
-       boost::signal<void()> changed;
-       /// This signal is emitted when the buffer structure is changed.
-       boost::signal<void()> structureChanged;
-       /// This signal is emitted when some parsing error shows up.
-       boost::signal<void(std::string)> errors;
-       /// This signal is emitted when some message shows up.
-       boost::signal<void(docstring)> message;
-       /// This signal is emitted when the buffer busy status change.
-       boost::signal<void(bool)> busy;
-       /// This signal is emitted when the buffer readonly status change.
-       boost::signal<void(bool)> readonly;
-       /// Update window titles of all users.
-       boost::signal<void()> updateTitles;
-       /// Reset autosave timers for all users.
-       boost::signal<void()> resetAutosaveTimers;
-       /// This signal is emitting if the buffer is being closed.
-       boost::signal<void()> closing;
-
+       ///
+       frontend::WorkAreaManager & workAreaManager() const;
 
        /** Save file.
            Takes care of auto-save files and backup file if requested.
@@ -159,6 +155,12 @@ public:
        /// Write file. Returns \c false if unsuccesful.
        bool writeFile(support::FileName const &) const;
 
+  /// Loads LyX file \c filename into buffer, *  and \return success 
+       bool loadLyXFile(support::FileName const & s);
+
+       /// Fill in the ErrorList with the TeXErrors
+       void bufferErrors(TeXErrors const &, ErrorList &) const;
+
        /// Just a wrapper for writeLaTeXSource, first creating the ofstream.
        bool makeLaTeXFile(support::FileName const & filename,
                           std::string const & original_path,
@@ -199,7 +201,7 @@ public:
                             OutputParams const & runparams_in,
                             bool only_body = false);
        /// returns the main language for the buffer (document)
-       Language const * getLanguage() const;
+       Language const * language() const;
        /// get l10n translated to the buffers language
        docstring const B_(std::string const & l10n) const;
 
@@ -212,11 +214,17 @@ public:
        ///
        bool isDepClean(std::string const & name) const;
 
+       /// whether or not disk file has been externally modified
+       bool isExternallyModified(CheckMethod method) const;
+
+       /// save timestamp and checksum of the given file.
+       void saveCheckSum(support::FileName const & file) const;
+
        /// mark the main lyx file as not needing saving
        void markClean() const;
 
        ///
-       void markBakClean();
+       void markBakClean() const;
 
        ///
        void markDepClean(std::string const & name);
@@ -231,7 +239,7 @@ public:
        void markDirty();
 
        /// Returns the buffer's filename. It is always an absolute path.
-       std::string const fileName() const;
+       std::string absFileName() const;
 
        /// Returns the the path where the buffer lives.
        /// It is always an absolute path.
@@ -240,10 +248,10 @@ public:
        /** A transformed version of the file name, adequate for LaTeX.
            \param no_path optional if \c true then the path is stripped.
        */
-       std::string const getLatexName(bool no_path = true) const;
+       std::string latexName(bool no_path = true) const;
 
        /// Get thee name and type of the log.
-       std::pair<LogType, std::string> const getLogName() const;
+       std::pair<LogType, std::string> logName() const;
 
        /// Change name of buffer. Updates "read-only" flag.
        void setFileName(std::string const & newfile);
@@ -254,11 +262,11 @@ public:
        /** Get the document's master (or \c this if this is not a
            child document)
         */
-       Buffer const * getMasterBuffer() const;
+       Buffer const * masterBuffer() const;
        /** Get the document's master (or \c this if this is not a
            child document)
         */
-       Buffer * getMasterBuffer();
+       Buffer * masterBuffer();
 
        /// Is buffer read-only?
        bool isReadonly() const;
@@ -284,8 +292,6 @@ public:
        */
        void validate(LaTeXFeatures &) const;
 
-       /// return all bibkeys from buffer and its childs
-       void fillWithBibKeys(std::vector<std::pair<std::string, docstring> > & keys) const;
        /// Update the cache with all bibfiles in use (including bibfiles
        /// of loaded child documents).
        void updateBibfilesCache();
@@ -301,14 +307,6 @@ public:
        ///
        bool isMultiLingual() const;
 
-       /// Does this mean that this is buffer local?
-       limited_stack<Undo> & undostack();
-       limited_stack<Undo> const & undostack() const;
-
-       /// Does this mean that this is buffer local?
-       limited_stack<Undo> & redostack();
-       limited_stack<Undo> const & redostack() const;
-
        ///
        BufferParams & params();
        BufferParams const & params() const;
@@ -344,14 +342,14 @@ public:
         *  Used to prevent the premature generation of previews
         *  and by the citation inset.
         */
-       bool fully_loaded() const;
+       bool isFullyLoaded() const;
        /// Set by buffer_funcs' newFile.
-       void fully_loaded(bool);
+       void setFullyLoaded(bool);
 
        /// Our main text (inside the top InsetText)
-       LyXText & text() const;
+       Text & text() const;
 
-       /// Our top InsetText!
+       /// Our top InsetText
        Inset & inset() const;
 
        //
@@ -366,53 +364,95 @@ public:
        ///
        void insertMacro(docstring const & name, MacroData const & data);
 
-       ///
-       void saveCursor(StableDocIterator cursor, StableDocIterator anchor);
-       ///
-       StableDocIterator getCursor() const { return cursor_; }
-       ///
-       StableDocIterator getAnchor() const { return anchor_; }
-       ///
+       /// Replace the inset contents for insets which InsetCode is equal
+       /// to the passed \p inset_code.
        void changeRefsIfUnique(docstring const & from, docstring const & to,
-               Inset::Code code);
-/// get source code (latex/docbook) for some paragraphs, or all paragraphs
-/// including preamble
-       void getSourceCode(odocstream & os, pit_type par_begin, pit_type par_end, bool full_source);
+               InsetCode code);
 
-       /// errorLists_ accessors.
-       //@{
+       /// get source code (latex/docbook) for some paragraphs, or all paragraphs
+       /// including preamble
+       void getSourceCode(odocstream & os, pit_type par_begin, pit_type par_end,
+               bool full_source);
+
+       /// Access to error list
        ErrorList const & errorList(std::string const & type) const;
        ErrorList & errorList(std::string const & type);
-       //@}
 
        //@{
        TocBackend & tocBackend();
        TocBackend const & tocBackend() const;
        //@}
+       
+       //@{
+       EmbeddedFiles & embeddedFiles();
+       EmbeddedFiles const & embeddedFiles() const;
+       //@}
+
+       Undo & undo();
+       
+       /// This function is called when the buffer is changed.
+       void changed() const;
+       /// This function is called when the buffer structure is changed.
+       void structureChanged() const;
+       /// This function is called when some parsing error shows up.
+       void errors(std::string const & err) const;
+       /// This function is called when the buffer busy status change.
+       void setBusy(bool on) const;
+       /// This function is called when the buffer readonly status change.
+       void setReadOnly(bool on) const;
+       /// Update window titles of all users.
+       void updateTitles() const;
+       /// Reset autosave timers for all users.
+       void resetAutosaveTimers() const;
+       ///
+       void message(docstring const & msg) const;
+
+       void setGuiDelegate(frontend::GuiBufferDelegate * gui);
+
+       ///
+       void autoSave() const;
+       ///
+       bool writeAs(std::string const & newname = std::string());
+       ///
+       bool menuWrite();
+       ///
+       void loadChildDocuments() const;
+       /// return the format of the buffer on a string
+       std::string bufferFormat() const;
+
+       ///
+       bool doExport(std::string const & format, bool put_in_tempdir,
+               std::string & result_file);
+       ///
+       bool doExport(std::string const & format, bool put_in_tempdir);
+       ///
+       bool preview(std::string const & format);
+       ///
+       bool isExportable(std::string const & format) const;
+       ///
+       std::vector<Format const *> exportableFormats(bool only_viewable) const;
 
 private:
+  /// 
+       bool readFileHelper(support::FileName const & s);
+       ///
+       std::vector<std::string> backends() const;
        /** Inserts a file into a document
            \return \c false if method fails.
        */
        ReadStatus readFile(Lexer &, support::FileName const & filename,
-                           bool fromString = false);
+                           bool fromString = false);
 
        /// Use the Pimpl idiom to hide the internals.
        class Impl;
        /// The pointer never changes although *pimpl_'s contents may.
-       boost::scoped_ptr<Impl> const pimpl_;
+       Impl * const pimpl_;
 
-       /// Save the cursor Position on Buffer switch
-       /// this would not be needed if every Buffer would have
-       /// it's BufferView, this should be FIXED in future.
-       StableDocIterator cursor_;
-       StableDocIterator anchor_;
        /// A cache for the bibfiles (including bibfiles of loaded child
        /// documents), needed for appropriate update of natbib labels.
        mutable std::vector<support::FileName> bibfilesCache_;
 
-       /// Container for all sort of Buffer dependant errors.
-       std::map<std::string, ErrorList> errorLists_;
+       frontend::GuiBufferDelegate * gui_;
 };