]> git.lyx.org Git - lyx.git/blobdiff - src/buffer.h
update libtool
[lyx.git] / src / buffer.h
index db9af3a238b87bf48ff7969ea67a54976529c19b..021b56c74e5f2c13b446ba6b019f28fb5e67ead1 100644 (file)
@@ -1,14 +1,14 @@
 // -*- C++ -*-
 /* This file is part of
  * ====================================================== 
-* 
-*           LyX, The Document Processor         
-*          Copyright (C) 1995 Matthias Ettrich
-*
-*           This file is Copyleft (C) 1996
-*           Lars Gullik Bjønnes
-*
-* ====================================================== */
+ 
+ *           LyX, The Document Processor        
+ *           Copyright 1995 Matthias Ettrich
+ *
+ *           This file is Copyleft 1996
+ *           Lars Gullik Bjønnes
+ *
+ * ====================================================== */
  
 // Change Log:
 // =========== 
 #pragma interface
 #endif
 
-#include "undo.h"
+#include "LString.h"
+
 #include "BufferView.h"
 #include "lyxvc.h"
 #include "bufferparams.h"
 #include "texrow.h"
-#include "lyxtext.h"
-#include "support/filetools.h"
 
 
 class LyXRC;
 class TeXErrors;
 class LaTeXFeatures;
-
-extern void updateAllVisibleBufferRelatedPopups();
-extern void WarnReadonly();
+class Language;
 
 ///
 struct DEPCLEAN {
@@ -49,277 +46,246 @@ struct DEPCLEAN {
        ///
        string master;
        ///
-       DEPCLEAN *next;
+       DEPCLEAN * next;
 };
 
 /** The buffer object.
   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, LyXRC * lyxrc = 0, 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
-       void updateTitles();
+       /// Update window titles of all users.
+       void updateTitles() const;
 
-       /// Reset autosave timers for all users
-       void resetAutosaveTimers();
+       /// 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();
 
-        /// Open and lock an updatable inset
-        void open_new_inset(UpdatableInset *);
-
-       ///
+       /// 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);
 
-       /// Inserts a lyx file at cursor position. Returns false if it fails.
-       bool insertLyXFile(string const & filename);
-
-       /// Write file. Returns false if unsuccesful.
-       bool writeFile(string const &, bool);
+       /// This parses a single LyXformat-Token.
+       bool parseSingleLyXformat2Token(LyXLex &, LyXParagraph *& par,
+                                       LyXParagraph *& return_par,
+                                       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 \c true if the save is successful, \c false otherwise.
+       */
+       bool save() const;
+       
+       /// 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();
-       
-        ///
-        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() { 
-               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<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() { 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();
-                       }
-               }
+       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;
 
        ///
        void setPaperStuff();
 
-#if 0
-       ///
-       void setOldPaperStuff();
-#endif
-       
        /** 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 &); //the correct parameters to be
-       //included later 
-
-       /** Insert an inset into the buffer
-           Insert inset into buffer, placing it in a layout of lout,
-           if no_table make sure that it doesn't end up in a table. */
-       void insertInset(Inset *, string const & lout = string(), 
-                        bool no_table = false);
-
-        ///
-        void setCursorFromRow (int);
+       void validate(LaTeXFeatures &) const;
 
        ///
-       string getIncludeonlyList(char delim = ',');
+       string const getIncludeonlyList(char delim = ',');
        ///
-       string getReferenceList(char delim = '|');
+       std::vector<std::pair<string, string> > const getBibkeyList();
        ///
-       string getBibkeyList(char delim = '|');
+       struct TocItem {
+               TocItem(LyXParagraph * p, int d, string const & s)
+                       : par(p), depth(d), str(s) {}
+               ///
+               LyXParagraph * par;
+               ///
+               int depth;
+               ///
+               string str;
+       };
        ///
-       bool gotoLabel(string const &);
-
-       /// removes all autodeletable insets
-       bool removeAutoInsets();
+       typedef std::vector<TocItem> SingleList;
+       ///
+       typedef std::map<string, SingleList> Lists;
+       ///
+       Lists const getLists() const;
+       ///
+       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);
+       ///
+       bool isMultiLingual();
 
        /// Does this mean that this is buffer local?
         UndoStack undostack;
@@ -330,101 +296,55 @@ 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;
 
-       /// per view not per buffer?
-       UpdatableInset * the_locking_inset;
-
-       /// 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;
 
-       ///
-        void InsetUnlock();
-       
-       ///
-        inline void InsetSleep();
-       
-       ///
-        inline void InsetWakeup();
-       
-       ///
-        bool inset_slept;
-       
-       ///
-        int  slx;
-       ///
-       int sly;
+       /// Used when typesetting to place errorboxes.
+       TexRow texrow;
 private:
-       ///
-       void insertErrors(TeXErrors &);
-
-        ///
-        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 LinuxDocError(LyXParagraph * par, int pos,
+                          string const & message);
         ///
-       void SimpleLinuxDocOnePar(ostream & os, LyXParagraph * par,
-                                 int desc_on, int const depth);
-        ///
-       void SimpleDocBookOnePar(string & file, 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 RoffAsciiTable(ostream &, LyXParagraph * par);
+       void SimpleLinuxDocOnePar(std::ostream & os, LyXParagraph * par, int depth);
 
        /// is save needed
-       bool lyx_clean;
+       mutable bool lyx_clean;
        
        /// is autosave needed
-       bool bak_clean;
+       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
@@ -434,40 +354,201 @@ 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;
 
-       /// Used when typesetting to place errorboxes.
-       TexRow texrow;
+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::InsetSleep()
+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()
 {
-       if (the_locking_inset && !inset_slept) {
-               the_locking_inset->GetCursorPos(slx, sly);
-               the_locking_inset->InsetUnlock();
-               inset_slept = true;
+       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  
-void Buffer::InsetWakeup()
+inline
+string const & Buffer::fileName() const
+{
+       return filename;
+}
+
+
+inline
+bool Buffer::isReadonly() const
+{
+       return read_only;
+}
+
+
+inline
+BufferView * Buffer::getUser() const
 {
-       if (the_locking_inset && inset_slept) {
-               the_locking_inset->Edit(slx, sly);
-               inset_slept = false;
-       }       
+       return users;
 }
 
 
@@ -477,4 +558,36 @@ 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