]> git.lyx.org Git - lyx.git/blobdiff - src/Buffer.h
Update notes.
[lyx.git] / src / Buffer.h
index 1d372f48483276dbec6a68c28aceb5e6a04cbbae..297e63208ce126bf5110d47a62f428f3292ffd73 100644 (file)
@@ -21,6 +21,7 @@
 #include "support/SignalSlot.h"
 
 #include <list>
+#include <set>
 #include <string>
 #include <vector>
 
@@ -124,11 +125,17 @@ public:
        };
 
        /// Constructor
-       explicit Buffer(std::string const & file, bool b = false);
+       explicit Buffer(std::string const & file, bool readonly = false,
+               Buffer const * cloned_buffer = 0);
 
        /// Destructor
        ~Buffer();
 
+       ///
+       Buffer * clone() const;
+       ///
+       bool isClone() const;
+
        /** High-level interface to buffer functionality.
            This function parses a command string and executes it.
        */
@@ -177,8 +184,10 @@ public:
        /// Write file. Returns \c false if unsuccesful.
        bool writeFile(support::FileName const &) const;
 
-       /// Loads LyX file \c filename into buffer, *  and \return success
+       /// Loads LyX file \c filename into buffer, *  and return success
        bool loadLyXFile(support::FileName const & s);
+       /// Reloads the LyX file
+       bool reload();
 
        /// Fill in the ErrorList with the TeXErrors
        void bufferErrors(TeXErrors const &, ErrorList &) const;
@@ -311,14 +320,17 @@ public:
        /// \return true if \p child is a child of this \c Buffer.
        bool isChild(Buffer * child) const;
        
-       /// return a vector with all children and grandchildren
-       std::vector<Buffer *> getChildren() const;
+       /// return a vector with all children (and grandchildren)
+       std::vector<Buffer *> getChildren(bool grand_children = true) const;
+
+       /// Add all children (and grandchildren) to supplied vector
+       void getChildren(std::vector<Buffer *> & children, bool grand_children = true) const;
 
        /// Is buffer read-only?
        bool isReadonly() const;
 
        /// Set buffer read-only flag
-       void setReadonly(bool flag = true) const;
+       void setReadonly(bool flag = true);
 
        /// returns \c true if the buffer contains a LaTeX document
        bool isLatex() const;
@@ -338,15 +350,23 @@ public:
        */
        void validate(LaTeXFeatures &) const;
 
-       /// Update the cache with all bibfiles in use (including bibfiles
+       /// Update the list of all bibfiles in use (including bibfiles
        /// of loaded child documents).
        void updateBibfilesCache(UpdateScope scope = UpdateMaster) const;
-       ///
-       void invalidateBibinfoCache();
-       /// Return the cache with all bibfiles in use (including bibfiles
+       /// Return the list with all bibfiles in use (including bibfiles
        /// of loaded child documents).
        support::FileNameList const & 
                getBibfilesCache(UpdateScope scope = UpdateMaster) const;
+       /// Information from BibTeX databases is cached in the Buffer, so
+       /// we do not have to read the file over and over. 
+       /// Calling this method invalidates the cache and so requires a
+       /// re-read.
+       void invalidateBibinfoCache();
+       /// Updates the cached bibliography information.
+       /// Note that you MUST call this method to update the cache. It will
+       /// not happen otherwise. (Currently, it is called at the start of
+       /// updateLabels() and from GuiCitation.)
+       void checkBibInfoCache() const;
        /// \return the bibliography information for this buffer's master,
        /// or just for it, if it isn't a child.
        BiblioInfo const & masterBibInfo() const;
@@ -429,6 +449,10 @@ public:
        /// Return macro defined before the inclusion of the child
        MacroData const * getMacro(docstring const & name, Buffer const & child, bool global = true) const;
 
+       /// Collect user macro names at loading time
+       typedef std::set<docstring> UserMacroSet;
+       UserMacroSet usermacros;
+
        /// Replace the inset contents for insets which InsetCode is equal
        /// to the passed \p inset_code.
        void changeRefsIfUnique(docstring const & from, docstring const & to,
@@ -456,7 +480,9 @@ public:
        Undo & undo();
 
        /// This function is called when the buffer is changed.
-       void changed() const;
+       void changed(bool update_metrics) const;
+       ///
+       void setChild(DocIterator const & dit, Buffer * child);
        ///
        void updateTocItem(std::string const &, DocIterator const &) const;
        /// This function is called when the buffer structure is changed.
@@ -495,15 +521,18 @@ public:
 
        ///
        bool doExport(std::string const & format, bool put_in_tempdir,
-               std::string & result_file) const;
+               bool includeall, std::string & result_file) const;
        ///
-       bool doExport(std::string const & format, bool put_in_tempdir) const;
+       bool doExport(std::string const & format, bool put_in_tempdir,
+                     bool includeall = false) const;
        ///
-       bool preview(std::string const & format) const;
+       bool preview(std::string const & format, bool includeall = false) const;
        ///
        bool isExportable(std::string const & format) const;
        ///
        std::vector<Format const *> exportableFormats(bool only_viewable) const;
+       ///
+       bool isExportableFormat(std::string const & format) const;
 
        ///
        typedef std::vector<std::pair<InsetRef *, ParIterator> > References;
@@ -520,10 +549,16 @@ public:
        // FIXME This really shouldn't be needed, but at the moment it's not
        // clear how to do it just for the individual pieces we need.
        void setBuffersForInsets() const;
-       ///
-       void updateLabels(UpdateScope = UpdateMaster) const;
-       ///
-       void updateLabels(ParIterator & parit) const;
+       /// Updates screen labels and some other information associated with
+       /// insets and paragraphs. Actually, it's more like a general "recurse
+       /// through the Buffer" routine, that visits all the insets and paragraphs.
+       void updateLabels() const { updateLabels(UpdateMaster, false); }
+       /// \param scope: whether to start with the master document or just
+       /// do this one.
+       /// \param output: whether we are preparing for output.
+       void updateLabels(UpdateScope scope, bool output) const;
+       /// 
+       void updateLabels(ParIterator & parit, bool output) const;
 
        /// Spellcheck starting from \p from.
        /// \p from initial position, will then points to the next misspelled
@@ -543,7 +578,8 @@ private:
        */
        void updateMacros(DocIterator & it,
                                     DocIterator & scope) const;
-
+       ///
+       void setLabel(ParIterator & it) const;
        ///
        void collectRelatives(BufferSet & bufs) const;
 
@@ -566,7 +602,7 @@ private:
        class Impl;
        /// The pointer never changes although *pimpl_'s contents may.
        Impl * const d;
-
+       ///
        frontend::GuiBufferDelegate * gui_;
 
        /// This function is called when the buffer structure is changed.