diff --git a/src/gresource/js/Greeter.js b/src/gresource/js/Greeter.js
index ec1e111..04b2f80 100644
--- a/src/gresource/js/Greeter.js
+++ b/src/gresource/js/Greeter.js
@@ -32,12 +32,16 @@
  * @global
  */
 
+/**
+ * @namespace LightDM The greeter's Theme JavaScript API.
+ */
+
 
 /**
- * Base class for the greeter's JavaScript Theme API. Greeter themes will interact
+ * Base class for the greeter's Theme JavaScript API. Greeter themes will interact
  * directly with an object derived from this class to facilitate the user log-in process.
  * The greeter will automatically create an instance when it starts.
- * The instance can be accessed using the global variable: {@link window.lightdm}.
+ * The instance can be accessed using the global variable: [`lightdm`](#dl-window-lightdm).
  *
  * @memberOf LightDM
  */
diff --git a/src/gresource/js/GreeterConfig.js b/src/gresource/js/GreeterConfig.js
index 4a629e6..d02e25b 100644
--- a/src/gresource/js/GreeterConfig.js
+++ b/src/gresource/js/GreeterConfig.js
@@ -47,7 +47,7 @@ function set_values( defaults, target_obj, method ) {
  * Provides theme authors with a way to retrieve values from the greeter's config
  * file located at `/etc/lightdm/lightdm-webkit2-greeter.conf`. The greeter will
  * create an instance of this class when it starts. The instance can be accessed
- * with the global variable: [`greeter_config`]({@link external:window.greeter_config}).
+ * with the global variable: [`greeter_config`](#dl-window-greeter_config).
  *
  * @memberOf LightDM
  */
diff --git a/src/gresource/js/LightDMObjects.js b/src/gresource/js/LightDMObjects.js
index f10d32e..d574bf7 100644
--- a/src/gresource/js/LightDMObjects.js
+++ b/src/gresource/js/LightDMObjects.js
@@ -25,10 +25,6 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/**
- * @namespace LightDM
- */
-
 /**
  * Interface for object that holds info about a session. Session objects are not
  * created by the theme's code, but rather by the {@link LightDM.Greeter} class.
diff --git a/src/gresource/js/ThemeUtils.js b/src/gresource/js/ThemeUtils.js
index d9a873b..4ec29be 100644
--- a/src/gresource/js/ThemeUtils.js
+++ b/src/gresource/js/ThemeUtils.js
@@ -41,7 +41,7 @@ let localized_invalid_date = moment('today', '!@#'),
 /**
  * Provides various utility methods for use by theme authors. The greeter will automatically
  * create an instance of this class when it starts. The instance can be accessed
- * with the global variable: {@link window.theme_utils}.
+ * with the global variable: [`theme_utils`](#dl-window-theme_utils).
  *
  * @memberOf LightDM
  */
@@ -235,7 +235,7 @@ __theme_utils.then( result => {
 	 * @name greeterutil
 	 * @type {LightDM.ThemeUtils}
 	 * @memberOf window
-	 * @deprecated Use {@link window.theme_utils} instead.
+	 * @deprecated Use [`theme_utils`](#dl-window-theme_utils) instead.
 	 */
 	window.greeterutil = window.theme_utils;
 } );