[doc] Document travisCI.getBuild

README.md

@@ -114,3 +114,74 @@ Output format is (when invoked as `travisCI.listBuild('flatiron', 'nconf', cb)`)
 ]
 ```
 
+### travisCI.getBuild(owner, repo, id, callback)
+Get build record for `id` build of `<owner>/<repo>`.
+
+Output format is (when invoked as travisCI.getBuild('flatiron', 'nconf', 325967, cb)):
+
+```json
+{ id: 325967,
+  repository_id: 3935,
+  number: '5',
+  state: 'finished',
+  started_at: '2011-11-20T21:21:36Z',
+  finished_at: '2011-11-20T21:21:58Z',
+  config:
+   { language: 'node_js',
+     node_js: [ '0.4', '0.6' ],
+     notifications: { email: [Object], irc: 'irc.freenode.org#nodejitsu' },
+     '.configured': 'true' },
+  status: 0,
+  result: 0,
+  matrix:
+   [ { id: 325968,
+       repository_id: 3935,
+       number: '5.1',
+       state: 'finished',
+       started_at: '2011-11-20T21:21:36Z',
+       finished_at: '2011-11-20T21:21:58Z',
+       config: [Object],
+       status: 0,
+       log: 'Using worker: nodejs1.worker.travis-ci.org:worker-3 (...)'
+       result: 0,
+       parent_id: 325967,
+       commit: 'ea5caa200a664d470792d76e1059f9d7d3c42e8d',
+       branch: '0.5.x',
+       message: '[refactor] Refactor to make using nconf more fluent.',
+       committed_at: '2011-11-20T21:21:09Z',
+       committer_name: null,
+       committer_email: null,
+       author_name: 'indexzero',
+       author_email: 'charlie.robbins@gmail.com',
+       compare_url: 'https://github.com/flatiron/nconf/commit/ea5caa2' },
+     { id: 325969,
+       repository_id: 3935,
+       number: '5.2',
+       state: 'finished',
+       started_at: '2011-11-20T21:21:36Z',
+       finished_at: '2011-11-20T21:21:58Z',
+       config: [Object],
+       status: 0,
+       log: 'Using worker: nodejs1.worker.travis-ci.org:worker-1 (...)'
+       result: 0,
+       parent_id: 325967,
+       commit: 'ea5caa200a664d470792d76e1059f9d7d3c42e8d',
+       branch: '0.5.x',
+       message: '[refactor] Refactor to make using nconf more fluent.',
+       committed_at: '2011-11-20T21:21:09Z',
+       committer_name: null,
+       committer_email: null,
+       author_name: 'indexzero',
+       author_email: 'charlie.robbins@gmail.com',
+       compare_url: 'https://github.com/flatiron/nconf/commit/ea5caa2' } ],
+  commit: 'ea5caa200a664d470792d76e1059f9d7d3c42e8d',
+  branch: '0.5.x',
+  message: '[refactor] Refactor to make using nconf more fluent.',
+  committed_at: '2011-11-20T21:21:09Z',
+  committer_name: null,
+  committer_email: null,
+  author_name: 'indexzero',
+  author_email: 'charlie.robbins@gmail.com',
+  compare_url: 'https://github.com/flatiron/nconf/commit/ea5caa2' }
+```
+