Update Configurations.md

Update configuration tests

This commit adds following functionalities to `configuration_snippet_tests`:

1. Error if there is an unknown configuration option in Configuration.md.
2. Error if there are multiple guides for the same configuration option in
   Configuration.md.
3. Error if an user-facing configuration option does not have its guide in
   Configuration.md.

We will be able to catch outdated Configuration.md. Should prevent issues
like #2459.

Merge pull request #2480 from topecongiro/issue-2476

Avoid drifting macro body which is unformattable

Cargo clippy

Cargo fmt and update a test

Call wrap_str to make sure that the formatting macro body worked

Use multiple lines for function calls with 0 arg which exceeds max width

e.g.

foo(
)

Continue formatting function calls even if it does not fit in a single line

We may be able to format it using multiple lines.

Update tests for #2438 and #2476

Remove macros.rs

Merge pull request #2478 from csmoe/explict-version-info

Explict version info

Merge branch 'explict-version-info' of https://github.com/csmoe/rustfmt into explict-version-info

option_env and commit_info

option_env

Merge pull request #2477 from davidalber/unignore-configuration-snippet-tests

Removing ignore attribute

Removing ignore attribute

Merge pull request #2471 from topecongiro/issue-2470

Return the original snippet if the attribute contains invalid syntax

Merge pull request #2472 from davidalber/fix-reorder-extern-crates-in-group-examples

Update `reorder_extern_crates*` Configuration.md snippets

Modifying `reorder_extern_crates` example to show effect on groups

Fixing the documentation for `reorder_extern_crates_in_group`

Merge pull request #2469 from davidalber/fix-struct-lit-single-line-config-snippet

Using shorter example for `struct_lit_single_line` option

Return the original snippet if the attribute contains invalid syntax

This allows us to keep formatting the macro def with attributes that become
invalid syntax when the `$` is replaced with `z`, e.g. `#[doc = $expr]`.

explict version informations

Using shorter example for `struct_lit_single_line` option

Merge pull request #2468 from topecongiro/perf

Apply optimization suggested by perf

Merge pull request #2467 from topecongiro/issue-2466

Skip formatting macro_rules! that are not using {}

Skip formatting macro_rules! that are not using {}

Use push-approach over format! in rewrite_segment

Clean up

Use Indent::to_string_with_newline to avoid unnecessary allocation

Use SnippetProvider to implement SpanUtils over CodeMap

`SnippetProvider::span_to_snippet` avoids allocating a `String` so it is more
efficient than `CodeMap::span_to_snippet`.

Avoid running lookup_line_range when file_lines are not specified

Avoid allocating small strings in combine_strs_with_missing_comments

Avoid using pretty printer if possible

Setting a pretty printer adds noticeable overhead.

We can replace the usage in `ast:Lifetime::rewrite` by simply converting `Ident`
to string.
We can do the same thing for a macro path as long as it is not nested, which
should hold for most cases.

Do not inspect code for issues or todos when not required

Use debug_assert_eq! to avoid comparing PathBuf on release

Comparing `PathBuf` adds noticeable overhead, avoid it in release build.

Replace lookup_char_pos with lookup_line

`lookup_char_pos` wastes time on fetching unused information. We only need a
`FileMap` and line numbers, so `lookup_line` is enough.

Merge pull request #2465 from karyon/fix_2346

Fix #2346: empty comments should not have any trailing space added

Merge pull request #2461 from topecongiro/reorder-mod

Refactoring: add `reorder` modules

Merge pull request #2464 from topecongiro/beginning-vert

Format a match arm with the beginning vertical bar

Fix #2346: empty comments should not have any trailing space added

Format a match arm with the beginning vertical bar

Merge pull request #2463 from Razican/typo_fix

Fixed small typo in configuration help

Fixed small typo in configuration help

Add TODO

Get rid of macro

Rename fns

Get rid of format_imports

Move reorder-related stuffs in visitor mod to reorder mod

Move rewrite_mod to the items module

Add a reorder module

Merge pull request #2460 from matklad/simple-ci

Simplify CI exaple in the readme

Simplify CI exaple in the readme

rustfmt-preview is now in stable

Merge pull request #2421 from brotzeit/clippy

apply some clippy suggestions

Merge pull request #2454 from radix/issue-2446

Don't generate V: { f: u8, // comment }

only wrap on trailing comments, allow /* */ comments in-line

use contains_comment instead of an ad-hoc check for "//"

hacky solution that makes the tests pass but should really be better

test case for issue #2446

Merge pull request #2453 from muja/patch-1

Fix typo "carfo" -> "cargo" in changelog.

Fix typo "carfo" -> "cargo" in changelog.

Merge pull request #2450 from topecongiro/issue-37

Preserve trailing spaces in doc comments even when options are set

Preserve trailing spaces in doc comments even when options are set

Closes #37.

Merge pull request #2448 from jonathanmorley/patch-1

Rust 1.24 released, rustfmt now works on stable

Merge pull request #2443 from topecongiro/skip-children

Do not try to parse external modules when skipping children

Merge pull request #2436 from topecongiro/markdown-spaces

Preserve trailing two whitespace in comments

Merge pull request #2449 from radix/patch-1

IRC channel is now #rust-dev-tools

IRC channel is now #rust-dev-tools

Also specifically mention the IRC network (irc.mozilla.org) that the channel is on.

Rust 1.24 released, rustfmt now works on stable

Do not try to parse external modules when skipping children

Add rustfmt_skip to a test with long string

Preserve two or more trailing spaces in doc comment

rustdoc treats two or more trailing spaces as a line break.

Preserve trailing whitespaces only for doc comment

Merge pull request #2086 from jugglerchris/difflines_mode

Add a new "modified lines" write mode.

Merge pull request #2422 from davidalber/travis-config-badge

Proposal: add badge for Travis CI example status

Merge pull request #2441 from topecongiro/issue-2438

Return `None` when format_code_block may have failed

Merge pull request #2428 from PSeitz/master

scale WidthHeuristics by max_width

Adding badge and explanation for Travis CI example status

apply some clippy suggestions

Return None when format_code_block may have failed

Merge pull request #2440 from topecongiro/issue-2439

Disable formatting macro-def if args do not fit on one line

Merge pull request #2435 from davidalber/fix-option-typo

Fixing command-line option name

Merge pull request #2187 from brotzeit/master

don't print verbose output when formatting with stdin

Disable formatting macro-def if args do not fit on one line

scale WidthHeuristics by max_width

scale WidthHeuristics by max_width

Preserve trailing two whitespace in comments

Closes #2434.

Fixing command-line option name

Update comment to say that Modified is for internal use only.

Update after review comments.

Move the modified test files to the new location.

Merge remote-tracking branch 'origin/master' into difflines_mode

Merge pull request #2409 from davidalber/configuration-check-opt-out

Skipping formatting of some configuration snippets

Formatting snippets without configuration option marked as skip

don't print verbose output when formatting with stdin

Merge pull request #2432 from davidalber/remove-unused-import

Removing unused import

Merge pull request #2433 from davidalber/unhork-snippet-tests

Fixing path to Configurations.md

Fixing path to Configurations.md

Issue #2419 changed the directory in which
`configuration_snippet_tests` runs, which broke the test. Since the
test is currently annotated with `#[ignore]`, the break wasn't
caught before merge.

Removing unused import

Merge pull request #2431 from davidalber/fix-indent-style-control-flow-snippet

Fixing `indent_style` control flow examples

Merge pull request #2419 from topecongiro/core

Separate rustfmt into multiple crates