Adds editArticleRef

3 files changed, 21 insertions, 1 deletions

diff --git a/lib/modifiers/summary/editArticleRef.js b/lib/modifiers/summary/editArticleRef.js
new file mode 100644
index 0000000..7106960
--- /dev/null
+++ b/lib/modifiers/summary/editArticleRef.js
@@ -0,0 +1,17 @@
+var mergeAtLevel = require('./mergeAtLevel');
+
+/**
+    Edit the ref of an article
+
+    @param {Summary} summary
+    @param {String} level
+    @param {String} newRef
+    @return {Summary}
+*/
+function editArticleRef(summary, level, newRef) {
+    return mergeAtLevel(summary, level, {
+        ref: newRef
+    });
+}
+
+module.exports = editArticleRef;
diff --git a/lib/modifiers/summary/index.js b/lib/modifiers/summary/index.js
index 3ee0367..f91fdb6 100644
--- a/lib/modifiers/summary/index.js
+++ b/lib/modifiers/summary/index.js
@@ -5,6 +5,7 @@ module.exports = {
     removeArticle:      require('./removeArticle'),
     unshiftArticle:     require('./unshiftArticle'),
     editArticleTitle:   require('./editArticleTitle'),
+    editArticleRef:     require('./editArticleRef'),
 
     insertPart:         require('./insertPart'),
     removePart:         require('./removePart'),
diff --git a/lib/modifiers/summary/moveArticleAfter.js b/lib/modifiers/summary/moveArticleAfter.js
index e03eae9..e268f73 100644
--- a/lib/modifiers/summary/moveArticleAfter.js
+++ b/lib/modifiers/summary/moveArticleAfter.js
@@ -3,7 +3,9 @@ var removeArticle = require('./removeArticle');
 var insertArticle = require('./insertArticle');
 
 /**
-    Returns a new summary, with the an article moved after another article.
+    Returns a new summary, with the an article moved after another
+    article. Unlike `moveArticle`, does not ensure that the article
+    will be found at the target's level plus one.
 
     @param {Summary} summary
     @param {String|SummaryArticle} origin