]> git.proxmox.com Git - mirror_xterm.js.git/commitdiff
Update documentation with cleaner license declaration
authorParis Kasidiaris <paris@sourcelair.com>
Thu, 1 Dec 2016 13:35:23 +0000 (15:35 +0200)
committerParis Kasidiaris <paris@sourcelair.com>
Thu, 1 Dec 2016 13:37:20 +0000 (13:37 +0000)
Fix #366

15 files changed:
jsdoc.json
package.json
src/CompositionHelper.ts
src/EventEmitter.js
src/Interfaces.ts
src/Viewport.ts
src/addons/attach/attach.js
src/addons/fit/fit.js
src/addons/fullscreen/fullscreen.js
src/addons/linkify/linkify.js
src/addons/terminado/terminado.js
src/handlers/Clipboard.js
src/utils/Browser.js
src/utils/Generic.js
src/xterm.js

index 6879aa2b0a42f20f1cb9bd1449fc019da04edf43..cd864c89a84e42d9bff6b340abf4a994e027cd48 100644 (file)
@@ -1,13 +1,12 @@
 {
   "source": {
     "include": [
-      "src/xterm.js",
-      "src/handlers/Clipboard.js",
-      "addons/attach/attach.js",
-      "addons/fit/fit.js",
-      "addons/fullscreen/fullscreen.js",
-      "addons/linkify/linkify.js"
-    ]
+      "src/"
+    ],
+    "exclude": [
+      "src/test/"
+    ],
+    "excludePattern": "src/.+\\.test\\.(js|ts)$"
   },
   "opts": {
     "readme": "README.md",
index 0c338451b8317966411049688f1c02655c739840..c7356a1a256e8ea19c99751346a21adab20d9596 100644 (file)
@@ -20,7 +20,7 @@
     "express": "4.13.4",
     "express-ws": "2.0.0-rc.1",
     "glob": "^7.0.5",
-    "jsdoc": "3.4.0",
+    "jsdoc": "3.4.3",
     "mocha": "2.5.3",
     "nodemon": "1.10.2",
     "pty.js": "0.3.1",
index a7f97ad19aa6f83c11d466c02a87789adbae5ece..21c0a9e92432b9159f1c41d1f82c8d0b591ee3e6 100644 (file)
@@ -1,6 +1,5 @@
 /**
- * xterm.js: xterm, in the browser
- * Copyright (c) 2014-2016, SourceLair Private Company (www.sourcelair.com (MIT License)
+ * @license MIT
  */
 
 import { ITerminal } from './Interfaces';
index cb43818ececfce7d6a76187a7756db4d196c610f..3661894857779b79bb33fb6d1fcca38fc9dbf3bc 100644 (file)
@@ -1,6 +1,5 @@
 /**
- * xterm.js: xterm, in the browser
- * Copyright (c) 2014-2016, SourceLair Private Company (www.sourcelair.com (MIT License)
+ * @license MIT
  */
 
 function EventEmitter() {
index 55cceb8b46a56387ad990c5934a49bd9f261f9a7..db1b622a79dcba3bab7bab99b3c32e32395d72f1 100644 (file)
@@ -1,6 +1,5 @@
 /**
- * xterm.js: xterm, in the browser
- * Copyright (c) 2014-2016, SourceLair Private Company (www.sourcelair.com (MIT License)
+ * @license MIT
  */
 
 export interface ITerminal {
index 8a3e4fc088287d16842043cfff1d5d4292d44e34..3aa1319fb1c74ac7ccd7f4b6b0d3a8790fd33d48 100644 (file)
@@ -1,6 +1,5 @@
 /**
- * xterm.js: xterm, in the browser
- * Copyright (c) 2014-2016, SourceLair Private Company (www.sourcelair.com (MIT License)
+ * @license MIT
  */
 
 import { ITerminal } from './Interfaces';
index 769a7e53e0567c18254071ecf54f074c4a39b913..c2a7989b4ebe35014250c71bc2595795017f5103 100644 (file)
@@ -1,9 +1,7 @@
-/*
- * Implements the attach method, that
- * attaches the terminal to a WebSocket stream.
- *
- * The bidirectional argument indicates, whether the terminal should
- * send data to the socket as well and is true, by default.
+/**
+ * Implements the attach method, that attaches the terminal to a WebSocket stream.
+ * @module xterm/addons/attach/attach
+ * @license MIT
  */
 
 (function (attach) {
 })(function (Xterm) {
   'use strict';
 
-  /**
-   * This module provides methods for attaching a terminal to a WebSocket
-   * stream.
-   *
-   * @module xterm/addons/attach/attach
-   */
   var exports = {};
 
   /**
index 7e24fd9b36e18c57ca499480d867732044a0ccf4..7b0ac14f4aa68661a9603df949067b1f1a3953e8 100644 (file)
@@ -1,16 +1,16 @@
-/*
- *  Fit terminal columns and rows to the dimensions of its
- *  DOM element.
+/**
+ * Fit terminal columns and rows to the dimensions of its DOM element.
  *
- *  Approach:
- *    - Rows: Truncate the division of the terminal parent element height
- *            by the terminal row height
+ * ## Approach
+ * - Rows: Truncate the division of the terminal parent element height by the terminal row height.
  *
- *    - Columns: Truncate the division of the terminal parent element width by
- *               the terminal character width (apply display: inline at the
- *               terminal row and truncate its width with the current number
- *               of columns)
+ * - Columns: Truncate the division of the terminal parent element width by the terminal character
+ * width (apply display: inline at the terminal row and truncate its width with the current
+ * number of columns).
+ * @module xterm/addons/fit/fit
+ * @license MIT
  */
+
 (function (fit) {
   if (typeof exports === 'object' && typeof module === 'object') {
     /*
     fit(window.Terminal);
   }
 })(function (Xterm) {
-  /**
-   * This module provides methods for fitting a terminal's size to a parent container.
-   *
-   * @module xterm/addons/fit/fit
-   */
   var exports = {};
 
   exports.proposeGeometry = function (term) {
index e4098f48a4b3ced979d0b2c360ecaa5cd6b6061e..e8e34ea3947a5cc8531af3b13598723191ca1bcd 100644 (file)
@@ -1,14 +1,7 @@
-/*
+/**
  * Fullscreen addon for xterm.js
- *
- * Implements the toggleFullscreen function.
- *
- * If the `fullscreen` argument has been supplied, then
- * if it is true, the fullscreen mode gets turned on,
- * if it is false or null, the fullscreen mode gets turned off.
- *
- * If the `fullscreen` argument has not been supplied, the
- * fullscreen mode is being toggled.
+ * @module xterm/addons/fullscreen/fullscreen
+ * @license MIT
  */
 (function (fullscreen) {
   if (typeof exports === 'object' && typeof module === 'object') {
 })(function (Xterm) {
   var exports = {};
 
+  /**
+   * Toggle the given terminal's fullscreen mode.
+   * @param {Xterm} term - The terminal to toggle full screen mode
+   * @param {boolean} fullscreen - Toggle fullscreen on (true) or off (false)
+   */
   exports.toggleFullScreen = function (term, fullscreen) {
     var fn;
 
index 2140c0aa65969d4ad5ebeeda42902db106f584cc..d23910261ddcc016ceb2870f0b999bd2ce4a1ca1 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * Methods for turning URL subscrings in the terminal's content into links (`a` DOM elements).
+ * @module xterm/addons/linkify/linkify
+ * @license MIT
+ */
+
 (function (linkify) {
   if (typeof exports === 'object' && typeof module === 'object') {
     /*
 })(function (Xterm) {
   'use strict';
 
-  /**
-   * This module provides methods for convertings valid URL substrings
-   * into HTML anchor elements (links), inside a terminal view.
-   *
-   * @module xterm/addons/linkify/linkify
-   */
   var exports = {},
       protocolClause = '(https?:\\/\\/)',
       domainCharacterSet = '[\\da-z\\.-]+',
index e17a188a559dd03384b9331e5ed7df58da169d23..86e6ea2e89c750d5d5d0ad5df2d4a9d7f723a908 100644 (file)
@@ -1,9 +1,8 @@
-/*
- * Implements the attach method that
- * attaches the terminal to a Terminado WebSocket stream.
+/**
+ * This module provides methods for attaching a terminal to a terminado WebSocket stream.
  *
- * The bidirectional argument indicates, whether the terminal should
- * send data to the socket as well and is true, by default.
+ * @module xterm/addons/terminado/terminado
+ * @license MIT
  */
 
 (function (attach) {
 })(function (Xterm) {
   'use strict';
 
-  /**
-   * This module provides methods for attaching a terminal to a WebSocket
-   * stream.
-   *
-   * @module xterm/addons/attach/attach
-   */
   var exports = {};
 
   /**
index 1cb07ebbd1f1bce81ed961d479b87c289d3c4583..70c625e4d59e3737165cafaf48a305edf5b955b3 100644 (file)
@@ -1,12 +1,8 @@
 /**
- * xterm.js: xterm, in the browser
- * Copyright (c) 2016, SourceLair Private Company <www.sourcelair.com> (MIT License)
- */
-
-/**
- * Clipboard handler module. This module contains methods for handling all
- * clipboard-related events appropriately in the terminal.
+ * Clipboard handler module: exports methods for handling all clipboard-related events in the
+ * terminal.
  * @module xterm/handlers/Clipboard
+ * @license MIT
  */
 
 /**
index 47b756eca573c833e800f6ed2b76507e81ee9b5d..cd13e02758aaf83f9e311ab5814c29665651e71f 100644 (file)
@@ -1,12 +1,7 @@
 /**
- * xterm.js: xterm, in the browser
- * Copyright (c) 2016, SourceLair Private Company <www.sourcelair.com> (MIT License)
- */
-
-/**
- * Browser utilities module. This module contains attributes and methods to help with
- * identifying the current browser and platform.
+ * Attributes and methods to help with identifying the current browser and platform.
  * @module xterm/utils/Browser
+ * @license MIT
  */
 
 import { contains } from './Generic.js';
index 9e48a721a2551c590a0e48105ee4188e9502d608..42f876f372a73ebca6bb992d3e6ec1597279e0ec 100644 (file)
@@ -1,12 +1,7 @@
 /**
- * xterm.js: xterm, in the browser
- * Copyright (c) 2016, SourceLair Private Company <www.sourcelair.com> (MIT License)
- */
-
-/**
- * Generic utilities module. This module contains generic methods that can be helpful at
- * different parts of the code base.
+ * Generic utilities module with methods that can be helpful at different parts of the code base.
  * @module xterm/utils/Generic
+ * @license MIT
  */
 
 /**
index e6482c4d74482eb0d835011db3bbfaaa6eca41e0..7f1bf63c8949836f07b04266a7c958939c9cf462 100644 (file)
@@ -1,27 +1,5 @@
 /**
  * xterm.js: xterm, in the browser
- * Copyright (c) 2014-2014, SourceLair Private Company <www.sourcelair.com> (MIT License)
- * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)
- * https://github.com/chjj/term.js
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- *
  * Originally forked from (with the author's permission):
  *   Fabrice Bellard's javascript vt100 for jslinux:
  *   http://bellard.org/jslinux/
@@ -29,6 +7,7 @@
  *   The original design remains. The terminal itself
  *   has been extended to include xterm CSI codes, among
  *   other features.
+ * @license MIT
  */
 
 import { CompositionHelper } from './CompositionHelper.js';