[gnome-builder] libide: start adjusting what we will consider public API

[Christian Hergert <chergert src gnome org>]

commit 02050a717f1f444eba70f93b02fa4ec46e6c9404
Author: Christian Hergert <christian hergert me>
Date:   Thu May 14 14:58:44 2015 -0700

    libide: start adjusting what we will consider public API
    
    We are nowhere near having something generally consumable, but this cleans
    things up a bit for what I meant to be implementation details vs
    generally available.

 libide/Makefile.am            |  114 ++++++++++++++++++++--------------------
 libide/ide-highlight-engine.c |    9 +++
 libide/ide.h                  |   14 +++--
 3 files changed, 75 insertions(+), 62 deletions(-)
---
diff --git a/libide/Makefile.am b/libide/Makefile.am
index d634de2..348c717 100644
--- a/libide/Makefile.am
+++ b/libide/Makefile.am
@@ -7,57 +7,24 @@ pkglibdir = $(libdir)/gnome-builder
 pkglib_LTLIBRARIES = libide-1.0.la
 
 libide_1_0_la_public_sources = \
-       autotools/ide-autotools-build-system.c \
-       autotools/ide-autotools-build-system.h \
-       autotools/ide-autotools-build-task.c \
-       autotools/ide-autotools-build-task.h \
-       autotools/ide-autotools-builder.c \
-       autotools/ide-autotools-builder.h \
-       autotools/ide-autotools-project-miner.c \
-       autotools/ide-autotools-project-miner.h \
-       c/ide-c-indenter.c \
-       c/ide-c-indenter.h \
        c/ide-c-language.c \
        c/ide-c-language.h \
-       clang/ide-clang-diagnostic-provider.c \
-       clang/ide-clang-diagnostic-provider.h \
-       clang/ide-clang-highlighter.c \
-       clang/ide-clang-highlighter.h \
-       clang/ide-clang-private.h \
-       clang/ide-clang-service.c \
-       clang/ide-clang-service.h \
-       clang/ide-clang-symbol-resolver.c \
-       clang/ide-clang-symbol-resolver.h \
-       clang/ide-clang-translation-unit.c \
-       clang/ide-clang-translation-unit.h \
-       devhelp/ide-devhelp-search-provider.c \
-       devhelp/ide-devhelp-search-provider.h \
        devhelp/ide-devhelp-search-result.c \
        devhelp/ide-devhelp-search-result.h \
        directory/ide-directory-build-system.c \
        directory/ide-directory-build-system.h \
        directory/ide-directory-vcs.c \
        directory/ide-directory-vcs.h \
-       doap/ide-doap.c \
-       doap/ide-doap.h \
        doap/ide-doap-person.c \
        doap/ide-doap-person.h \
-       editorconfig/ide-editorconfig-file-settings.c \
-       editorconfig/ide-editorconfig-file-settings.h \
+       doap/ide-doap.c \
+       doap/ide-doap.h \
        git/ide-git-remote-callbacks.c \
        git/ide-git-remote-callbacks.h \
-       git/ide-git-search-provider.c \
-       git/ide-git-search-provider.h \
        git/ide-git-search-result.c \
        git/ide-git-search-result.h \
        git/ide-git-vcs.c \
        git/ide-git-vcs.h \
-       gjs/ide-gjs-script.cpp \
-       gjs/ide-gjs-script.h \
-       gsettings/ide-gsettings-file-settings.c \
-       gsettings/ide-gsettings-file-settings.h \
-       html/ide-html-completion-provider.c \
-       html/ide-html-completion-provider.h \
        html/ide-html-language.c \
        html/ide-html-language.h \
        ide-back-forward-item.c \
@@ -110,6 +77,8 @@ libide_1_0_la_public_sources = \
        ide-fixit.c \
        ide-fixit.h \
        ide-global.h \
+       ide-highlight-engine.c \
+       ide-highlight-engine.h \
        ide-highlight-index.c \
        ide-highlight-index.h \
        ide-highlighter.c \
@@ -164,6 +133,8 @@ libide_1_0_la_public_sources = \
        ide-settings.h \
        ide-source-location.c \
        ide-source-location.h \
+       ide-source-map.c \
+       ide-source-map.h \
        ide-source-range.c \
        ide-source-range.h \
        ide-source-snippet-chunk.c \
@@ -190,49 +161,43 @@ libide_1_0_la_public_sources = \
        ide-test-case.h \
        ide-test-suite.c \
        ide-test-suite.h \
+       ide-thread-pool.c \
+       ide-thread-pool.h \
        ide-types.h \
        ide-unsaved-file.c \
        ide-unsaved-file.h \
        ide-unsaved-files.c \
        ide-unsaved-files.h \
+       ide-vcs-uri.c \
+       ide-vcs-uri.h \
        ide-vcs.c \
        ide-vcs.h \
        ide.c \
        ide.h \
        local/ide-local-device.c \
        local/ide-local-device.h \
-       mingw/ide-mingw-device-provider.c \
-       mingw/ide-mingw-device-provider.h \
        mingw/ide-mingw-device.c \
        mingw/ide-mingw-device.h \
-       modelines/ide-modelines-file-settings.c \
-       modelines/ide-modelines-file-settings.h \
-       pygobject/ide-pygobject-script.c \
-       pygobject/ide-pygobject-script.h \
-       python/ide-python-format-provider.c \
-       python/ide-python-format-provider.h \
-       python/ide-python-indenter.c \
-       python/ide-python-indenter.h \
        python/ide-python-language.c \
        python/ide-python-language.h \
        theatrics/ide-animation.c \
        theatrics/ide-animation.h \
        vala/ide-vala-language.c \
        vala/ide-vala-language.h \
-       xml/ide-xml-indenter.c \
-       xml/ide-xml-indenter.h \
        xml/ide-xml-language.c \
        xml/ide-xml-language.h \
-       xml/ide-xml-highlighter.c \
-       xml/ide-xml-highlighter.h \
-       ide-source-map.c \
-       ide-source-map.h \
-       ide-thread-pool.c \
-       ide-thread-pool.h \
        $(NULL)
 
 libide_1_0_la_SOURCES = \
        $(libide_1_0_la_public_sources) \
+       autotools/ide-autotools-build-system.c \
+       autotools/ide-autotools-build-system.h \
+       autotools/ide-autotools-build-task.c \
+       autotools/ide-autotools-build-task.h \
+       autotools/ide-autotools-builder.c \
+       autotools/ide-autotools-builder.h \
+       autotools/ide-autotools-project-miner.c \
+       autotools/ide-autotools-project-miner.h \
        autotools/ide-makecache-target.c \
        autotools/ide-makecache-target.h \
        autotools/ide-makecache.c \
@@ -241,12 +206,29 @@ libide_1_0_la_SOURCES = \
        c/c-parse-helper.h \
        c/ide-c-format-provider.c \
        c/ide-c-format-provider.h \
+       c/ide-c-indenter.c \
+       c/ide-c-indenter.h \
        clang/ide-clang-completion-item.c \
        clang/ide-clang-completion-item.h \
        clang/ide-clang-completion-provider.c \
        clang/ide-clang-completion-provider.h \
+       clang/ide-clang-diagnostic-provider.c \
+       clang/ide-clang-diagnostic-provider.h \
+       clang/ide-clang-highlighter.c \
+       clang/ide-clang-highlighter.h \
+       clang/ide-clang-private.h \
+       clang/ide-clang-service.c \
+       clang/ide-clang-service.h \
+       clang/ide-clang-symbol-resolver.c \
+       clang/ide-clang-symbol-resolver.h \
+       clang/ide-clang-translation-unit.c \
+       clang/ide-clang-translation-unit.h \
+       devhelp/ide-devhelp-search-provider.c \
+       devhelp/ide-devhelp-search-provider.h \
        editorconfig/editorconfig-glib.c \
        editorconfig/editorconfig-glib.h \
+       editorconfig/ide-editorconfig-file-settings.c \
+       editorconfig/ide-editorconfig-file-settings.h \
        gca/gca-diagnostics.c \
        gca/gca-diagnostics.h \
        gca/gca-service.c \
@@ -263,15 +245,21 @@ libide_1_0_la_SOURCES = \
        git/ide-git-buffer-change-monitor.h \
        git/ide-git-search-index.c \
        git/ide-git-search-index.h \
+       git/ide-git-search-provider.c \
+       git/ide-git-search-provider.h \
+       gjs/ide-gjs-script.cpp \
+       gjs/ide-gjs-script.h \
+       gsettings/ide-gsettings-file-settings.c \
+       gsettings/ide-gsettings-file-settings.h \
        gsettings/ide-language-defaults.c \
        gsettings/ide-language-defaults.h \
+       html/ide-html-completion-provider.c \
+       html/ide-html-completion-provider.h \
        ide-async-helper.c \
        ide-async-helper.h \
        ide-battery-monitor.c \
        ide-battery-monitor.h \
        ide-debug.h \
-       ide-highlight-engine.c \
-       ide-highlight-engine.h \
        ide-internal.h \
        ide-line-change-gutter-renderer.c \
        ide-line-change-gutter-renderer.h \
@@ -294,12 +282,20 @@ libide_1_0_la_SOURCES = \
        ide-source-view-capture.h \
        ide-source-view-movements.c \
        ide-source-view-movements.h \
-       ide-vcs-uri.c \
-       ide-vcs-uri.h \
        ide-vim-iter.c \
        ide-vim-iter.h \
+       mingw/ide-mingw-device-provider.c \
+       mingw/ide-mingw-device-provider.h \
+       modelines/ide-modelines-file-settings.c \
+       modelines/ide-modelines-file-settings.h \
        modelines/modeline-parser.c \
        modelines/modeline-parser.h \
+       pygobject/ide-pygobject-script.c \
+       pygobject/ide-pygobject-script.h \
+       python/ide-python-format-provider.c \
+       python/ide-python-format-provider.h \
+       python/ide-python-indenter.c \
+       python/ide-python-indenter.h \
        tasks/ide-load-directory-task.c \
        tasks/ide-load-directory-task.h \
        theatrics/ide-box-theatric.c \
@@ -316,6 +312,10 @@ libide_1_0_la_SOURCES = \
        util/ide-rgba.h \
        util/ide-xml.c \
        util/ide-xml.h \
+       xml/ide-xml-highlighter.c \
+       xml/ide-xml-highlighter.h \
+       xml/ide-xml-indenter.c \
+       xml/ide-xml-indenter.h \
        $(NULL)
 
 libide_1_0_la_includes = \
diff --git a/libide/ide-highlight-engine.c b/libide/ide-highlight-engine.c
index 7ae3b94..17aec2e 100644
--- a/libide/ide-highlight-engine.c
+++ b/libide/ide-highlight-engine.c
@@ -762,6 +762,15 @@ ide_highlight_engine_invalidate (IdeHighlightEngine *self,
   IDE_EXIT;
 }
 
+/**
+ * ide_highlight_engine_get_style:
+ * @self: the #IdeHighlightEngine
+ * @style_name: the name of the style to retrieve
+ *
+ * A #GtkTextTag for @style_name.
+ *
+ * Returns: (transfer none): A #GtkTextTag.
+ */
 GtkTextTag *
 ide_highlight_engine_get_style (IdeHighlightEngine *self,
                                 const gchar        *style_name)
diff --git a/libide/ide.h b/libide/ide.h
index 06e5869..398af02 100644
--- a/libide/ide.h
+++ b/libide/ide.h
@@ -31,6 +31,7 @@ G_BEGIN_DECLS
 #include "ide-build-system.h"
 #include "ide-builder.h"
 #include "ide-buffer.h"
+#include "ide-buffer-change-monitor.h"
 #include "ide-buffer-manager.h"
 #include "ide-context.h"
 #include "ide-debug.h"
@@ -49,6 +50,7 @@ G_BEGIN_DECLS
 #include "ide-file.h"
 #include "ide-file-settings.h"
 #include "ide-global.h"
+#include "ide-highlight-engine.h"
 #include "ide-highlighter.h"
 #include "ide-indenter.h"
 #include "ide-language.h"
@@ -92,20 +94,22 @@ G_BEGIN_DECLS
 #include "ide-vcs-uri.h"
 
 #include "autotools/ide-autotools-build-system.h"
-#include "autotools/ide-autotools-project-miner.h"
+#include "c/ide-c-language.h"
 #include "devhelp/ide-devhelp-search-result.h"
 #include "directory/ide-directory-build-system.h"
 #include "directory/ide-directory-vcs.h"
-#include "doap/ide-doap.h"
 #include "doap/ide-doap-person.h"
-#include "editorconfig/ide-editorconfig-file-settings.h"
+#include "doap/ide-doap.h"
 #include "git/ide-git-remote-callbacks.h"
 #include "git/ide-git-search-result.h"
 #include "git/ide-git-vcs.h"
-#include "gsettings/ide-gsettings-file-settings.h"
+#include "html/ide-html-language.h"
 #include "local/ide-local-device.h"
-#include "modelines/ide-modelines-file-settings.h"
+#include "mingw/ide-mingw-device.h"
+#include "python/ide-python-language.h"
 #include "theatrics/ide-animation.h"
+#include "vala/ide-vala-language.h"
+#include "xml/ide-xml-language.h"
 
 #undef IDE_INSIDE