Improve comment rewriting with normalize_comments == false

Only change multiline comments of the form

```rust
/*
 * Text
 */
```

while not affecting comments of the form

```rust
/*
Text
*/
```

when normalize_comments is off. In the first case,
we have a known character we can align against, while
we don't have one in the second case.

Before, we have converted the second form into the first,
but this is against the spirit of normalize_comments being
turned off.

Fixes #956

Add three new options for spaces

Update to latest Syntex

+ Cargo update
+ 0.6.2 release

Merge pull request #1151 from sinkuu/issue1021

Fix #1021: Handle `..` in tuple / tuple struct patterns

Fix #1021: Handle `..` in tuple / tuple struct patterns

Split impl at 'for' if a line break is needed (#1148)

* Split impl at 'for' if a line break is needed

* Fix formatting

* Improve comments

* Skip second try if there is no 'for'

* Restore intentional trailing whitespace

* Change test source to be incorrectly formatted

* Restore more missing trailing whitespace

* Remove too much whitespace...

Really should learn how to use git revert.

Merge pull request #1147 from brettcannon/patch-1

Put rustfmt on PATH so `cargo fmt` works on Travis

Put rustfmt on PATH so `cargo fmt` works on Travis

Closes #1143

Merge pull request #1135 from sinkuu/clippy

Run clippy

Run clippy

Merge pull request #1134 from sinkuu/issue977

Fix #977

Fix #977

Merge pull request #1142 from kamalmarhubi/fix-1140

Check term supports colour before printing fancy diffs

Check term supports colour before printing fancy diffs

For a terminal like DUMB, we were still attempting to print colourful
diffs, which failed with a `NotSupported` error.

Fixes #1140

Merge pull request #1138 from johannhof/travis-docs

Add instructions on how to run rustfmt on Travis

Add instructions on how to run rustfmt on Travis

This adds very simplistic instructions on how to run rustfmt on CI.

I also wrote a blog post for more details: http://johannh.me/blog/rustfmt-ci.html

Fix issue 1124 - detect start of output rather than start of input file when writing output source file (#1133)

* Change required to prevent a trailing space at the end of a separate module being propagated

* Detect the start of the output file rather than the start of the input file when deciding whether to output preceding snippets - this stops unnecessary whitespace and blank lines from being inserted when spans and statements are output in an order other than that from the input file.

* Add code to prevent space from being added with the prefix snippet if a) the snippet is entirely horizontal whitespace, or b) the snippet contains whitespace  followed by a newline. This prevents trailing spaces at the end of a line from being added.

* Tests for this issue

* Tidy up `match` statements

* Add test with blank lines between `use` statements

v0.6.0

Merge pull request #1123 from juicejitsu/807

Don't emit filename in diff mode, add filename to diff metadata

Fix #1120 - rework how the use list prefix is determined. (#1121)

* Fix #1120 - rework how the use list prefix is determined.

* Added test commentary & another test case

Merge pull request #1122 from studoot/add-test-for-1111

Add test case for issue #1111

Don't emit filename in diff mode, add filename to diff metadata

Add commentary

Reformat the source to actually pass the tests!

Add test case for issue #1111, by adding another route by which a test file's config can be located

Merge pull request #1119 from HighCommander4/issue1109b

Apply space_before_type_annotation to struct ctors (#1109)

Apply space_before_type_annotation to struct ctors (#1109)

Merge pull request #1117 from pepyakin/issue-1116

Fix underflow in format_imports

Fix issue-1116

Merge pull request #1110 from HighCommander4/issue1109a

Add two new whitespace options (#1109)

Merge pull request #1118 from julienXX/change-multirust-to-rustup-in-readme

Update README with Rustup.rs instead of multirust

Update README with Rustup.rs instead of multirust

Add two new whitespace options (#1109)

* An option to leave a space before the colon in a type annotation

* An option to leave a space before the colon in a trait or lifetime bound

Merge pull request #1052 from julienXX/fix-imports-with-absolute-paths

Fix imports with absolute paths

Fix imports with absolute paths

Fix overlong function signature (#1089)

* Fix issue-1049

* Add testcase suggested by pepyakin

* Fix last commit

* Handle special case

* Remove debugging println

* Fix grammar in comment

* Change word in comment

* Add test for long func without ret type

* Add one more test

Multiple config file names feature (#1101)

* Add multiple configuration file names feature

* Add '.rustfmt.toml' in README file

* Clean up configuration file code

* Make config file names constant

* Use only one blank line

Fix overlong impl (#1091)

* Fix issue-1048

* Take possible where-clause into account

* Move test to existing test set

* Fix wrong variable name

Add `use` declaration re-ordering (#1104)

* Add config options for combinations of lines and items

* Reordering of import lines implemented.

* Changed nested matches to tuple pattern matching

* Added ordering of path list items to the ordering of use declarations

* Move `format_imports` and `format_import` methods to `imports.rs`

* Add comment to explain how `use` declarations are split off while walking through a module

* Change `ImportReordering` config option to separate boolean options

Canonicalize file paths within the map of file line ranges (#1098)

* Canonicalize file paths within the map of file line ranges

* Forgot to run the tests - and of course, the formatting of the canonicalization change was off, but it's fixed now!

* Move imports to the top of the file, as per @nrc.

* Change `canonicalize_path_string` to return `Option<String>`, `None` indicating an error rather than an empty string

* `format!` is better than string concatenation...

* Change `canonicalize_path_string` to return `Result` rather than `Option`

Merge pull request #1100 from studoot/add-appveyor-support

Add Appveyor CI support

Add appveyor CI support

Merge pull request #1088 from sinkuu/issue_1086

Fix formatting empty block comments (`/**/`)

Fix formatting empty block comments (`/**/`)

issue #1086

Merge pull request #1084 from johannhof/rustfmt-not-found

Show more helpful error if rustfmt is not in PATH.

Show more helpful error if rustfmt is not in PATH.

This fixes #1071.

Merge pull request #1083 from KaivoAnastetiks/fix/easy-issue-repo

Links to the rust-lang-nursery/rustfmt issue list.

rustup

Links to the rust-lang-nursery/rustfmt issue list.

Merge pull request #1075 from johannhof/diff-exit

Return failure exit code on found diffs (fix #906)

Return failure exit code on found diffs (fix #906)

This changes rustfmt to return exit code 4
when run with write mode diff and differences between
the formatted code and the original code are found.

Useful for CI to make sure your contributors actually ran rustfmt.

Merge pull request #1064 from dato/patch-2

Fix typo in path: ~/cargo/bin → ~/.cargo/bin

Fix typo in path: ~/cargo/bin → ~/.cargo/bin

Merge pull request #1054 from sanxiyn/loop-width

Fix width computation in Loop::rewrite

Fix width computation in Loop::rewrite

Include git commit and worktree status in version output (#1060)

This will help in debugging issues as rustfmt gets more users.

If the working tree is clean, output looks like

    $ target/debug/rustfmt -V
    0.5.0 (9f5ed3b)

If the working tree is dirty, output looks like

    $ target/debug/rustfmt -V
    0.5.0 (9f5ed3b worktree dirty)

If git is unavailable, output looks like

    $ target/debug/rustfmt -V
    0.5.0 (git commit unavailable)

To avoid rebuilds on changing tests, the build script will only rerun if
files under src/ are changed. This means the actual git status may show
changed files and this would not show up in the version. This should not
be an issue as files not in src/ should not affect the build output.

Merge pull request #1061 from marcusklaas/fix-subtract2

Fix integer underflow in extra_offset

Fix integer underflow in extra_offset

Merge pull request #1059 from marcusklaas/fix-subtract

Fix integer underflow

Fix integer underflow

Merge pull request #1042 from imjacobclark/1014-refactoring-vector-string-to-join

Refactor string collects to itertools join

Refactoring exsisting filter_maps to maps

Refactor string collects to itertools join

Merge pull request #1033 from marcusklaas/assignment-break

Add test for general assignment breaks

Merge pull request #1032 from marcusklaas/else-if-let-overflow

Fix constraints on pattern formatting of else arms

Add test for general assignment breaks

Fix constraints on pattern formatting of else arms

Merge pull request #1030 from nokaa/master

Update Vim integration instructions

Update Vim integration instructions

Merge pull request #1016 from rust-lang-nursery/try-double-indent

Treat chains with just expr? specially.

Add support for the `default` keyword (#1025)

Adds support for Defaultness on impl methods.
Fixes #945

Merge pull request #1023 from kamalmarhubi/diff-color-fix

print_diff: Don't print color codes if output is not a tty

print_diff: Don't print color codes if output is not a tty

On unix, `term::stdout()` just reads the `TERM` environment variable to
decide what features are available. It does not check if the output file
descriptor is in fact a tty. This resulted in printing escape codes when
redirecting output.

Merge pull request #1007 from kamalmarhubi/basic-line-ranges-v2

Add infrastructure for formatting specific line ranges

README: Explain that --file-lines ranges are 1-based

Explain that FileLines cannot be given in rustfmt.toml

This adds a note to both the `--config-help` output for `file_lines`,
and to the panic message on attempting to deserialize a `FileLines`
struct.

codemap: Add module description

Add copyright notices to added files

rustfmt: Add option to specify line ranges for formatting

This commit adds the `--experimental-file-lines` option to rustfmt. This
allows specifying line ranges to format from the command line.

Refs #434

visitor: Handle specified line ranges in visit_stmt

This commit adds a very rough implementation of handling the specified
line ranges in `config.file_lines_map` for statements. It reformats a
statement if its span is fully contained in the set of lines specified
for the file.

The implementation here is intended as a proof of concept, and
demonstration that the machinery added in the preceding commits is
functional. A final implementation would likely hook in via the
`Rewrite` trait.

Refs #434

Add type to represent collection of lines in files

This commit adds a type to represent lines in files, and adds it to the
`Config` struct. It will be used for restricting formatting to specific
lines.

Refs #434

codemap: Add utilities for looking up line ranges of spans

This commit adds extension methods to `Codemap` to allow looking up line
ranges for spans.

Refs #434

utils: Move codemap related utilities to a dedicated module

This commit adds a `codemap` module, and moves the `CodemapSpanUtils`
added in #857 to it. This is preparation for adding more `Codemap`
specific utilities.

Refs #434

visitor: Add debug log for FmtVisitor::visit_stmt()

Derive Debug for the Input enum

Merge pull request #1017 from marcusklaas/tweak-if-else

Format non-statement if-else expressions on a single line

Merge pull request #1022 from kamalmarhubi/update-syntex-syntax

deps: Update syntex_syntax to 0.33

Merge pull request #1015 from srinivasreddy/readme

Add section - Installing from source

deps: Update syntex_syntax to 0.33

This bump brings syntex_syntax support for `..` in tuple and tuple
struct patterns, which come from RFC 1492:
  https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md

These new patterns are not properly handled in this PR; instead #1021
tracks supporting them.

Refs #1021

Format non-statement if-else expressions on a single line

Treat chains with just expr? specially.

Fixes #1004

Add section - Installing from source

Handle pub(restricted) (#1013)

* Handle pub(restricted)

This commit properly handles pub(restricted) as introduced in RFC 1422
[0]. The syntax support was added in #971, but they were not correctly
formatted.

[0] https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md

Fixes #970

* Drop #[inline] attribute on format_visibility

* Make newly non-failing functions return String

The change to `format_visibiilty` means that `format_header` and
`format_unit_struct` can no longer fail. Their return type is updated to
reflect that.

Merge pull request #1008 from rust-lang-nursery/hrtb

Don't ignore universal quantification in function types

Don't ignore universal quantification in function types

Fixes #1006

Merge pull request #1009 from rust-lang-nursery/fn-args-1

Fix off by 2 error in function sigs

Fix off by 2 error in function sigs

Fixes #1000

This is a little conservative in some cases, but better than being wrong in others.

Don't put a newline before `?` when it is the second sub-expression in a chain (#1012)

Fixes #1003

Optionally put short struct variants on one line (#997)

Closes #418

Format inline attributes on out-of-line modules (#996)

Fixes #838