[latexila] liblatexila: explain the purpose of latexila.h and latexila-types.h

[Sébastien Wilmet <swilmet src gnome org>]

commit 40c86aa199d56d1a4b2d424a455162b57fa6c774
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Thu May 28 17:53:57 2015 +0200

    liblatexila: explain the purpose of latexila.h and latexila-types.h

 src/liblatexila/latexila-types.h |    5 +++++
 src/liblatexila/latexila.h       |    4 ++++
 2 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/src/liblatexila/latexila-types.h b/src/liblatexila/latexila-types.h
index 6c01249..335ebc6 100644
--- a/src/liblatexila/latexila-types.h
+++ b/src/liblatexila/latexila-types.h
@@ -17,6 +17,11 @@
  * along with LaTeXila.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/* Every type is defined here. It avoids problems with header #includes cycles.
+ * For example when type-a.h needs the TypeB declaration, and type-b.h needs the
+ * TypeA declaration.
+ */
+
 #ifndef __LATEXILA_TYPES_H__
 #define __LATEXILA_TYPES_H__
 
diff --git a/src/liblatexila/latexila.h b/src/liblatexila/latexila.h
index 34607ad..9c1a8b6 100644
--- a/src/liblatexila/latexila.h
+++ b/src/liblatexila/latexila.h
@@ -17,6 +17,10 @@
  * along with LaTeXila.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/* Main header for the LaTeXila "library". Code using the library (e.g. Vala
+ * code) should #include only this header.
+ */
+
 #ifndef __LATEXILA_H__
 #define __LATEXILA_H__