Cscott has uploaded a new change for review.

  https://gerrit.wikimedia.org/r/79818


Change subject: Minor fixes to documentation comments.
......................................................................

Minor fixes to documentation comments.

Found when attempting to use panino to generate docs.

Change-Id: Ic9bd5593ae0e5e4a0300c863baf8bc97d5c3deaa
---
M js/lib/ext.core.LinkHandler.js
M js/lib/ext.core.TemplateHandler.js
M js/lib/fakejquery.js
M js/lib/mediawiki.DOMUtils.js
M js/lib/mediawiki.Util.js
M js/lib/mediawiki.parser.js
6 files changed, 12 insertions(+), 11 deletions(-)


  git pull ssh://gerrit.wikimedia.org:29418/mediawiki/extensions/Parsoid 
refs/changes/18/79818/1

diff --git a/js/lib/ext.core.LinkHandler.js b/js/lib/ext.core.LinkHandler.js
index a95d94d..f741ebd 100644
--- a/js/lib/ext.core.LinkHandler.js
+++ b/js/lib/ext.core.LinkHandler.js
@@ -1,5 +1,5 @@
 "use strict";
-/*
+/**
  * Simple link handler. Registers after template expansions, as an
  * asynchronous transform.
  *
diff --git a/js/lib/ext.core.TemplateHandler.js 
b/js/lib/ext.core.TemplateHandler.js
index 59eec6d..a145659 100644
--- a/js/lib/ext.core.TemplateHandler.js
+++ b/js/lib/ext.core.TemplateHandler.js
@@ -950,7 +950,7 @@
        }
 };
 
-/*********************** Template argument expansion *******************/
+/* ********************** Template argument expansion ****************** */
 
 /**
  * Expand template arguments with tokens from the containing frame.
diff --git a/js/lib/fakejquery.js b/js/lib/fakejquery.js
index 9445cc4..9f413c9 100644
--- a/js/lib/fakejquery.js
+++ b/js/lib/fakejquery.js
@@ -1,6 +1,7 @@
 "use strict";
 /* jshint eqnull:true, eqeqeq:false, asi:true, curly:false */
-/* minimalist jquery which just defines the tiny bits parsoid uses */
+
+/** Minimalist jquery which just defines the tiny bits parsoid uses. */
 /* based on zepto.js, which explains why the code conventions don't
  * match the rest of parsoid. */
   var $ = module.exports = {};
diff --git a/js/lib/mediawiki.DOMUtils.js b/js/lib/mediawiki.DOMUtils.js
index 27e1c01..cd3f646 100644
--- a/js/lib/mediawiki.DOMUtils.js
+++ b/js/lib/mediawiki.DOMUtils.js
@@ -1,7 +1,7 @@
 "use strict";
 
 /**
- * General DOM utilities
+ * General DOM utilities.
  */
 
 require('./core-upgrade.js');
diff --git a/js/lib/mediawiki.Util.js b/js/lib/mediawiki.Util.js
index b4060f7..c41eec5 100644
--- a/js/lib/mediawiki.Util.js
+++ b/js/lib/mediawiki.Util.js
@@ -1,5 +1,5 @@
-/*
- * This file contains general utilities for token transforms
+/**
+ * This file contains general utilities for token transforms.
  */
 /* jshint nonstandard:true */ // define 'unescape'
 
@@ -13,7 +13,7 @@
        TemplateRequest = require( './mediawiki.ApiRequest.js' 
).TemplateRequest,
        Consts = require('./mediawiki.wikitext.constants.js').WikitextConstants;
 
-/** WORKAROUND HACK to entities package, using domino. */
+/* WORKAROUND HACK to entities package, using domino. */
 // see https://github.com/fb55/node-entities/issues/8
 if ( /^0.2.[01]$/.test( require( 'entities/package.json' ).version ) ) {
        entities.decodeHTML5 = function(data) {
diff --git a/js/lib/mediawiki.parser.js b/js/lib/mediawiki.parser.js
index 52c170d..403ca15 100644
--- a/js/lib/mediawiki.parser.js
+++ b/js/lib/mediawiki.parser.js
@@ -158,9 +158,9 @@
                // Build a tree out of the fully processed token stream
                [ TreeBuilder, [] ],
 
-               /**
-               * Final processing on the HTML DOM.
-               */
+               /*
+                * Final processing on the HTML DOM.
+                */
 
                /* Generic DOM transformer.
                * This currently performs minor tree-dependent clean up like 
wrapping
@@ -320,7 +320,7 @@
 };
 
 
-/******************** ParserPipeline ****************************/
+/* ******************* ParserPipeline *************************** */
 
 /**
  * Wrap some stages into a pipeline. The last member of the pipeline is

-- 
To view, visit https://gerrit.wikimedia.org/r/79818
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings

Gerrit-MessageType: newchange
Gerrit-Change-Id: Ic9bd5593ae0e5e4a0300c863baf8bc97d5c3deaa
Gerrit-PatchSet: 1
Gerrit-Project: mediawiki/extensions/Parsoid
Gerrit-Branch: master
Gerrit-Owner: Cscott <[email protected]>

_______________________________________________
MediaWiki-commits mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits

Reply via email to