[gnome-builder: 136/139] build: update doc generation

From: Christian Hergert <chergert src gnome org>
To: commits-list gnome org
Cc:
Subject: [gnome-builder: 136/139] build: update doc generation
Date: Thu, 10 Jan 2019 04:28:45 +0000 (UTC)
commit 75c9d1f1dc7d8b855b0a650e73507344694760ef
Author: Christian Hergert <chergert redhat com>
Date:   Wed Jan 9 17:46:06 2019 -0800

    build: update doc generation
    
    I don't really like the gtk-doc output, but this gets things compiling
    which is infinitely better than not compiling.

 doc/sdk/libide-docs.sgml | 571 +++++++++++++++++++----------------------------
 doc/sdk/meson.build      |  65 +++++-
 2 files changed, 291 insertions(+), 345 deletions(-)
---
diff --git a/doc/sdk/libide-docs.sgml b/doc/sdk/libide-docs.sgml
index 5f693a624..21294963c 100644
--- a/doc/sdk/libide-docs.sgml
+++ b/doc/sdk/libide-docs.sgml
@@ -17,278 +17,276 @@
       </para>
     </releaseinfo>
     <copyright>
-      <year>2014-2017</year>
+      <year>2014-2019</year>
       <holder>Christian Hergert, et al.</holder>
     </copyright>
   </bookinfo>
 
   <part id="libide-api">
-    <title>Builder Core API</title>
+    <title>API Reference</title>
     <chapter>
-      <title>Overview</title>
-      <para>
-        Access to Builder's SDK is centered around a project context named
-        <link linkend="IdeContext">IdeContext</link>. You access various
-        subsystems such as the debugger or build manager via accessor methods
-        on the <link linkend="IdeContext">IdeContext</link>.
-      </para>
-      <para>
-        To simplify access to the project context, many internal objects share
-        a common base class named <link linkend="IdeObject">IdeObject</link>.
-        It provides direct access to the
-        <link linkend="IdeContext">IdeContext</link> via
-        <link linkend="ide-object-get-context">ide_object_get_context()</link>
-        as well as convenience API for lifecycle management.
-      </para>
-    </chapter>
-    <chapter>
-      <title>Core Objects</title>
-      <xi:include href="xml/ide-application.xml"/>
-      <xi:include href="xml/ide-context.xml"/>
-      <xi:include href="xml/ide-object.xml"/>
-      <xi:include href="xml/ide-service.xml"/>
-    </chapter>
-    <chapter>
-      <title>Application Extensions</title>
+      <title>Extending Builder</title>
       <xi:include href="xml/ide-application-addin.xml"/>
-      <xi:include href="xml/ide-application-tool.xml"/>
+      <xi:include href="xml/ide-buffer-addin.xml"/>
+      <xi:include href="xml/ide-build-pipeline-addin.xml"/>
+      <xi:include href="xml/ide-build-target-provider.xml"/>
+      <xi:include href="xml/ide-command-provider.xml"/>
+      <xi:include href="xml/ide-completion-provider.xml"/>
+      <xi:include href="xml/ide-config-view-addin.xml"/>
+      <xi:include href="xml/ide-configuration-provider.xml"/>
+      <xi:include href="xml/ide-context-addin.xml"/>
+      <xi:include href="xml/ide-device-provider.xml"/>
+      <xi:include href="xml/ide-diagnostic-provider.xml"/>
+      <xi:include href="xml/ide-editor-addin.xml"/>
+      <xi:include href="xml/ide-editor-page-addin.xml"/>
+      <xi:include href="xml/ide-extension-adapter.xml"/>
+      <xi:include href="xml/ide-extension-set-adapter.xml"/>
+      <xi:include href="xml/ide-extension-util-private.xml"/>
+      <xi:include href="xml/ide-frame-addin.xml"/>
+      <xi:include href="xml/ide-hover-provider.xml"/>
+      <xi:include href="xml/ide-omni-bar-addin.xml"/>
+      <xi:include href="xml/ide-preferences-addin.xml"/>
+      <xi:include href="xml/ide-rename-provider.xml"/>
+      <xi:include href="xml/ide-runner-addin.xml"/>
+      <xi:include href="xml/ide-runtime-provider.xml"/>
+      <xi:include href="xml/ide-search-provider.xml"/>
+      <xi:include href="xml/ide-session-addin.xml"/>
+      <xi:include href="xml/ide-symbol-resolver.xml"/>
+      <xi:include href="xml/ide-test-provider.xml"/>
+      <xi:include href="xml/ide-toolchain-provider.xml"/>
+      <xi:include href="xml/ide-tree-addin.xml"/>
+      <xi:include href="xml/ide-workbench-addin.xml"/>
+      <xi:include href="xml/ide-workspace-addin.xml"/>
     </chapter>
+
     <chapter>
-      <title>Logging and Tracing</title>
+      <title>Core</title>
+      <xi:include href="xml/ide-build-ident.xml"/>
+      <xi:include href="xml/ide-context.xml"/>
       <xi:include href="xml/ide-debug.xml"/>
+      <xi:include href="xml/ide-global.xml"/>
       <xi:include href="xml/ide-log.xml"/>
-    </chapter>
-    <chapter>
-      <title>Builder Versioning</title>
+      <xi:include href="xml/ide-macros.xml"/>
+      <xi:include href="xml/ide-notification.xml"/>
+      <xi:include href="xml/ide-notifications.xml"/>
+      <xi:include href="xml/ide-object-box.xml"/>
+      <xi:include href="xml/ide-object.xml"/>
+      <xi:include href="xml/ide-settings.xml"/>
+      <xi:include href="xml/ide-transfer.xml"/>
+      <xi:include href="xml/ide-transfer-manager.xml"/>
+      <xi:include href="xml/ide-version-macros.xml"/>
       <xi:include href="xml/ide-version.xml"/>
-      <xi:include href="xml/ide-build-ident.xml"/>
     </chapter>
-  </part>
 
-  <part id="libide-buffers">
-    <title>The Buffer Subsystem</title>
-    <chapter>
-      <title>Files and URIs</title>
-      <xi:include href="xml/ide-uri.xml"/>
-      <xi:include href="xml/ide-file.xml"/>
-      <xi:include href="xml/ide-file-settings.xml"/>
-    </chapter>
-    <chapter>
-      <title>Buffers</title>
-      <xi:include href="xml/ide-buffer-manager.xml"/>
-      <xi:include href="xml/ide-buffer.xml"/>
-      <xi:include href="xml/ide-buffer-addin.xml"/>
-      <xi:include href="xml/ide-buffer-change-monitor.xml"/>
-    </chapter>
     <chapter>
-      <title>Tracking Unsaved Files</title>
-      <xi:include href="xml/ide-unsaved-files.xml"/>
-      <xi:include href="xml/ide-unsaved-file.xml"/>
+      <title>IO</title>
+      <xi:include href="xml/ide-content-type.xml"/>
+      <xi:include href="xml/ide-gfile.xml"/>
+      <xi:include href="xml/ide-line-reader.xml"/>
+      <xi:include href="xml/ide-marked-content.xml"/>
+      <xi:include href="xml/ide-path.xml"/>
+      <xi:include href="xml/ide-persistent-map-builder.xml"/>
+      <xi:include href="xml/ide-persistent-map.xml"/>
+      <xi:include href="xml/ide-pkcon-transfer.xml"/>
+      <xi:include href="xml/ide-pty-intercept.xml"/>
     </chapter>
-  </part>
 
-  <part id="libide-editor">
-    <title>Source Code Editing</title>
-    <chapter>
-      <title>The Editor Perspective</title>
-      <xi:include href="xml/ide-editor-perspective.xml"/>
-      <xi:include href="xml/ide-editor-sidebar.xml"/>
-      <xi:include href="xml/ide-editor-utilities.xml"/>
-    </chapter>
     <chapter>
-      <title>The Editor View</title>
-      <xi:include href="xml/ide-editor-view.xml"/>
-      <xi:include href="xml/ide-editor-view-addin.xml"/>
-      <xi:include href="xml/ide-source-view.xml"/>
-      <xi:include href="xml/ide-source-map.xml"/>
-    </chapter>
-    <chapter>
-      <title>Search and Replace</title>
-      <xi:include href="xml/ide-editor-search.xml"/>
+      <title>Gui</title>
+      <xi:include href="xml/ide-application.xml"/>
+      <xi:include href="xml/ide-cell-renderer-fancy.xml"/>
+      <xi:include href="xml/ide-command.xml"/>
+      <xi:include href="xml/ide-environment-editor.xml"/>
+      <xi:include href="xml/ide-fancy-tree-view.xml"/>
+      <xi:include href="xml/ide-frame-header.xml"/>
+      <xi:include href="xml/ide-frame.xml"/>
+      <xi:include href="xml/ide-grid-column.xml"/>
+      <xi:include href="xml/ide-grid.xml"/>
+      <xi:include href="xml/ide-gui-global.xml"/>
+      <xi:include href="xml/ide-gutter.xml"/>
+      <xi:include href="xml/ide-header-bar.xml"/>
+      <xi:include href="xml/ide-line-change-gutter-renderer.xml"/>
+      <xi:include href="xml/ide-marked-view.xml"/>
+      <xi:include href="xml/ide-notifications-button.xml"/>
+      <xi:include href="xml/ide-omni-bar.xml"/>
+      <xi:include href="xml/ide-page.xml"/>
+      <xi:include href="xml/ide-pane.xml"/>
+      <xi:include href="xml/ide-panel.xml"/>
+      <xi:include href="xml/ide-preferences-surface.xml"/>
+      <xi:include href="xml/ide-preferences-window.xml"/>
+      <xi:include href="xml/ide-primary-workspace.xml"/>
+      <xi:include href="xml/ide-search-entry.xml"/>
+      <xi:include href="xml/ide-surface.xml"/>
+      <xi:include href="xml/ide-surfaces-button.xml"/>
+      <xi:include href="xml/ide-tagged-entry.xml"/>
+      <xi:include href="xml/ide-transfer-button.xml"/>
+      <xi:include href="xml/ide-transient-sidebar.xml"/>
+      <xi:include href="xml/ide-tree-model.xml"/>
+      <xi:include href="xml/ide-tree-node.xml"/>
+      <xi:include href="xml/ide-tree.xml"/>
+      <xi:include href="xml/ide-workbench.xml"/>
+      <xi:include href="xml/ide-worker.xml"/>
+      <xi:include href="xml/ide-workspace.xml"/>
     </chapter>
+
     <chapter>
-      <title>Auto-completion</title>
-      <xi:include href="xml/ide-completion.xml"/>
-      <xi:include href="xml/ide-completion-context.xml"/>
-      <xi:include href="xml/ide-completion-provider.xml"/>
-      <xi:include href="xml/ide-completion-list-box-row.xml"/>
+      <title>Greeter</title>
+      <xi:include href="xml/ide-clone-surface.xml"/>
+      <xi:include href="xml/ide-greeter-section.xml"/>
+      <xi:include href="xml/ide-greeter-workspace.xml"/>
     </chapter>
+
     <chapter>
-      <title>Semantic Highlighting</title>
+      <title>Code</title>
+      <xi:include href="xml/ide-buffer-change-monitor.xml"/>
+      <xi:include href="xml/ide-buffer-manager.xml"/>
+      <xi:include href="xml/ide-buffer.xml"/>
+      <xi:include href="xml/ide-code-enums.xml"/>
+      <xi:include href="xml/ide-code-index-entries.xml"/>
+      <xi:include href="xml/ide-code-index-entry.xml"/>
+      <xi:include href="xml/ide-code-indexer.xml"/>
+      <xi:include href="xml/ide-code-types.xml"/>
+      <xi:include href="xml/ide-diagnostic.xml"/>
+      <xi:include href="xml/ide-diagnostics-manager.xml"/>
+      <xi:include href="xml/ide-diagnostics.xml"/>
+      <xi:include href="xml/ide-file-settings.xml"/>
+      <xi:include href="xml/ide-formatter-options.xml"/>
+      <xi:include href="xml/ide-formatter.xml"/>
       <xi:include href="xml/ide-highlight-engine.xml"/>
-      <xi:include href="xml/ide-highlighter.xml"/>
       <xi:include href="xml/ide-highlight-index.xml"/>
-    </chapter>
-    <chapter>
-      <title>Auto-Indentation</title>
-      <xi:include href="xml/ide-indenter.xml"/>
+      <xi:include href="xml/ide-highlighter.xml"/>
       <xi:include href="xml/ide-indent-style.xml"/>
+      <xi:include href="xml/ide-indenter.xml"/>
+      <xi:include href="xml/ide-language.xml"/>
+      <xi:include href="xml/ide-location.xml"/>
+      <xi:include href="xml/ide-range.xml"/>
+      <xi:include href="xml/ide-spaces-style.xml"/>
+      <xi:include href="xml/ide-symbol-node.xml"/>
+      <xi:include href="xml/ide-symbol-tree.xml"/>
+      <xi:include href="xml/ide-symbol.xml"/>
+      <xi:include href="xml/ide-text-edit.xml"/>
+      <xi:include href="xml/ide-text-iter.xml"/>
+      <xi:include href="xml/ide-text-util.xml"/>
+      <xi:include href="xml/ide-unsaved-file.xml"/>
+      <xi:include href="xml/ide-unsaved-files.xml"/>
     </chapter>
+
     <chapter>
-      <title>Reformatting Code</title>
-      <xi:include href="xml/ide-formatter.xml"/>
-      <xi:include href="xml/ide-formatter-options.xml"/>
-    </chapter>
-    <chapter>
-      <title>Snippets</title>
-      <xi:include href="xml/ide-snippet.xml"/>
+      <title>Source View</title>
+      <xi:include href="xml/ide-completion-context.xml"/>
+      <xi:include href="xml/ide-completion-display.xml"/>
+      <xi:include href="xml/ide-completion-list-box-row.xml"/>
+      <xi:include href="xml/ide-completion-proposal.xml"/>
+      <xi:include href="xml/ide-completion-types.xml"/>
+      <xi:include href="xml/ide-completion.xml"/>
       <xi:include href="xml/ide-snippet-chunk.xml"/>
       <xi:include href="xml/ide-snippet-context.xml"/>
+      <xi:include href="xml/ide-snippet-parser.xml"/>
+      <xi:include href="xml/ide-snippet-private.xml"/>
       <xi:include href="xml/ide-snippet-storage.xml"/>
+      <xi:include href="xml/ide-snippet-types.xml"/>
+      <xi:include href="xml/ide-snippet.xml"/>
+      <xi:include href="xml/ide-source-search-context.xml"/>
+      <xi:include href="xml/ide-source-style-scheme.xml"/>
+      <xi:include href="xml/ide-source-view-enums.xml"/>
+      <xi:include href="xml/ide-source-view.xml"/>
+      <xi:include href="xml/ide-hover-context.xml"/>
     </chapter>
-  </part>
 
-  <part id="libide-building">
-    <title>The Build Subsystem</title>
     <chapter>
-      <title>Core Build API</title>
-      <xi:include href="xml/ide-build-manager.xml"/>
-      <xi:include href="xml/ide-build-system.xml"/>
-      <xi:include href="xml/ide-build-target.xml"/>
+      <title>Editor</title>
+      <xi:include href="xml/ide-editor-page.xml"/>
+      <xi:include href="xml/ide-editor-search.xml"/>
+      <xi:include href="xml/ide-editor-sidebar.xml"/>
+      <xi:include href="xml/ide-editor-surface.xml"/>
+      <xi:include href="xml/ide-editor-utilities.xml"/>
+      <xi:include href="xml/ide-editor-workspace.xml"/>
     </chapter>
+
     <chapter>
-      <title>The Build Pipeline</title>
-      <xi:include href="xml/ide-build-pipeline.xml"/>
-      <xi:include href="xml/ide-build-pipeline-addin.xml"/>
-      <xi:include href="xml/ide-build-stage.xml"/>
+      <title>Threading and Processes</title>
+      <xi:include href="xml/ide-environment-variable.xml"/>
+      <xi:include href="xml/ide-environment.xml"/>
+      <xi:include href="xml/ide-subprocess-launcher.xml"/>
+      <xi:include href="xml/ide-subprocess-supervisor.xml"/>
+      <xi:include href="xml/ide-subprocess.xml"/>
+      <xi:include href="xml/ide-task.xml"/>
+      <xi:include href="xml/ide-thread-pool.xml"/>
     </chapter>
+
     <chapter>
-      <title>Reusable Build Stages</title>
+      <title>Foundry</title>
+      <xi:include href="xml/ide-build-log.xml"/>
+      <xi:include href="xml/ide-build-manager.xml"/>
+      <xi:include href="xml/ide-build-pipeline.xml"/>
       <xi:include href="xml/ide-build-stage-launcher.xml"/>
       <xi:include href="xml/ide-build-stage-mkdirs.xml"/>
       <xi:include href="xml/ide-build-stage-transfer.xml"/>
-    </chapter>
-    <chapter>
-      <title>Build Configurations</title>
+      <xi:include href="xml/ide-build-stage.xml"/>
+      <xi:include href="xml/ide-build-system-discovery.xml"/>
+      <xi:include href="xml/ide-build-system.xml"/>
+      <xi:include href="xml/ide-build-target.xml"/>
+      <xi:include href="xml/ide-compile-commands.xml"/>
       <xi:include href="xml/ide-configuration-manager.xml"/>
-      <xi:include href="xml/ide-configuration-provider.xml"/>
       <xi:include href="xml/ide-configuration.xml"/>
-      <xi:include href="xml/ide-environment.xml"/>
-      <xi:include href="xml/ide-environment-variable.xml"/>
-    </chapter>
-    <chapter>
-      <title>Utility and Fallback API</title>
-      <xi:include href="xml/ide-compile-commands.xml"/>
-      <xi:include href="xml/ide-build-system-discovery.xml"/>
-      <xi:include href="xml/ide-directory-build-system.xml"/>
-    </chapter>
-  </part>
-
-  <part id="libide-diagnostics">
-    <title>The Diagnostics Subsystem</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-source-location.xml"/>
-      <xi:include href="xml/ide-source-range.xml"/>
-      <xi:include href="xml/ide-diagnostic-provider.xml"/>
-      <xi:include href="xml/ide-diagnostics-manager.xml"/>
-      <xi:include href="xml/ide-diagnostics.xml"/>
-      <xi:include href="xml/ide-diagnostic.xml"/>
-      <xi:include href="xml/ide-fixit.xml"/>
-    </chapter>
-  </part>
-
-  <part id="libide-devices">
-    <title>The Device Subsystem</title>
-    <chapter>
-      <title>API Reference</title>
+      <xi:include href="xml/ide-dependency-updater.xml"/>
+      <xi:include href="xml/ide-deploy-strategy.xml"/>
+      <xi:include href="xml/ide-device-info.xml"/>
       <xi:include href="xml/ide-device-manager.xml"/>
-      <xi:include href="xml/ide-device-provider.xml"/>
       <xi:include href="xml/ide-device.xml"/>
+      <xi:include href="xml/ide-fallback-build-system.xml"/>
+      <xi:include href="xml/ide-foundry-compat.xml"/>
+      <xi:include href="xml/ide-foundry-enums.xml"/>
+      <xi:include href="xml/ide-foundry-types.xml"/>
       <xi:include href="xml/ide-local-device.xml"/>
+      <xi:include href="xml/ide-run-manager.xml"/>
+      <xi:include href="xml/ide-runner.xml"/>
+      <xi:include href="xml/ide-runtime-manager.xml"/>
+      <xi:include href="xml/ide-runtime.xml"/>
+      <xi:include href="xml/ide-simple-build-system-discovery.xml"/>
+      <xi:include href="xml/ide-simple-build-target.xml"/>
+      <xi:include href="xml/ide-simple-toolchain.xml"/>
+      <xi:include href="xml/ide-test-manager.xml"/>
+      <xi:include href="xml/ide-test-private.xml"/>
+      <xi:include href="xml/ide-test.xml"/>
+      <xi:include href="xml/ide-toolchain-manager.xml"/>
+      <xi:include href="xml/ide-toolchain.xml"/>
+      <xi:include href="xml/ide-triplet.xml"/>
     </chapter>
-  </part>
 
-  <part id="libide-search">
-    <title>Project Search</title>
     <chapter>
-      <title>Search Engine</title>
-      <xi:include href="xml/ide-search-engine.xml"/>
-      <xi:include href="xml/ide-search-provider.xml"/>
-      <xi:include href="xml/ide-search-result.xml"/>
+      <title>VCS</title>
+      <xi:include href="xml/ide-directory-vcs.xml"/>
+      <xi:include href="xml/ide-vcs-cloner.xml"/>
+      <xi:include href="xml/ide-vcs-config.xml"/>
+      <xi:include href="xml/ide-vcs-enums.xml"/>
+      <xi:include href="xml/ide-vcs-file-info.xml"/>
+      <xi:include href="xml/ide-vcs-initializer.xml"/>
+      <xi:include href="xml/ide-vcs-monitor.xml"/>
+      <xi:include href="xml/ide-vcs-uri.xml"/>
+      <xi:include href="xml/ide-vcs.xml"/>
     </chapter>
-    <chapter>
-      <title>Performance Considerations</title>
-      <xi:include href="xml/ide-search-reducer.xml"/>
-    </chapter>
-    <chapter>
-      <title>Source Code Indexing</title>
-      <xi:include href="xml/ide-code-index-entries.xml"/>
-      <xi:include href="xml/ide-code-index-entry.xml"/>
-      <xi:include href="xml/ide-code-indexer.xml"/>
-    </chapter>
-  </part>
-
-  <part id="libide-refactoring">
-    <title>Refactoring</title>
-    <xi:include href="xml/ide-rename-provider.xml"/>
-    <xi:include href="xml/ide-project-edit.xml"/>
-  </part>
 
-  <part id="libide-workbench">
-    <title>Workbench and View Layout</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-workbench.xml"/>
-      <xi:include href="xml/ide-workbench-header-bar.xml"/>
-      <xi:include href="xml/ide-perspective.xml"/>
-      <xi:include href="xml/ide-omni-bar.xml"/>
-    </chapter>
     <chapter>
-      <title>Extending the Workbench</title>
-      <xi:include href="xml/ide-workbench-addin.xml"/>
-      <xi:include href="xml/ide-workbench-message.xml"/>
-    </chapter>
-    <chapter>
-      <title>Layout Management</title>
-      <xi:include href="xml/ide-layout-view.xml"/>
-      <xi:include href="xml/ide-layout-grid-column.xml"/>
-      <xi:include href="xml/ide-layout-grid.xml"/>
-      <xi:include href="xml/ide-layout-stack-addin.xml"/>
-      <xi:include href="xml/ide-layout-stack-header.xml"/>
-      <xi:include href="xml/ide-layout-stack.xml"/>
-      <xi:include href="xml/ide-layout.xml"/>
-      <xi:include href="xml/ide-layout-pane.xml"/>
-      <xi:include href="xml/ide-layout-transient-sidebar.xml"/>
-    </chapter>
-    <chapter>
-      <title>Keyboard Shortcuts</title>
-      <!--
-      <xi:include href="xml/ide-keybindings.xml"/>
-      -->
+      <title>Search</title>
+      <xi:include href="xml/ide-search-engine.xml"/>
+      <xi:include href="xml/ide-search-reducer.xml"/>
+      <xi:include href="xml/ide-search-result.xml"/>
     </chapter>
-  </part>
-
-  <part id="libide-vcs">
-    <title>The Version Control Subsystem</title>
-    <xi:include href="xml/ide-vcs.xml"/>
-    <xi:include href="xml/ide-vcs-uri.xml"/>
-    <xi:include href="xml/ide-vcs-config.xml"/>
-    <xi:include href="xml/ide-vcs-initializer.xml"/>
-    <xi:include href="xml/ide-directory-vcs.xml"/>
-  </part>
 
-  <part id="libide-runtimes">
-    <title>SDKs and Runtimes</title>
-    <xi:include href="xml/ide-runtime-manager.xml"/>
-    <xi:include href="xml/ide-runtime-provider.xml"/>
-    <xi:include href="xml/ide-runtime.xml"/>
-  </part>
-
-  <part id="libide-runner">
-    <title>Running Project Programs</title>
-    <xi:include href="xml/ide-run-manager.xml"/>
-    <xi:include href="xml/ide-runner.xml"/>
     <chapter>
-      <title>Extending Runners</title>
-      <xi:include href="xml/ide-runner-addin.xml"/>
+      <title>Terminal</title>
+      <xi:include href="xml/ide-terminal-page.xml"/>
+      <xi:include href="xml/ide-terminal-search.xml"/>
+      <xi:include href="xml/ide-terminal-surface.xml"/>
+      <xi:include href="xml/ide-terminal-util.xml"/>
+      <xi:include href="xml/ide-terminal-workspace.xml"/>
+      <xi:include href="xml/ide-terminal.xml"/>
     </chapter>
-  </part>
 
-  <part id="libide-debugger">
-    <title>The Debugger Subsystem</title>
     <chapter>
-      <title>API Reference</title>
+      <title>Debugging</title>
+      <xi:include href="xml/ide-debugger-address-map-private.xml"/>
       <xi:include href="xml/ide-debugger-breakpoints.xml"/>
       <xi:include href="xml/ide-debugger-breakpoint.xml"/>
       <xi:include href="xml/ide-debugger-frame.xml"/>
@@ -302,136 +300,27 @@
       <xi:include href="xml/ide-debugger.xml"/>
       <xi:include href="xml/ide-debug-manager.xml"/>
     </chapter>
-  </part>
-
-  <part id="libide-symbols">
-    <title>Symbol Extraction and Resolution</title>
-    <xi:include href="xml/ide-symbol-node.xml"/>
-    <xi:include href="xml/ide-symbol-resolver.xml"/>
-    <xi:include href="xml/ide-symbol-tree.xml"/>
-    <xi:include href="xml/ide-symbol.xml"/>
-    <xi:include href="xml/ide-tags-builder.xml"/>
-  </part>
-
-  <part id="libide-testing">
-    <title>Unit Testing</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-test-manager.xml"/>
-      <xi:include href="xml/ide-test-provider.xml"/>
-      <xi:include href="xml/ide-test.xml"/>
-    </chapter>
-  </part>
 
-  <part id="libide-projects">
-    <title>Project Management and Templates</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-project-info.xml"/>
-      <xi:include href="xml/ide-project-item.xml"/>
-      <xi:include href="xml/ide-project.xml"/>
-    </chapter>
     <chapter>
-      <title>Extending Project Creation Workflow</title>
-      <xi:include href="xml/ide-genesis-addin.xml"/>
-      <xi:include href="xml/ide-recent-projects.xml"/>
+      <title>Language Servers</title>
+      <xi:include href="xml/ide-lsp-client.xml"/>
+      <xi:include href="xml/ide-lsp-completion-item.xml"/>
+      <xi:include href="xml/ide-lsp-completion-provider.xml"/>
+      <xi:include href="xml/ide-lsp-completion-results.xml"/>
+      <xi:include href="xml/ide-lsp-diagnostic-provider.xml"/>
+      <xi:include href="xml/ide-lsp-formatter.xml"/>
+      <xi:include href="xml/ide-lsp-highlighter.xml"/>
+      <xi:include href="xml/ide-lsp-hover-provider.xml"/>
+      <xi:include href="xml/ide-lsp-rename-provider.xml"/>
+      <xi:include href="xml/ide-lsp-symbol-node-private.xml"/>
+      <xi:include href="xml/ide-lsp-symbol-node.xml"/>
+      <xi:include href="xml/ide-lsp-symbol-resolver.xml"/>
+      <xi:include href="xml/ide-lsp-symbol-tree-private.xml"/>
+      <xi:include href="xml/ide-lsp-symbol-tree.xml"/>
+      <xi:include href="xml/ide-lsp-types.xml"/>
+      <xi:include href="xml/ide-lsp-util.xml"/>
     </chapter>
-    <chapter>
-      <title>Templates</title>
-      <xi:include href="xml/ide-project-template.xml"/>
-      <xi:include href="xml/ide-template-provider.xml"/>
-      <xi:include href="xml/ide-template-base.xml"/>
-    </chapter>
-  </part>
 
-  <part id="libide-preferences">
-    <title>Application and Plugin Preferences</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-preferences-addin.xml"/>
-    </chapter>
-  </part>
-
-  <part id="libide-threading">
-    <title>Processes, Threading, and Tasks</title>
-    <chapter>
-      <title>Threading</title>
-      <xi:include href="xml/ide-thread-pool.xml"/>
-    </chapter>
-    <chapter>
-      <title>Worker Processes</title>
-      <xi:include href="xml/ide-worker.xml"/>
-    </chapter>
-    <chapter>
-      <title>Subprocesses</title>
-      <xi:include href="xml/ide-subprocess-launcher.xml"/>
-      <xi:include href="xml/ide-subprocess.xml"/>
-      <xi:include href="xml/ide-subprocess-supervisor.xml"/>
-    </chapter>
-    <chapter>
-      <title>Pausable Tasks</title>
-      <xi:include href="xml/ide-pausable.xml"/>
-    </chapter>
-  </part>
-
-  <part id="libide-langserv">
-    <title>Language Server Protocol</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-langserv-client.xml"/>
-      <xi:include href="xml/ide-langserv-completion-provider.xml"/>
-      <xi:include href="xml/ide-langserv-diagnostic-provider.xml"/>
-      <xi:include href="xml/ide-langserv-formatter.xml"/>
-      <xi:include href="xml/ide-langserv-highlighter.xml"/>
-      <xi:include href="xml/ide-langserv-rename-provider.xml"/>
-      <xi:include href="xml/ide-langserv-symbol-node.xml"/>
-      <xi:include href="xml/ide-langserv-symbol-resolver.xml"/>
-      <xi:include href="xml/ide-langserv-symbol-tree.xml"/>
-    </chapter>
-  </part>
-
-  <part id="libide-transfers">
-    <title>Downloads and Transfers</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-transfer.xml"/>
-      <xi:include href="xml/ide-transfer-manager.xml"/>
-      <xi:include href="xml/ide-pkcon-transfer.xml"/>
-    </chapter>
-    <chapter>
-      <title>Widgets</title>
-      <xi:include href="xml/ide-transfer-button.xml"/>
-      <xi:include href="xml/ide-transfers-button.xml"/>
-    </chapter>
-  </part>
-
-  <part id="libide-misc">
-    <title>Miscellaneous and Utility API</title>
-    <chapter>
-      <title>API Reference</title>
-      <xi:include href="xml/ide-doap-person.xml"/>
-      <xi:include href="xml/ide-doap.xml"/>
-      <xi:include href="xml/ide-dnd.xml"/>
-      <xi:include href="xml/ide-flatpak.xml"/>
-      <xi:include href="xml/ide-glib.xml"/>
-      <xi:include href="xml/ide-gtk.xml"/>
-      <xi:include href="xml/ide-line-reader.xml"/>
-      <xi:include href="xml/ide-posix.xml"/>
-      <xi:include href="xml/ide-enums.xml"/>
-      <xi:include href="xml/ide-progress.xml"/>
-      <xi:include href="xml/ide-ref-ptr.xml"/>
-      <xi:include href="xml/ide-settings.xml"/>
-    </chapter>
-    <chapter>
-      <title>Internal Extension Management</title>
-      <xi:include href="xml/ide-extension-adapter.xml"/>
-      <xi:include href="xml/ide-extension-set-adapter.xml"/>
-    </chapter>
-    <chapter>
-      <title>Widgets</title>
-      <xi:include href="xml/ide-cell-renderer-fancy.xml"/>
-      <xi:include href="xml/ide-fancy-tree-view.xml"/>
-    </chapter>
   </part>
 
   <chapter id="object-tree">
diff --git a/doc/sdk/meson.build b/doc/sdk/meson.build
index 5953184bc..4bb2421b3 100644
--- a/doc/sdk/meson.build
+++ b/doc/sdk/meson.build
@@ -3,7 +3,7 @@ if get_option('docs')
 subdir('xml')
 
 private_headers = ['config.h']
-foreach source : libide_private_sources
+foreach source : gnome_builder_private_sources + gnome_builder_private_headers
   private_headers += ['@0@/@1@'.format(meson.source_root(), source)]
 endforeach
 
@@ -28,20 +28,77 @@ vte_docpath = join_paths(vte_prefix, 'share', 'vte-doc', 'html')
 # Locate our directory for documentation
 docpath = join_paths(get_option('datadir'), 'gtk-doc', 'html')
 
+libide_gtk_doc = shared_library('ide-gtk-doc',
+            c_args: libide_args + release_args,
+      dependencies: gnome_builder_deps,
+)
+
+libide_gtk_doc_dep = declare_dependency(
+         dependencies: gnome_builder_deps,
+            link_with: libide_gtk_doc,
+)
+
 gnome.gtkdoc('libide',
            main_xml: 'libide-docs.sgml',
             src_dir: [
-              join_paths(meson.source_root(), 'src', 'libide'),
-              join_paths(meson.build_root(), 'src', 'libide'),
+              join_paths(meson.source_root(), 'src', 'libide', 'core'),
+              join_paths(meson.build_root(), 'src', 'libide', 'core'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'io'),
+              join_paths(meson.build_root(), 'src', 'libide', 'io'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'threading'),
+              join_paths(meson.build_root(), 'src', 'libide', 'threading'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'code'),
+              join_paths(meson.build_root(), 'src', 'libide', 'code'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'foundry'),
+              join_paths(meson.build_root(), 'src', 'libide', 'foundry'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'sourceview'),
+              join_paths(meson.build_root(), 'src', 'libide', 'sourceview'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'editor'),
+              join_paths(meson.build_root(), 'src', 'libide', 'editor'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'vcs'),
+              join_paths(meson.build_root(), 'src', 'libide', 'vcs'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'debugger'),
+              join_paths(meson.build_root(), 'src', 'libide', 'debugger'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'greeter'),
+              join_paths(meson.build_root(), 'src', 'libide', 'greeter'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'gui'),
+              join_paths(meson.build_root(), 'src', 'libide', 'gui'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'lsp'),
+              join_paths(meson.build_root(), 'src', 'libide', 'lsp'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'plugins'),
+              join_paths(meson.build_root(), 'src', 'libide', 'plugins'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'search'),
+              join_paths(meson.build_root(), 'src', 'libide', 'search'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'terminal'),
+              join_paths(meson.build_root(), 'src', 'libide', 'terminal'),
+
+              join_paths(meson.source_root(), 'src', 'libide', 'tree'),
+              join_paths(meson.build_root(), 'src', 'libide', 'tree'),
             ],
 
-       dependencies: libide_dep,
+       dependencies: [ libide_gtk_doc_dep ],
   gobject_typesfile: 'libide.types',
           scan_args: [
             '--rebuild-types',
             '--ignore-decorators=_IDE_EXTERN',
           ],
      ignore_headers: private_headers,
+      content_files: gnome_builder_public_sources + gnome_builder_public_headers,
+             c_args: libide_args,
 
        fixxref_args: [
          '--html-dir=@0@'.format(docpath),
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]