initial commit

node_modules/gulp-concat/README.md

@@ -0,0 +1,89 @@
+![status](https://secure.travis-ci.org/contra/gulp-concat.svg?branch=master)
+
+## Installation
+
+Install package with NPM and add it to your development dependencies:
+
+`npm install --save-dev gulp-concat`
+
+## Information
+
+<table>
+<tr>
+<td>Package</td><td>gulp-concat</td>
+</tr>
+<tr>
+<td>Description</td>
+<td>Concatenates files</td>
+</tr>
+<tr>
+<td>Node Version</td>
+<td>>= 0.10</td>
+</tr>
+</table>
+
+## Usage
+
+```js
+var concat = require('gulp-concat');
+
+gulp.task('scripts', function() {
+  return gulp.src('./lib/*.js')
+    .pipe(concat('all.js'))
+    .pipe(gulp.dest('./dist/'));
+});
+```
+
+This will concat files by your operating systems newLine. It will take the base directory from the first file that passes through it.
+
+Files will be concatenated in the order that they are specified in the `gulp.src` function. For example, to concat `./lib/file3.js`, `./lib/file1.js` and `./lib/file2.js` in that order, the following code will create a task to do that:
+
+```js
+var concat = require('gulp-concat');
+
+gulp.task('scripts', function() {
+  return gulp.src(['./lib/file3.js', './lib/file1.js', './lib/file2.js'])
+    .pipe(concat('all.js'))
+    .pipe(gulp.dest('./dist/'));
+});
+```
+
+To change the newLine simply pass an object as the second argument to concat with newLine being whatever (\r\n if you want to support any OS to look at it)
+
+For instance:
+
+```js
+.pipe(concat('main.js', {newLine: ';'}))
+```
+
+To specify `cwd`, `path` and other [vinyl](https://github.com/wearefractal/vinyl) properties, gulp-concat accepts `Object` as first argument:
+
+```js
+var concat = require('gulp-concat');
+
+gulp.task('scripts', function() {
+  return gulp.src(['./lib/file3.js', './lib/file1.js', './lib/file2.js'])
+    .pipe(concat({ path: 'new.js', stat: { mode: 0666 }}))
+    .pipe(gulp.dest('./dist'));
+});
+```
+
+This will concat files into `./dist/new.js`.
+
+### Source maps
+
+Source maps can be generated by using [gulp-sourcemaps](https://www.npmjs.org/package/gulp-sourcemaps):
+
+```js
+var gulp = require('gulp');
+var concat = require('gulp-concat');
+var sourcemaps = require('gulp-sourcemaps');
+
+gulp.task('javascript', function() {
+  return gulp.src('src/**/*.js')
+    .pipe(sourcemaps.init())
+      .pipe(concat('all.js'))
+    .pipe(sourcemaps.write())
+    .pipe(gulp.dest('dist'));
+});
+```