Documentation code is not formatted when format_code_in_doc_comments is enabled.

[olson-sean-k]

I'm using nightly build 1.4.4-nightly (0462008 2019-08-06) of rustfmt with the following rustfmt.toml:

control_brace_style = "ClosingNextLine"
format_code_in_doc_comments = true

When invoked with cargo +nightly fmt using this configuration, rustfmt does not format code in documentation comments. This doesn't seem to agree with the documentation for the format_code_in_doc_comments setting. Could this be a bug?

[topecongiro]

Thank you for reporting an issue. Would you mind providing us with some examples? That would be helpful to track down the bug.

[olson-sean-k]

This happens against this repository at this commit. If I intentionally "scramble" the examples, rustfmt does not reformat them as expected.

For example, this altered comment (originally from here) is left unchanged after running cargo +nightly fmt:

//! # Examples
//!
//! Indexing data for a cube to create raw buffers and a `MeshBuffer`:
//!
//! ```rust
//! # extern crate decorum;
//! # extern crate nalgebra;
//! # extern crate plexus;
//! #
//! use nalgebra::Point3;
//! use plexus::buffer::MeshBuffer3;
//! use plexus::index::{Flat3, HashIndexer};
//! use plexus::prelude::*;
//! use plexus::primitive::cube::Cube;
//! use plexus::primitive::generate::Position;
//! use decorum::N64;
//!
//! # fn main() {
//! let (indices,     positions) = Cube::new().polygons::<Position<Point3<N64>>>()
//!
//! .triangulate()
//!     .index_vertices::<Flat3, _>(HashIndexer::default())
//! ;
//! let buffer = 
//! MeshBuffer3::<u32, _>::
//! from_raw_buffers(indices, positions).unwrap();
//! # }
//! ```

I noticed this when I wrote some new documentation code. I expected rustfmt to make some changes but nothing happened. When I intentionally introduced formatting errors it still did nothing.

[topecongiro]

Thanks! It looks like rustfmt fails to format the doc comment when it contains a line with # but without any content. A minimal working example:

//! ```rust
//! #
//! # fn main() {
//!  foo ( )  ;
//! # }
//! ```