X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fbufferlist.h;h=b24f813d20f721886a41beedc10a901aec016b2f;hb=545777433a65fd90ad3bb18be33d8e741c622853;hp=da970e6fe8774ebfc0c420399fe4278edb1a28bb;hpb=dda41e40d36386e51be78c841bb7b15df9ba2603;p=lyx.git

diff --git a/src/bufferlist.h b/src/bufferlist.h
index da970e6fe8..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,9 +13,14 @@
 #pragma interface
 #endif
 
-#include "buffer.h"
-#include "debug.h"
-#include "support/utility.hpp"
+#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
@@ -30,7 +30,7 @@
   This class should ideally be enclosed inside class BufferList, but that
   gave me an "internal gcc error".
   */
-class BufferStorage : public noncopyable {
+class BufferStorage : boost::noncopyable {
 public:
 	///
 	typedef std::vector<Buffer *> Container;
@@ -39,11 +39,24 @@ 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(); }
 	///
@@ -56,20 +69,25 @@ public:
 	Buffer * front() { return container.front(); }
 	///
 	Buffer * operator[](int c) { return container[c]; }
-	///
-	int size() const { return container.size(); }
+	/**
+	   What is the size of the container.
+	   \return The size of the container.
+	 */
+	size_type size() const { return container.size(); }
 private:
 	///
 	Container container;
 };
 
 
-/** The class govern all open buffers.
+/**
+   The class holds all all open buffers, and handles construction
+   and deletions of new ones.
  */
-class BufferList : public noncopyable {
+class BufferList : boost::noncopyable {
 public:
 	///
- 	BufferList();
+	BufferList();
 
 	/// state info
 	enum list_state {
@@ -81,34 +99,37 @@ 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> getFileNames() const;
+	std::vector<string> const getFileNames() const;
 
 	///
 	int unlockInset(UpdatableInset *);
@@ -119,32 +140,38 @@ 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(int);
-
+	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_;
+	///
+	void emergencyWrite(Buffer * buf);
 };
 
 #endif