@mixin font-face(
  $font-family,
  $file-path,
  $weight: normal,
  $style: normal,
  $asset-pipeline: $asset-pipeline,
  $file-formats: $global-font-file-formats) {

  $font-url-prefix: font-url-prefixer($asset-pipeline);

  @font-face {
    font-family: $font-family;
    font-style: $style;
    font-weight: $weight;

    src: font-source-declaration(
      $font-family,
      $file-path,
      $asset-pipeline,
      $file-formats,
      $font-url-prefix
    );
  }
}

@charset "UTF-8";

/// Generates an @font-face declaration. Accepts arugments for weight, style, usage with the Rails Asset Pipeline and file formats.
///
/// @param {string} $font-family
/// @param {string} $file-path
/// @param {string} $weight [normal]
/// @param {string} $asset-pipeline [$asset-pipeline]
/// `$asset-pipeline` is set to `false` by default. You can pass in `true` to use the Rails Asset Pipeline (place the fonts in `app/assets/fonts/').
/// @param {list} $file-formats [$global-font-file-formats]
/// `$global-font-file-formats` is set to `null` by default. Pass a list of file formats to support. E.g. `eot woff2 woff ttf svg`.
///
/// @example scss
/// @include font-face("source-sans-pro", "source-sans-pro/source-sans-pro-regular", normal, $asset-pipeline: true, $file-formats: eot woff ttf);
///
/// @example css
/// @font-face {
///   font-family: "source-sans-pro";
///   font-style: normal;
///   font-weight: normal;
///   src: font-url("source-sans-pro/source-sans-pro-regular.eot?#iefix") format("embedded-opentype"), font-url("source-sans-pro/source-sans-pro-regular.woff") format("woff"), font-url("source-sans-pro/source-sans-pro-regular.ttf") format("truetype");
/// }
///
/// @require {function} font-url-prefixer
/// @require {function} font-source-declaration

@mixin font-face(
  $font-family,
  $file-path,
  $weight: normal,
  $style: normal,
  $asset-pipeline: $asset-pipeline,
  $file-formats: $global-font-file-formats) {

  $font-url-prefix: font-url-prefixer($asset-pipeline);

  @font-face {
    font-family: $font-family;
    font-style: $style;
    font-weight: $weight;

    src: font-source-declaration(
      $font-family,
      $file-path,
      $asset-pipeline,
      $file-formats,
      $font-url-prefix
    );
  }
}

Add documentation for font face mixin
Add documentation for font face mixin
