docs: Fix build and some warnings

docs/Makefile.am

@@ -5,10 +5,12 @@ libgala_doc_files = \
 	$(top_srcdir)/lib/Plugin.vala \
 	$(top_srcdir)/lib/Utils.vala \
 	$(top_srcdir)/lib/WindowManager.vala \
+	$(top_srcdir)/lib/WindowIcon.vala \
 	$(NULL)
 
 gala_doc_files = \
 	$(top_srcdir)/src/DBus.vala \
+	$(top_srcdir)/src/DockThemeManager.vala \
 	$(top_srcdir)/src/DragDropAction.vala \
 	$(top_srcdir)/src/InternalUtils.vala \
 	$(top_srcdir)/src/Main.vala \
@@ -20,10 +22,12 @@ gala_doc_files = \
 	$(top_srcdir)/src/WindowListener.vala \
 	$(top_srcdir)/src/WindowManager.vala \
 	$(top_srcdir)/src/WorkspaceManager.vala \
+	$(top_srcdir)/src/Background/Animation.vala \
 	$(top_srcdir)/src/Background/Background.vala \
 	$(top_srcdir)/src/Background/BackgroundCache.vala \
+	$(top_srcdir)/src/Background/BackgroundContainer.vala \
 	$(top_srcdir)/src/Background/BackgroundManager.vala \
-	$(top_srcdir)/src/Background/SlideShow.vala \
+	$(top_srcdir)/src/Background/BackgroundSource.vala \
 	$(top_srcdir)/src/Background/SystemBackground.vala \
 	$(top_srcdir)/src/Widgets/IconGroup.vala \
 	$(top_srcdir)/src/Widgets/IconGroupContainer.vala \
@@ -31,9 +35,12 @@ gala_doc_files = \
 	$(top_srcdir)/src/Widgets/MultitaskingView.vala \
 	$(top_srcdir)/src/Widgets/WindowClone.vala \
 	$(top_srcdir)/src/Widgets/WindowCloneContainer.vala \
+	$(top_srcdir)/src/Widgets/WindowIconActor.vala \
+	$(top_srcdir)/src/Widgets/WindowMenu.vala \
 	$(top_srcdir)/src/Widgets/WindowOverview.vala \
 	$(top_srcdir)/src/Widgets/WindowSwitcher.vala \
 	$(top_srcdir)/src/Widgets/WorkspaceClone.vala \
+	$(top_srcdir)/src/Widgets/WorkspaceInsertThumb.vala \
 	$(NULL)
 
 valadoc_flags_gala = \
@@ -44,12 +51,12 @@ valadoc_flags_gala = \
 	$(GALA_DOCS_VALAFLAGS) \
 	--driver "`$(VALAC) --version`" \
 	--pkg config \
-	--pkg cogl-fixes \	
+	--pkg cogl-fixes \
 	--vapidir=$(top_builddir)/lib \
 	--vapidir=$(top_srcdir)/vapi \
 	$(NULL)
 
-#if HAVE_VALADOC
+if HAVE_VALADOC
 
 html: $(libgala_doc_files) $(gala_doc_files) Makefile
 	$(AM_V_GEN)$(VALADOC) \
@@ -66,7 +73,7 @@ libhtml: $(libgala_doc_files) Makefile
 		$(valadoc_flags_gala) \
 		$(filter %.vala,$^)
 
-#endif
+endif
 
 distclean-local: distclean-docs
 distclean-docs:

lib/WindowIcon.vala

@@ -63,7 +63,7 @@ namespace Gala
 		 *
 		 * @param window               The window for which to create the icon
 		 * @param icon_size            The size of the icon in pixels
-		 * @param destroy_on_unmanaged @see destroy_on_unmanaged
+		 * @param destroy_on_unmanaged see destroy_on_unmanaged property
 		 */
 		public WindowIcon (Meta.Window window, int icon_size, bool destroy_on_unmanaged = false)
 		{

src/DBus.vala

@@ -98,7 +98,7 @@ namespace Gala
 		 *                         relative to the monitor you picked. Values will be clamped
 		 *                         to its dimensions
 		 * @param reference_y      Y coordinate
-		 * @param refenrece_width  Width of the rectangle
+		 * @param reference_width  Width of the rectangle
 		 * @param reference_height Height of the rectangle
 		 */
 		public async ColorInformation get_background_color_information (int monitor,

src/InternalUtils.vala

@@ -47,7 +47,7 @@ namespace Gala
 			 * Creates a new SafeWindowClone
 			 *
 			 * @param window               The window to clone from
-			 * @param destroy_on_unmanaged @see destroy_on_unmanaged
+			 * @param destroy_on_unmanaged see destroy_on_unmanaged property
 			 */
 			public SafeWindowClone (Window window, bool destroy_on_unmanaged = false)
 			{
@@ -191,7 +191,7 @@ namespace Gala
 		 * removed again when in dynamic workspaces, the window is first placed on it.
 		 *
 		 * @param index  The index at which to insert the workspace
-		 * @param window A window that should be moved to the new workspace
+		 * @param new_window A window that should be moved to the new workspace
 		 */
 		public static void insert_workspace_with_window (int index, Window new_window)
 		{