message: Remove the docs to pipe in graphics::pipe
diff: //! a [`SpriteBatch`](spritebatch/struct.SpriteBatch.html), which can be orders
  //! of magnitude more efficient than individual
  //! draw calls.
  -//!
  -//! The `pipe` module is auto-generated by `gfx_defines!`. You shouldn't need to
  -//! touch it, but alas we can't exclude it from `cargo doc`.
  use std::collections::HashMap;
  use std::convert::From;
  @@ -360,24 +357,37 @@ gfx_defines! {
  constant Globals {
  mvp_matrix: [[f32; 4]; 4] = "u_MVP",
  }
  +}
  - // Internal structure containing graphics pipeline state.
  - // This can't be a doc comment though because it somehow
  - // breaks the gfx_defines! macro though. :-(
  - pipeline pipe {
  - vbuf: gfx::VertexBuffer<Vertex> = (),
  - tex: gfx::TextureSampler<[f32; 4]> = "t_Texture",
  - globals: gfx::ConstantBuffer<Globals> = "Globals",
  - rect_instance_properties: gfx::InstanceBuffer<InstanceProperties> = (),
  - // The default values here are overwritten by the
  - // pipeline init values in `shader::create_shader()`.
  - out: gfx::RawRenderTarget =
  - ("Target0",
  - gfx::format::Format(gfx::format::SurfaceType::R8_G8_B8_A8, gfx::format::ChannelType::Srgb),
  - gfx::state::ColorMask::all(), Some(gfx::preset::blend::ALPHA)
  +pub(crate) mod pipe {
  + use super::{Globals, InstanceProperties, Vertex};
  +
  + gfx_pipeline_inner! {
  + vbuf: gfx::VertexBuffer<Vertex>,
  + tex: gfx::TextureSampler<[f32; 4]>,
  + globals: gfx::ConstantBuffer<Globals>,
  + rect_instance_properties: gfx::InstanceBuffer<InstanceProperties>,
  + out: gfx::RawRenderTarget,
  + }
  +
  + pub fn new() -> Init<'static> {
  + Init {
  + vbuf: (),
  + tex: "t_Texture",
  + globals: "Globals",
  + rect_instance_properties: (),
  + out: (
  + "Target0",
  + gfx::format::Format(
  + gfx::format::SurfaceType::R8_G8_B8_A8,
  + gfx::format::ChannelType::Srgb,
  + ),
  + gfx::state::ColorMask::all(),
  + Some(gfx::preset::blend::ALPHA),
  ),
  }
  }
  +}
  impl fmt::Display for InstanceProperties {
  fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
  