
{{alias}}( file[, options], clbk )
    Asynchronously reads the entire contents of a file.

    If provided an encoding, the function returns a string. Otherwise, the
    function returns a Buffer object.

    Parameters
    ----------
    file: string|Buffer|integer
        Filename or file descriptor.

    options: Object|string (optional)
        Options. If a string, the value is the encoding.

    options.encoding: string|null (optional)
        Encoding. Default: null.

    options.flag: string (optional)
        Flag. Default: 'r'.

    clbk: Function
        Callback to invoke upon reading file contents.

    Examples
    --------
    > function onRead( error, data ) {
    ...     if ( error ) {
    ...         console.error( error.message );
    ...     } else {
    ...         console.log( data );
    ...     }
    ... };
    > {{alias}}( './beep/boop.js', onRead );


{{alias}}.sync( file[, options] )
    Synchronously reads the entire contents of a file.

    If provided an encoding, the function returns a string. Otherwise, the
    function returns a Buffer object.

    Parameters
    ----------
    file: string|Buffer|integer
        Filename or file descriptor.

    options: Object|string (optional)
        Options. If a string, the value is the encoding.

    options.encoding: string|null (optional)
        Encoding. Default: null.

    options.flag: string (optional)
        Flag. Default: 'r'.

    Returns
    -------
    out: Error|Buffer|string
        File contents.

    Examples
    --------
    > var out = {{alias}}.sync( './beep/boop.js' );

    See Also
    --------

