X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fbuffer.h;h=021b56c74e5f2c13b446ba6b019f28fb5e67ead1;hb=4590c8cfab02a3bc56813cfb1f2e80bd1119af9e;hp=9a58df3282d83f3b239c921ba2036758398d0d86;hpb=1c9a8d27a26b5f76562914f0e81aa98334f8c06a;p=lyx.git diff --git a/src/buffer.h b/src/buffer.h index 9a58df3282..021b56c74e 100644 --- a/src/buffer.h +++ b/src/buffer.h @@ -32,15 +32,12 @@ #include "lyxvc.h" #include "bufferparams.h" #include "texrow.h" -#include "support/filetools.h" -#include "lyx_gui_misc.h" class LyXRC; class TeXErrors; class LaTeXFeatures; - -extern void updateAllVisibleBufferRelatedPopups(); +class Language; /// struct DEPCLEAN { @@ -56,229 +53,191 @@ struct DEPCLEAN { The is is the buffer object. It contains all the informations about a document loaded into LyX. I am not sure if the class is complete or minimal, probably not. + \author Lars Gullik Bjønnes */ class Buffer { public: - /**@name Constructors and destructor */ - //@{ - /// - Buffer(string const & file, bool b = false); + /// What type of log will \c getLogName() return? + enum LogType { + latexlog, ///< LaTeX log + buildlog ///< Literate build log + }; + + /** Constructor + \param file + \param b optional \c false by default + */ + explicit Buffer(string const & file, bool b = false); - /// + /// Destrucotr ~Buffer(); - //@} - - /**@name Methods */ - //@{ - /** save the buffer's parameters as user default - This function saves a file user_lyxdir/templates/defaults.lyx + /** Save the buffer's parameters as user default. + This function saves a file \c user_lyxdir/templates/defaults.lyx which parameters are those of the current buffer. This file is used as a default template when creating a new - file. Returns true on success. + file. Returns \c true on success. */ bool saveParamsAsDefaults(); - /** high-level interface to buffer functionality + /** High-level interface to buffer functionality. This function parses a command string and executes it */ - void Dispatch(const string & command); + bool Dispatch(string const & command); /// Maybe we know the function already by number... - void Dispatch(int ac, const string & argument); + bool Dispatch(int ac, string const & argument); - /// should be changed to work for a list. - void resize() { - if (users) { - users->resize(); - } - } + /// Should be changed to work for a list. + void resize(); + /// + void resizeInsets(BufferView *); - /// Update window titles of all users + /// Update window titles of all users. void updateTitles() const; - /// Reset autosave timers for all users + /// Reset autosave timers for all users. void resetAutosaveTimers() const; /** Adds the BufferView to the users list. - Later this func will insert the BufferView into a real list, + Later this func will insert the \c BufferView into a real list, not just setting a pointer. */ - void addUser(BufferView * u) { users = u; } + void addUser(BufferView * u); - /** Removes the BufferView from the users list. + /** Removes the #BufferView# from the users list. Since we only can have one at the moment, we just reset it. */ - void delUser(BufferView *) { users = 0; } + void delUser(BufferView *); /// - void redraw() { - users->redraw(); - users->fitCursor(); - users->updateScrollbar(); - } + void redraw(); - /// + /// Load the autosaved file. void loadAutoSaveFile(); /** Reads a file. - Returns false if it fails. - If par is given, the file is inserted. */ + \param par if != 0 insert the file. + \return \c false if method fails. + */ bool readFile(LyXLex &, LyXParagraph * par = 0); /** Reads a file without header. - Returns false, if file is not completely read. - If par is given, the file is inserted. */ + \param par if != 0 insert the file. + \return \c false if file is not completely read. + */ bool readLyXformat2(LyXLex &, LyXParagraph * par = 0); - /* This parses a single LyXformat-Token */ + /// This parses a single LyXformat-Token. bool parseSingleLyXformat2Token(LyXLex &, LyXParagraph *& par, LyXParagraph *& return_par, - const string & token, int & pos, - char & depth, LyXFont &, - LyXParagraph::footnote_flag &, - LyXParagraph::footnote_kind &); - - /** Save file + string const & token, int & pos, + char & depth, LyXFont &); +private: + /// Parse a single inset. + void readInset(LyXLex &, LyXParagraph *& par, int & pos, LyXFont &); +public: + /** Save file. Takes care of auto-save files and backup file if requested. - Returns true if the save is successful, false otherwise. + Returns \c true if the save is successful, \c false otherwise. */ - bool save(bool makeBackup) const; + bool save() const; - /// Write file. Returns false if unsuccesful. + /// Write file. Returns \c false if unsuccesful. bool writeFile(string const &, bool) const; /// void writeFileAscii(string const & , int); - + /// + void writeFileAscii(std::ostream &, int); + /// + string const asciiParagraph(LyXParagraph const *, + unsigned int linelen) const; /// void makeLaTeXFile(string const & filename, string const & original_path, bool nice, bool only_body = false); - - /// - int runLaTeX(); - - /// - int runLiterate(); + /** LaTeX all paragraphs from par to endpar. + \param \a endpar if == 0 then to the end + */ + void latexParagraphs(std::ostream & os, LyXParagraph * par, + LyXParagraph * endpar, TexRow & texrow) const; /// - int buildProgram(); + void SimpleDocBookOnePar(std::ostream &, string & extra, + LyXParagraph * par, int & desc_on, + int depth) const ; /// int runChktex(); /// - void makeLinuxDocFile(string const & filename, int column); + void makeLinuxDocFile(string const & filename, + bool nice, bool only_body = false); /// - void makeDocBookFile(string const & filename, int column); + void makeDocBookFile(string const & filename, + bool nice, bool only_body = false); /// returns the main language for the buffer (document) - string GetLanguage() const { - return params.language; - } - + Language const * GetLanguage() const; /// - bool isLyxClean() const { return lyx_clean; } - - /// changed Heinrich Bauer, 23/03/98 - bool isDviClean() const; - - /// - bool isNwClean() const { return nw_clean; } - + bool isLyxClean() const; /// - bool isBakClean() const { return bak_clean; } - + bool isBakClean() const; /// bool isDepClean(string const & name) const; /// - void markLyxClean() const { - if (!lyx_clean) { - lyx_clean = true; - updateTitles(); - } - // if the .lyx file has been saved, we don't need an - // autosave - bak_clean = true; - } + void markLyxClean() const; - /// changed Heinrich Bauer, 23/03/98 - void markDviClean(); - - /// - void markNwClean() { nw_clean = true; } - /// - void markBakClean() { bak_clean = true; } + void markBakClean(); /// void markDepClean(string const & name); /// - void markDviDirty(); - - /// - void markNwDirty() { nw_clean = false; } - - /// - void markDirty() { - if (lyx_clean) { - lyx_clean = false; - updateTitles(); - } - dvi_clean_tmpd = false; - dvi_clean_orgd = false; - nw_clean = false; - bak_clean = false; - DEPCLEAN * tmp = dep_clean; - while (tmp) { - tmp->clean = false; - tmp = tmp->next; - } - } + void setUnnamed(bool flag = true); /// - string const & fileName() const { return filename; } + bool isUnnamed(); - /** A transformed version of the file name, adequate for LaTeX - The path is stripped if no_path is true (default) */ - string getLatexName(bool no_path = true) const { - return ChangeExtension(MakeLatexName(filename), - ".tex", no_path); - } + /// Mark this buffer as dirty. + void markDirty(); + + /// Returns the buffers filename. + string const & fileName() const; + + /** A transformed version of the file name, adequate for LaTeX. + \param no_path optional if \c true then the path is stripped. + */ + string const getLatexName(bool no_path = true) const; + /// Get the name and type of the log. + std::pair const getLogName() const; + /// Change name of buffer. Updates "read-only" flag. - void fileName(string const & newfile); + void setFileName(string const & newfile); /// Name of the document's parent void setParentName(string const &); /// Is buffer read-only? - bool isReadonly() const { return read_only; } + bool isReadonly() const; /// Set buffer read-only flag - void setReadonly(bool flag = true) { - if (read_only != flag) { - read_only = flag; - updateTitles(); - updateAllVisibleBufferRelatedPopups(); - } - if (read_only) { - WarnReadonly(filename); - } - } + void setReadonly(bool flag = true); - /// returns true if the buffer contains a LaTeX document + /// returns \c true if the buffer contains a LaTeX document bool isLatex() const; - /// returns true if the buffer contains a LinuxDoc document + /// returns \c true if the buffer contains a LinuxDoc document bool isLinuxDoc() const; - /// returns true if the buffer contains a DocBook document + /// returns \c true if the buffer contains a DocBook document bool isDocBook() const; - /// returns true if the buffer contains either a LinuxDoc or DocBook document + /** returns \c true if the buffer contains either a LinuxDoc + or DocBook document */ bool isSGML() const; - /// returns true if the buffer contains a Wed document + /// returns \c true if the buffer contains a Wed document bool isLiterate() const; /// @@ -286,26 +245,47 @@ public: /** Validate a buffer for LaTeX. This validates the buffer, and returns a struct for use by - makeLaTeX and others. Its main use is to figure out what commands - and packages need to be included in the LaTeX file. It (should) - also check that the needed constructs are there (i.e. that the \refs - points to coresponding \labels). It should perhaps inset "error" - insets to help the user correct obvious mistakes. + #makeLaTeX# and others. Its main use is to figure out what + commands and packages need to be included in the LaTeX file. + It (should) also check that the needed constructs are there + (i.e. that the \refs points to coresponding \labels). It + should perhaps inset "error" insets to help the user correct + obvious mistakes. */ void validate(LaTeXFeatures &) const; /// - string getIncludeonlyList(char delim = ','); + string const getIncludeonlyList(char delim = ','); + /// + std::vector > const getBibkeyList(); /// - string getReferenceList(char delim = '|'); + struct TocItem { + TocItem(LyXParagraph * p, int d, string const & s) + : par(p), depth(d), str(s) {} + /// + LyXParagraph * par; + /// + int depth; + /// + string str; + }; /// - string getBibkeyList(char delim = '|'); + typedef std::vector SingleList; + /// + typedef std::map Lists; + /// + Lists const getLists() const; + /// + std::vector const getLabelList(); /** This will clearly have to change later. Later we can have more than one user per buffer. */ - BufferView * getUser() const { return users; } + BufferView * getUser() const; - //@} + /// + void ChangeLanguage(Language const * from, Language const * to); + /// + bool isMultiLingual(); /// Does this mean that this is buffer local? UndoStack undostack; @@ -316,20 +296,23 @@ public: /// BufferParams params; - /** is a list of paragraphs. + /** The list of paragraphs. + This is a linked list of paragraph, this list holds the + whole contents of the document. */ LyXParagraph * paragraph; - /// RCS object + /// LyX version control object. LyXVC lyxvc; - /// where the temporaries go if we want them + /// Where to put temporary files. string tmppath; - /// + /// The path to the document file. string filepath; - /** While writing as LaTeX, tells whether we are + /** If we are writing a nice LaTeX file or not. + While writing as LaTeX, tells whether we are doing a 'nice' LaTeX file */ bool niceFile; @@ -337,62 +320,31 @@ public: TexRow texrow; private: /// - void linuxDocHandleFootnote(ostream & os, - LyXParagraph * & par, int const depth); - /// - void DocBookHandleCaption(ostream & os, string & inner_tag, - int const depth, int desc_on, + void DocBookHandleCaption(std::ostream & os, string & inner_tag, + int depth, int desc_on, LyXParagraph * & par); - /// - void DocBookHandleFootnote(ostream & os, - LyXParagraph * & par, int const depth); - /// - void sgmlOpenTag(ostream & os, int depth, + /// Open SGML/XML tag. + void sgmlOpenTag(std::ostream & os, int depth, string const & latexname) const; - /// - void sgmlCloseTag(ostream & os, int depth, + /// Closes SGML/XML tag. + void sgmlCloseTag(std::ostream & os, int depth, string const & latexname) const; /// - void LinuxDocError(LyXParagraph * par, int pos, char const * message); - /// - void SimpleLinuxDocOnePar(ostream & os, LyXParagraph * par, - int desc_on, int const depth); + void LinuxDocError(LyXParagraph * par, int pos, + string const & message); /// - void SimpleDocBookOnePar(ostream &, string & extra, - LyXParagraph * par, int & desc_on, - int const depth); - - /// LinuxDoc. - void push_tag(ostream & os, char const * tag, - int & pos, char stack[5][3]); - - /// LinuxDoc. - void pop_tag(ostream & os, char const * tag, - int & pos, char stack[5][3]); + void SimpleLinuxDocOnePar(std::ostream & os, LyXParagraph * par, int depth); -#if 0 - /// - void RoffAsciiTable(ostream &, LyXParagraph * par); -#endif - /// is save needed mutable bool lyx_clean; /// is autosave needed mutable bool bak_clean; - /** do we need to run LaTeX, changed 23/03/98, Heinrich Bauer - We have to distinguish between TeX-runs executed in the original - directory (in which the original LyX-file resides) and TeX-runs - executed in a temporary directory. The first situation is valid - for a dvi-export, the latter one for printing or previewing. */ - bool dvi_clean_orgd; - bool dvi_clean_tmpd; - - /// do we need to run weave/tangle - bool nw_clean; - - /// is regenerating .tex necessary + /// is this a unnamed file (New...) + bool unnamed; + + /// is regenerating #.tex# necessary DEPCLEAN * dep_clean; /// buffer is r/o @@ -402,23 +354,240 @@ private: string filename; /// Format number of buffer - float format; - + int file_format; /** A list of views using this buffer. Why not keep a list of the BufferViews that use this buffer? At least then we don't have to do a lot of magic like: - buffer->lyx_gui->bufferview->updateLayoutChoice. Just ask each - of the buffers in the list of users to do a updateLayoutChoice. + #buffer->lyx_gui->bufferview->updateLayoutChoice#. Just ask each + of the buffers in the list of users to do a #updateLayoutChoice#. */ BufferView * users; + +public: + /// + class inset_iterator { + public: + typedef std::input_iterator_tag iterator_category; + typedef Inset value_type; + typedef ptrdiff_t difference_type; + typedef Inset * pointer; + typedef Inset & reference; + + + /// + inset_iterator() : par(0) /*, it(0)*/ {} + // + inset_iterator(LyXParagraph * paragraph) : par(paragraph) { + SetParagraph(); + } + /// + inset_iterator(LyXParagraph * paragraph, + LyXParagraph::size_type pos); + /// + inset_iterator & operator++() { // prefix ++ + if (par) { + ++it; + if (it == par->inset_iterator_end()) { + par = par->next(); + SetParagraph(); + } + } + return *this; + } + /// + inset_iterator operator++(int) { // postfix ++ + inset_iterator tmp(par, it.getPos()); + if (par) { + ++it; + if (it == par->inset_iterator_end()) { + par = par->next(); + SetParagraph(); + } + } + return tmp; + } + /// + Inset * operator*() { return *it; } + + /// + LyXParagraph * getPar() { return par; } + /// + LyXParagraph::size_type getPos() const { return it.getPos(); } + /// + friend + bool operator==(inset_iterator const & iter1, + inset_iterator const & iter2); + private: + /// + void SetParagraph(); + /// + LyXParagraph * par; + /// + LyXParagraph::inset_iterator it; + }; + + /// + inset_iterator inset_iterator_begin() { + return inset_iterator(paragraph); + } + /// + inset_iterator inset_iterator_end() { + return inset_iterator(); + } }; +inline +void Buffer::addUser(BufferView * u) +{ + users = u; +} + + +inline +void Buffer::delUser(BufferView *) +{ + users = 0; +} + + +inline +void Buffer::redraw() +{ + users->redraw(); + users->fitCursor(users->text); +} + + +inline +Language const * Buffer::GetLanguage() const +{ + return params.language; +} + + +inline +bool Buffer::isLyxClean() const +{ + return lyx_clean; +} + + +inline +bool Buffer::isBakClean() const +{ + return bak_clean; +} + + +inline +void Buffer::markLyxClean() const +{ + if (!lyx_clean) { + lyx_clean = true; + updateTitles(); + } + // if the .lyx file has been saved, we don't need an + // autosave + bak_clean = true; +} + + +inline +void Buffer::markBakClean() +{ + bak_clean = true; +} + + +inline +void Buffer::setUnnamed(bool flag) +{ + unnamed = flag; +} + + +inline +bool Buffer::isUnnamed() +{ + return unnamed; +} + + +inline +void Buffer::markDirty() +{ + if (lyx_clean) { + lyx_clean = false; + updateTitles(); + } + bak_clean = false; + DEPCLEAN * tmp = dep_clean; + while (tmp) { + tmp->clean = false; + tmp = tmp->next; + } +} + + +inline +string const & Buffer::fileName() const +{ + return filename; +} + + +inline +bool Buffer::isReadonly() const +{ + return read_only; +} + + +inline +BufferView * Buffer::getUser() const +{ + return users; +} + + inline void Buffer::setParentName(string const & name) { params.parentname = name; } + +/// +inline +bool operator==(Buffer::TocItem const & a, Buffer::TocItem const & b) { + return a.par == b.par && a.str == b.str; + // No need to compare depth. +} + + +/// +inline +bool operator!=(Buffer::TocItem const & a, Buffer::TocItem const & b) { + return !(a == b); + // No need to compare depth. +} + + +/// +inline +bool operator==(Buffer::inset_iterator const & iter1, + Buffer::inset_iterator const & iter2) { + return iter1.par == iter2.par + && (iter1.par == 0 || iter1.it == iter2.it); +} + + +/// +inline +bool operator!=(Buffer::inset_iterator const & iter1, + Buffer::inset_iterator const & iter2) { + return !(iter1 == iter2); +} #endif