X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fsupport%2Ftypes.h;h=fc443dcf533e4b4443a153ae47d7ee6bfdb408eb;hb=82b3a26a320f1056b09d4061bfbe704e838b7487;hp=5ecde9747f946ddbcb5b02ab8139c7c473eda04b;hpb=2292145ba3a0ae9c49acd351cfc6eb696041a81f;p=lyx.git

diff --git a/src/support/types.h b/src/support/types.h
index 5ecde9747f..fc443dcf53 100644
--- a/src/support/types.h
+++ b/src/support/types.h
@@ -8,7 +8,7 @@
  * indices wile trying to stay compatible with types used
  * by the standard containers.
  *
- * \author André Pönitz
+ * \author André Pönitz
  *
  * Full author contact details are available in file CREDITS.
  */
@@ -20,13 +20,24 @@
 
 namespace lyx {
 
-	/// a type for positions used in paragraphs
-	// needs to be signed for a while to hold the special value -1 that is
-	// used there...
+	/*!
+	 * A type for positions used in paragraphs.
+	 * Each position is either occupied by a single character or an inset.
+	 * For insets, the placeholder META_INSET is stored in the paragraph
+	 * text, and the actual insets are maintained separately.
+	 */
+	// FIXME: should be unsigned, but needs to be signed for a while to
+	// hold the special value -1 that is used somewhere
+	// Note that the signed property is also used in loops counting to zero.
 	typedef ptrdiff_t  pos_type;
 
-	/// a type for paragraph offsets
-	typedef ptrdiff_t  paroffset_type;
+	/*!
+	 * A type for paragraph offsets.
+	 * This is used to address paragraphs in ParagraphList, Text etc.
+	 */
+	// FIXME: should be unsigned as well.
+	// however, simply changing it breaks a downward loop somewhere...
+	typedef ptrdiff_t  pit_type;
 
 	/// a type for the nesting depth of a paragraph
 	typedef size_t     depth_type;
@@ -37,9 +48,6 @@ namespace lyx {
 	/// a type for sizes
 	typedef size_t     size_type;
 
-	/// a type used for numbering text classes
-	typedef size_t     textclass_type;
-
 #else
 
 	// These structs wrap simple things to make them distinguishible
@@ -48,35 +56,22 @@ namespace lyx {
 
 	struct size_type {
 		///
-		typedef size_t  base_type;
+		typedef size_t base_type;
 		///
 		size_type(base_type t) { data_ = t; }
 		///
 		operator base_type() const { return data_; }
 		///
-		private:
+	private:
 		base_type data_;
 	};
 
-	struct textclass_type {
-		///
-		typedef size_t   base_type;
-		///
-		textclass_type(base_type t) { data_ = t; }
-		///
-		operator base_type() const { return data_; }
-		///
-		private:
-		base_type data_;
-	};
-
-
 #endif
 
 	///
 	enum word_location {
-		// the word around the cursor, only if the cursor is
-		//not at a boundary
+		/// the word around the cursor, only if the cursor is
+		/// not at a boundary
 		WHOLE_WORD_STRICT,
 		// the word around the cursor
 		WHOLE_WORD,
@@ -88,6 +83,14 @@ namespace lyx {
 		NEXT_WORD
 	};
 
+	///
+	enum PageSides {
+		///
+		OneSide,
+		///
+		TwoSides
+	};
+
 } // namespace lyx
 
 #endif // LYX_TYPES_H