X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Flyxtextclass.h;h=2b0a3a538a5d0ad308e7dbb0641431daa217b497;hb=dad1fc66e44a4dad94eb1e9ffd5736bf8f59ae6d;hp=007bc43a83c0c85d98c51a1c8c32991c0b82ac6b;hpb=12b01bf0a285d3e564654d5ea9d85908821c5704;p=lyx.git

diff --git a/src/lyxtextclass.h b/src/lyxtextclass.h
index 007bc43a83..2b0a3a538a 100644
--- a/src/lyxtextclass.h
+++ b/src/lyxtextclass.h
@@ -1,21 +1,15 @@
 // -*- C++ -*-
-/* This file is part of
- * ======================================================
+/**
+ * \file lyxtextclass.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- *           LyX, The Document Processor
- *
- *           Copyright 1995 Matthias Ettrich
- *           Copyright 1995-2001 The LyX Team.
- *
- * ====================================================== */
+ * Full author contact details are available in file CREDITS
+ */
 
 #ifndef LYXTEXTCLASS_H
 #define LYXTEXTCLASS_H
 
-#ifdef __GNUG__
-#pragma interface
-#endif
-
 #include "lyxlayout.h"
 #include "LString.h"
 #include "lyxlayout_ptr_fwd.h"
@@ -30,29 +24,31 @@ class LyXLex;
 class Counters;
 class FloatList;
 
-///
+/// Stores the layout specification of a LyX document class.
 class LyXTextClass {
 public:
-	///
+	/// The individual styles comprising the document class
 	typedef std::vector<LyXLayout_ptr> LayoutList;
-	///
+	/// Enumerate the paragraph styles.
 	typedef LayoutList::const_iterator const_iterator;
-	///
+	/// Construct a layout with default values. Actual values loaded later.
 	explicit
 	LyXTextClass(string const & = string(),
 		     string const & = string(),
 		     string const & = string());
 
-	///
+	/// paragraph styles begin iterator.
 	const_iterator begin() const { return layoutlist_.begin(); }
-	///
+	/// paragraph styles end iterator
 	const_iterator end() const { return layoutlist_.end(); }
 
-	///
+	/// Performs the read of the layout file.
 	bool Read(string const & filename, bool merge = false);
 	///
 	void readOutputType(LyXLex &);
 	///
+	void readTitleType(LyXLex &);
+	///
 	void readMaxCounter(LyXLex &);
 	///
 	void readClassOptions(LyXLex &);
@@ -69,11 +65,11 @@ public:
 	/// Sees to that the textclass structure has been loaded
 	bool load() const;
 
-	/// the list of floats defined in the class
+	/// the list of floats defined in the document class
 	FloatList & floats();
-	/// the list of floats defined in the class
+	/// the list of floats defined in the document class
 	FloatList const & floats() const;
-	/// The Counters present in this textclass.
+	/// The Counters present in this document class.
 	Counters & counters() const;
 	///
 	string const & defaultLayoutName() const;
@@ -128,7 +124,7 @@ public:
 	///
 	int tocdepth() const;
 
-	///
+	/// Can be LaTeX, LinuxDoc, etc.
 	OutputType outputType() const;
 
 	///
@@ -141,6 +137,12 @@ public:
 	string const & rightmargin() const;
 	///
 	int maxcounter() const;
+
+	/// The type of command used to produce a title
+	LYX_TITLE_LATEX_TYPES titletype() const;
+	/// The name of the title command
+	string const & titlename() const;
+
 	///
 	int size() const;
 private:
@@ -148,11 +150,11 @@ private:
 	bool delete_layout(string const &);
 	///
 	bool do_readStyle(LyXLex &, LyXLayout &);
-	///
+	/// Layout file name
 	string name_;
-	///
+	/// document class name
 	string latexname_;
-	///
+	/// document class description
 	string description_;
 	/// Specific class options
 	string opt_fontsize_;
@@ -164,19 +166,19 @@ private:
 	string pagestyle_;
 	///
 	string defaultlayout_;
-	///
+	/// preamble text to support layout styles
 	string preamble_;
-	///
+	/// latex packages loaded by document class.
 	Provides provides_;
 	///
 	unsigned int columns_;
 	///
 	PageSides sides_;
-	///
+	/// header depth to have numbering
 	int secnumdepth_;
-	///
+	/// header depth to appear in table of contents
 	int tocdepth_;
-	///
+	/// Can be LaTeX, LinuxDoc, etc.
 	OutputType outputType_;
 	/** Base font. The paragraph and layout fonts are resolved against
 	    this font. This has to be fully instantiated. Attributes
@@ -189,16 +191,21 @@ private:
 
 	/// Text that dictates how wide the right margin is on the screen
 	string rightmargin_;
-	///
+	/// highest header level used in this layout.
 	int maxcounter_; // add approp. signedness
 
-	///
+	/// The type of command used to produce a title
+	LYX_TITLE_LATEX_TYPES titletype_;
+	/// The name of the title command
+	string titlename_;
+
+	/// Paragraph styles used in this layout
 	LayoutList layoutlist_;
 
-	///
+	/// available types of float, eg. figure, algorithm.
 	boost::shared_ptr<FloatList> floatlist_;
 
-	///
+	/// Types of counters, eg. sections, eqns, figures, avail. in document class.
 	boost::shared_ptr<Counters> ctrs_;
 
 	/// Has this layout file been loaded yet?
@@ -206,7 +213,7 @@ private:
 };
 
 
-///
+/// Merge two different provides flags into one bit field record
 inline
 void operator|=(LyXTextClass::Provides & p1, LyXTextClass::Provides p2)
 {
@@ -214,7 +221,7 @@ void operator|=(LyXTextClass::Provides & p1, LyXTextClass::Provides p2)
 }
 
 
-///
+/// convert page sides option to text 1 or 2
 std::ostream & operator<<(std::ostream & os, LyXTextClass::PageSides p);
 
 #endif