Processes a file's source. Adds created docObjects to docMap.
documentjs.process.file(source, docMap, [filename])
Processes a file's source and calls documentjs.process.codeAndComment accordingly. If
the file ends with
.js, each comment will be processed individually. Otherwise,
it treats the entire source as one big comment.
A files source
A map of the name of each DocObject to the DocObject
The filename. If a filename is not provided, the entire file is treated as one big comment block. If a filename is provided and is not a .md or .markdown file, it is assumed to be a source file.
An options object. Currently only the
tagsoption is used.