qulogic/talkatu

Merged in default (pull request #31)

2019-07-22, Gary Kramlich
a38f8992c4d0
Parents be2b4d3019d410a61ad59924
Children c4b07dfd0db9
Merged in default (pull request #31)

Fix up the docs to get to 100% coverage

Approved-by: Elliott Sales de Andrade
23 files changed, 425 insertions(+), 58 deletions(-)
  • +22 -0
    talkatu/talkatuactiongroup.c
  • +3 -0
    talkatu/talkatuactiongroup.h
  • +25 -1
    talkatu/talkatubuffer.c
  • +3 -0
    talkatu/talkatubuffer.h
  • +12 -0
    talkatu/talkatueditor.c
  • +11 -0
    talkatu/talkatuhistory.c
  • +21 -0
    talkatu/talkatuhistorybuffer.c
  • +3 -0
    talkatu/talkatuhistorybuffer.h
  • +20 -0
    talkatu/talkatuhtmlbuffer.c
  • +3 -0
    talkatu/talkatuhtmlbuffer.h
  • +11 -0
    talkatu/talkatulinkdialog.c
  • +20 -0
    talkatu/talkatumarkdownbuffer.c
  • +4 -4
    talkatu/talkatumarkdownbuffer.h
  • +12 -0
    talkatu/talkatumenutoolbutton.c
  • +21 -0
    talkatu/talkatumessage.c
  • +12 -0
    talkatu/talkatumessageactions.c
  • +139 -50
    talkatu/talkatutag.c
  • +11 -0
    talkatu/talkatutagtable.c
  • +13 -0
    talkatu/talkatutoolbar.c
  • +16 -0
    talkatu/talkatutooldrawer.c
  • +26 -2
    talkatu/talkatuview.c
  • +4 -1
    talkatu/talkatuview.h
  • +13 -0
    talkatu/talkatuwholebuffer.c
    • --- a/talkatu/talkatuactiongroup.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuactiongroup.c Mon Jul 22 07:32:37 2019 +0000
    @@ -32,6 +32,28 @@
    */
    /**
    + * TALKATU_TYPE_ACTION_GROUP:
    + *
    + * The standard _get_type macro for #TalkatuActionGroup.
    + */
    +
    +/**
    + * TalkatuActionGroup:
    + *
    + * A #GSimpleActionGroup subclass that contains all of the actions for
    + * formatting text in Talkatu. They are typically created by
    + * #TalkatuBuffer subclasses.
    + */
    +
    +/**
    + * TalkatuActionGroupClass:
    + * @action_activated: The class handler for the
    + * #TalkatuActionGroup::action-activated signal.
    + *
    + * The backing class of a #TalkatuActionGroup.
    + */
    +
    +/**
    * TALKATU_ACTION_FORMAT_BOLD:
    *
    * A constant that represents the bold font style action.
    --- a/talkatu/talkatuactiongroup.h Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuactiongroup.h Mon Jul 22 07:32:37 2019 +0000
    @@ -43,10 +43,13 @@
    G_DECLARE_DERIVABLE_TYPE(TalkatuActionGroup, talkatu_action_group, TALKATU, ACTION_GROUP, GSimpleActionGroup)
    struct _TalkatuActionGroupClass {
    + /*< private >*/
    GSimpleActionGroupClass parent;
    + /*< public >*/
    void (*action_activated)(TalkatuActionGroup *ag, GAction *action, const gchar *name);
    + /*< private >*/
    gpointer reserved[4];
    };
    --- a/talkatu/talkatubuffer.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatubuffer.c Mon Jul 22 07:32:37 2019 +0000
    @@ -35,6 +35,30 @@
    */
    /**
    + * TALKATU_TYPE_BUFFER:
    + *
    + * The standard _get_type macro for #TalkatuBuffer.
    + */
    +
    +/**
    + * TalkatuBuffer:
    + *
    + * A #GtkTextBuffer subclass that will automatically apply formatting according
    + * to the actions in a #GSimpleAction group.
    + */
    +
    +/**
    + * TalkatuBufferClass:
    + * @insert_markup: The insert_markup vfunc is called to insert already rendered
    + * text into the #TalkatuBuffer.
    + * @create_action_group: The create_action_group vfunc is called to get a
    + * #GSimpleAction group of actions that the
    + * #TalkatuBuffer supports.
    + *
    + * The backing class to #TalkatuBuffer.
    + */
    +
    +/**
    * TALKATU_BUFFER_LINK_TARGET_ATTRIBUTE:
    *
    * The name of the attribute set on #GtkTextTags that contain the URL for
    @@ -669,4 +693,4 @@
    gtk_text_buffer_get_bounds(GTK_TEXT_BUFFER(buffer), &start, &end);
    return gtk_text_iter_equal(&start, &end);
    -}
    \ No newline at end of file
    +}
    --- a/talkatu/talkatubuffer.h Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatubuffer.h Mon Jul 22 07:32:37 2019 +0000
    @@ -40,12 +40,15 @@
    G_DECLARE_DERIVABLE_TYPE(TalkatuBuffer, talkatu_buffer, TALKATU, BUFFER, GtkTextBuffer)
    struct _TalkatuBufferClass {
    + /*< private >*/
    GtkTextBufferClass parent;
    + /*< public >*/
    void (*insert_markup)(TalkatuBuffer *buffer, GtkTextIter *pos, const gchar *new_text, gint new_text_length);
    GSimpleActionGroup *(*create_action_group)(TalkatuBuffer *buffer);
    + /*< private >*/
    gpointer reserved[4];
    };
    --- a/talkatu/talkatueditor.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatueditor.c Mon Jul 22 07:32:37 2019 +0000
    @@ -31,6 +31,18 @@
    * help make them easier to use.
    */
    +/**
    + * TALKATU_TYPE_EDITOR:
    + *
    + * The standard _get_type macro for #TalkatuEditor.
    + */
    +
    +/**
    + * TalkatuEditor:
    + *
    + * A composite widget that contains a #TalkatuToolbar, #TalkatuView, and an
    + * optional send button in the common instant messaging input layout.
    + */
    struct _TalkatuEditor {
    GtkBox parent;
    --- a/talkatu/talkatuhistory.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuhistory.c Mon Jul 22 07:32:37 2019 +0000
    @@ -30,6 +30,17 @@
    * it is multi user or one to one.
    */
    +/**
    + * TALKATU_TYPE_HISTORY:
    + *
    + * The standard _get_type macro for #TalkatuHistory.
    + */
    +
    +/**
    + * TalkatuHistory:
    + *
    + * A #TalkatuView subclass that is used to display a conversation.
    + */
    struct _TalkatuHistory {
    TalkatuView parent;
    };
    --- a/talkatu/talkatuhistorybuffer.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuhistorybuffer.c Mon Jul 22 07:32:37 2019 +0000
    @@ -31,6 +31,27 @@
    * manually.
    */
    +/**
    + * TALKATU_TYPE_HISTORY_BUFFER:
    + *
    + * The standard _get_type macro for #TalkatuHistoryBuffer.
    + */
    +
    +/**
    + * TalkatuHistoryBuffer:
    + *
    + * A #TalkatuBuffer subclass that works on #TalkatuMessage's rather than raw
    + * text.
    + */
    +
    +/**
    + * TalkatuHistoryBufferClass:
    + * @write_message: The write_message vfunc is called to render a
    + * #TalkatuMessage into the #TalkatuHistoryBuffer.
    + *
    + * The backing class to #TalkatuHistoryBuffer.
    + */
    +
    G_DEFINE_TYPE(TalkatuHistoryBuffer, talkatu_history_buffer, GTK_TYPE_TEXT_BUFFER);
    /******************************************************************************
    --- a/talkatu/talkatuhistorybuffer.h Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuhistorybuffer.h Mon Jul 22 07:32:37 2019 +0000
    @@ -35,10 +35,13 @@
    G_DECLARE_DERIVABLE_TYPE(TalkatuHistoryBuffer, talkatu_history_buffer, TALKATU, HISTORY_BUFFER, GtkTextBuffer)
    struct _TalkatuHistoryBufferClass {
    + /*< private >*/
    GtkTextBufferClass parent;
    + /*< public >*/
    void (*write_message)(TalkatuHistoryBuffer *buffer, TalkatuMessage *message);
    + /*< private >*/
    gpointer reserved[4];
    };
    --- a/talkatu/talkatuhtmlbuffer.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuhtmlbuffer.c Mon Jul 22 07:32:37 2019 +0000
    @@ -33,6 +33,26 @@
    * to render it properly.
    */
    +/**
    + * TALKATU_TYPE_HTML_BUFFER:
    + *
    + * The standard _get_type macro for #TalkatuHtmlBuffer.
    + */
    +
    +/**
    + * TalkatuHtmlBuffer:
    + *
    + * A #TalkatuBuffer subclass that renders HTML.
    + */
    +
    +/**
    + * TalkatuHtmlBufferClass:
    + * @insert_html: The insert_html vfunc is called to render HTML into the
    + * #TalkatuHtmlBuffer.
    + *
    + * The backing class to #TalkatuHtmlBuffer.
    + */
    +
    G_DEFINE_TYPE(TalkatuHtmlBuffer, talkatu_html_buffer, TALKATU_TYPE_BUFFER);
    /******************************************************************************
    --- a/talkatu/talkatuhtmlbuffer.h Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuhtmlbuffer.h Mon Jul 22 07:32:37 2019 +0000
    @@ -37,10 +37,13 @@
    G_DECLARE_DERIVABLE_TYPE(TalkatuHtmlBuffer, talkatu_html_buffer, TALKATU, HTML_BUFFER, TalkatuBuffer)
    struct _TalkatuHtmlBufferClass {
    + /*< private >*/
    TalkatuBufferClass parent;
    + /*< public >*/
    void (*insert_html)(TalkatuHtmlBuffer *buffer, GtkTextIter *iter, const gchar *text, gint len);
    + /*< private >*/
    gpointer reserved[4];
    };
    --- a/talkatu/talkatulinkdialog.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatulinkdialog.c Mon Jul 22 07:32:37 2019 +0000
    @@ -27,6 +27,17 @@
    * A simple dialog to aid in the creation of a link.
    */
    +/**
    + * TALKATU_TYPE_LINK_DIALOG:
    + *
    + * The standard _get_type macro for #TalkatuLinkDialog.
    + */
    +
    +/**
    + * TalkatuLinkDialog:
    + *
    + * A simple #GtkDialog subclass to allow the user to create a link.
    + */
    struct _TalkatuLinkDialog {
    GtkDialog parent;
    --- a/talkatu/talkatumarkdownbuffer.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatumarkdownbuffer.c Mon Jul 22 07:32:37 2019 +0000
    @@ -34,6 +34,26 @@
    * to render it properly.
    */
    +/**
    + * TALKATU_TYPE_MARKDOWN_BUFFER:
    + *
    + * The standard _get_type macro for #TalkatuMarkdownBuffer.
    + */
    +
    +/**
    + * TalkatuMarkdownBuffer:
    + *
    + * A #TalkatuBuffer subclass that renders markdown.
    + */
    +
    +/**
    + * TalkatuMarkdownBufferClass:
    + * @insert_markdown: The insert_markdown vfunc is called to render
    + * markdown into the #TalkatuMarkdownBuffer.
    + *
    + * The backing class for #TalkatuMarkdownBuffer.
    + */
    +
    #define TALKATU_MARKDOWN_LINK_TARGET_ATTRIBUTE "markdown_link_target"
    G_DEFINE_TYPE(TalkatuMarkdownBuffer, talkatu_markdown_buffer, TALKATU_TYPE_BUFFER);
    --- a/talkatu/talkatumarkdownbuffer.h Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatumarkdownbuffer.h Mon Jul 22 07:32:37 2019 +0000
    @@ -37,14 +37,14 @@
    G_DECLARE_DERIVABLE_TYPE(TalkatuMarkdownBuffer, talkatu_markdown_buffer, TALKATU, MARKDOWN_BUFFER, TalkatuBuffer)
    struct _TalkatuMarkdownBufferClass {
    + /*< private >*/
    TalkatuBufferClass parent;
    + /*< public >*/
    void (*insert_markdown)(TalkatuMarkdownBuffer *buffer, GtkTextIter *iter, const gchar *text, gint len);
    - void (*_talkatu_reserved1)(void);
    - void (*_talkatu_reserved2)(void);
    - void (*_talkatu_reserved3)(void);
    - void (*_talkatu_reserved4)(void);
    + /*< private >*/
    + gpointer reserved[4];
    };
    GtkTextBuffer *talkatu_markdown_buffer_new(void);
    --- a/talkatu/talkatumenutoolbutton.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatumenutoolbutton.c Mon Jul 22 07:32:37 2019 +0000
    @@ -29,6 +29,18 @@
    * visible button. This #GtkToolItem instead just uses a label with no action.
    */
    +/**
    + * TALKATU_TYPE_MENU_TOOL_BUTTON:
    + *
    + * The standard _get_type macro for #TalkatuMenuToolButton.
    + */
    +
    +/**
    + * TalkatuMenuToolButton:
    + *
    + * A #GtkToolButton subclass that behaves like a #GtkComboBox.
    + */
    +
    struct _TalkatuMenuToolButton {
    GtkToolButton parent;
    --- a/talkatu/talkatumessage.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatumessage.c Mon Jul 22 07:32:37 2019 +0000
    @@ -30,6 +30,27 @@
    */
    /**
    + * TALKATU_TYPE_MESSAGE:
    + *
    + * The standard _get_type macro for #TalkatuMessage.
    + */
    +
    +/**
    + * TalkatuMessage:
    + *
    + * #TalkatuMessage is an opaque data structure and can only be accessed using
    + * the following functions.
    + */
    +
    +/**
    + * TalkatuMessageInterface:
    + *
    + * #TalkatuMessage is an interface to be implemented to standardize the way
    + * messages are handled. All of its properties should be overridden with a
    + * sensible value returned for them.
    + */
    +
    +/**
    * TalkatuContentType:
    * @TALKATU_CONTENT_TYPE_PLAIN: Plain text content.
    * @TALKATU_CONTENT_TYPE_PANGO: Pango Markup content.
    --- a/talkatu/talkatumessageactions.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatumessageactions.c Mon Jul 22 07:32:37 2019 +0000
    @@ -28,6 +28,18 @@
    * to format any #TalkatuBuffer via the formatting actions.
    */
    +/**
    + * TALKATU_TYPE_MESSAGE_ACTIONS:
    + *
    + * The standard _get_type macro for #TalkatuMessageActions.
    + */
    +
    +/**
    + * TalkatuMessageActions:
    + *
    + * A composite #GtkWidget to allow the user to interact with a message in a
    + * #TalkatuHistory.
    + */
    struct _TalkatuMessageActions {
    GtkBox parent;
    --- a/talkatu/talkatutag.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatutag.c Mon Jul 22 07:32:37 2019 +0000
    @@ -29,15 +29,21 @@
    */
    /**
    - * TALKATU_TAG_PREFIX:
    + * TALKATU_TYPE_TAG:
    *
    - * The prefix that all talkatu tags use.
    + * The standard _get_type macro for #TalkatuTag.
    */
    /**
    - * TALKATU_TAG_PREFIX_LEN:
    + * TALKATU_TAG_ANCHOR:
    *
    - * The length of #TALKATU_TAG_PREFIX for easy computation.
    + * A constant that represents an anchor or link font style.
    + */
    +
    +/**
    + * TALKATU_TAG_AUTHOR:
    + *
    + * A constant for referencing the styling for an author.
    */
    /**
    @@ -47,63 +53,48 @@
    */
    /**
    - * TALKATU_TAG_ITALIC:
    - *
    - * A constant that represents the italic font style.
    - */
    -
    -/**
    - * TALKATU_TAG_UNDERLINE:
    - *
    - * A constant that represents the underlined font style.
    - */
    -
    -
    -/**
    - * TALKATU_TAG_STRIKETHROUGH:
    - *
    - * A constant that represents the strike through font style.
    - */
    -
    -
    -/**
    - * TALKATU_TAG_SUBSCRIPT:
    - *
    - * A constant that represents the sub-script font style.
    - */
    -
    -
    -/**
    - * TALKATU_TAG_SUPERSCRIPT:
    - *
    - * A constant that represents the super-script font style.
    - */
    -
    -
    -/**
    - * TALKATU_TAG_PRE:
    - *
    - * A constant that represents a pre formatted font style.
    - */
    -
    -
    -/**
    * TALKATU_TAG_CODE:
    *
    * A constant that represents a code font style.
    */
    +/**
    + * TALKATU_TAG_CONTENTS:
    + *
    + * A constant for the tag that tags message contents in a #TalkatuHistory
    + * buffer.
    + */
    /**
    - * TALKATU_TAG_SEARCH:
    + * TALKATU_TAG_DD:
    *
    - * A constant that represents the highlighed search term font style.
    + * A constant that represents the dd HTML element.
    */
    /**
    - * TALKATU_TAG_ANCHOR:
    + * TALKATU_TAG_DL:
    + *
    + * A constant that represents the dl HTML element.
    + */
    +
    +/**
    + * TALKATU_TAG_DT:
    *
    - * A constant that represents an anchor or link font style.
    + * A constant that reprensents the dt HTML element.
    + */
    +
    +/**
    + * TALKATU_TAG_FORMATTING_END:
    + *
    + * A constant to be used as a suffix for tags that need formatting applied
    + * after the original tag.
    + */
    +
    +/**
    + * TALKATU_TAG_FORMATTING_START:
    + *
    + * A constant to be used as a prefix for tags that need formatting applied
    + * before the original tag.
    */
    /**
    @@ -142,6 +133,87 @@
    * A constant that represents the h6 header font style.
    */
    +/**
    + * TALKATU_TAG_ITALIC:
    + *
    + * A constant that represents the italic font style.
    + */
    +
    +/**
    + * TALKATU_TAG_MESSAGE:
    + *
    + * A constant for the tag that tags an entire message in a #TalkatuHistory
    + * buffer.
    + */
    +
    +/**
    + * TALKATU_TAG_PRE:
    + *
    + * A constant that represents a preformatted font style.
    + */
    +
    +/**
    + * TALKATU_TAG_PREFIX:
    + *
    + * The prefix that all Talkatu tags use.
    + */
    +
    +/**
    + * TALKATU_TAG_PREFIX_LEN:
    + *
    + * The length of #TALKATU_TAG_PREFIX for easy computation.
    + */
    +
    +/**
    + * TALKATU_TAG_SEARCH:
    + *
    + * A constant that represents the highlighted search term font style.
    + */
    +
    +/**
    + * TALKATU_TAG_STRIKETHROUGH:
    + *
    + * A constant that represents the strikethrough font style.
    + */
    +
    +/**
    + * TALKATU_TAG_SUBSCRIPT:
    + *
    + * A constant that represents the sub-script font style.
    + */
    +
    +/**
    + * TALKATU_TAG_SUPERSCRIPT:
    + *
    + * A constant that represents the super-script font style.
    + */
    +
    +/**
    + * TALKATU_TAG_TIMESTAMP:
    + *
    + * A constant that represents the timestamp font style.
    + */
    +
    +/**
    + * TALKATU_TAG_UNDERLINE:
    + *
    + * A constant that represents the underlined font style.
    + */
    +
    +/**
    + * TalkatuTagDisplay:
    + * @TALKATU_TAG_DISPLAY_INLINE: The tag should be rendered inline.
    + * @TALKATU_TAG_DISPLAY_BLOCK: The tag should be rendered on its own line.
    + *
    + * An enum representing how a tag should be rendered.
    + */
    +
    +/**
    + * TalkatuTag:
    + *
    + * TalkatuTag is a #GtkTextTag subclass that has a few additional properties
    + * that allows greater control of how text is rendered.
    + */
    struct _TalkatuTag {
    GtkTextTag parent;
    @@ -218,7 +290,9 @@
    /**
    * talkatu_tag_new:
    * @name: The name to give the tag.
    - * @...: Pairs of property names and values terminated by NULL.
    + * @first_property: The name of the first property to set.
    + * @...: The value of the first property followed optionally by more name/value
    + * pairs, followed by NULL.
    *
    * Creates a new #TalkatuTag to be used for styling text.
    *
    @@ -324,6 +398,14 @@
    return NULL;
    }
    +/**
    + * talkatu_tag_get_display:
    + * @tag: The #TalkatuTag instance.
    + *
    + * Gets the #TalkatuTagDisplay for @tag.
    + *
    + * Returns: The #TalkatuTagDisplay for @tag.
    + */
    TalkatuTagDisplay
    talkatu_tag_get_display(TalkatuTag *tag) {
    g_return_val_if_fail(TALKATU_IS_TAG(tag), TALKATU_TAG_DISPLAY_INLINE);
    @@ -331,6 +413,13 @@
    return tag->display;
    }
    +/**
    + * talkatu_tag_set_display:
    + * @tag: The #TalkatuTag instance.
    + * @display: The #TalkatuTagDisplay value to set.
    + *
    + * Sets the display type for @tag to @display.
    + */
    void
    talkatu_tag_set_display(TalkatuTag *tag, TalkatuTagDisplay display) {
    g_return_if_fail(TALKATU_IS_TAG(tag));
    --- a/talkatu/talkatutagtable.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatutagtable.c Mon Jul 22 07:32:37 2019 +0000
    @@ -32,6 +32,17 @@
    * to format any #TalkatuBuffer via the formatting actions.
    */
    +/**
    + * TALKATU_TYPE_TAG_TABLE:
    + *
    + * The standard _get_type macro for #TalkatuTagTable.
    + */
    +
    +/**
    + * TalkatuTagTable:
    + *
    + * A #GtkTextTagTable subclass that is preloaded with all of the #TalkatuTag's.
    + */
    struct _TalkatuTagTable {
    GtkTextTagTable parent;
    };
    --- a/talkatu/talkatutoolbar.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatutoolbar.c Mon Jul 22 07:32:37 2019 +0000
    @@ -28,6 +28,19 @@
    * to format any #TalkatuBuffer via the formatting actions.
    */
    +/**
    + * TALKATU_TYPE_TOOLBAR:
    + *
    + * The standard _get_type macro for #TalkatuToolbar.
    + */
    +
    +/**
    + * TalkatuToolbar:
    + *
    + * The formatting toolbar for #TalkatuView's. It's based on the
    + * #GSimpleActionGroup's that #TalkatuBuffer's expose which makes it completely
    + * autonomous.
    + */
    struct _TalkatuToolbar {
    GtkToolbar parent;
    };
    --- a/talkatu/talkatutooldrawer.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatutooldrawer.c Mon Jul 22 07:32:37 2019 +0000
    @@ -31,6 +31,12 @@
    * the user interface.
    */
    +/**
    + * TALKATU_TYPE_TOOL_DRAWER:
    + *
    + * The standard _get_type macro for #TalkatuToolDrawer.
    + */
    +
    typedef struct {
    GAction *action;
    gchar *markup;
    @@ -39,7 +45,17 @@
    GCallback callback;
    } TalkatuToolDrawerItem;
    +/**
    + * TalkatuToolDrawer:
    + *
    + * A #GtkToolItem subclass that displays a menu of items or can be expanded
    + * to show all of the items as a toolbar.
    + *
    + * Stability: Unstable
    + */
    struct _TalkatuToolDrawer {
    + GtkToolItem parent;
    +
    gchar *label;
    gchar *icon_name;
    gboolean expanded;
    --- a/talkatu/talkatuview.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuview.c Mon Jul 22 07:32:37 2019 +0000
    @@ -38,9 +38,27 @@
    */
    /**
    + * TALKATU_TYPE_VIEW:
    + *
    + * The standard _get_type macro for #TalkatuView.
    + */
    +
    +/**
    + * TalkatuViewClass:
    + * @format_activate: The class handler for the #TalkatuView::format_activate
    + * signal.
    + * @should_send_message: The class handler for the
    + * #TalkatuView::should_send_message signal.
    + * @send_message: The class handler for the #TalkatuView::send_message signal.
    + * @open_url: The class handler for the #TalkatuView::open_url signal.
    + *
    + * The backing class to #TalkatuView instances.
    + */
    +
    +/**
    * TalkatuViewSendBinding:
    - * @TALKATU_VIEW_SEND_BINDING_RETURN: Represents the return.
    - * @TALKATU_VIEW_SEND_BINDING_KP_ENTER: Represents the enter.
    + * @TALKATU_VIEW_SEND_BINDING_RETURN: Represents return.
    + * @TALKATU_VIEW_SEND_BINDING_KP_ENTER: Represents enter.
    * @TALKATU_VIEW_SEND_BINDING_SHIFT_RETURN: Represents shift-return.
    * @TALKATU_VIEW_SEND_BINDING_CONTROL_RETURN: Represents control-return.
    *
    @@ -48,6 +66,12 @@
    * send a message.
    */
    +/**
    + * TalkatuView:
    + *
    + * A #GtkTextView subclass that's preconfigured with a #TalkatuBuffer.
    + */
    +
    typedef struct {
    GSimpleActionGroup *action_group;
    TalkatuViewSendBinding send_binding;
    --- a/talkatu/talkatuview.h Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuview.h Mon Jul 22 07:32:37 2019 +0000
    @@ -43,8 +43,10 @@
    G_DECLARE_DERIVABLE_TYPE(TalkatuView, talkatu_view, TALKATU, VIEW, GtkTextView)
    struct _TalkatuViewClass {
    + /*< private >*/
    GtkTextViewClass parent;
    + /*< public >*/
    void (*format_activate)(TalkatuView *view, const gchar *action_name);
    void (*should_send_message)(TalkatuView *view, TalkatuViewSendBinding binding);
    @@ -52,7 +54,8 @@
    void (*open_url)(TalkatuView *view, const gchar *url);
    - gpointer reserved[5];
    + /*< private >*/
    + gpointer reserved[4];
    };
    GtkWidget *talkatu_view_new(void);
    --- a/talkatu/talkatuwholebuffer.c Fri Jul 19 21:36:09 2019 +0000
    +++ b/talkatu/talkatuwholebuffer.c Mon Jul 22 07:32:37 2019 +0000
    @@ -28,6 +28,19 @@
    * TalkatuWholeBuffer is a #GtkTextBuffer who's formatting applied to the
    * entire buffer and not on a character by character basis.
    */
    +
    +/**
    + * TALKATU_TYPE_WHOLE_BUFFER:
    + *
    + * The standard _get_type macro for #TalkatuWholeBuffer.
    + */
    +
    +/**
    + * TalkatuWholeBuffer:
    + *
    + * A #TalkatuBuffer subclass that applies formatting to the entire buffer
    + * rather that allowing rich formatting at character resolution.
    + */
    struct _TalkatuWholeBuffer {
    TalkatuBuffer parent;
    };