]> git.lyx.org Git - lyx.git/blobdiff - src/buffer.h
Fix several warnings regarding unused variable/arguments.
[lyx.git] / src / buffer.h
index 1404bfc90b204e3366ad5d01b32a1e7383dc672d..627bf362e8d7a5cca76fb9803e3ba04caa120d44 100644 (file)
  *
  * ====================================================== */
  
-// Change Log:
-// =========== 
-// 23/03/98   Heinrich Bauer (heinrich.bauer@t-mobil.de)
-// Spots marked "changed Heinrich Bauer, 23/03/98" modified due to the
-// following bug: dvi file export did not work after printing (or previewing)
-// and vice versa as long as the same file was concerned. This happened
-// every time the LyX-file was left unchanged between the two actions mentioned
-// above.
-
 #ifndef BUFFER_H
 #define BUFFER_H
 
 #endif
 
 #include "LString.h"
-
-#include "BufferView.h"
+#include "undo.h"
+#include "undostack.h"
 #include "lyxvc.h"
 #include "bufferparams.h"
 #include "texrow.h"
+#include "paragraph.h"
 
-
+class BufferView;
 class LyXRC;
 class TeXErrors;
 class LaTeXFeatures;
-class auto_mem_buffer;
+class Language;
+class ParIterator;
+
+// When lyx 1.3.x starts we should enable this
+// btw. we should also test this with 1.2 so that we
+// do not get any surprises. (Lgb)
+//#define NO_COMPABILITY 1
 
 ///
 struct DEPCLEAN {
@@ -50,128 +48,128 @@ struct DEPCLEAN {
 };
 
 /** The buffer object.
-  This is the buffer object. It contains all the informations about
+  This 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:
-       ///
+       /// 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);
        
-       ///
+       /// Destructor
        ~Buffer();
 
-       /** save the buffer's parameters as user default
-           This function saves a file #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.
-       */
-       bool saveParamsAsDefaults();
-
        /** High-level interface to buffer functionality.
            This function parses a command string and executes it
        */
-       bool Dispatch(string const & command);
+       bool dispatch(string const & command);
 
        /// Maybe we know the function already by number...
-       bool Dispatch(int ac, string const & argument);
+       bool dispatch(int ac, string const & argument);
 
-       /// and have an xtl buffer to work with.
-       bool Dispatch(int, auto_mem_buffer &);
-
-       /// 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.
            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. 
-           @param par if != 0 insert the file.
-           @return #false# if method fails.
+           \param par if != 0 insert the file.
+           \return \c false if method fails.
        */
-       bool readFile(LyXLex &, LyXParagraph * par = 0);
+       bool readFile(LyXLex &, Paragraph * par = 0);
        
        /** Reads a file without header.
-           @param par if != 0 insert the file.
-           @return false if file is not completely read.
+           \param par if != 0 insert the file.
+           \return \c false if file is not completely read.
        */
-       bool readLyXformat2(LyXLex &, LyXParagraph * par = 0);
+       bool readLyXformat2(LyXLex &, Paragraph * par = 0);
 
        /// This parses a single LyXformat-Token.
-       bool parseSingleLyXformat2Token(LyXLex &, LyXParagraph *& par,
-                                       LyXParagraph *& return_par,
+       bool parseSingleLyXformat2Token(LyXLex &, Paragraph *& par,
+                                       Paragraph *& return_par,
                                        string const & token, int & pos,
-                                       char & depth, LyXFont &
-#ifndef NEW_INSETS
-                                       ,LyXParagraph::footnote_flag &,
-                                       LyXParagraph::footnote_kind &
+                                       Paragraph::depth_type & depth, 
+                                       LyXFont &);
+       ///
+       void insertStringAsLines(Paragraph *&, Paragraph::size_type &,
+                                LyXFont const &, string const &) const;
+#ifndef NO_COMPABILITY
+       ///
+       void insertErtContents(Paragraph * par, int & pos,
+                              LyXFont const & font,
+                              bool set_inactive = true);
 #endif
-               );
+       ///
+       Paragraph * getParFromID(int id) const;
 private:
        /// Parse a single inset.
-       void readInset(LyXLex &, LyXParagraph *& par, int & pos, LyXFont &);
+       void readInset(LyXLex &, Paragraph *& par, int & pos, LyXFont &);
 public:
-       /** Save file
+       /** 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() 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(Paragraph const *,
+                                   unsigned int linelen) const;
        ///
        void makeLaTeXFile(string const & filename,
                           string const & original_path,
                           bool nice, bool only_body = false);
        /** LaTeX all paragraphs from par to endpar.
-           @param endpar if == 0 then to the end
+           \param \a endpar if == 0 then to the end
        */
-       void latexParagraphs(std::ostream & os, LyXParagraph * par,
-                            LyXParagraph * endpar, TexRow & texrow) const;
-
-       ///
-       int runLaTeX();
+       void latexParagraphs(std::ostream & os, Paragraph * par,
+                            Paragraph * endpar, TexRow & texrow) const;
 
         ///
-        int runLiterate();
-
+       void simpleDocBookOnePar(std::ostream &,
+                                Paragraph * par, int & desc_on,
+                                Paragraph::depth_type depth) const ;
         ///
-        int buildProgram();
-
-       ///
-       int runChktex();
+       void simpleLinuxDocOnePar(std::ostream & os, Paragraph * par, 
+                                 Paragraph::depth_type depth);
 
        ///
        void makeLinuxDocFile(string const & filename,
@@ -179,103 +177,80 @@ public:
        ///
        void makeDocBookFile(string const & filename,
                             bool nice, bool only_body = false);
+       /// Open SGML/XML tag.
+        void sgmlOpenTag(std::ostream & os, Paragraph::depth_type depth,
+                        string const & latexname) const;
+        /// Closes SGML/XML tag.
+        void sgmlCloseTag(std::ostream & os, Paragraph::depth_type depth,
+                         string const & latexname) const;
+       ///
+       void sgmlError(Paragraph * par, int pos,
+                      string const & message) const;
 
        /// returns the main language for the buffer (document)
-       string GetLanguage() const {
-               return params.language;
-       }
-       
+       Language const * getLanguage() const;
        ///
-       bool isLyxClean() const { return lyx_clean; }
-       
-        ///
-        bool isNwClean() const { return nw_clean; }
-       
+       int runChktex();
        ///
-       bool isBakClean() const { return bak_clean; }
-       
+       bool isLyxClean() const;
+       ///
+       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;
 
-        ///
-        void markNwClean() { nw_clean = true; }
-       
        ///
-       void markBakClean() { bak_clean = true; }
+       void markBakClean();
        
        ///
        void markDepClean(string const & name);
        
-        ///
-        void markNwDirty() { nw_clean = false; }
-
        ///
-       void setUnnamed(bool flag=true) { unnamed = flag; }
+       void setUnnamed(bool flag = true);
 
        ///
-       bool isUnnamed() { return unnamed; }
+       bool isUnnamed();
 
-       ///
-       void markDirty() {
-               if (lyx_clean) {
-                       lyx_clean = false;
-                       updateTitles();
-               }
-               nw_clean = false;
-               bak_clean = false;
-               DEPCLEAN * tmp = dep_clean;
-               while (tmp) {
-                       tmp->clean = false;
-                       tmp = tmp->next;
-               }
-       }
+       /// Mark this buffer as dirty.
+       void markDirty();
 
-       ///
-       string const & fileName() const { return filename; }
+       /// Returns the buffers filename.
+       string const & fileName() const;
 
-       /** A transformed version of the file name, adequate for LaTeX  
-           The path is stripped if no_path is true (default)
+       /** A transformed version of the file name, adequate for LaTeX.
+           \param no_path optional if \c true then the path is stripped.
        */
-       string getLatexName(bool no_path = true) const;
+       string const getLatexName(bool no_path = true) const;
 
+       /// Get the name and type of the log.
+       std::pair<LogType, string> 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);
 
-       /// 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
+       /** 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;
 
-       ///
-       void setPaperStuff();
-
        /** 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
@@ -288,40 +263,35 @@ public:
        void validate(LaTeXFeatures &) const;
 
        ///
-       string getIncludeonlyList(char delim = ',');
+       string const getIncludeonlyList(char delim = ',');
        ///
-       std::vector<std::pair<string,string> > getBibkeyList();
+       std::vector<std::pair<string, string> > const getBibkeyList();
        ///
        struct TocItem {
+               TocItem(Paragraph * p, int d, string const & s)
+                       : par(p), depth(d), str(s) {}
                ///
-               LyXParagraph * par;
+               Paragraph * par;
                ///
                int depth;
                ///
                string str;
        };
        ///
-       enum TocType {
-               ///
-               TOC_TOC = 0,
-               ///
-               TOC_LOF,
-               ///
-               TOC_LOT,
-               ///
-               TOC_LOA
-       };
+       typedef std::vector<TocItem> SingleList;
+       ///
+       typedef std::map<string, SingleList> Lists;
        ///
-       std::vector<std::vector<TocItem> > getTocList();
+       Lists const getLists() const;
        ///
-       std::vector<string> getLabelList();
+       std::vector<string> 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);
+       void changeLanguage(Language const * from, Language const * to);
        ///
        bool isMultiLingual();
 
@@ -334,73 +304,35 @@ 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;
+       Paragraph * 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;
 
        /// Used when typesetting to place errorboxes.
        TexRow texrow;
 private:
-#ifndef NEW_INSETS
-        ///
-        void linuxDocHandleFootnote(std::ostream & os,
-                                   LyXParagraph * & par, int const depth);
-#endif
-        ///
-       void DocBookHandleCaption(std::ostream & os, string & inner_tag,
-                                 int const depth, int desc_on,
-                                 LyXParagraph * & par);
-#ifndef NEW_INSETS
-        ///
-       void DocBookHandleFootnote(std::ostream & os,
-                                  LyXParagraph * & par, int const depth);
-#endif
-       ///
-        void sgmlOpenTag(std::ostream & os, int depth,
-                        string const & latexname) const;
-        ///
-        void sgmlCloseTag(std::ostream & os, int depth,
-                         string const & latexname) const;
-       ///
-       void LinuxDocError(LyXParagraph * par, int pos, char const * message);
-        ///
-       void SimpleLinuxDocOnePar(std::ostream & os, LyXParagraph * par,
-                                 int desc_on, int const depth);
-        ///
-       void SimpleDocBookOnePar(std::ostream &, string & extra,
-                                LyXParagraph * par, int & desc_on,
-                                int const depth);
-
-       /// LinuxDoc.
-       void push_tag(std::ostream & os, char const * tag,
-                     int & pos, char stack[5][3]);
-       
-       /// LinuxDoc.
-       void pop_tag(std::ostream & os, char const * tag,
-                    int & pos, char stack[5][3]);
-
        /// is save needed
        mutable bool lyx_clean;
        
        /// is autosave needed
        mutable bool bak_clean;
        
-        /// do we need to run weave/tangle
-        bool nw_clean;
-
        /// is this a unnamed file (New...)
        bool unnamed;
 
@@ -414,8 +346,7 @@ 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?
 
@@ -429,47 +360,63 @@ 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(Paragraph * paragraph) : par(paragraph) {
+                       setParagraph();
                }
                ///
-               inset_iterator(LyXParagraph * paragraph,
-                              LyXParagraph::size_type pos);
+               inset_iterator(Paragraph * paragraph,
+                              Paragraph::size_type pos);
                ///
-               inset_iterator & operator++() {
+               inset_iterator & operator++() { // prefix ++
                        if (par) {
                                ++it;
                                if (it == par->inset_iterator_end()) {
-                                       par = par->next;
-                                       SetParagraph();
+                                       par = par->next();
+                                       setParagraph();
                                }
                        }
                        return *this;
                }
                ///
-               Inset * operator*() {return *it; }
+               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;
+               }
                ///
-               LyXParagraph * getPar() { return par; }
+               Inset * operator*() { return *it; }
+               
                ///
-               LyXParagraph::size_type getPos() {return it.getPos(); }
+               Paragraph * getPar() { return par; }
                ///
-               friend
-               bool operator==(inset_iterator const & iter1,
-                               inset_iterator const & iter2);
+               Paragraph::size_type getPos() const { return it.getPos(); }
                ///
                friend
-               bool operator!=(inset_iterator const & iter1,
+               bool operator==(inset_iterator const & iter1,
                                inset_iterator const & iter2);
        private:
                ///
-               void SetParagraph();
+               void setParagraph();
                ///
-               LyXParagraph * par;
+               Paragraph * par;
                ///
-               LyXParagraph::inset_iterator it;
+               Paragraph::inset_iterator it;
        };
 
        ///
@@ -480,15 +427,138 @@ public:
        inset_iterator inset_iterator_end() {
                return inset_iterator();
        }
+       ///
+       inset_iterator inset_const_iterator_begin() const {
+               return inset_iterator(paragraph);
+       }
+       ///
+       inset_iterator inset_const_iterator_end() const {
+               return inset_iterator();
+       }
+
+       ///
+       ParIterator par_iterator_begin();
+       ///
+       ParIterator par_iterator_end();
+
+       ///
+       Inset * getInsetFromID(int id_arg) const;
 };
 
 
+inline
+void Buffer::addUser(BufferView * u)
+{
+       users = u;
+}
+
+
+inline
+void Buffer::delUser(BufferView *)
+{
+       users = 0;
+}
+       
+
+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) {
@@ -504,6 +574,7 @@ bool operator!=(Buffer::TocItem const & a, Buffer::TocItem const & b) {
        // No need to compare depth.
 }
 
+
 ///
 inline
 bool operator==(Buffer::inset_iterator const & iter1,
@@ -512,11 +583,12 @@ bool operator==(Buffer::inset_iterator const & iter1,
                && (iter1.par == 0 || iter1.it == iter2.it);
 }
 
+
 ///
 inline
 bool operator!=(Buffer::inset_iterator const & iter1,
                Buffer::inset_iterator const & iter2) {
        return !(iter1 == iter2);
 }
-#endif
 
+#endif