X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2FBuffer.h;h=f932a565cef68516a1ee7e39662750bdcf827ff3;hb=1c362c80b22012d66472da713ffa0cf3d71815e7;hp=fe8c93f251cb9b9c0e88fbc408a1759544908927;hpb=4ce0961b5acbaf0f78d6782cfedbbfa885b763ae;p=lyx.git diff --git a/src/Buffer.h b/src/Buffer.h index fe8c93f251..f932a565ce 100644 --- a/src/Buffer.h +++ b/src/Buffer.h @@ -12,32 +12,29 @@ #ifndef BUFFER_H #define BUFFER_H -#include "DocIterator.h" +#include "insets/InsetCode.h" -#include "support/FileName.h" -#include "support/limited_stack.h" +#include "support/strfwd.h" #include "support/types.h" -#include "support/docstring.h" -#include "support/docstream.h" +#include "support/SignalSlot.h" -#include -#include - -#include #include -#include #include namespace lyx { +class BiblioInfo; class BufferParams; +class DocIterator; class ErrorItem; class ErrorList; class FuncRequest; class Inset; -class InsetText; +class InsetRef; +class InsetLabel; class Font; +class Format; class Lexer; class LyXRC; class Text; @@ -45,7 +42,10 @@ class LyXVC; class LaTeXFeatures; class Language; class MacroData; +class MacroNameSet; +class MacroSet; class OutputParams; +class Paragraph; class ParConstIterator; class ParIterator; class ParagraphList; @@ -55,9 +55,15 @@ class TocBackend; class Undo; namespace frontend { +class GuiBufferDelegate; class WorkAreaManager; } +namespace support { +class FileName; +class FileNameList; +} + /** The buffer object. * This is the buffer object. It contains all the informations about * a document loaded into LyX. @@ -68,7 +74,7 @@ class WorkAreaManager; * 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? @@ -84,6 +90,7 @@ public: wrongversion ///< The version of the file does not match ours }; + /// Method to check if a file is externally modified, used by /// isExternallyModified() /** @@ -94,9 +101,11 @@ public: * 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. + * + * FIXME: replace this method with support/FileMonitor. */ enum CheckMethod { - checksum_method, ///< Use file check sum + checksum_method, ///< Use file checksum timestamp_method, ///< Use timestamp, and checksum if timestamp has changed }; @@ -139,33 +148,12 @@ public: pit_type &, pos_type &, Font const &, docstring const &, bool); /// - ParIterator getParFromID(int id) const; + DocIterator getParFromID(int id) const; /// do we have a paragraph with this id? bool hasParWithID(int id) const; - /// This signal is emitted when the buffer is changed. - void changed(); - /// - frontend::WorkAreaManager * workAreaManager() const; - - /// This signal is emitted when the buffer structure is changed. - boost::signal structureChanged; - /// This signal is emitted when an embedded file is changed - boost::signal embeddingChanged; - /// This signal is emitted when some parsing error shows up. - boost::signal errors; - /// This signal is emitted when some message shows up. - boost::signal message; - /// This signal is emitted when the buffer busy status change. - boost::signal busy; - /// This signal is emitted when the buffer readonly status change. - boost::signal readonly; - /// Update window titles of all users. - boost::signal updateTitles; - /// Reset autosave timers for all users. - boost::signal resetAutosaveTimers; - + frontend::WorkAreaManager & workAreaManager() const; /** Save file. Takes care of auto-save files and backup file if requested. @@ -178,12 +166,18 @@ 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, OutputParams const &, bool output_preamble = true, - bool output_body = true); + bool output_body = true) const; /** Export the buffer to LaTeX. If \p os is a file stream, and params().inputenc is "auto" or "default", and the buffer contains text in different languages @@ -208,17 +202,17 @@ public: std::string const & original_path, OutputParams const &, bool output_preamble = true, - bool output_body = true); + bool output_body = true) const; /// void makeDocBookFile(support::FileName const & filename, OutputParams const & runparams_in, - bool only_body = false); + bool only_body = false) const; /// void writeDocBookSource(odocstream & os, std::string const & filename, OutputParams const & runparams_in, - bool only_body = false); + bool only_body = false) const; /// 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; @@ -235,13 +229,13 @@ public: bool isExternallyModified(CheckMethod method) const; /// save timestamp and checksum of the given file. - void saveCheckSum(std::string const & file) const; + 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); @@ -256,34 +250,37 @@ public: void markDirty(); /// Returns the buffer's filename. It is always an absolute path. - std::string const fileName() const; + support::FileName fileName() const; + + /// Returns the buffer's filename. It is always an absolute path. + std::string absFileName() const; /// Returns the the path where the buffer lives. /// It is always an absolute path. - std::string const & filePath() const; + std::string filePath() const; /** 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 const getLogName() const; + std::string logName(LogType * type = 0) const; /// Change name of buffer. Updates "read-only" flag. void setFileName(std::string const & newfile); - /// Name of the document's parent - void setParentName(std::string const &); + /// Set document's parent Buffer. + void setParent(Buffer const *); + Buffer const * parent(); /** Get the document's master (or \c this if this is not a child document) */ - Buffer const * getMasterBuffer() const; - /** Get the document's master (or \c this if this is not a - child document) - */ - Buffer * getMasterBuffer(); + Buffer const * masterBuffer() const; + + /// \return true if \p child is a child of this \c Buffer. + bool isChild(Buffer * child) const; /// Is buffer read-only? bool isReadonly() const; @@ -311,10 +308,17 @@ public: /// Update the cache with all bibfiles in use (including bibfiles /// of loaded child documents). - void updateBibfilesCache(); + void updateBibfilesCache() const; + /// + void invalidateBibinfoCache(); /// Return the cache with all bibfiles in use (including bibfiles /// of loaded child documents). - std::vector const & getBibfilesCache() const; + support::FileNameList const & getBibfilesCache() const; + /// \return the bibliography information for this buffer's master, + /// or just for it, if it isn't a child. + BiblioInfo const & masterBibInfo() const; + /// \return the bibliography information for this buffer ONLY. + BiblioInfo const & localBibInfo() const; /// void getLabelList(std::vector &) const; @@ -324,14 +328,6 @@ public: /// bool isMultiLingual() const; - /// Does this mean that this is buffer local? - limited_stack & undostack(); - limited_stack const & undostack() const; - - /// Does this mean that this is buffer local? - limited_stack & redostack(); - limited_stack const & redostack() const; - /// BufferParams & params(); BufferParams const & params() const; @@ -348,10 +344,9 @@ public: LyXVC const & lyxvc() const; /// Where to put temporary files. - std::string const & temppath() const; + std::string const temppath() const; /// Used when typesetting to place errorboxes. - TexRow & texrow(); TexRow const & texrow() const; /// @@ -367,52 +362,121 @@ 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) Text & text() const; - /// Our top InsetText! + /// Our top InsetText Inset & inset() const; // // Macro handling // + /// Collect macro definitions in paragraphs + void updateMacros() const; + /// Iterate through the whole buffer and try to resolve macros + void updateMacroInstances() const; + + /// List macro names of this buffer, the parent and the children + void listMacroNames(MacroNameSet & macros) const; + /// Collect macros of the parent and its children in front of this buffer. + void listParentMacros(MacroSet & macros, LaTeXFeatures & features) const; + + /// Return macro defined before pos (or in the master buffer) + MacroData const * getMacro(docstring const & name, DocIterator const & pos, bool global = true) const; + /// Return macro defined anywhere in the buffer (or in the master buffer) + MacroData const * getMacro(docstring const & name, bool global = true) const; + /// Return macro defined before the inclusion of the child + MacroData const * getMacro(docstring const & name, Buffer const & child, bool global = true) const; + + /// 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); + + /// 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. + /// This method is used only for GUI visualisation of Buffer related + /// errors (like parsing or LateX compilation). This method is const + /// because modifying the returned ErrorList does not touch the document + /// contents. + ErrorList & errorList(std::string const & type) const; + + /// The Toc backend. + /// This is useful only for screen visualisation of the Buffer. This + /// method is const because modifying this backend does not touch + /// the document contents. + TocBackend & tocBackend() 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; + + /// 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) const; /// - void buildMacros(); + bool doExport(std::string const & format, bool put_in_tempdir) const; /// - bool hasMacro(docstring const & name) const; + bool preview(std::string const & format) const; /// - MacroData const & getMacro(docstring const & name) const; + bool isExportable(std::string const & format) const; /// - void insertMacro(docstring const & name, MacroData const & data); + std::vector exportableFormats(bool only_viewable) const; /// - 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); - - /// errorLists_ accessors. - //@{ - 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; - //@} + typedef std::vector > References; + References & references(docstring const & label); + References const & references(docstring const & label) const; + void clearReferenceCache() const; + void setInsetLabel(docstring const & label, InsetLabel const * il); + InsetLabel const * insetLabel(docstring const & label) const; private: + /// search for macro in local (buffer) table or in children + MacroData const * getBufferMacro(docstring const & name, + DocIterator const & pos) const; + /** Update macro table starting with position of it + \param it in some text inset + */ + void updateMacros(DocIterator & it, + DocIterator & scope) const; + + /// + bool readFileHelper(support::FileName const & s); + /// + std::vector backends() const; /** Inserts a file into a document \return \c false if method fails. */ @@ -422,11 +486,20 @@ private: /// Use the Pimpl idiom to hide the internals. class Impl; /// The pointer never changes although *pimpl_'s contents may. - boost::scoped_ptr const pimpl_; - - /// A cache for the bibfiles (including bibfiles of loaded child - /// documents), needed for appropriate update of natbib labels. - mutable std::vector bibfilesCache_; + Impl * const d; + + frontend::GuiBufferDelegate * gui_; + + /// This function is called when the buffer structure is changed. + Signal structureChanged_; + /// This function is called when some parsing error shows up. + //Signal errors(std::string const &) = 0; + /// This function is called when some message shows up. + //Signal message(docstring const &) = 0; + /// This function is called when the buffer busy status change. + //Signal setBusy(bool) = 0; + /// Reset autosave timers for all users. + Signal resetAutosaveTimers_; };