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