[evolution/webkit-composer: 93/185] Add documentation to basic classes and update copyright



commit 87424d8470c1e7fd69e0acf992760e3a47fb21ec
Author: Dan Vrátil <dvratil redhat com>
Date:   Sun Dec 2 14:54:21 2012 +0100

    Add documentation to basic classes and update copyright
    
    Add documentation to EEditor, EEditorSelection, EEditorWidget and
    EEditorWindow.
    
    Add copyright to all source files.

 e-util/e-color-chooser-widget.c      |  11 +-
 e-util/e-color-chooser-widget.h      |   4 +-
 e-util/e-color-combo.c               |   2 +
 e-util/e-color-combo.h               |   2 +
 e-util/e-editor-actions.c            |   2 +
 e-util/e-editor-actions.h            |   3 +
 e-util/e-editor-cell-dialog.c        |  10 +-
 e-util/e-editor-cell-dialog.h        |   2 +
 e-util/e-editor-dialog.c             |   2 +
 e-util/e-editor-dialog.h             |   2 +
 e-util/e-editor-find-dialog.c        |   2 +
 e-util/e-editor-find-dialog.h        |   2 +
 e-util/e-editor-hrule-dialog.c       |   2 +
 e-util/e-editor-hrule-dialog.h       |   2 +
 e-util/e-editor-image-dialog.c       |   2 +
 e-util/e-editor-image-dialog.h       |   2 +
 e-util/e-editor-link-dialog.c        |   4 +-
 e-util/e-editor-link-dialog.h        |   2 +
 e-util/e-editor-page-dialog.c        |   4 +-
 e-util/e-editor-page-dialog.h        |   2 +
 e-util/e-editor-paragraph-dialog.c   |   2 +
 e-util/e-editor-paragraph-dialog.h   |   2 +
 e-util/e-editor-private.h            |   5 +-
 e-util/e-editor-replace-dialog.c     |   2 +
 e-util/e-editor-replace-dialog.h     |   2 +
 e-util/e-editor-selection.c          | 504 ++++++++++++++++++++++++++++++++---
 e-util/e-editor-selection.h          |   6 +-
 e-util/e-editor-spell-check-dialog.c |   7 +-
 e-util/e-editor-spell-check-dialog.h |   5 +-
 e-util/e-editor-table-dialog.c       |   4 +-
 e-util/e-editor-table-dialog.h       |   2 +
 e-util/e-editor-text-dialog.c        |   2 +
 e-util/e-editor-text-dialog.h        |   2 +
 e-util/e-editor-utils.c              |  26 ++
 e-util/e-editor-utils.h              |   2 +
 e-util/e-editor-widget.c             | 344 +++++++++++++++++++++++-
 e-util/e-editor-widget.h             |   7 +-
 e-util/e-editor-window.c             |  44 ++-
 e-util/e-editor-window.h             |   2 +
 e-util/e-editor.c                    |  81 +++++-
 e-util/e-editor.h                    |   5 +-
 e-util/e-emoticon-action.c           |   6 +-
 e-util/e-emoticon-action.h           |   6 +-
 e-util/e-emoticon-chooser-menu.c     |   6 +-
 e-util/e-emoticon-chooser-menu.h     |   6 +-
 e-util/e-emoticon-chooser.c          |   6 +-
 e-util/e-emoticon-chooser.h          |   6 +-
 e-util/e-emoticon-tool-button.c      |   6 +-
 e-util/e-emoticon-tool-button.h      |   6 +-
 e-util/e-emoticon.c                  |   6 +-
 e-util/e-emoticon.h                  |   6 +-
 e-util/e-image-chooser-dialog.c      |   2 +
 e-util/e-image-chooser-dialog.h      |   2 +
 e-util/test-editor.c                 |   2 +
 54 files changed, 1116 insertions(+), 70 deletions(-)
---
diff --git a/e-util/e-color-chooser-widget.c b/e-util/e-color-chooser-widget.c
index 18339f5..7cc0b06 100644
--- a/e-util/e-color-chooser-widget.c
+++ b/e-util/e-color-chooser-widget.c
@@ -1,6 +1,8 @@
- 
+
 /* e-color-chooser-widget.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
@@ -29,6 +31,13 @@ G_DEFINE_TYPE (
        e_color_chooser_widget,
        GTK_TYPE_COLOR_CHOOSER_WIDGET);
 
+/**
+ * EColorChooserWidget:
+ *
+ * This widget wrapps around #GtkColorChooserWidget and allows the widget to be
+ * used as a delegate for #GtkComboBox for instance.
+ */
+
 struct _EColorChooserWidgetPrivate {
        gboolean showing_editor;
 };
diff --git a/e-util/e-color-chooser-widget.h b/e-util/e-color-chooser-widget.h
index b68062c..5960542 100644
--- a/e-util/e-color-chooser-widget.h
+++ b/e-util/e-color-chooser-widget.h
@@ -1,5 +1,7 @@
 /* e-color-chooser-widget.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
@@ -68,4 +70,4 @@ GtkWidget *   e_color_chooser_widget_new      (void);
 G_END_DECLS
 
 #endif /* E_COLOR_CHOOSER_WIDGET_H */
- 
+
diff --git a/e-util/e-color-combo.c b/e-util/e-color-combo.c
index f426aef..53584be 100644
--- a/e-util/e-color-combo.c
+++ b/e-util/e-color-combo.c
@@ -1,5 +1,7 @@
 /* e-color-combo.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
diff --git a/e-util/e-color-combo.h b/e-util/e-color-combo.h
index 1b90a35..265d1ee 100644
--- a/e-util/e-color-combo.h
+++ b/e-util/e-color-combo.h
@@ -1,5 +1,7 @@
 /* e-color-combo.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
diff --git a/e-util/e-editor-actions.c b/e-util/e-editor-actions.c
index 678bf17..01b87ac 100644
--- a/e-util/e-editor-actions.c
+++ b/e-util/e-editor-actions.c
@@ -1,5 +1,7 @@
 /* e-editor-actions.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
diff --git a/e-util/e-editor-actions.h b/e-util/e-editor-actions.h
index 7c1bb2e..4d50ac7 100644
--- a/e-util/e-editor-actions.h
+++ b/e-util/e-editor-actions.h
@@ -1,4 +1,7 @@
 /* e-editor-actions.h
+ *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
diff --git a/e-util/e-editor-cell-dialog.c b/e-util/e-editor-cell-dialog.c
index ba21ec5..13640e3 100644
--- a/e-util/e-editor-cell-dialog.c
+++ b/e-util/e-editor-cell-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-cell-dialog.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -15,7 +17,7 @@
  * License along with the program; if not, see <http://www.gnu.org/licenses/>
  *
  */
- 
+
 #ifdef HAVE_CONFIG_H
 #include <config.h>
 #endif
@@ -598,7 +600,7 @@ e_editor_cell_dialog_init (EEditorCellDialog *dialog)
 
        g_signal_connect_swapped (
                widget, "toggled",
-               G_CALLBACK (editor_cell_dialog_set_scope), dialog);     
+               G_CALLBACK (editor_cell_dialog_set_scope), dialog);
 
        /* Scope: row */
        widget = gtk_image_new_from_icon_name ("stock_select-row", GTK_ICON_SIZE_BUTTON);
@@ -611,7 +613,7 @@ e_editor_cell_dialog_init (EEditorCellDialog *dialog)
 
        g_signal_connect_swapped (
                widget, "toggled",
-               G_CALLBACK (editor_cell_dialog_set_scope), dialog);     
+               G_CALLBACK (editor_cell_dialog_set_scope), dialog);
 
        /* Scope: table */
        widget = gtk_image_new_from_icon_name ("stock_select-table", GTK_ICON_SIZE_BUTTON);
@@ -624,7 +626,7 @@ e_editor_cell_dialog_init (EEditorCellDialog *dialog)
 
        g_signal_connect_swapped (
                widget, "toggled",
-               G_CALLBACK (editor_cell_dialog_set_scope), dialog);     
+               G_CALLBACK (editor_cell_dialog_set_scope), dialog);
 
        /* Scope: column */
        widget = gtk_image_new_from_icon_name ("stock_select-column", GTK_ICON_SIZE_BUTTON);
diff --git a/e-util/e-editor-cell-dialog.h b/e-util/e-editor-cell-dialog.h
index 2ea9514..62a4009 100644
--- a/e-util/e-editor-cell-dialog.h
+++ b/e-util/e-editor-cell-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-cell-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-dialog.c b/e-util/e-editor-dialog.c
index 0adfa56..22a303e 100644
--- a/e-util/e-editor-dialog.c
+++ b/e-util/e-editor-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-dialog.h b/e-util/e-editor-dialog.h
index 6f305fd..cfa44c0 100644
--- a/e-util/e-editor-dialog.h
+++ b/e-util/e-editor-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-find-dialog.c b/e-util/e-editor-find-dialog.c
index ae28732..3499652 100644
--- a/e-util/e-editor-find-dialog.c
+++ b/e-util/e-editor-find-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-find-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-find-dialog.h b/e-util/e-editor-find-dialog.h
index 633318b..66a1556 100644
--- a/e-util/e-editor-find-dialog.h
+++ b/e-util/e-editor-find-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-find-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-hrule-dialog.c b/e-util/e-editor-hrule-dialog.c
index 1c572a5..d217481 100644
--- a/e-util/e-editor-hrule-dialog.c
+++ b/e-util/e-editor-hrule-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-hrule-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-hrule-dialog.h b/e-util/e-editor-hrule-dialog.h
index d36b589..46877f7 100644
--- a/e-util/e-editor-hrule-dialog.h
+++ b/e-util/e-editor-hrule-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-hrule-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-image-dialog.c b/e-util/e-editor-image-dialog.c
index 0004e8d..8f7288d 100644
--- a/e-util/e-editor-image-dialog.c
+++ b/e-util/e-editor-image-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-image-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-image-dialog.h b/e-util/e-editor-image-dialog.h
index c6fdaa5..21f7a93 100644
--- a/e-util/e-editor-image-dialog.h
+++ b/e-util/e-editor-image-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-image-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-link-dialog.c b/e-util/e-editor-link-dialog.c
index 6fe9945..f067053 100644
--- a/e-util/e-editor-link-dialog.c
+++ b/e-util/e-editor-link-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-link-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -334,7 +336,7 @@ e_editor_link_dialog_init (EEditorLinkDialog *dialog)
                G_CALLBACK (editor_link_dialog_description_changed), dialog);
        g_signal_connect_swapped (
                widget, "key-press-event",
-               G_CALLBACK (editor_link_dialog_entry_key_pressed), dialog);     
+               G_CALLBACK (editor_link_dialog_entry_key_pressed), dialog);
        dialog->priv->label_edit = widget;
 
        widget = gtk_label_new_with_mnemonic (_("_Description:"));
diff --git a/e-util/e-editor-link-dialog.h b/e-util/e-editor-link-dialog.h
index 8f0ea49..921d718 100644
--- a/e-util/e-editor-link-dialog.h
+++ b/e-util/e-editor-link-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-link-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-page-dialog.c b/e-util/e-editor-page-dialog.c
index 0ce56a4..a5681e3 100644
--- a/e-util/e-editor-page-dialog.c
+++ b/e-util/e-editor-page-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-page-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -417,7 +419,7 @@ e_editor_page_dialog_init (EEditorPageDialog *dialog)
        dialog->priv->text_color_picker = widget;
 
        widget = gtk_label_new_with_mnemonic (_("_Text:"));
-       gtk_label_set_justify (GTK_LABEL (widget), GTK_JUSTIFY_RIGHT);  
+       gtk_label_set_justify (GTK_LABEL (widget), GTK_JUSTIFY_RIGHT);
        gtk_label_set_mnemonic_widget (
                GTK_LABEL (widget), dialog->priv->text_color_picker);
        gtk_grid_attach (grid, widget, 0, 0, 1, 1);
diff --git a/e-util/e-editor-page-dialog.h b/e-util/e-editor-page-dialog.h
index 21a6399..145a092 100644
--- a/e-util/e-editor-page-dialog.h
+++ b/e-util/e-editor-page-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-page-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-paragraph-dialog.c b/e-util/e-editor-paragraph-dialog.c
index 7b4327f..477ce10 100644
--- a/e-util/e-editor-paragraph-dialog.c
+++ b/e-util/e-editor-paragraph-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-text-dialog.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-paragraph-dialog.h b/e-util/e-editor-paragraph-dialog.h
index cadd32d..1c8f0e7 100644
--- a/e-util/e-editor-paragraph-dialog.h
+++ b/e-util/e-editor-paragraph-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-paragraph-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-private.h b/e-util/e-editor-private.h
index f04b1b2..0144b8d 100644
--- a/e-util/e-editor-private.h
+++ b/e-util/e-editor-private.h
@@ -1,4 +1,7 @@
-/* e-editor-private.h
+/*
+ * e-editor-private.h
+ *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-editor-replace-dialog.c b/e-util/e-editor-replace-dialog.c
index 52df61a..fbf7771 100644
--- a/e-util/e-editor-replace-dialog.c
+++ b/e-util/e-editor-replace-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-replace-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-replace-dialog.h b/e-util/e-editor-replace-dialog.h
index 8912751..f6c80ee 100644
--- a/e-util/e-editor-replace-dialog.h
+++ b/e-util/e-editor-replace-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-replace-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-selection.c b/e-util/e-editor-selection.c
index f370e62..967c255 100644
--- a/e-util/e-editor-selection.c
+++ b/e-util/e-editor-selection.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-selection.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -21,6 +23,7 @@
 #endif
 
 #include "e-editor-selection.h"
+#include "e-editor-widget.h"
 #include "e-editor.h"
 #include "e-editor-utils.h"
 
@@ -39,6 +42,20 @@
 #define WORD_WRAP_LENGTH 71
 
 
+G_DEFINE_TYPE (
+       EEditorSelection,
+       e_editor_selection,
+       G_TYPE_OBJECT
+);
+
+/**
+ * EEditorSelection:
+ *
+ * The #EEditorSelection object represents current position of the cursor
+ * with the editor or current text selection within the editor. To obtain
+ * valid #EEditorSelection, call #e_editor_widget_get_selection().
+ */
+
 struct _EEditorSelectionPrivate {
 
        WebKitWebView *webview;
@@ -51,15 +68,9 @@ struct _EEditorSelectionPrivate {
        gulong selection_offset;
 };
 
-G_DEFINE_TYPE (
-       EEditorSelection,
-       e_editor_selection,
-       G_TYPE_OBJECT
-);
-
 enum {
        PROP_0,
-       PROP_WEBVIEW,
+       PROP_EDITOR_WIDGET,
        PROP_ALIGNMENT,
        PROP_BACKGROUND_COLOR,
        PROP_BOLD,
@@ -214,10 +225,10 @@ webview_selection_changed (WebKitWebView *webview,
 }
 
 static void
-editor_selection_set_webview (EEditorSelection *selection,
-                             WebKitWebView *webview)
+editor_selection_set_editor_widget (EEditorSelection *selection,
+                                   EEditorWidget *editor_widget)
 {
-       selection->priv->webview = g_object_ref (webview);
+       selection->priv->webview = g_object_ref (E_EDITOR_WIDGET (editor_widget));
        g_signal_connect (
                webview, "selection-changed",
                G_CALLBACK (webview_selection_changed), selection);
@@ -322,8 +333,8 @@ e_editor_selection_set_property (GObject *object,
        EEditorSelection *selection = E_EDITOR_SELECTION (object);
 
        switch (property_id) {
-               case PROP_WEBVIEW:
-                       editor_selection_set_webview (
+               case PROP_EDITOR_WIDGET:
+                       editor_selection_set_editor_widget (
                                selection, g_value_get_object (value));
                        return;
 
@@ -421,14 +432,20 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
 
        g_object_class_install_property (
                object_class,
-               PROP_WEBVIEW,
+               PROP_EDITOR_WIDGET,
                g_param_spec_object (
-                       "webview",
+                       "editor-widget",
                        NULL,
                        NULL,
-                       WEBKIT_TYPE_WEB_VIEW,
+                       E_TYPE_EDITOR_WIDGET
                        G_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY));
 
+       /**
+        * EEditorSelection:alignment
+        *
+        * Holds alignment of current paragraph.
+        */
+       /* FIXME: Convert the enum to a proper type */
        g_object_class_install_property (
                object_class,
                PROP_ALIGNMENT,
@@ -441,6 +458,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        E_EDITOR_SELECTION_ALIGNMENT_LEFT,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:background-color
+        *
+        * Holds background color of current selection or at current cursor
+        * position.
+        */
        g_object_class_install_property (
                object_class,
                PROP_BACKGROUND_COLOR,
@@ -451,6 +474,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        NULL,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:bold
+        *
+        * Holds whether current selection or text at current cursor position
+        * is bold.
+        */
        g_object_class_install_property (
                object_class,
                PROP_BOLD,
@@ -461,6 +490,11 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        FALSE,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:font-name
+        *
+        * Holds name of font in current selection or at current cursor position.
+        */
        g_object_class_install_property (
                object_class,
                PROP_FONT_NAME,
@@ -471,6 +505,11 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        NULL,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:font-size
+        *
+        * Holds point size of current selection or at current cursor position.
+        */
        g_object_class_install_property (
                object_class,
                PROP_FONT_SIZE,
@@ -483,6 +522,11 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        3,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:font-color
+        *
+        * Holds font color of current selection or at current cursor position
+        */
        g_object_class_install_property (
                object_class,
                PROP_FONT_COLOR,
@@ -493,6 +537,13 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        GDK_TYPE_RGBA,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:block-format
+        *
+        * Holds block format of current paragraph. See #EEditorSelectionBlockFormat
+        * for valid values.
+        */
+       /* FIXME: Convert the EEditorSelectionBlockFormat enum to a propert type */
        g_object_class_install_property (
                object_class,
                PROP_BLOCK_FORMAT,
@@ -505,6 +556,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        0,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:indented
+        *
+        * Holds whether current paragraph is indented. This does not include
+        * citations.
+        */
        g_object_class_install_property (
                object_class,
                PROP_INDENTED,
@@ -515,6 +572,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        FALSE,
                        G_PARAM_READABLE));
 
+       /**
+        * EEditorSelection:italic
+        *
+        * Holds whether current selection or letter at current cursor position
+        * is italic.
+        */
        g_object_class_install_property (
                object_class,
                PROP_ITALIC,
@@ -525,6 +588,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        FALSE,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:monospaced
+        *
+        * Holds whether current selection or letter at current cursor position
+        * is monospaced.
+        */
        g_object_class_install_property (
                object_class,
                PROP_MONOSPACED,
@@ -535,6 +604,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        FALSE,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:strike-through
+        *
+        * Holds whether current selection or letter at current cursor position
+        * is strike-through.
+        */
        g_object_class_install_property (
                object_class,
                PROP_STRIKE_THROUGH,
@@ -545,6 +620,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        FALSE,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:superscript
+        *
+        * Holds whether current selection or letter at current cursor position
+        * is in superscript.
+        */
        g_object_class_install_property (
                object_class,
                PROP_SUPERSCRIPT,
@@ -555,6 +636,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        FALSE,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:subscript
+        *
+        * Holds whether current selection or letter at current cursor position
+        * is in subscript.
+        */
        g_object_class_install_property (
                object_class,
                PROP_SUBSCRIPT,
@@ -565,6 +652,11 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                        FALSE,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorSelection:text
+        *
+        * Holds always up-to-date text of current selection.
+        */
        g_object_class_install_property (
                object_class,
                PROP_TEXT,
@@ -575,6 +667,12 @@ e_editor_selection_class_init (EEditorSelectionClass *klass)
                       NULL,
                       G_PARAM_READABLE));
 
+       /**
+        * EEditorSelection:underline
+        *
+        * Holds whether current selection or letter at current cursor position
+        * is underlined.
+        */
        g_object_class_install_property (
                object_class,
                PROP_UNDERLINE,
@@ -593,16 +691,14 @@ e_editor_selection_init (EEditorSelection *selection)
        selection->priv = E_EDITOR_SELECTION_GET_PRIVATE (selection);
 }
 
-EEditorSelection *
-e_editor_selection_new (WebKitWebView *parent_view)
-{
-       g_return_val_if_fail (WEBKIT_IS_WEB_VIEW (parent_view), NULL);
-
-       return g_object_new (
-                       E_TYPE_EDITOR_SELECTION,
-                       "webview", parent_view, NULL);
-}
-
+/**
+ * e_editor_selection_has_text:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection contains any text.
+ *
+ * Returns: @TRUE when current selection contains text, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_has_text (EEditorSelection *selection)
 {
@@ -644,6 +740,15 @@ e_editor_selection_has_text (EEditorSelection *selection)
        return FALSE;
 }
 
+/**
+ * e_editor_selection_get_caret_word:
+ * @selection: an #EEditorSelection
+ *
+ * Returns word under cursor.
+ *
+ * Returns: A newly allocated string with current caret word or @NULL when there
+ * is no text under cursor or when selection is active. [transfer-full].
+ */
 gchar *
 e_editor_selection_get_caret_word (EEditorSelection *selection)
 {
@@ -660,6 +765,13 @@ e_editor_selection_get_caret_word (EEditorSelection *selection)
        return webkit_dom_range_to_string (range, NULL);
 }
 
+/**
+ * e_editor_selection_replace_caret_word:
+ * @selection: an #EEditorSelection
+ * @replacement: a string to replace current caret word with
+ *
+ * Replaces current word under cursor with @replacement.
+ */
 void
 e_editor_selection_replace_caret_word (EEditorSelection *selection,
                                       const gchar *replacement)
@@ -683,6 +795,15 @@ e_editor_selection_replace_caret_word (EEditorSelection *selection,
        e_editor_selection_insert_html (selection, replacement);
 }
 
+/**
+ * e_editor_selection_get_string:
+ * @selection: an #EEditorSelection
+ *
+ * Returns currently selected string.
+ *
+ * Returns: A pointer to content of current selection. The string is owned by
+ * #EEditorSelection and should not be free'd.
+ */
 const gchar *
 e_editor_selection_get_string (EEditorSelection *selection)
 {
@@ -698,6 +819,13 @@ e_editor_selection_get_string (EEditorSelection *selection)
        return selection->priv->text;
 }
 
+/**
+ * e_editor_selection_replace:
+ * @selection: an #EEditorSelection
+ * @new_string: a string to replace current selection with
+ *
+ * Replaces currently selected text with @new_string.
+ */
 void
 e_editor_selection_replace (EEditorSelection *selection,
                            const gchar *new_string)
@@ -716,6 +844,14 @@ e_editor_selection_replace (EEditorSelection *selection,
        webkit_dom_range_insert_node (range, WEBKIT_DOM_NODE (frag), NULL);
 }
 
+/**
+ * e_editor_selection_get_alignment:
+ * @selection: #an EEditorSelection
+ *
+ * Returns alignment of current paragraph
+ *
+ * Returns: #EEditorSelectionAlignment
+ */
 EEditorSelectionAlignment
 e_editor_selection_get_alignment (EEditorSelection *selection)
 {
@@ -766,6 +902,13 @@ e_editor_selection_get_alignment (EEditorSelection *selection)
        return alignment;
 }
 
+/**
+ * e_editor_selection_set_alignment:
+ * @selection: an #EEditorSelection
+ * @alignment: an #EEditorSelectionAlignment value to apply
+ *
+ * Sets alignment of current paragraph to give @alignment.
+ */
 void
 e_editor_selection_set_alignment (EEditorSelection *selection,
                                  EEditorSelectionAlignment alignment)
@@ -799,9 +942,17 @@ e_editor_selection_set_alignment (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "alignment");
 }
 
-
+/**
+ * e_editor_selection_get_background_color:
+ * @selection: an #EEditorSelection
+ *
+ * Returns background color of currently selected text or letter at current
+ * cursor position.
+ *
+ * Returns: A string with code of current background color.
+ */
 const gchar *
-e_editor_selection_get_background_color        (EEditorSelection *selection)
+e_editor_selection_get_background_color (EEditorSelection *selection)
 {
        WebKitDOMNode *ancestor;
        WebKitDOMRange *range;
@@ -821,6 +972,14 @@ e_editor_selection_get_background_color    (EEditorSelection *selection)
        return selection->priv->background_color;
 }
 
+/**
+ * e_editor_selection_set_background_color:
+ * @selection: an #EEditorSelection
+ * @color: code of new background color to set
+ *
+ * Changes background color of current selection or letter at current cursor
+ * position to @color.
+ */
 void
 e_editor_selection_set_background_color (EEditorSelection *selection,
                                        const gchar *color)
@@ -837,6 +996,14 @@ e_editor_selection_set_background_color (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "background-color");
 }
 
+/**
+ * e_editor_selection_get_block_format:
+ * @selection: an #EEditorSelection
+ *
+ * Returns block format of current paragraph.
+ *
+ * Returns: #EEditorSelectionBlockFormat
+ */
 EEditorSelectionBlockFormat
 e_editor_selection_get_block_format (EEditorSelection *selection)
 {
@@ -901,6 +1068,13 @@ e_editor_selection_get_block_format (EEditorSelection *selection)
        return result;
 }
 
+/**
+ * e_editor_selection_set_block_format:
+ * @selection: an #EEditorSelection
+ * @format: an #EEditorSelectionBlockFormat value
+ *
+ * Changes block format of current paragraph to @format.
+ */
 void
 e_editor_selection_set_block_format (EEditorSelection *selection,
                                     EEditorSelectionBlockFormat format)
@@ -1018,7 +1192,14 @@ e_editor_selection_set_block_format (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "block-format");
 }
 
-
+/**
+ * e_editor_selection_get_font_color:
+ * @selection: an #EEditorSelection
+ * @rgba:[out] a #GdkRGBA object to be set to current font color
+ *
+ * Sets @rgba to contain color of current text selection or letter at current
+ * cursor position.
+ */
 void
 e_editor_selection_get_font_color (EEditorSelection *selection,
                                   GdkRGBA *rgba)
@@ -1036,6 +1217,14 @@ e_editor_selection_get_font_color (EEditorSelection *selection,
        g_free (color);
 }
 
+/**
+ * e_editor_selection_set_font_color:
+ * @selection: an #EEditorSelection
+ * @rgba: a #GdkRGBA
+ *
+ * Sets font color of current selection or letter at current cursor position to
+ * color defined in @rgba.
+ */
 void
 e_editor_selection_set_font_color (EEditorSelection *selection,
                                   const GdkRGBA *rgba)
@@ -1059,6 +1248,15 @@ e_editor_selection_set_font_color (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "font-color");
 }
 
+/**
+ * e_editor_selection_get_font_name:
+ * @selection: an #EEditorSelection
+ *
+ * Returns name of font used in current selection or at letter at current cursor
+ * position.
+ *
+ * Returns: A string with font name. [transfer-none]
+ */
 const gchar *
 e_editor_selection_get_font_name (EEditorSelection *selection)
 {
@@ -1079,6 +1277,14 @@ e_editor_selection_get_font_name (EEditorSelection *selection)
        return selection->priv->font_family;
 }
 
+/**
+ * e_editor_selection_set_font_name:
+ * @selection: an #EEditorSelection
+ * @font_name: a font name to apply
+ *
+ * Sets font name of current selection or of letter at current cursor position
+ * to @font_name.
+ */
 void
 e_editor_selection_set_font_name (EEditorSelection *selection,
                                  const gchar *font_name)
@@ -1093,7 +1299,13 @@ e_editor_selection_set_font_name (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "font-name");
 }
 
-guint
+/**
+ * e_editor_Selection_get_font_size:
+ * @selection: an #EEditorSelection
+ *
+ * Returns point size of current selection or of letter at current cursor position.
+ */
+ guint
 e_editor_selection_get_font_size (EEditorSelection *selection)
 {
        gchar *size;
@@ -1118,6 +1330,14 @@ e_editor_selection_get_font_size (EEditorSelection *selection)
        return size_int;
 }
 
+/**
+ * e_editor_selection_set_font_size:
+ * @selection: an #EEditorSelection
+ * @font_size: point size to apply
+ *
+ * Sets font size of current selection or of letter at current cursor position
+ * to @font_size.
+ */
 void
 e_editor_selection_set_font_size (EEditorSelection *selection,
                                  guint font_size)
@@ -1135,7 +1355,14 @@ e_editor_selection_set_font_size (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "font-size");
 }
 
-/* Not a property! */
+/**
+ * e_editor_selection_is_citation:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current paragraph is a citation.
+ *
+ * Returns: @TRUE when current paragraph is a citation, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_citation (EEditorSelection* selection)
 {
@@ -1145,6 +1372,15 @@ e_editor_selection_is_citation (EEditorSelection* selection)
        return get_has_style (selection, "citation");
 }
 
+/**
+ * e_editor_selection_is_indented:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current paragraph is indented. This does not include citations.
+ * To check, whether paragraph is a citation, use #e_editor_selection_is_citation().
+ *
+ * Returns: @TRUE when current paragraph is indented, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_indented (EEditorSelection *selection)
 {
@@ -1153,6 +1389,12 @@ e_editor_selection_is_indented (EEditorSelection *selection)
        return get_has_style (selection, "blockquote");
 }
 
+/**
+ * e_editor_selection_indent:
+ * @selection: an #EEditorSelection
+ *
+ * Indents current paragraph by one level.
+ */
 void
 e_editor_selection_indent (EEditorSelection *selection)
 {
@@ -1166,6 +1408,12 @@ e_editor_selection_indent (EEditorSelection *selection)
        g_object_notify (G_OBJECT (selection), "indented");
 }
 
+/**
+ * e_editor_selection_unindent:
+ * @selection: an #EEditorSelection
+ *
+ * Unindents current paragraph by one level.
+ */
 void
 e_editor_selection_unindent (EEditorSelection *selection)
 {
@@ -1179,6 +1427,15 @@ e_editor_selection_unindent (EEditorSelection *selection)
        g_object_notify (G_OBJECT (selection), "indented");
 }
 
+/**
+ * e_editor_selection_is_bold:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection or letter at current cursor position
+ * is bold.
+ *
+ * Returns @TRUE when selection is bold, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_bold (EEditorSelection *selection)
 {
@@ -1187,6 +1444,14 @@ e_editor_selection_is_bold (EEditorSelection *selection)
        return get_has_style (selection, "b");
 }
 
+/**
+ * e_editor_selection_set_bold:
+ * @selection: an #EEditorSelection
+ * @bold: @TRUE to enable bold, @FALSE to disable
+ *
+ * Toggles bold formatting of current selection or letter at current cursor
+ * position, depending on whether @bold is @TRUE or @FALSE.
+ */
 void
 e_editor_selection_set_bold (EEditorSelection *selection,
                             gboolean bold)
@@ -1206,6 +1471,15 @@ e_editor_selection_set_bold (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "bold");
 }
 
+/**
+ * e_editor_selection_is_italic:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection or letter at current cursor position
+ * is italic.
+ *
+ * Returns @TRUE when selection is italic, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_italic (EEditorSelection *selection)
 {
@@ -1214,6 +1488,14 @@ e_editor_selection_is_italic (EEditorSelection *selection)
        return get_has_style (selection, "i");
 }
 
+/**
+ * e_editor_selection_set_italic:
+ * @selection: an #EEditorSelection
+ * @italic: @TRUE to enable italic, @FALSE to disable
+ *
+ * Toggles italic formatting of current selection or letter at current cursor
+ * position, depending on whether @italic is @TRUE or @FALSE.
+ */
 void
 e_editor_selection_set_italic (EEditorSelection *selection,
                               gboolean italic)
@@ -1233,6 +1515,15 @@ e_editor_selection_set_italic (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "italic");
 }
 
+/**
+ * e_editor_selection_is_monospaced:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection or letter at current cursor position
+ * is monospaced.
+ *
+ * Returns @TRUE when selection is monospaced, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_monospaced (EEditorSelection *selection)
 {
@@ -1241,6 +1532,14 @@ e_editor_selection_is_monospaced (EEditorSelection *selection)
        return get_has_style (selection, "tt");
 }
 
+/**
+ * e_editor_selection_set_monospaced:
+ * @selection: an #EEditorSelection
+ * @monospaced: @TRUE to enable monospaced, @FALSE to disable
+ *
+ * Toggles monospaced formatting of current selection or letter at current cursor
+ * position, depending on whether @monospaced is @TRUE or @FALSE.
+ */
 void
 e_editor_selection_set_monospaced (EEditorSelection *selection,
                                   gboolean monospaced)
@@ -1287,6 +1586,15 @@ e_editor_selection_set_monospaced (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "monospaced");
 }
 
+/**
+ * e_editor_selection_is_strike_through:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection or letter at current cursor position
+ * is striked through.
+ *
+ * Returns @TRUE when selection is striked through, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_strike_through (EEditorSelection *selection)
 {
@@ -1295,6 +1603,14 @@ e_editor_selection_is_strike_through (EEditorSelection *selection)
        return get_has_style (selection, "strike");
 }
 
+/**
+ * e_editor_selection_set_strike_through:
+ * @selection: an #EEditorSelection
+ * @strike_through: @TRUE to enable strike through, @FALSE to disable
+ *
+ * Toggles strike through formatting of current selection or letter at current
+ * cursor position, depending on whether @strike_through is @TRUE or @FALSE.
+ */
 void
 e_editor_selection_set_strike_through (EEditorSelection *selection,
                                       gboolean strike_through)
@@ -1314,6 +1630,15 @@ e_editor_selection_set_strike_through (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "strike-through");
 }
 
+/**
+ * e_editor_selection_is_subscript:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection or letter at current cursor position
+ * is in subscript.
+ *
+ * Returns @TRUE when selection is in subscript, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_subscript (EEditorSelection *selection)
 {
@@ -1342,6 +1667,14 @@ e_editor_selection_is_subscript (EEditorSelection *selection)
        return (node != NULL);
 }
 
+/**
+ * e_editor_selection_set_subscript:
+ * @selection: an #EEditorSelection
+ * @subscrupt: @TRUE to enable subscript, @FALSE to disable
+ *
+ * Toggles subscript of current selection or letter at current cursor position,
+ * depending on whether @subscript is @TRUE or @FALSE.
+ */
 void
 e_editor_selection_set_subscript (EEditorSelection *selection,
                                  gboolean subscript)
@@ -1361,6 +1694,15 @@ e_editor_selection_set_subscript (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "subscript");
 }
 
+/**
+ * e_editor_selection_is_superscript:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection or letter at current cursor position
+ * is in superscript.
+ *
+ * Returns @TRUE when selection is in superscript, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_superscript (EEditorSelection *selection)
 {
@@ -1389,6 +1731,14 @@ e_editor_selection_is_superscript (EEditorSelection *selection)
        return (node != NULL);
 }
 
+/**
+ * e_editor_selection_set_superscript:
+ * @selection: an #EEditorSelection
+ * @superscript: @TRUE to enable superscript, @FALSE to disable
+ *
+ * Toggles superscript of current selection or letter at current cursor position,
+ * depending on whether @superscript is @TRUE or @FALSE.
+ */
 void
 e_editor_selection_set_superscript (EEditorSelection *selection,
                                    gboolean superscript)
@@ -1408,6 +1758,15 @@ e_editor_selection_set_superscript (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "superscript");
 }
 
+/**
+ * e_editor_selection_is_underline:
+ * @selection: an #EEditorSelection
+ *
+ * Returns whether current selection or letter at current cursor position
+ * is underlined.
+ *
+ * Returns @TRUE when selection is underlined, @FALSE otherwise.
+ */
 gboolean
 e_editor_selection_is_underline (EEditorSelection *selection)
 {
@@ -1416,6 +1775,14 @@ e_editor_selection_is_underline (EEditorSelection *selection)
        return get_has_style (selection, "u");
 }
 
+/**
+ * e_editor_selection_set_underline:
+ * @selection: an #EEditorSelection
+ * @underline: @TRUE to enable underline, @FALSE to disable
+ *
+ * Toggles underline formatting of current selection or letter at current
+ * cursor position, depending on whether @underline is @TRUE or @FALSE.
+ */
 void
 e_editor_selection_set_underline (EEditorSelection *selection,
                                  gboolean underline)
@@ -1435,6 +1802,13 @@ e_editor_selection_set_underline (EEditorSelection *selection,
        g_object_notify (G_OBJECT (selection), "underline");
 }
 
+/**
+ * e_editor_selection_unlink:
+ * @selection: an #EEditorSelection
+ *
+ * Removes any links (&lt;A&gt; elements) from current selection or at current
+ * cursor position.
+ */
 void
 e_editor_selection_unlink (EEditorSelection *selection)
 {
@@ -1446,6 +1820,13 @@ e_editor_selection_unlink (EEditorSelection *selection)
        webkit_dom_document_exec_command (document, "unlink", FALSE, "");
 }
 
+/**
+ * e_editor_selection_create_link:
+ * @selection: an #EEditorSelection
+ * @uri: destination of the new link
+ *
+ * Converts current selection into a link pointing to @url.
+ */
 void
 e_editor_selection_create_link (EEditorSelection *selection,
                                const gchar *uri)
@@ -1459,7 +1840,14 @@ e_editor_selection_create_link (EEditorSelection *selection,
        webkit_dom_document_exec_command (document, "createLink", FALSE, uri);
 }
 
-
+/**
+ * e_editor_selection_insert_text:
+ * @selection: an #EEditorSelection
+ * @plain_text: text to insert
+ *
+ * Inserts @plain_text at current cursor position. When a text range is selected,
+ * it will be replaced by @plain_text.
+ */
 void
 e_editor_selection_insert_text (EEditorSelection *selection,
                                const gchar *plain_text)
@@ -1475,6 +1863,14 @@ e_editor_selection_insert_text (EEditorSelection *selection,
                document, "insertText", FALSE, plain_text);
 }
 
+/**
+ * e_editor_selection_insert_html:
+ * @selection: an #EEditorSelection
+ * @html_text: an HTML code to insert
+ *
+ * Insert @html_text into document at current cursor position. When a text range
+ * is selected, it will be replaced by @html_text.
+ */
 void
 e_editor_selection_insert_html (EEditorSelection *selection,
                                const gchar *html_text)
@@ -1489,6 +1885,14 @@ e_editor_selection_insert_html (EEditorSelection *selection,
                        document, "insertHTML", FALSE, html_text);
 }
 
+/**
+ * e_editor_selection_insert_image:
+ * @selection: an #EEditorSelection
+ * @image_uri: an URI of the source image
+ *
+ * Inserts image at current cursor position using @image_uri as source. When a
+ * text range is selected, it will be replaced by the image.
+ */
 void
 e_editor_selection_insert_image (EEditorSelection *selection,
                                 const gchar *image_uri)
@@ -1547,6 +1951,12 @@ find_where_to_break_line (WebKitDOMNode *node,
        return max_len;
 }
 
+/**
+ * e_editor_selection_wrap_lines:
+ * @selection: an #EEditorSelection
+ *
+ * Wraps all lines in current selection to be 71 characters long.
+ */
 void
 e_editor_selection_wrap_lines (EEditorSelection *selection)
 {
@@ -1670,6 +2080,27 @@ e_editor_selection_wrap_lines (EEditorSelection *selection)
        g_free (html);
 }
 
+/**
+ * e_editor_selection_save:
+ * @selection: an #EEditorSelection
+ *
+ * Saves current cursor position or current selection range. The selection can
+ * be later restored by calling #e_editor_selection_restore().
+ *
+ * Note that calling #e_editor_selection_save() overwrites previously saved
+ * position.
+ *
+ * Note that this method inserts special markings into the HTML code that are
+ * used to later restore the selection. It can happen that by deleting some segments
+ * of the document some of the markings are deleted too. In that case restoring
+ * the selection by #e_editor_selection_restore() can fail. Also by moving text
+ * segments (Cut & Paste) can result in moving the markings elsewhere, thus
+ * #e_editor_selection_restore() will restore the selection incorrectly.
+ *
+ * It is recommended to use this method only when you are not planning to make
+ * bigger changes to content or structure of the document (formatting changes
+ * are usually OK).
+ */
 void
 e_editor_selection_save (EEditorSelection* selection)
 {
@@ -1735,7 +2166,16 @@ e_editor_selection_save (EEditorSelection* selection)
                WEBKIT_DOM_NODE (marker), split, NULL);
 }
 
-
+/**
+ * e_editor_selection_restore:
+ * @selection: an #EEditorSelection
+ *
+ * Restores cursor position or selection range that was saved by
+ * #e_editor_selection_save().
+ *
+ * Note that calling this function without calling #e_editor_selection_save()
+ * before is a programming error and the behavior is undefined.
+ */
 void
 e_editor_selection_restore (EEditorSelection* selection)
 {
diff --git a/e-util/e-editor-selection.h b/e-util/e-editor-selection.h
index b5e5cfa..4d62cca 100644
--- a/e-util/e-editor-selection.h
+++ b/e-util/e-editor-selection.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-selection.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -24,7 +26,6 @@
 #define E_EDITOR_SELECTION_H
 
 #include <glib-object.h>
-#include <webkit/webkit.h>
 
 /* Standard GObject macros */
 #define E_TYPE_EDITOR_SELECTION \
@@ -47,6 +48,7 @@
 
 G_BEGIN_DECLS
 
+typedef struct _EEditorWidget EEditorWidget;
 typedef struct _EEditorSelection EEditorSelection;
 typedef struct _EEditorSelectionClass EEditorSelectionClass;
 typedef struct _EEditorSelectionPrivate EEditorSelectionPrivate;
@@ -97,8 +99,6 @@ struct _EEditorSelectionClass {
 
 GType                  e_editor_selection_get_type     (void);
 
-EEditorSelection *     e_editor_selection_new          (WebKitWebView *parent_view);
-
 gboolean               e_editor_selection_has_text     (EEditorSelection *selection);
 
 gchar *                        e_editor_selection_get_caret_word
diff --git a/e-util/e-editor-spell-check-dialog.c b/e-util/e-editor-spell-check-dialog.c
index d91c6cb..01a1a17 100644
--- a/e-util/e-editor-spell-check-dialog.c
+++ b/e-util/e-editor-spell-check-dialog.c
@@ -1,4 +1,7 @@
-/* e-editor-spell-dialog.c
+/*
+ * e-editor-spell-dialog.c
+ *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
@@ -232,7 +235,7 @@ static gboolean
 editor_spell_check_dialog_prev (EEditorSpellCheckDialog *dialog)
 {
        WebKitDOMNode *start = NULL, *end = NULL;
-       gulong start_offset, end_offset;        
+       gulong start_offset, end_offset;
 
        if (dialog->priv->word == NULL) {
                webkit_dom_dom_selection_modify (
diff --git a/e-util/e-editor-spell-check-dialog.h b/e-util/e-editor-spell-check-dialog.h
index 624ff72..a8202e2 100644
--- a/e-util/e-editor-spell-check-dialog.h
+++ b/e-util/e-editor-spell-check-dialog.h
@@ -1,4 +1,7 @@
-/* e-editor-spell-check-dialog.h
+/*
+ * e-editor-spell-check-dialog.h
+ *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-editor-table-dialog.c b/e-util/e-editor-table-dialog.c
index 446f4e0..36b6c2d 100644
--- a/e-util/e-editor-table-dialog.c
+++ b/e-util/e-editor-table-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-table-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -828,6 +830,6 @@ e_editor_table_dialog_new (EEditor *editor)
                        E_TYPE_EDITOR_TABLE_DIALOG,
                        "editor", editor,
                        "title", N_("Table Properties"),
-                       NULL)); 
+                       NULL));
 }
 
diff --git a/e-util/e-editor-table-dialog.h b/e-util/e-editor-table-dialog.h
index 8bcca33..e3262f6 100644
--- a/e-util/e-editor-table-dialog.h
+++ b/e-util/e-editor-table-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-table-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-text-dialog.c b/e-util/e-editor-text-dialog.c
index efaca51..9668200 100644
--- a/e-util/e-editor-text-dialog.c
+++ b/e-util/e-editor-text-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-text-dialog.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-text-dialog.h b/e-util/e-editor-text-dialog.h
index f660f4e..2eea996 100644
--- a/e-util/e-editor-text-dialog.h
+++ b/e-util/e-editor-text-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-text-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-utils.c b/e-util/e-editor-utils.c
index 5daabff..ee872b5 100644
--- a/e-util/e-editor-utils.c
+++ b/e-util/e-editor-utils.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-utils.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -23,6 +25,18 @@
 #include "e-editor-utils.h"
 #include <string.h>
 
+/**
+ * e_editor_dom_node_find_parent_element:
+ * @node: Start node
+ * @tagname: Tag name of element to search
+ *
+ * Recursively searches for first occurance of element with given @tagname
+ * that is parent of given @node.
+ *
+ * Returns: A #WebKitDOMElement with @tagname representing parent of @node or
+ * @NULL when @node has no parent with given @tagname. When @node matches @tagname,
+ * then the @node is returned.
+ */
 WebKitDOMElement *
 e_editor_dom_node_find_parent_element (WebKitDOMNode *node,
                                       const gchar *tagname)
@@ -53,6 +67,18 @@ e_editor_dom_node_find_parent_element (WebKitDOMNode *node,
        return NULL;
 }
 
+/**
+ * e_editor_dom_node_find_child_element:
+ * @node: Start node
+ * @tagname: Tag name of element to search.
+ *
+ * Recursively searches for first occurence of element with given @tagname that
+ * is a child of @node.
+ *
+ * Returns: A #WebKitDOMElement with @tagname representing a child of @node or
+ * @NULL when @node has no child with given @tagname. When @node matches @tagname,
+ * then the @node is returned.
+ */
 WebKitDOMElement *
 e_editor_dom_node_find_child_element (WebKitDOMNode *node,
                                      const gchar *tagname)
diff --git a/e-util/e-editor-utils.h b/e-util/e-editor-utils.h
index 5e370c7..fb4d313 100644
--- a/e-util/e-editor-utils.h
+++ b/e-util/e-editor-utils.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-utils.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor-widget.c b/e-util/e-editor-widget.c
index c661003..8730edc 100644
--- a/e-util/e-editor-widget.c
+++ b/e-util/e-editor-widget.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-widget.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -29,6 +31,20 @@
 #include <glib/gi18n-lib.h>
 #include <gdk/gdkkeysyms.h>
 
+G_DEFINE_TYPE (
+       EEditorWidget,
+       e_editor_widget,
+       WEBKIT_TYPE_WEB_VIEW);
+
+/**
+ * EEditorWidget:
+ *
+ * The #EEditorWidget is a WebKit-based rich text editor. The widget itself
+ * only provides means to configure global behavior of the editor. To work
+ * with the actual content, current cursor position or current selection,
+ * use #EEditorSelection object.
+ */
+
 struct _EEditorWidgetPrivate {
        gint changed            : 1;
        gint inline_spelling    : 1;
@@ -53,10 +69,6 @@ struct _EEditorWidgetPrivate {
        GQueue *postreload_operations;
 };
 
-G_DEFINE_TYPE (
-       EEditorWidget,
-       e_editor_widget,
-       WEBKIT_TYPE_WEB_VIEW);
 
 enum {
        PROP_0,
@@ -733,6 +745,11 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
 
        klass->paste_clipboard_quoted = editor_widget_paste_clipboard_quoted;
 
+       /**
+        * EEditorWidget:html-mode
+        *
+        * Determines whether HTML or plain text mode is enabled.
+        **/
        g_object_class_install_property (
                object_class,
                PROP_HTML_MODE,
@@ -744,6 +761,11 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        G_PARAM_READWRITE |
                        G_PARAM_CONSTRUCT));
 
+       /**
+        * EEditorWidget::inline-spelling
+        *
+        * Determines whether automatic spellchecking is enabled.
+        */
        g_object_class_install_property (
                object_class,
                PROP_INLINE_SPELLING,
@@ -755,6 +777,12 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        G_PARAM_READWRITE |
                        G_PARAM_CONSTRUCT));
 
+       /**
+        * EEditorWidget:magic-links
+        *
+        * Determines whether automatic conversion of text links into
+        * HTML links is enabled.
+        */
        g_object_class_install_property (
                object_class,
                PROP_MAGIC_LINKS,
@@ -766,6 +794,12 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        G_PARAM_READWRITE |
                        G_PARAM_CONSTRUCT));
 
+       /**
+        * EEditorWidget:magic-smileys
+        *
+        * Determines whether automatic conversion of text smileys into
+        * images is enabled.
+        */
        g_object_class_install_property (
                object_class,
                PROP_MAGIC_SMILEYS,
@@ -777,6 +811,11 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        G_PARAM_READWRITE |
                        G_PARAM_CONSTRUCT));
 
+       /**
+        * EEditorWidget:changed
+        *
+        * Determines whether document has been modified
+        */
        g_object_class_install_property (
                object_class,
                PROP_CHANGED,
@@ -787,6 +826,12 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        FALSE,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorWidget:can-copy
+        *
+        * Determines whether it's possible to copy to clipboard. The action
+        * is usually disabled when there is no selection to copy.
+        */
        g_object_class_install_property (
                object_class,
                PROP_CAN_COPY,
@@ -797,6 +842,12 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        FALSE,
                        G_PARAM_READABLE));
 
+       /**
+        * EEditorWidget:can-cut
+        *
+        * Determines whether it's possible to cut to clipboard. The action
+        * is usually disabled when there is no selection to cut.
+        */
        g_object_class_install_property (
                object_class,
                PROP_CAN_CUT,
@@ -807,6 +858,12 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        FALSE,
                        G_PARAM_READABLE));
 
+       /**
+        * EEditorWidget:can-paste
+        *
+        * Determines whether it's possible to paste from clipboard. The action
+        * is usually disabled when there is no valid content in clipboard to paste.
+        */
        g_object_class_install_property (
                object_class,
                PROP_CAN_PASTE,
@@ -817,6 +874,12 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        FALSE,
                        G_PARAM_READABLE));
 
+       /**
+        * EEditorWidget:can-redu
+        *
+        * Determines whether it's possible to redo previous action. The action
+        * is usually disabled when there is no action to redo.
+        */
        g_object_class_install_property (
                object_class,
                PROP_CAN_REDO,
@@ -827,6 +890,12 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        FALSE,
                        G_PARAM_READABLE));
 
+       /**
+        * EEditorWidget:can-undo
+        *
+        * Determines whether it's possible to undo last action. The action
+        * is usually disabled when there is no previous action to undo.
+        */
        g_object_class_install_property (
                object_class,
                PROP_CAN_UNDO,
@@ -837,6 +906,11 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        FALSE,
                        G_PARAM_READABLE));
 
+       /**
+        * EEditorWidget:spell-languages
+        *
+        * List of #ESpellDictionary objects used for spellchecking.
+        */
        g_object_class_install_property (
                object_class,
                PROP_SPELL_LANGUAGES,
@@ -846,6 +920,11 @@ e_editor_widget_class_init (EEditorWidgetClass *klass)
                        NULL,
                        G_PARAM_READWRITE));
 
+       /**
+        * EEditorWidget:popup-event
+        *
+        * Emitted whenever a context menu is requested.
+        */
        signals[POPUP_EVENT] = g_signal_new (
                "popup-event",
                G_TYPE_FROM_CLASS (klass),
@@ -909,8 +988,10 @@ e_editor_widget_init (EEditorWidget *editor)
        g_signal_connect (inspector, "inspect-web-view",
                G_CALLBACK (editor_widget_open_inspector), NULL);
 
-       editor->priv->selection = e_editor_selection_new (
-                                       WEBKIT_WEB_VIEW (editor));
+       editor->priv->selection = g_object_new (
+                                       E_TYPE_EDITOR_SELECTION,
+                                       "editor-widget", editor,
+                                       NULL);
 
        g_settings = g_settings_new ("org.gnome.desktop.interface");
        g_signal_connect_swapped (
@@ -944,12 +1025,30 @@ e_editor_widget_init (EEditorWidget *editor)
        editor_widget_set_links_active (editor, FALSE);
 }
 
+/**
+ * e_editor_widget_new:
+ *
+ * Returns a new instance of the editor.
+ *
+ * Returns: A newly created #EEditorWidget. [transfer-full]
+ */
 EEditorWidget *
 e_editor_widget_new (void)
 {
        return g_object_new (E_TYPE_EDITOR_WIDGET, NULL);
 }
 
+/**
+ * e_editor_widget_get_selection:
+ * @widget: an #EEditorWidget
+ *
+ * Returns an #EEditorSelection object which represents current selection or
+ * cursor position within the editor document. The #EEditorSelection allows
+ * programmer to manipulate with formatting, selection, styles etc.
+ *
+ * Returns: An always valid #EEditorSelection object. The object is owned by
+ * the @widget and should never be free'd.
+ */
 EEditorSelection *
 e_editor_widget_get_selection (EEditorWidget *widget)
 {
@@ -958,6 +1057,87 @@ e_editor_widget_get_selection (EEditorWidget *widget)
        return widget->priv->selection;
 }
 
+/**
+ * e_editor_widget_exec_command:
+ * @widget: an #EEditorWidget
+ * @command: a command to execute
+ * @value: value of the command (or @NULL)
+ *
+ * Supported @command keywords are:
+ *     "BackColor" - sets background color to @value
+ *     "Bold" - toggles bold text, depending whether @value is "true" or "false"
+ *     "Copy" - copies current selection to clipboard
+ *     "CreateLink" - converts current selection to a link that points to URL in @value
+ *     "Cut" - cuts current selection to clipboard
+ *     "DefaultParagraphSeparator"
+ *     "Delete" - deletes current selection
+ *     "FindString" - highlights string passed in @value
+ *     "FontName" - sets font name to @value
+ *     "FontSize" - sets font point size to @value (no units, just number)
+ *     "FontSizeDelta" - changes font size by delta passed in @value (no units, just number)
+ *     "FontColor" - sets font color to @value
+ *     "FormatBlock" - formats block to given formatting. Allowed formatting keywords are "BLOCKQUOTE",
+ *                     "H1", "H2", "H3", "H4", "H5", "H6", "P", "PRE" and "ADDRESS"
+ *     "ForwardDelete"
+ *     "HiliteColor" - sets color in which results of "FindString" command should be highlighted to @value
+ *     "Indent" - indents current paragraph
+ *     "InsertHTML" - inserts content of @value into document as an HTML code
+ *     "InsertHorizontalRule" - inserts <HR> on current line
+ *     "InsertImage" - inserts an image with URL contained in @value into document
+ *     "InsertLineBreak" - breaks line at current cursor position
+ *     "InsertNewlineInQuotedContent - breaks citation at current cursor position
+ *     "InsertOrderedList - inserts <OL> environment
+ *     "InsertParagraph - inserts <P> environment
+ *     "InsertText - inserts content of @value as text
+ *     "InsertUnorderedList" - inserts <UL> environment
+ *     "Italic" - toggles italic format depending on whether @value is "true" or "false"
+ *     "JustifyCenter" - aligns current paragraph to center
+ *     "JustifyFull" - justifies current paragraph to block
+ *     "JustifyLeft" - aligns current paragraph to left
+ *     "JustifyNone" - cancels any justification or alignment of current paragraph
+ *     "JustifyRight" - aligns current paragraph to right
+ *     "Outdent" - outdents current paragraph
+ *     "Paste" - pastes clipboard content at current cursor position
+ *     "PasteAndMatchStyle" - pastes clipboard content and matches it's style to style at current cursor 
position
+ *     "PasteAsPlainText" - pastes clipboard content at current cursor position removing any HTML formatting
+ *     "Print" - initiates printing of current document
+ *     "Redo"
+ *     "RemoveFormat" - removes any formatting of current selection
+ *     "SelectAll" - selects the entire document
+ *     "Strikethrough" - toggles strikethrough formatting depending on whether @value is "true" or "false"
+ *     "StyleWithCSS" - toggles whether style should be defined in CSS "style" attribute of elements or
+ *                      whether to use deprecated <FONT> tags. Depends on whether @value is "true" or "false"
+ *     "Subscript" - toggles subscript of current selection depending on whether @value is "true" or "false"
+ *     "Superscript" - toggles superscript of current selection depending on whether @value is "true" or 
"false"
+ *     "Transpose"
+ *     "Underline" - toggles underline formatting of current selection depending on whether @value is "true" 
or "false"
+ *     "Undo"
+ *     "Unlink" - removes links (<A>) from current selection (if there's any)
+ *     "Unselect" - cancels current selection
+ *     "UseCSS" - whether to allow use of CSS or not depending on whether @value is "true" or "false"
+ */
+gboolean
+e_editor_widget_exec_command (EEditorWidget* widget,
+                             const gchar* command,
+                             const gchar* value)
+{
+       WebKitDOMDocument *document;
+
+       g_return_if_fail (E_IS_EDITOR_WIDGET (widget));
+       g_return_if_fail (command && *command);
+
+       document = webkit_web_view_get_dom_document (WEBKIT_WEB_VIEW (widget));
+       return webkit_dom_document_exec_command (document, command, FALSE, value ? value : "");
+}
+
+/**
+ * e_editor_widget_get_changed:
+ * @widget: an #EEditorWidget
+ *
+ * Whether content of the editor has been changed.
+ *
+ * Returns: @TRUE when document was changed, @FALSE otherwise.
+ */
 gboolean
 e_editor_widget_get_changed (EEditorWidget *widget)
 {
@@ -966,6 +1146,15 @@ e_editor_widget_get_changed (EEditorWidget *widget)
        return widget->priv->changed;
 }
 
+/**
+ * e_editor_widget_set_changed:
+ * @widget: an #EEditorWidget
+ * @changed: whether document has been changed or not
+ *
+ * Sets whether document has been changed or not. The editor is tracking changes
+ * automatically, but sometimes it's necessary to change the dirty flag to force
+ * "Save changes" dialog for example.
+ */
 void
 e_editor_widget_set_changed (EEditorWidget *widget,
                             gboolean changed)
@@ -980,6 +1169,16 @@ e_editor_widget_set_changed (EEditorWidget *widget,
        g_object_notify (G_OBJECT (widget), "changed");
 }
 
+/**
+ * e_editor_widget_get_html_mode:
+ * @widget: an #EEditorWidget
+ *
+ * Whether the editor is in HTML mode or plain text mode. In HTML mode,
+ * more formatting options are avilable an the email is sent as
+ * multipart/alternative.
+ *
+ * Returns: @TRUE when HTML mode is enabled, @FALSE otherwise.
+ */
 gboolean
 e_editor_widget_get_html_mode (EEditorWidget *widget)
 {
@@ -988,6 +1187,16 @@ e_editor_widget_get_html_mode (EEditorWidget *widget)
        return widget->priv->html_mode;
 }
 
+/**
+ * e_editor_widget_set_html_mode:
+ * @widget: an #EEditorWidget
+ * @html_mode: @TRUE to enable HTML mode, @FALSE to enable plain text mode
+ *
+ * When switching from HTML to plain text mode, user will be prompted whether
+ * he/she really wants to switch the mode and lose all formatting. When user
+ * declines, the property is not changed. When they accept, the all formatting
+ * is lost.
+ */
 void
 e_editor_widget_set_html_mode (EEditorWidget *widget,
                               gboolean html_mode)
@@ -1065,6 +1274,16 @@ e_editor_widget_set_html_mode (EEditorWidget *widget,
        g_object_notify (G_OBJECT (widget), "html-mode");
 }
 
+/**
+ * e_editor_widget_get_inline_spelling:
+ * @widget: an #EEditorWidget
+ *
+ * Returns whether automatic spellchecking is enabled or not. When enabled,
+ * editor will perform spellchecking as user is typing. Otherwise spellcheck
+ * has to be run manually from menu.
+ *
+ * Returns: @TRUE when automatic spellchecking is enabled, @FALSE otherwise.
+ */
 gboolean
 e_editor_widget_get_inline_spelling (EEditorWidget *widget)
 {
@@ -1073,6 +1292,13 @@ e_editor_widget_get_inline_spelling (EEditorWidget *widget)
        return widget->priv->inline_spelling;
 }
 
+/**
+ * e_editor_widget_set_inline_spelling:
+ * @widget: an #EEditorWidget
+ * @inline_spelling: @TRUE to enable automatic spellchecking, @FALSE otherwise
+ *
+ * Enables or disables automatic spellchecking.
+ */
 void
 e_editor_widget_set_inline_spelling (EEditorWidget *widget,
                                     gboolean inline_spelling)
@@ -1087,6 +1313,15 @@ e_editor_widget_set_inline_spelling (EEditorWidget *widget,
        g_object_notify (G_OBJECT (widget), "inline-spelling");
 }
 
+/**
+ * e_editor_widget_get_magic_links:
+ * @widget: an #EEditorWidget
+ *
+ * Returns whether automatic links conversion is enabled. When enabled, the editor
+ * will automatically convert any HTTP links into clickable HTML links.
+ *
+ * Returns: @TRUE when magic links are enabled, @FALSE otherwise.
+ */
 gboolean
 e_editor_widget_get_magic_links (EEditorWidget *widget)
 {
@@ -1095,6 +1330,13 @@ e_editor_widget_get_magic_links (EEditorWidget *widget)
        return widget->priv->magic_links;
 }
 
+/**
+ * e_editor_widget_set_magic_links:
+ * @widget: an #EEditorWidget
+ * @magic_link: @TRUE to enable magic links, @FALSE to disable them
+ *
+ * Enables or disables automatic links conversion.
+ */
 void
 e_editor_widget_set_magic_links (EEditorWidget *widget,
                                 gboolean magic_links)
@@ -1109,6 +1351,16 @@ e_editor_widget_set_magic_links (EEditorWidget *widget,
        g_object_notify (G_OBJECT (widget), "magic-links");
 }
 
+/**
+ * e_editor_widget_get_magic_smileys:
+ * @widget: an #EEditorWidget
+ *
+ * Returns whether automatic conversion of smileys is enabled or disabled. When
+ * enabled, the editor will automatically convert text smileys ( :-), ;-),...)
+ * into images.
+ *
+ * Returns: @TRUE when magic smileys are enabled, @FALSE otherwise.
+ */
 gboolean
 e_editor_widget_get_magic_smileys (EEditorWidget *widget)
 {
@@ -1117,6 +1369,13 @@ e_editor_widget_get_magic_smileys (EEditorWidget *widget)
        return widget->priv->magic_smileys;
 }
 
+/**
+ * e_editor_widget_set_magic_smileys:
+ * @widget: an #EEditorWidget
+ * @magic_smileys: @TRUE to enable magic smileys, @FALSE to disable them
+ *
+ * Enables or disables magic smileys.
+ */
 void
 e_editor_widget_set_magic_smileys (EEditorWidget *widget,
                                   gboolean magic_smileys)
@@ -1131,6 +1390,16 @@ e_editor_widget_set_magic_smileys (EEditorWidget *widget,
        g_object_notify (G_OBJECT (widget), "magic-smileys");
 }
 
+/**
+ * e_editor_widget_get_spell_languages:
+ * @widget: an #EEditorWidget
+ *
+ * Returns list of #ESpellDictionary objects that are used for spell checking.
+ *
+ * Returns: A newly allocated list of #ESpellDictionary objects. You should free
+ * the list by g_list_free() The objects are owned by #EEditorWidget.and should
+ * not be unref'ed or free'd. [element-type ESpellDictionary]
+ */
 GList *
 e_editor_widget_get_spell_languages (EEditorWidget *widget)
 {
@@ -1139,9 +1408,17 @@ e_editor_widget_get_spell_languages (EEditorWidget *widget)
        return g_list_copy (widget->priv->spelling_langs);
 }
 
+/**
+ * e_editor_widget_set_spell_languages:
+ * @widget: an #EEditorWidget
+ * @spell_languages:[element-type ESpellDictionary][transfer-none] a list of
+ * #ESpellDictionary objects
+ *
+ * Sets list of #ESpellDictionary objects that will be used for spell checking.
+ */
 void
 e_editor_widget_set_spell_languages (EEditorWidget *widget,
-                                    GList *spell_languages)
+                                    const GList *spell_languages)
 {
        g_return_if_fail (E_IS_EDITOR_WIDGET (widget));
        g_return_if_fail (spell_languages);
@@ -1153,13 +1430,28 @@ e_editor_widget_set_spell_languages (EEditorWidget *widget,
        g_object_notify (G_OBJECT (widget), "spell-languages");
 }
 
+/**
+ * e_editor_widget_get_spell_checker:
+ * @widget: an #EEditorWidget
+ *
+ * Returns an #ESpellChecker object that is used to perform spellchecking.
+ *
+ * Returns: An always-valid #ESpellChecker object
+ */
 ESpellChecker *
 e_editor_widget_get_spell_checker (EEditorWidget *widget)
 {
        return E_SPELL_CHECKER (webkit_get_text_checker ());
 }
 
-
+/**
+ * e_editor_widget_get_text_html:
+ * @widget: an #EEditorWidget:
+ *
+ * Returns HTML content of the editor document.
+ *
+ * Returns: A newly allocated string
+ */
 gchar *
 e_editor_widget_get_text_html (EEditorWidget *widget)
 {
@@ -1256,6 +1548,15 @@ process_elements (WebKitDOMNode *node,
        g_regex_unref (regex);
 }
 
+/**
+ * e_editor_widget_get_text_plain:
+ * @widget: an #EEditorWidget
+ *
+ * Returns plain text content of the @widget. The algorithm removes any formatting
+ * or styles from the document and keeps only the text and line breaks.
+ *
+ * Returns: A newly allocated string with plain text content of the document. [transfer-full]
+ */
 gchar *
 e_editor_widget_get_text_plain (EEditorWidget *widget)
 {
@@ -1273,6 +1574,13 @@ e_editor_widget_get_text_plain (EEditorWidget *widget)
        return g_string_free (plain_text, FALSE);
 }
 
+/**
+ * e_editor_widget_set_text_html:
+ * @widget: an #EEditorWidget
+ * @text: HTML code to load into the editor
+ *
+ * Loads given @text into the editor, destroying any content already present.
+ */
 void
 e_editor_widget_set_text_html (EEditorWidget *widget,
                               const gchar *text)
@@ -1296,6 +1604,13 @@ do_set_text_plain (EEditorWidget *widget,
                document, "insertText", FALSE, data);
 }
 
+/**
+ * e_editor_widget_set_text_plain:
+ * @widget: an #EEditorWidget
+ * @text: A plain text to load into the editor
+ *
+ * Loads given @text into the editor, destryoing any content already present.
+ */
 void
 e_editor_widget_set_text_plain (EEditorWidget *widget,
                                const gchar *text)
@@ -1313,6 +1628,12 @@ e_editor_widget_set_text_plain (EEditorWidget *widget,
                widget, do_set_text_plain, g_strdup (text), g_free);
 }
 
+/**
+ * e_editor_widget_paste_clipboard_quoted:
+ * @widget: an #EEditorWidget
+ *
+ * Pastes current content of clipboard into the editor as quoted text
+ */
 void
 e_editor_widget_paste_clipboard_quoted (EEditorWidget *widget)
 {
@@ -1326,6 +1647,13 @@ e_editor_widget_paste_clipboard_quoted (EEditorWidget *widget)
        klass->paste_clipboard_quoted (widget);
 }
 
+/**
+ * e_editor_widget_update_fonts:
+ * @widget: an #EEditorWidget
+ *
+ * Forces the editor to reload font settings from WebKitWebSettings and apply
+ * it on the content of the editor document.
+ */
 void
 e_editor_widget_update_fonts (EEditorWidget *widget)
 {
diff --git a/e-util/e-editor-widget.h b/e-util/e-editor-widget.h
index 23d5149..6b94d19 100644
--- a/e-util/e-editor-widget.h
+++ b/e-util/e-editor-widget.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-widget.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -82,6 +84,9 @@ EEditorWidget *       e_editor_widget_new             (void);
 EEditorSelection *
                e_editor_widget_get_selection   (EEditorWidget *widget);
 
+gboolean       e_editor_widget_exec_command    (EEditorWidget *widget,
+                                                const gchar *command,
+                                                const gchar *value);
 
 gboolean       e_editor_widget_get_changed     (EEditorWidget *widget);
 void           e_editor_widget_set_changed     (EEditorWidget *widget,
@@ -109,7 +114,7 @@ GList *             e_editor_widget_get_spell_languages
                                                (EEditorWidget *widget);
 void           e_editor_widget_set_spell_languages
                                                (EEditorWidget *widget,
-                                                GList *spell_languages);
+                                                const GList *spell_languages);
 
 ESpellChecker *        e_editor_widget_get_spell_checker
                                                (EEditorWidget *widget);
diff --git a/e-util/e-editor-window.c b/e-util/e-editor-window.c
index 30a4286..9b77aaf 100644
--- a/e-util/e-editor-window.c
+++ b/e-util/e-editor-window.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-window.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -27,6 +29,15 @@ G_DEFINE_TYPE (
        e_editor_window,
        GTK_TYPE_WINDOW)
 
+/**
+ * EEditorWindow:
+ *
+ * A #GtkWindow that contains main toolbars and an #EEditor. To create a
+ * custom editor window, one can subclass this class and pack additional widgets
+ * above and below the editor using #e_editor_window_pack_above() and
+ * #e_editor_window_pack_below().
+ */
+
 struct _EEditorWindowPrivate {
        EEditor *editor;
        GtkGrid *main_layout;
@@ -123,6 +134,14 @@ e_editor_window_init (EEditorWindow *window)
        priv->editor_row = 2;
 }
 
+/**
+ * e_editor_window_new:
+ * @type: #GtkWindowType
+ *
+ * Creates a new editor window.
+ *
+ * Returns: A newly created editor window. [transfer-full]
+ */
 GtkWidget *
 e_editor_window_new (GtkWindowType type)
 {
@@ -132,6 +151,12 @@ e_editor_window_new (GtkWindowType type)
                NULL);
 }
 
+/**
+ * e_editor_window_get_editor:
+ * @window: an #EEditorWindow
+ *
+ * Returns the #EEditor widget used in this @window.
+ */
 EEditor *
 e_editor_window_get_editor (EEditorWindow *window)
 {
@@ -140,6 +165,15 @@ e_editor_window_get_editor (EEditorWindow *window)
        return window->priv->editor;
 }
 
+/**
+ * e_editor_window_pack_above:
+ * @window: an #EEditorWindow
+ * @child: a #GtkWidget
+ *
+ * Inserts @child in between the mail toolbars and the editor widget. If there
+ * are multiple children, the new @child is placed at the end (immediatelly
+ * adjacent to the editor widget)
+ */
 void
 e_editor_window_pack_above (EEditorWindow *window,
                            GtkWidget *child)
@@ -157,9 +191,17 @@ e_editor_window_pack_above (EEditorWindow *window,
                GTK_POS_TOP, 1, 1);
 }
 
+/**
+ * e_editor_window_pack_below:
+ * @window: an #EEditorWindow
+ * @child: a #GtkWidget
+ *
+ * Inserts @child below the editor widget. If there are multiple children, the
+ * new @child is placed at the end.
+ */
 void
 e_editor_window_pack_below (EEditorWindow *window,
-                         GtkWidget *child)
+                           GtkWidget *child)
 {
        g_return_if_fail (E_IS_EDITOR_WINDOW (window));
        g_return_if_fail (GTK_IS_WIDGET (child));
diff --git a/e-util/e-editor-window.h b/e-util/e-editor-window.h
index adb9bbc..bcd9e7a 100644
--- a/e-util/e-editor-window.h
+++ b/e-util/e-editor-window.h
@@ -1,6 +1,8 @@
 /*
  * e-editor-window.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
diff --git a/e-util/e-editor.c b/e-util/e-editor.c
index 3e25ec9..2d127c6 100644
--- a/e-util/e-editor.c
+++ b/e-util/e-editor.c
@@ -1,4 +1,7 @@
-/* e-editor.c
+/*
+ * e-editor.c
+ *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
@@ -32,6 +35,13 @@ G_DEFINE_TYPE (
        e_editor,
        GTK_TYPE_BOX);
 
+/**
+ * EEditor:
+ *
+ * #EEditor provides GUI for manipulating with properties of #EEditorWidget and
+ * it's #EEditorSelection - i.e. toolbars and actions.
+ */
+
 enum {
        PROP_0,
        PROP_FILENAME
@@ -792,6 +802,13 @@ e_editor_init (EEditor *editor)
        editor_actions_init (editor);
 }
 
+/**
+ * e_editor_new:
+ *
+ * Constructs a new #EEditor.
+ *
+ * Returns: A newly created widget. [transfer-full]
+ */
 GtkWidget *
 e_editor_new (void)
 {
@@ -800,6 +817,12 @@ e_editor_new (void)
                NULL);
 }
 
+/**
+ * e_editor_get_editor_widget:
+ * @editor: an #EEditor
+ *
+ * Returns instance of #EEditorWidget used in the @editor.
+ */
 EEditorWidget *
 e_editor_get_editor_widget (EEditor *editor)
 {
@@ -808,6 +831,12 @@ e_editor_get_editor_widget (EEditor *editor)
        return editor->priv->editor_widget;
 }
 
+/**
+ * e_editor_get_ui_manager:
+ * @editor: an #EEditor
+ *
+ * Returns #GtkUIManager that manages all the actions in the @editor.
+ */
 GtkUIManager *
 e_editor_get_ui_manager (EEditor *editor)
 {
@@ -816,6 +845,13 @@ e_editor_get_ui_manager (EEditor *editor)
        return editor->priv->manager;
 }
 
+/**
+ * e_editor_get_action:
+ * @editor: an #EEditor
+ * @action_name: name of action to lookup and return
+ *
+ * Returns: A #GtkAction matching @action_name or @NULL if no such action exists.
+ */
 GtkAction *
 e_editor_get_action (EEditor *editor,
                     const gchar *action_name)
@@ -843,6 +879,14 @@ e_editor_get_action (EEditor *editor,
        return action;
 }
 
+/**
+ * e_editor_get_action_group:
+ * @editor: an #EEditor
+ * @group_name: name of action group to lookup and return
+ *
+ * Returns: A #GtkActionGroup matching @group_name or @NULL if not such action
+ * group exists.
+ */
 GtkActionGroup *
 e_editor_get_action_group (EEditor *editor,
                           const gchar *group_name)
@@ -888,6 +932,12 @@ e_editor_get_managed_widget (EEditor *editor,
        return widget;
 }
 
+/**
+ * e_editor_get_filename:
+ * @editor: an #EEditor
+ *
+ * Returns path and name of file to which content of the editor should be saved.
+ */
 const gchar *
 e_editor_get_filename (EEditor *editor)
 {
@@ -896,6 +946,13 @@ e_editor_get_filename (EEditor *editor)
        return editor->priv->filename;
 }
 
+/**
+ * e_editor_set_filename:
+ * @editor: an #EEditor
+ * @filename: Target file
+ *
+ * Sets file to which content of the editor should be saved (see #e_editor_save())
+ */
 void
 e_editor_set_filename (EEditor *editor,
                       const gchar *filename)
@@ -911,6 +968,19 @@ e_editor_set_filename (EEditor *editor,
        g_object_notify (G_OBJECT (editor), "filename");
 }
 
+/**
+ * e_editor_save:
+ * @editor: an #EEditor
+ * @filename: file into which to save the content
+ * @as_html: whether the content should be saved as HTML or plain text
+ * @error:[out] a #GError
+ *
+ * Saves current content of the #EEditorWidget into given file. When @as_html
+ * is @FALSE, the content is first converted into plain text.
+ *
+ * Returns: @TRUE when content is succesfully saved, @FALSE otherwise.
+ */
+ */
 gboolean
 e_editor_save (EEditor *editor,
               const gchar *filename,
@@ -953,6 +1023,15 @@ e_editor_save (EEditor *editor,
        return TRUE;
 }
 
+/**
+ * e_editor_emit_spell_languages_changed:
+ * @editor: an #EEditor
+ *
+ * Emits "spell-languages-checked" signal on the @editor.
+ *
+ * This function is for internal use by the editor components and should not
+ * be called from outside the editor.
+ */
 void
 e_editor_emit_spell_languages_changed (EEditor *editor)
 {
diff --git a/e-util/e-editor.h b/e-util/e-editor.h
index 1dcfdd0..ab4b352 100644
--- a/e-util/e-editor.h
+++ b/e-util/e-editor.h
@@ -1,4 +1,7 @@
-/* e-editor.h
+/*
+ * e-editor.h
+ *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-action.c b/e-util/e-emoticon-action.c
index 7ff674c..cc9a640 100644
--- a/e-util/e-emoticon-action.c
+++ b/e-util/e-emoticon-action.c
@@ -1,4 +1,8 @@
-/* e-emoticon-action.c
+/*
+ * e-emoticon-action.c
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-action.h b/e-util/e-emoticon-action.h
index 388b851..3e62881 100644
--- a/e-util/e-emoticon-action.h
+++ b/e-util/e-emoticon-action.h
@@ -1,4 +1,8 @@
-/* e-emoticon-action.h
+/*
+ * e-emoticon-action.h
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-chooser-menu.c b/e-util/e-emoticon-chooser-menu.c
index 91cc756..c70c034 100644
--- a/e-util/e-emoticon-chooser-menu.c
+++ b/e-util/e-emoticon-chooser-menu.c
@@ -1,4 +1,8 @@
-/* e-emoticon-chooser-menu.c
+/*
+ * e-emoticon-chooser-menu.c
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-chooser-menu.h b/e-util/e-emoticon-chooser-menu.h
index bbed9aa..4c17e9d 100644
--- a/e-util/e-emoticon-chooser-menu.h
+++ b/e-util/e-emoticon-chooser-menu.h
@@ -1,4 +1,8 @@
-/* e-emoticon-chooser-menu.h
+/*
+ * e-emoticon-chooser-menu.h
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-chooser.c b/e-util/e-emoticon-chooser.c
index 4c894a4..550ffc8 100644
--- a/e-util/e-emoticon-chooser.c
+++ b/e-util/e-emoticon-chooser.c
@@ -1,4 +1,8 @@
-/* e-emoticon-chooser.c
+/*
+ * e-emoticon-chooser.c
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-chooser.h b/e-util/e-emoticon-chooser.h
index f0e3c15..1a82d9b 100644
--- a/e-util/e-emoticon-chooser.h
+++ b/e-util/e-emoticon-chooser.h
@@ -1,4 +1,8 @@
-/* e-emoticon-chooser.h
+/*
+ * e-emoticon-chooser.h
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-tool-button.c b/e-util/e-emoticon-tool-button.c
index eaf2105..7f28a1e 100644
--- a/e-util/e-emoticon-tool-button.c
+++ b/e-util/e-emoticon-tool-button.c
@@ -1,4 +1,8 @@
-/* e-emoticon-tool-button.c
+/*
+ * e-emoticon-tool-button.c
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon-tool-button.h b/e-util/e-emoticon-tool-button.h
index 6c1273e..77e0ccf 100644
--- a/e-util/e-emoticon-tool-button.h
+++ b/e-util/e-emoticon-tool-button.h
@@ -1,4 +1,8 @@
-/* e-emoticon-tool-button.h
+/*
+ * e-emoticon-tool-button.h
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon.c b/e-util/e-emoticon.c
index d5b69c6..76dd512 100644
--- a/e-util/e-emoticon.c
+++ b/e-util/e-emoticon.c
@@ -1,4 +1,8 @@
-/* e-emoticon.c
+/*
+ * e-emoticon.c
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-emoticon.h b/e-util/e-emoticon.h
index 17995d5..d7416de 100644
--- a/e-util/e-emoticon.h
+++ b/e-util/e-emoticon.h
@@ -1,4 +1,8 @@
-/* e-emoticon.h
+/*
+ * e-emoticon.h
+ *
+ * Copyright (C) 2008 Novell, Inc.
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
diff --git a/e-util/e-image-chooser-dialog.c b/e-util/e-image-chooser-dialog.c
index 17daca3..49fcd66 100644
--- a/e-util/e-image-chooser-dialog.c
+++ b/e-util/e-image-chooser-dialog.c
@@ -1,6 +1,8 @@
 /*
  * e-image-chooser-dialog.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
diff --git a/e-util/e-image-chooser-dialog.h b/e-util/e-image-chooser-dialog.h
index 82f8cec..967fddf 100644
--- a/e-util/e-image-chooser-dialog.h
+++ b/e-util/e-image-chooser-dialog.h
@@ -1,6 +1,8 @@
 /*
  * e-image-chooser-dialog.h
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of version 2 of the GNU Lesser General Public
  * License as published by the Free Software Foundation.
diff --git a/e-util/test-editor.c b/e-util/test-editor.c
index dc92037..ea96790 100644
--- a/e-util/test-editor.c
+++ b/e-util/test-editor.c
@@ -1,6 +1,8 @@
 /*
  * e-editor-test.c
  *
+ * Copyright (C) 2012 Dan Vrátil <dvratil redhat com>
+ *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]