chore(doc): improve documents

* docs(eg): correct document
* docs(class,Component): correct description
* docs(flicking): correct description
* docs(infiniteGrid): correct infiniteGrid
* docs(movableCoord): correct description
* docs(visible,jQueryPlugin): correct description

ref #366

Author: sculove

src/class.js

@@ -8,15 +8,15 @@ eg.module("class", [eg], function(ns) {
 
 	/**
 	 *
-	 * The Class object is used to implement object-oriented style programming
+	 * A module used to implement an application in object-oriented programming style
 	 * @group egjs
-	 * @ko Class는 어플리케이션을 객체지향 프로그래밍 방식으로 구현하는데 사용한다.
+	 * @ko 애플리케이션을 객체지향 프로그래밍 방식으로 구현할 때 사용하는 모듈
 	 * @class
 	 * @name eg.Class
 	 *
 	 * @support {"ie": "7+", "ch" : "latest", "ff" : "latest",  "sf" : "latest", "edge" : "latest", "ios" : "7+", "an" : "2.1+ (except 3.x)"}
-	 * @param {Object} def Class definition of object literal type. <ko>Class 정의부로 Object 의 <a href="https://en.wikipedia.org/wiki/Literal_(computer_programming)">리터럴 규칙</a>을 따른다. 단, "construct" 는 생성자 함수를 위해 예약된 키 값이다. </ko>
-	 * @param {Function} def.construct constructor of class. <ko>Class 생성자 함수 (Optional)</ko>
+	 * @param {Object} def definition. Follow the rules under <a href="https://en.wikipedia.org/wiki/Literal_(computer_programming)">Literals of objects</a>. Note that "construct" is a key reserved as a constructor function. <ko>클래스를 정의하는 부분. <a href="https://en.wikipedia.org/wiki/Literal_(computer_programming)">객체 리터럴 규칙</a>을 따른다. 단, 'construct'는 생성자 함수로 예약된 키다</ko>
+	 * @param {Function} [def.construct] The constructor of the class <ko>클래스 생성자 함수 (Optional)</ko>
 	 *
 	 * @example
 	 	var Some = eg.Class({
@@ -42,10 +42,10 @@ eg.module("class", [eg], function(ns) {
 		typeClass.prototype = def;
 
 		/**
-		 * Retrun instance itself.
-		 * @ko 자신의 인스턴스를 반환한다.
+		 * Returns an instance of a class itself.
+		 * @ko 클래스 자신의 인스턴스를 반환한다.
 		 * @method eg.Class#instance
-		 * @return {eg.Class} instance of itself<ko>자신의 인스턴스</ko>
+		 * @return {eg.Class} An instance of a class itself<ko>클래스 자신의 인스턴스</ko>
 		 */
 		typeClass.prototype.instance = function() {
 			return this;
@@ -55,14 +55,14 @@ eg.module("class", [eg], function(ns) {
 		return typeClass;
 	};
 	/**
-	 * Extends class
-	 * @ko extend는 Class를 상속할 때 사용한다.
+	 * Extends a class.
+	 * @ko 클래스를 상속한다.
 	 * @static
 	 * @method eg.Class.extend
-	 * @param {eg.Class} oSuperClass Super class. <ko>상속하려는 Class</ko>
-	 * @param {Object} def Class definition of object literal type. <ko>Class 정의부로 Object 의 <a href="https://en.wikipedia.org/wiki/Literal_(computer_programming)">리터럴 규칙</a>을 따른다. 단, "construct" 는 생성자 함수를 위해 예약된 키 값이다.</ko>
-	 * @param {Function} def.construct <ko>Class 생성자 함수 (Optional)</ko>
-	 * @return {eg.Class} instance of new eg.Class <ko>새로 생성된 Class 인스턴스</ko>
+	 * @param {eg.Class} oSuperClass Superclass <ko>상속하려는 클래스</ko>
+	 * @param {Object} def Class definition. Follow the rules under <a href="https://en.wikipedia.org/wiki/Literal_(computer_programming)">Literals of objects</a>. Note that "construct" is a key reserved as a constructor function. <ko>클래스를 정의하는 부분. <a href="https://en.wikipedia.org/wiki/Literal_(computer_programming)">객체 리터럴 규칙</a>을 따른다. 단, 'construct'는 생성자 함수로 예약된 키다.</ko>
+	 * @param {Function} [def.construct] The constructor of the class <ko>클래스 생성자 함수 (Optional)</ko>
+	 * @return {eg.Class} An instance of a new class <ko>새로 생성된 클래스의 인스턴스</ko>
 	 * @example
 	 	var Some = eg.Class.extend(eg.Component,{
 			"some" : function(){}

src/component.js

@@ -7,11 +7,11 @@ eg.module("component", [eg], function(ns) {
 	"use strict";
 
 	/**
-	 * Component
+	 * A class used to manage events and options in a component
 	 * @class
 	 * @group egjs
 	 * @name eg.Component
-	 * @ko 컴포넌트를 만들 때 이벤트와 옵션을 관리할 수 있도록 도와주는 클래스이다.
+	 * @ko 컴포넌트의 이벤트와 옵션을 관리할 수 있게 하는 클래스
 	 *
 	 * @support {"ie": "7+", "ch" : "latest", "ff" : "latest",  "sf" : "latest", "edge" : "latest", "ios" : "7+", "an" : "2.1+ (except 3.x)"}
 	 */
@@ -23,12 +23,12 @@ eg.module("component", [eg], function(ns) {
 			this.options = {};
 		},
 		/**
-		 * Get or set option.
-		 * @ko 옵션을 관리한다.
+		 * Sets options in a component or returns them.
+		 * @ko 컴포넌트에 옵션을 설정하거나 옵션을 반환한다
 		 * @method eg.Component#option
-		 * @param {String} key
-		 * @param {Object} [value]
-		 * @return {eg.Component|Object} (set)instance of itself or (get)option value <ko>옵션을 설정할 경우 인스턴스 자신을 반환하며, 옵션 값을 요청한 경우 해당 key에 저장된 값을 반환한다.</ko>
+		 * @param {String} key The key of the option<ko>옵션의 키</ko>
+		 * @param {Object} [value] The option value that corresponds to a given key <ko>키에 해당하는 옵션값</ko>
+		 * @return {eg.Component|Object} An instance, an option value, or an option object of a component itself.<br>- If both key and value are used to set an option, it returns an instance of a component itself.<br>- If only a key is specified for the parameter, it returns the option value corresponding to a given key.<br>- If nothing is specified, it returns an option object. <ko>컴포넌트 자신의 인스턴스나 옵션값, 옵션 객체.<br>- 키와 값으로 옵션을 설정하면 컴포넌트 자신의 인스턴스를 반환한다.<br>- 파라미터에 키만 설정하면 키에 해당하는 옵션값을 반환한다.<br>- 파라미터에 아무것도 설정하지 않으면 옵션 객체를 반환한다.</ko>
 		 * @example
 			var Some = eg.Class.extend(eg.Component);
 			var some = new Some({
@@ -65,12 +65,12 @@ eg.module("component", [eg], function(ns) {
 			return this;
 		},
 		/**
-		 * Trigger custom event.
-		 * @ko 커스텀 이벤트를 발생시킨다.
+		 * Triggers a custom event.
+		 * @ko 커스텀 이벤트를 발생시킨다
 		 * @method eg.Component#trigger
-		 * @param {String} eventName
-		 * @param {Object} customEvent
-		 * @return {Boolean}
+		 * @param {String} eventName The name of the custom event to be triggered <ko>발생할 커스텀 이벤트의 이름</ko>
+		 * @param {Object} customEvent Event data to be sent when triggering a custom event <ko>커스텀 이벤트가 발생할 때 전달할 데이터</ko>
+		 * @return {Boolean} Indicates whether the event has occurred. If the stop() method is called by a custom event handler, it will return false and prevent the event from occurring. <ko>이벤트 발생 여부. 커스텀 이벤트 핸들러에서 stop() 메서드를 호출하면 'false'를 반환하고 이벤트 발생을 중단한다.</ko>
 		 * @example
 			var Some = eg.Class.extend(eg.Component,{
 				"some": function(){
@@ -113,11 +113,11 @@ eg.module("component", [eg], function(ns) {
 			return !isCanceled;
 		},
 		/**
-		 * Check whether the event has been registered in component.
-		 * @ko 컴포넌트에 이벤트 등록 여부를 확인한다.
+		 * Checks whether an event has been attached to a component.
+		 * @ko 컴포넌트에 이벤트가 등록됐는지 확인한다.
 		 * @method eg.Component#hasOn
-		 * @param {String} eventName
-		 * @return {Boolean}
+		 * @param {String} eventName The name of the event to be attached <ko>등록 여부를 확인할 이벤트의 이름</ko>
+		 * @return {Boolean} Indicates whether the event is attached. <ko>이벤트 등록 여부</ko>
 		 * @example
 			var Some = eg.Class.extend(eg.Component,{
 				"some": function(){
@@ -129,12 +129,12 @@ eg.module("component", [eg], function(ns) {
 			return !!this.eventHandler[eventName];
 		},
 		/**
-		 * Attach an event handler function.
-		 * @ko 이벤트를 등록한다.
+		 * Attaches an event to a component.
+		 * @ko 컴포넌트에 이벤트를 등록한다.
 		 * @method eg.Component#on
-		 * @param {eventName} eventName
-		 * @param {Function} handlerToAttach
-		 * @return {eg.Component} instance of itself<ko>자신의 인스턴스</ko>
+		 * @param {eventName} eventName The name of the event to be attached <ko>등록할 이벤트의 이름</ko>
+		 * @param {Function} handlerToAttach The handler function of the event to be attached <ko>등록할 이벤트의 핸들러 함수</ko>
+		 * @return {eg.Component} An instance of a component itself<ko>컴포넌트 자신의 인스턴스</ko>
 		 * @example
 			var Some = eg.Class.extend(eg.Component,{
 				"hi": function(){},
@@ -166,12 +166,12 @@ eg.module("component", [eg], function(ns) {
 			return this;
 		},
 		/**
-		 * Detach an event handler function.
-		 * @ko 이벤트를 해제한다.
+		 * Detaches an event from the component.
+		 * @ko 컴포넌트에 등록된 이벤트를 해제한다
 		 * @method eg.Component#off
-		 * @param {eventName} eventName
-		 * @param {Function} handlerToDetach
-		 * @return {eg.Component} instance of itself<ko>자신의 인스턴스</ko>
+		 * @param {eventName} eventName The name of the event to be detached <ko>해제할 이벤트의 이름</ko>
+		 * @param {Function} handlerToDetach The handler function of the event to be detached <ko>해제할 이벤트의 핸들러 함수</ko>
+		 * @return {eg.Component} An instance of a component itself <ko>컴포넌트 자신의 인스턴스</ko>
 		 * @example
 			var Some = eg.Class.extend(eg.Component,{
 				"hi": function(){},

src/customEvent/rotate.js

@@ -13,14 +13,14 @@ eg.module("rotate", ["jQuery", eg, window, document], function($, ns, global, do
 	 * @group jQuery Extension
 	 */
 	/**
-	 * Add rotate event support in jQuery
+	 * This jQuery custom event is fired when device rotates.
 	 *
-	 * @ko 기기가 회전할 때 발생하는 jQuery의 커스텀 이벤트(rotate)이다.
+	 * @ko 기기가 회전할 때 발생하는 jQuery 커스텀 이벤트
 	 * @name jQuery#rotate
 	 * @event
-	 * @param {Event} e
-	 * @param {Object} info
-	 * @param {Boolean} info.isVertical vertical <ko>수직여부</ko>
+	 * @param {Event} e The Event object in jQuery<ko>jQuery의 Event 객체</ko>
+	 * @param {Object} info The object of data to be sent when the event is fired<ko>이벤트가 발생할 때 전달되는 데이터 객체</ko>
+	 * @param {Boolean} info.isVertical The orientation of the device (true: portrait, false: landscape) <ko>기기의 화면 방향(true: 수직 방향, false: 수평 방향)</ko>
 	 * @support { "ios" : "7+", "an" : "2.1+ (except 3.x)"}
 	 * @example
 	 * $(window).on("rotate",function(e, info){
@@ -175,10 +175,10 @@ eg.module("rotate", ["jQuery", eg, window, document], function($, ns, global, do
 	};
 
 	/**
-	 * Check if device is in portrait mode
-	 * @ko 화면이 수직방향(portrait 모드)일 경우 true 를 반환한다.
+	 * Checks whether the current orientation of the device is portrait.
+	 * @ko 기기의 화면이 수직 방향인지 확인한다
 	 * @method eg#isPortrait
-	 * @return {Boolean}
+	 * @return {Boolean} The orientation of the device (true: portrait, false: landscape) <ko>기기의 화면 방향(true: 수직 방향, false: 수평 방향)</ko>
 	 * @example
 eg.isPortrait();  // Check if device is in portrait mode
 	*/

src/customEvent/scrollEnd.js

@@ -9,14 +9,14 @@ eg.module("scrollEnd", ["jQuery", eg, window], function($, ns, global) {
 
 	// jscs:eable maximumLineLength
 	/**
-	* A jQuery custom event for "scrollEnd". It triggered when end of scrolling the page.
-	* @ko "scrollEnd" "scrollEnd" jQuery custom 이벤트. 스크롤이 끝날 때 발생한다.
+	* A custom event in jQuery occurs when scroll ends.
+	* @ko 스크롤이 끝날 때 발생하는 jQuery 커스텀 이벤트
 	* @name jQuery#scrollEnd
 	* @event
-	* @param {Event} e
-	* @param {Object} info
-	* @param {Number} info.top The number of pixels that the document has already been scrolled vertically.<ko>문서의 세로 스크롤 px</ko>
-	* @param {Number} info.left The number of pixels that the document has already been scrolled horizontally.<ko>문서의 가로 스크롤 px</ko>
+	* @param {Event} e The Event object in jQuery <ko>jQuery의 Event 객체</ko>
+	* @param {Object} info The object of data to be sent when the event is fired<ko>이벤트가 발생할 때 전달되는 데이터 객체</ko>
+	* @param {Number} info.top The size of the vertical scroll pane (unit: px)<ko>세로 스크롤 영역의 크기(단위: px)</ko>
+	* @param {Number} info.left The size of horizontal scroll pane (unit: px)<ko>가로 스크롤 영역의 크기(단위: px)</ko>
 	* @support {"ie": "9+", "ch" : "latest", "ff" : "latest",  "sf" : "latest", "edge" : "latest", "ios" : "7+", "an" : "2.1+ (except 3.x)"}
 	* @example
 	* $(window).on("scrollend",function(e, info){

src/eg.js

@@ -57,23 +57,23 @@ eg.module("eg", ["jQuery", eg, window, eg.Agent], function($, ns, global, Agent)
 
 	/**
 	 * @name eg.VERSION
-	 * @description A string containing the egjs version number.
+	 * @description The version numbers of egjs.
 	 * @ko egjs 버전
 	 */
 	ns.VERSION = "#__VERSION__#";
 	ns.hook =  {};
 	/**
-	* Get the value of user-agent information the browser.
-	* @ko 브라우저의 user-agent 정보를 반환한다.
+	* Returns the User-Agent information
+	* @ko user-agent 정보를 반환한다.
 	* @method eg#agent
 	* @return {Object} agent
-	* @return {Object} agent.os os infomation <ko>os 정보</ko>
-	* @return {String} agent.os.name os name (android, ios, window, mac) <ko>os 이름 (android, ios, window, mac)</ko>
-	* @return {String} agent.os.version os version <ko>os 버전</ko>
-	* @return {String} agent.browser browser information <ko>브라우저 정보</ko>
-	* @return {String} agent.browser.name browser name (default, safari, chrome, sbrowser, ie, firefox) <ko>브라우저 이름 (default, safari, chrome, sbrowser, ie, firefox)</ko>
-	* @return {String} agent.browser.version browser version <ko>브라우저 버전 </ko>
-	* @return {String} agent.browser.webview check to see if the browser is a webview<ko>웹뷰 브라우저 여부</ko>
+	* @return {Object} agent.os os Operating system information <ko>운영체제 정보</ko>
+	* @return {String} agent.os.name Operating system name (android, ios, window, mac) <ko>운영체제 이름 (android, ios, window, mac)</ko>
+	* @return {String} agent.os.version Operating system version <ko>운영체제 버전</ko>
+	* @return {String} agent.browser Browser information <ko>브라우저 정보</ko>
+	* @return {String} agent.browser.name Browser name (default, safari, chrome, sbrowser, ie, firefox) <ko>브라우저 이름 (default, safari, chrome, sbrowser, ie, firefox)</ko>
+	* @return {String} agent.browser.version Browser version <ko>브라우저 버전 </ko>
+	* @return {String} agent.browser.webview Indicates whether a WebView browser is available<ko>웹뷰 브라우저 여부</ko>
 	* @example
 eg.agent();
 // {
@@ -100,14 +100,14 @@ if(agent.os.name === "naver") {
 	};
 
 	/**
-	 * Get the string containing css 'translate' syntax.
+	 * Returns the syntax of the translate style which is applied to CSS transition properties.
 	 *
-	 * @ko CSS translate 구문을 반환한다.
+	 * @ko CSS 트랜지션 속성에 적용할 translate 스타일 구문을 반환한다
 	 * @method eg#translate
-	 * @param {String} x x-axis <ko>x축</ko>
-	 * @param {String} y y-axis <ko>y축</ko>
-	 * @param {Boolean} [isHA] isHWAccelerable <ko>하드웨어 가속 여부</ko>
-	 * @return {String}
+	 * @param {String} x Distance to move along the X axis <ko>x축을 따라 이동할 거리</ko>
+	 * @param {String} y Distance to move along the Y axis <ko>y축을 따라 이동할 거리</ko>
+	 * @param {Boolean} [isHA] Force hardware acceleration <ko>하드웨어 가속 사용 여부</ko>
+	 * @return {String} Syntax of the translate style <ko>translate 스타일 구문</ko>
 	 * @example
 eg.translate('10px', '200%');  // translate(10px,200%);
 eg.translate('10px', '200%', true);  // translate3d(10px,200%,0);
@@ -120,11 +120,11 @@ eg.translate('10px', '200%', true);  // translate3d(10px,200%,0);
 	};
 
 	/**
-	 * Check to see if the hardware acceleration is suitable to use.
+	 * Checks whether hardware acceleration is enabled.
 	 *
-	 * @ko 하드웨어 가속을 사용하는 것이 적합한지 확인한다.
+	 * @ko 하드웨어 가속을 사용할 수 있는 환경인지 확인한다
 	 * @method eg#isHWAccelerable
-	 * @return {Boolean}
+	 * @return {Boolean} Indicates whether hardware acceleration is enabled. <ko>하드웨어 가속 사용 가능 여부</ko>
 	 * @example
 eg.isHWAccelerable();  // Returns 'true' when hardware acceleration is supported
 
@@ -168,11 +168,11 @@ return defaultVal;
 	};
 
 	/**
-	 * Check to see CSS transition is suitable to use.
+	 * Checks whether CSS transition properties can be used.
 	 *
-	 * @ko CSS transtion을 사용하는 것이 적합한지 확인한다.
+	 * @ko CSS 트랜지션 속성을 사용할 수 있는 환경인지 확인한다.
 	 * @method eg#isTransitional
-	 * @return {Boolean}
+	 * @return {Boolean} Indicates whether CSS transition properties can be used. <ko>CSS 트랜지션 속성 사용 가능 여부</ko>
 	 * @example
 eg.isTransitional();  // Returns 'true' when CSS transition is supported.
 
@@ -225,11 +225,11 @@ return defaultVal;
 	};
 
 	/**
-	* The polyfill for 'requestAnimationFrame'
-	* @ko requestAnimationFrame 폴리필
+	* A polyfill for the window.requestAnimationFrame() method.
+	* @ko window.requestAnimationFrame() 메서드의 polyfill 함수다
 	* @method eg#requestAnimationFrame
-	* @param {Function} timer function
-	* @return {Number} key
+	* @param {Function} timer The function returned through a call to the requestAnimationFrame() method <ko>requestAnimationFrame() 메서드가 호출할 함수</ko>
+	* @return {Number} ID of the requestAnimationFrame() method. <ko>requestAnimationFrame() 메서드의 아이디</ko>
 	* @example
 		var timerId = eg.requestAnimationFrame(function() {
 			console.log("call");
@@ -240,10 +240,10 @@ return defaultVal;
 		return raf(fp);
 	};
 	/**
-	* The polyfill for 'cancelAnimationFrame'
-	* @ko cancelAnimationFrame 폴리필
+	* A polyfill for the window.cancelAnimationFrame() method. It cancels an animation executed through a call to the requestAnimationFrame() method.
+	* @ko window.cancelAnimationFrame() 메서드의 polyfill 함수다. requestAnimationFrame() 메서드로 실행한 애니메이션을 중단한다
 	* @method eg#cancelAnimationFrame
-	* @param {Number} key
+	* @param {Number} key −	The ID value returned through a call to the requestAnimationFrame() method. <ko>requestAnimationFrame() 메서드가 반환한 아이디 값</ko>
 	* @example
 		eg.cancelAnimationFrame(timerId);
 	* @see  https://developer.mozilla.org/en-US/docs/Web/API/Window/cancelAnimationFrame