]> git.lyx.org Git - lyx.git/blobdiff - src/Buffer.h
* zh_TW.po: Update from Mingyi Wu
[lyx.git] / src / Buffer.h
index f4cb22f964a54391fa168d53e870f839a62ea52f..fe0294bf1f608cf0e741102dc5cff54e7aa1ffe1 100644 (file)
@@ -15,8 +15,6 @@
 #include "OutputEnums.h"
 #include "OutputParams.h"
 
-#include "insets/InsetCode.h"
-
 #include "support/strfwd.h"
 #include "support/types.h"
 
@@ -79,10 +77,12 @@ class PreviewLoader;
 
 class Buffer;
 typedef std::list<Buffer *> ListOfBuffers;
+/// a list of Buffers we cloned
+typedef std::set<Buffer *> CloneList;
 
 
 /** The buffer object.
- * This is the buffer object. It contains all the informations about
+ * This is the buffer object. It contains all the information about
  * a document loaded into LyX.
  * The buffer object owns the Text (wrapped in an InsetText), which
  * contains the individual paragraphs of the document.
@@ -92,6 +92,9 @@ typedef std::list<Buffer *> ListOfBuffers;
  * minimal, probably not.
  * \author Lars Gullik Bjønnes
  */
+
+class MarkAsExporting;
+
 class Buffer {
 public:
        /// What type of log will \c getLogName() return?
@@ -109,7 +112,7 @@ public:
                ReadWrongVersion,
                ReadFileNotFound,
                ReadVCError,
-               ReadAutosaveFailure,            
+               ReadAutosaveFailure,
                ReadEmergencyFailure,
                ReadNoLyXFormat,
                ReadDocumentFailure,
@@ -125,6 +128,7 @@ public:
        enum ExportStatus {
                // export
                ExportSuccess,
+               ExportCancel,
                ExportError,
                ExportNoPathToFormat,
                ExportTexPathHasSpaces,
@@ -138,7 +142,7 @@ public:
        /// isExternallyModified()
        /**
         * timestamp is fast but inaccurate. For example, the granularity
-        * of timestamp on a FAT filesystem is 2 second. Also, various operations
+        * of timestamp on a FAT filesystem is 2 seconds. 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
@@ -165,8 +169,11 @@ public:
        /// Destructor
        ~Buffer();
 
-       ///
-       Buffer * clone() const;
+       /// Clones the entire structure of which this Buffer is part, starting
+       /// with the master and cloning all the children, too.
+       Buffer * cloneFromMaster() const;
+       /// Just clones this single Buffer. For autosave.
+       Buffer * cloneBufferOnly() const;
        ///
        bool isClone() const;
 
@@ -216,6 +223,10 @@ public:
        /// emergency or autosave files, one should use \c loadLyXFile.
        /// /sa loadLyXFile
        ReadStatus loadThisLyXFile(support::FileName const & fn);
+       /// import a new document from a string
+       bool importString(std::string const &, docstring const &, ErrorList &);
+       /// import a new file
+       bool importFile(std::string const &, support::FileName const &, ErrorList &);
        /// read a new document from a string
        bool readString(std::string const &);
        /// Reloads the LyX file
@@ -229,9 +240,9 @@ private:
        ///
        typedef std::map<Buffer const *, Buffer *> BufferMap;
        ///
-       void clone(BufferMap &) const;
+       void cloneWithChildren(BufferMap &, CloneList *) const;
        /// save timestamp and checksum of the given file.
-       void saveCheckSum() const;      
+       void saveCheckSum() const;
        /// read a new file
        ReadStatus readFile(support::FileName const & fn);
        /// Reads a file without header.
@@ -239,18 +250,17 @@ private:
        /// \return \c true if file is not completely read.
        bool readDocument(Lexer &);
        /// Try to extract the file from a version control container
-       /// before reading if the file cannot be found. This is only
-       /// implemented for RCS.
+       /// before reading if the file cannot be found.
        /// \sa LyXVC::file_not_found_hook
        ReadStatus extractFromVC();
-       /// Reads the first tag of a LyX File and 
+       /// Reads the first tag of a LyX File and
        /// returns the file format number.
        ReadStatus parseLyXFormat(Lexer & lex, support::FileName const & fn,
                int & file_format) const;
        /// Convert the LyX file to the LYX_FORMAT using
        /// the lyx2lyx script and returns the filename
        /// of the temporary file to be read
-       ReadStatus convertLyXFormat(support::FileName const & fn, 
+       ReadStatus convertLyXFormat(support::FileName const & fn,
                support::FileName & tmpfile, int from_format);
        //@}
 
@@ -258,7 +268,7 @@ public:
        /// \name Functions involved in autosave and emergency files.
        //@{
        /// Save an autosave file to #filename.lyx#
-       bool autoSave() const;  
+       bool autoSave() const;
        /// save emergency file
        /// \return a status message towards the user.
        docstring emergencyWrite();
@@ -267,11 +277,11 @@ public:
 //private:
        ///
        void removeAutosaveFile() const;
-       
+
 private:
        /// Try to load an autosave file associated to \c fn.
        ReadStatus loadAutosave();
-       /// Try to load an emergency file associated to \c fn. 
+       /// Try to load an emergency file associated to \c fn.
        ReadStatus loadEmergency();
        /// Get the filename of the emergency file associated with the Buffer
        support::FileName getEmergencyFileName() const;
@@ -288,6 +298,7 @@ public:
        enum OutputWhat {
                FullSource,
                OnlyBody,
+               IncludedFile,
                OnlyPreamble,
                CurrentParagraph
        };
@@ -372,6 +383,8 @@ public:
        /// automatically saved, nor it needs to trigger any "do you want to save ?" question.
        bool isInternal() const;
 
+       void setInternal(bool flag);
+
        /// Mark this buffer as dirty.
        void markDirty();
 
@@ -381,7 +394,7 @@ public:
        /// Returns the buffer's filename. It is always an absolute path.
        std::string absFileName() const;
 
-       /// Returns the the path where the buffer lives.
+       /// Returns the path where the buffer lives.
        /// It is always an absolute path.
        std::string filePath() const;
 
@@ -404,15 +417,15 @@ public:
 
        /// \return true if \p child is a child of this \c Buffer.
        bool isChild(Buffer * child) const;
-       
+
        /// \return true if this \c Buffer has children
        bool hasChildren() const;
-       
+
        /// \return a list of the direct children of this Buffer.
        /// this list has no duplicates and is in the order in which
        /// the children appear.
        ListOfBuffers getChildren() const;
-       
+
        /// \return a list of all descendents of this Buffer (children,
        /// grandchildren, etc). this list has no duplicates and is in
        /// the order in which the children appear.
@@ -444,7 +457,7 @@ public:
        void validate(LaTeXFeatures &) const;
 
        /// Reference information is cached in the Buffer, so we do not
-       /// have to check or read things over and over. 
+       /// have to check or read things over and over.
        ///
        /// There are two caches.
        ///
@@ -452,11 +465,11 @@ public:
        /// being gathered. This cache is PER BUFFER, and the cache for the
        /// master essentially includes the cache for its children. This gets
        /// invalidated when an InsetBibtex is created, deleted, or modified.
-       /// 
+       ///
        /// The other is a cache of the reference information itself. This
        /// exists only in the master buffer, and when it needs to be updated,
        /// the children add their information to the master's cache.
-       
+
        /// Calling this method invalidates the cache and so requires a
        /// re-read.
        void invalidateBibinfoCache() const;
@@ -477,10 +490,15 @@ public:
        /// add a single piece of bibliography info to our cache
        void addBibTeXInfo(docstring const & key, BibTeXInfo const & bi) const;
        ///
+       void makeCitationLabels() const;
+       ///
        bool citeLabelsValid() const;
        ///
        void getLabelList(std::vector<docstring> &) const;
 
+       /// This removes the .aux and .bbl files from the temp dir.
+       void removeBiblioTempFiles() const;
+
        ///
        void changeLanguage(Language const * from, Language const * to);
 
@@ -492,6 +510,8 @@ public:
        ///
        BufferParams & params();
        BufferParams const & params() const;
+       ///
+       BufferParams const & masterParams() const;
 
        /** The list of paragraphs.
            This is a linked list of paragraph, this list holds the
@@ -570,13 +590,13 @@ public:
 
        /// Replace the inset contents for insets which InsetCode is equal
        /// to the passed \p inset_code.
-       void changeRefsIfUnique(docstring const & from, docstring const & to,
-               InsetCode code);
+       void changeRefsIfUnique(docstring const & from, docstring const & to);
 
        /// get source code (latex/docbook) for some paragraphs, or all paragraphs
        /// including preamble
        void getSourceCode(odocstream & os, std::string const format,
-                          pit_type par_begin, pit_type par_end, OutputWhat output) const;
+                          pit_type par_begin, pit_type par_end, OutputWhat output,
+                          bool master) const;
 
        /// Access to error list.
        /// This method is used only for GUI visualisation of Buffer related
@@ -636,19 +656,24 @@ private:
                bool includeall) const;
        ///
        ExportStatus preview(std::string const & format, bool includeall = false) const;
+       ///
+       void setMathFlavor(OutputParams & op) const;
 
 public:
-       /// mark the buffer as busy exporting something, or not
-       void setExportStatus(bool e) const;
        ///
        bool isExporting() const;
 
        ///
        typedef std::vector<std::pair<Inset *, ParIterator> > References;
-       References & references(docstring const & label);
+       ///
        References const & references(docstring const & label) const;
+       ///
+       void addReference(docstring const & label, Inset * inset, ParIterator it);
+       ///
        void clearReferenceCache() const;
+       ///
        void setInsetLabel(docstring const & label, InsetLabel const * il);
+       ///
        InsetLabel const * insetLabel(docstring const & label) const;
 
        /// return a list of all used branches (also in children)
@@ -666,7 +691,7 @@ public:
        /// do this one.
        /// \param output: whether we are preparing for output.
        void updateBuffer(UpdateScope scope, UpdateType utype) const;
-       /// 
+       ///
        void updateBuffer(ParIterator & parit, UpdateType utype) const;
 
        /// Spellcheck starting from \p from.
@@ -679,8 +704,26 @@ public:
                WordLangTuple & word_lang, docstring_list & suggestions) const;
        ///
        void checkChildBuffers();
+       ///
+       void checkMasterBuffer();
+
+       /// compute statistics between \p from and \p to
+       /// \p from initial position
+       /// \p to points to the end position
+       /// \p skipNoOutput if notes etc. should be ignored
+       void updateStatistics(DocIterator & from, DocIterator & to,
+                                                 bool skipNoOutput = true) const;
+       /// statistics accessor functions
+       int wordCount() const;
+       int charCount(bool with_blanks) const;
 
 private:
+       friend class MarkAsExporting;
+       /// mark the buffer as busy exporting something, or not
+       void setExportStatus(bool e) const;
+
+       ///
+       References & getReferenceCache(docstring const & label);
        /// Change name of buffer. Updates "read-only" flag.
        void setFileName(support::FileName const & fname);
        ///
@@ -694,7 +737,7 @@ private:
        void updateBibfilesCache(UpdateScope scope = UpdateMaster) const;
        /// Return the list with all bibfiles in use (including bibfiles
        /// of loaded child documents).
-       support::FileNameList const & 
+       support::FileNameList const &
                getBibfilesCache(UpdateScope scope = UpdateMaster) const;
        ///
        void collectChildren(ListOfBuffers & children, bool grand_children) const;
@@ -710,6 +753,25 @@ private:
 };
 
 
+/// Helper class, to guarantee that the export status
+/// gets reset properly. To use, simply create a local variable:
+///    MarkAsExporting mex(bufptr);
+/// and leave the rest to us.
+class MarkAsExporting {
+public:
+       MarkAsExporting(Buffer const * buf) : buf_(buf)
+       {
+               buf_->setExportStatus(true);
+       }
+       ~MarkAsExporting()
+       {
+               buf_->setExportStatus(false);
+       }
+private:
+       Buffer const * const buf_;
+};
+
+
 } // namespace lyx
 
 #endif