Update reference.md

Author: rstacruz

Makefile

@@ -21,7 +21,7 @@ legacy.js: \
 %.css: %.styl
 	(echo "/*\n\nPlease don't edit this file directly.\nInstead, edit the stylus (.styl) files and compile it to CSS on your machine.\n\n*/" ; $(STYLUS) < $<) > $@
 
-Reference.md: src/flatdoc.js
+Reference.md: flatdoc.js
 	$(DOX) -r < $< | node support/dox2md.js --default-level 3 > $@
 
 # $ make v/0.1.0

Reference.md

@@ -11,6 +11,19 @@ Flatdoc.run({
 });
 ```
 
+These fetcher functions are available:
+
+```js
+Flatdoc.github('owner/repo')
+Flatdoc.github('owner/repo', 'API.md')
+Flatdoc.github('owner/repo', 'API.md', 'branch')
+Flatdoc.bitbucket('owner/repo')
+Flatdoc.bitbucket('owner/repo', 'API.md')
+Flatdoc.bitbucket('owner/repo', 'API.md', 'branch')
+Flatdoc.file('http://path/to/url')
+Flatdoc.file([ 'http://path/to/url', ... ])
+```
+
 
 
 ### Flatdoc.run()
@@ -39,6 +52,28 @@ See [Runner#run()] for a description of fetcher functions.
 
 See: http://developer.github.com/v3/repos/contents/
 
+### Flatdoc.bitbucket()
+
+Bitbucket fetcher.
+Fetches from repo `repo` (in format 'user/repo').
+
+If the parameter `filepath` is supplied, it fetches the contents of that
+given file in the repo.
+
+See [Runner#run()] for a description of fetcher functions.
+
+See: https://confluence.atlassian.com/display/BITBUCKET/src+Resources#srcResources-GETrawcontentofanindividualfile
+See: http://ben.onfabrik.com/posts/embed-bitbucket-source-code-on-your-website
+Bitbucket appears to have stricter restrictions on
+Access-Control-Allow-Origin, and so the method here is a bit
+more complicated than for Github
+
+If you don't pass a branch name, then 'default' for Hg repos is assumed
+For git, you should pass 'master'. In both cases, you should also be able
+to pass in a revision number here -- in Mercurial, this also includes
+things like 'tip' or the repo-local integer revision number
+Default to Mercurial because Git users historically tend to use GitHub
+
 Parser
 ------
 
@@ -49,10 +84,7 @@ on the Markdown document.
 ```js
 var data = Flatdoc.parser.parse('markdown source here');
 console.log(data);
-```
 
-  
-```js
 data == {
   title: 'My Project',
   content: '<p>This project is a...',
@@ -163,6 +195,24 @@ The following options are available:
 
 See: [Flatdoc.run()]
 
+### Runner#highlight()
+
+Syntax highlighting.
+
+You may define a custom highlight function such as `highlight` from
+the highlight.js library.
+
+```js
+Flatdoc.run({
+  highlight: function (code, value) {
+    return hljs.highlight(lang, code).value;
+  },
+  ...
+});
+```
+
+
+
 ### Runner#run()
 
 Loads the Markdown document (via the fetcher), parses it, and applies it
@@ -177,6 +227,7 @@ Applies given doc data `data` to elements in object `elements`.
 [Flatdoc.run()]: #flatdoc-run
 [Flatdoc.file()]: #flatdoc-file
 [Flatdoc.github()]: #flatdoc-github
+[Flatdoc.bitbucket()]: #flatdoc-bitbucket
 [Parser]: #parser
 [Parser.parse()]: #parser-parse
 [Transformer]: #transformer
@@ -189,5 +240,6 @@ Applies given doc data `data` to elements in object `elements`.
 [Highlighters.js]: #highlighters-js
 [MenuView]: #menuview
 [Runner]: #runner
+[Runner#highlight()]: #runner-highlight
 [Runner#run()]: #runner-run
 [Runner#applyData()]: #runner-applydata