]> git.lyx.org Git - lyx.git/blobdiff - src/bufferlist.h
Rewording in GTK document dialog
[lyx.git] / src / bufferlist.h
index 7a89a8a87ee6e303013b01c8934b4c0dd3250f02..2ca9fefe551d2db3404e8b16ba85323abf66b422 100644 (file)
 // -*- C++ -*-
-/* This file is part of
- * ====================================================== 
- * 
- *           LyX, The Document Processor        
- *           Copyright 1995 Matthias Ettrich
- *           Copyright 1995-2000 The LyX Team
+/**
+ * \file bufferlist.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- *           This file is Copyright 1996-2000
- *           Lars Gullik Bjønnes
+ * \author Lars Gullik Bjønnes
  *
- * ====================================================== */
+ * Full author contact details are available in file CREDITS.
+ */
 
 #ifndef BUFFER_LIST_H
 #define BUFFER_LIST_H
 
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include <boost/utility.hpp>
 
-#include "buffer.h"
-#include "debug.h"
-#include "support/utility.hpp"
+#include <string>
+#include <vector>
 
-/** A class to hold all the buffers in a structure
-  The point of this class is to hide from bufferlist what kind
-  of structure the buffers are stored in. Should be no concern for
-  bufferlist if the buffers is in a array or in a linked list.
+class Buffer;
+class OutputParams;
 
-  This class should ideally be enclosed inside class BufferList, but that
-  gave me an "internal gcc error".
-  */
-class BufferStorage : public noncopyable {
+/**
+ * The class holds all all open buffers, and handles construction
+ * and deletions of new ones.
+ */
+class BufferList : boost::noncopyable {
 public:
-       ///
-       typedef std::vector<Buffer *> Container;
-       ///
-       typedef Container::iterator iterator;
-       ///
-       typedef Container::const_iterator const_iterator;
-       ///
-       typedef Container::size_type size_type;
-       ///
-       bool empty() const { return container.empty(); }
-       ///
-       void release(Buffer * buf);
-       ///
-       Buffer * newBuffer(string const & s, bool = false);
-       ///
-       Container::iterator begin() { return container.begin(); }
-       ///
-       Container::iterator end() { return container.end(); }
-       ///
-       Container::const_iterator begin() const { return container.begin(); }
-       ///
-       Container::const_iterator end() const { return container.end(); }
-       ///
-       Buffer * front() { return container.front(); }
-       ///
-       Buffer * operator[](int c) { return container[c]; }
-       ///
-       size_type size() const { return container.size(); }
-private:
-       ///
-       Container container;
-};
+       BufferList();
 
+       /// write all buffers, asking the user, returns false if cancelled
+       bool quitWriteAll();
 
-/** The class govern all open buffers.
- */
-class BufferList : public noncopyable {
-public:
-       ///
-       BufferList();
-
-       /// state info
-       enum list_state {
-               ///
-               OK,
-               ///
-               CLOSING
-       };
-
-       /// returns the state of the bufferlist
-       list_state getState() const { return state_; }
-       
-       /** loads a LyX file or...
-           If the optional argument tolastfiles is false (default is
-            true), the file name will not be added to the last opened
-           files list
-       */  
-       Buffer * loadLyXFile(string const & filename, 
-                            bool tolastfiles = true);
-       
-       ///
-       bool empty() const;
+       /// create a new buffer
+       Buffer * newBuffer(std::string const & s, bool ronly = false);
 
-       ///
-        bool QwriteAll();
+       /// delete a buffer
+       void release(Buffer * b);
 
        /// Close all open buffers.
        void closeAll();
 
-       ///
-       void resize();
-
-       /// Read a file into a buffer readonly or not.
-       Buffer * readFile(string const &, bool ro);
-
-       /// Make a new file (buffer) using a template
-       Buffer * newFile(string const &, string, bool isNamed=false);
        /// returns a vector with all the buffers filenames
-       std::vector<string> const getFileNames() const;
-
-       ///
-       int unlockInset(UpdatableInset *);
+       std::vector<std::string> const getFileNames() const;
 
-       ///
-       void updateIncludedTeXfiles(string const &);
+       /// FIXME
+       void updateIncludedTeXfiles(std::string const &, OutputParams const &);
 
-       ///
+       /// emergency save for all buffers
        void emergencyWriteAll();
 
-       /** Close buffer.
-           @param buf the buffer that should be closed
-           @return #false# if operation was canceled
-         */
-       bool close(Buffer * buf);
+       /// close buffer. Returns false if cancelled by user
+       bool close(Buffer * buf, bool ask);
 
-       ///
+       /// return true if no buffers loaded
+       bool empty() const;
+
+       /// return head of buffer list if any
        Buffer * first();
-       
+
        /// returns true if the buffer exists already
-       bool exists(string const &) const;
+       bool exists(std::string const &) const;
 
        /// returns true if the buffer is loaded
        bool isLoaded(Buffer const * b) const;
-       
+
        /// returns a pointer to the buffer with the given name.
-       Buffer * getBuffer(string const &);
+       Buffer * getBuffer(std::string const &);
        /// returns a pointer to the buffer with the given number.
-       Buffer * getBuffer(int);
+       Buffer * getBuffer(unsigned int);
+       /// returns a pointer to the buffer whose temppath matches the string
+       Buffer * getBufferFromTmp(std::string const &);
+
+       /** returns a pointer to the buffer that follows argument in
+        * buffer list. The buffer following the last in list is the
+        * first one.
+        */
+       Buffer * next(Buffer const *) const;
+
+       /** returns a pointer to the buffer that precedes argument in
+        * buffer list. The buffer preceding the first in list is the
+        * last one.
+        */
+       Buffer * previous(Buffer const *) const;
+
+       /// reset current author for all buffers
+       void setCurrentAuthor(std::string const & name, std::string const & email);
 
 private:
-       ///
+       /// ask to save a buffer on quit, returns false if should cancel
+       bool quitWriteBuffer(Buffer * buf);
+
+       typedef std::vector<Buffer *> BufferStorage;
+
+       /// storage of all buffers
        BufferStorage bstore;
-       
-       ///
-       list_state state_;
+
+       /// save emergency file for the given buffer
+       void emergencyWrite(Buffer * buf);
 };
 
-#endif
+#endif // BUFFERLIST_H