Add support for ignoring final definitions

Closes GH-7.

index.js

@@ -21,8 +21,12 @@ var https = 'https://'
 
 /* Add a license section. */
 function license(options) {
-  if (!options) {
-    options = {}
+  var opts = options || {}
+  var finals = opts.ignoreFinalDefinitions
+  var headingOptions = {
+    ignoreFinalDefinitions:
+      finals === undefined || finals === null ? true : finals,
+    test: licenseHeadingRegexp
   }
 
   return transformer
@@ -36,13 +40,13 @@ function license(options) {
     var defaultLicenseFile
 
     // Skip package loading if we have all info in `options`.
-    if (options.url && options.name && options.license) {
+    if (opts.url && opts.name && opts.license) {
       one()
     } else {
       fs.readFile(path.resolve(cwd, 'package.json'), onpackage)
     }
 
-    if (options.file) {
+    if (opts.file) {
       one()
     } else {
       fs.readdir(cwd, onfiles)
@@ -106,10 +110,10 @@ function license(options) {
     }
 
     function done() {
-      var url = options.url || defaultUrl
-      var name = options.name || defaultName
-      var license = options.license || defaultLicense
-      var licenseFile = options.file || defaultLicenseFile
+      var url = opts.url || defaultUrl
+      var name = opts.name || defaultName
+      var license = opts.license || defaultLicense
+      var licenseFile = opts.file || defaultLicenseFile
 
       /* Ignore the license file itself. */
       if (licenseFile && file.path === licenseFile) {
@@ -140,7 +144,7 @@ function license(options) {
         licenseFile = spdx[license].url
       }
 
-      heading(tree, licenseHeadingRegexp, onheading)
+      heading(tree, headingOptions, onheading)
 
       next()
 

readme.md

@@ -83,6 +83,10 @@ If there is no given or found license file, but `options.license` is a known
 and `string`][author-format] format of `author`.  `http://` is prepended if
 `url` starts without HTTP or HTTPS protocol.
 
+###### `options.ignoreFinalDefinitions`
+
+Ignore final definitions otherwise in the section (`boolean`, default: true).
+
 ## Detection
 
 Detection of `package.json` and files in the current working directory is

test/fixtures/definitions-ignore-false/config.json

@@ -0,0 +1,3 @@
+{
+  "ignoreFinalDefinitions": false
+}

test/fixtures/definitions-ignore-false/output.md

@@ -0,0 +1,5 @@
+# [PI][]
+
+## License
+
+MIX © Alpha Bravo

test/fixtures/definitions-ignore-false/package.json

@@ -0,0 +1,4 @@
+{
+  "license": "MIX",
+  "author": "Alpha Bravo"
+}

test/fixtures/definitions-ignore-false/readme.md

@@ -0,0 +1,5 @@
+# [PI][]
+
+## License
+
+[pi]: https://en.wikipedia.org/wiki/Pi

test/fixtures/definitions/output.md

@@ -0,0 +1,7 @@
+# [PI][]
+
+## License
+
+MIX © Alpha Bravo
+
+[pi]: https://en.wikipedia.org/wiki/Pi

test/fixtures/definitions/package.json

@@ -0,0 +1,4 @@
+{
+  "license": "MIX",
+  "author": "Alpha Bravo"
+}

test/fixtures/definitions/readme.md

@@ -0,0 +1,5 @@
+# [PI][]
+
+## License
+
+[pi]: https://en.wikipedia.org/wiki/Pi

test/fixtures/other-headings/output.md

@@ -0,0 +1,7 @@
+# PI
+
+## License
+
+MIX © Alpha Bravo
+
+## Other

test/fixtures/other-headings/package.json

@@ -0,0 +1,4 @@
+{
+  "license": "MIX",
+  "author": "Alpha Bravo"
+}

test/fixtures/other-headings/readme.md

@@ -0,0 +1,5 @@
+# PI
+
+## License
+
+## Other