X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=src%2Fbufferlist.h;h=b24f813d20f721886a41beedc10a901aec016b2f;hb=acb4e0a1d39ad697fdfcc7f2d66be2bc6b82e2d1;hp=869a06e9711ac62be0f9046786a41ec30a0885a0;hpb=b17500c1c47d7bdd4508743c27fb72f0e57a5105;p=lyx.git

diff --git a/src/bufferlist.h b/src/bufferlist.h
index 869a06e971..b24f813d20 100644
--- a/src/bufferlist.h
+++ b/src/bufferlist.h
@@ -1,15 +1,10 @@
 // -*- C++ -*-
-/* This file is part of
- * ====================================================== 
- * 
- *           LyX, The Document Processor 	 
- *           Copyright 1995 Matthias Ettrich
- *           Copyright 1995-2000 The LyX Team
+/** \file
+ *  Copyright 2002 the LyX Team
+ *  Read the file COPYING
  *
- *           This file is Copyright 1996-2000
- *           Lars Gullik Bjønnes
- *
- * ====================================================== */
+ *  \author Lars Gullik Bjønnes
+*/
 
 #ifndef BUFFER_LIST_H
 #define BUFFER_LIST_H
@@ -18,10 +13,15 @@
 #pragma interface
 #endif
 
-#include "buffer.h"
-#include "debug.h"
+#include "LString.h"
+
 #include <boost/utility.hpp>
 
+#include <vector>
+
+class Buffer;
+class UpdatableInset;
+
 /** 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
@@ -40,12 +40,23 @@ public:
 	typedef Container::const_iterator const_iterator;
 	///
 	typedef Container::size_type size_type;
-	///
+	/**
+	   Is the container empty or not.
+	   \return True if the container is empty, False otherwise.
+	 */
 	bool empty() const { return container.empty(); }
-	///
+	/**
+	   Releases the passed buffer from the storage and deletes
+	   all resources.
+	   \param buf The buffer to release.
+	 */
 	void release(Buffer * buf);
-	///
-	Buffer * newBuffer(string const & s, bool = false);
+	/**
+	   \param s The name of the file to base the buffer on.
+	   \param ronly If the buffer should be created read only of not.
+	   \return The newly created buffer.
+	 */
+	Buffer * newBuffer(string const & s, bool ronly = false);
 	///
 	Container::iterator begin() { return container.begin(); }
 	///
@@ -58,7 +69,10 @@ public:
 	Buffer * front() { return container.front(); }
 	///
 	Buffer * operator[](int c) { return container[c]; }
-	///
+	/**
+	   What is the size of the container.
+	   \return The size of the container.
+	 */
 	size_type size() const { return container.size(); }
 private:
 	///
@@ -66,12 +80,14 @@ private:
 };
 
 
-/** The class govern all open buffers.
+/**
+   The class holds all all open buffers, and handles construction
+   and deletions of new ones.
  */
 class BufferList : boost::noncopyable {
 public:
 	///
- 	BufferList();
+	BufferList();
 
 	/// state info
 	enum list_state {
@@ -83,32 +99,35 @@ public:
 
 	/// 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, 
+
+	/**
+	   Loads a LyX file or...
+
+	   \param filename The filename to read from.
+	   \param tolastfiles Wether the file should be put in the
+	   last opened files list or not.
+	   \return The newly loaded LyX file.
+	*/
+	Buffer * loadLyXFile(string const & filename,
 			     bool tolastfiles = true);
-	
+
 	///
 	bool empty() const;
 
 	///
-        bool QwriteAll();
+	bool qwriteAll();
 
 	/// Close all open buffers.
 	void closeAll();
 
-	///
-	void resize();
-
-	/// Read a file into a buffer readonly or not.
+	/**
+	   Read a file into a buffer readonly or not.
+	   \return
+	*/
 	Buffer * readFile(string const &, bool ro);
 
 	/// Make a new file (buffer) using a template
-	Buffer * newFile(string const &, string, bool isNamed=false);
+	Buffer * newFile(string const &, string, bool isNamed = false);
 	/// returns a vector with all the buffers filenames
 	std::vector<string> const getFileNames() const;
 
@@ -120,31 +139,35 @@ public:
 
 	///
 	void emergencyWriteAll();
-	
-	/** Close buffer.
-	    @param buf the buffer that should be closed
-	    @return #false# if operation was canceled
+
+	/**
+	   Close buffer.
+	   \param buf the buffer that should be closed
+	   \return #false# if operation was canceled
 	  */
 	bool close(Buffer * buf);
 
 	///
 	Buffer * first();
-	
+
 	/// returns true if the buffer exists already
 	bool exists(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 &);
 	/// returns a pointer to the buffer with the given number.
 	Buffer * getBuffer(unsigned int);
-
 private:
+	/// ask to save a buffer on quit
+	bool qwriteOne(Buffer * buf, string const & fname,
+		       string & unsaved_list);
+
 	///
 	BufferStorage bstore;
-	
+
 	///
 	list_state state_;
 	///