Improve documentation and add [future-incompat-report] config section

Author: Aaron1011

src/doc/man/cargo-report.md

@@ -37,4 +37,6 @@ Only display a report for the specified package
        cargo report future-incompat --package my-dep:0.0.1
 
 ## SEE ALSO
+[Future incompat report](../reference/future-incompat-report.html)
+
 {{man "cargo" 1}}

src/doc/man/generated_txt/cargo-report.txt

@@ -27,5 +27,8 @@ EXAMPLES
               cargo report future-incompat --package my-dep:0.0.1
 
 SEE ALSO
+       Future incompat report
+       <https://doc.rust-lang.org/cargo/reference/future-incompat-report.html>
+
        cargo(1)
 

src/doc/src/commands/cargo-report.md

@@ -38,4 +38,6 @@ Displays a report of the given _type_ - currently, only `future-incompat` is sup
        cargo report future-incompat --package my-dep:0.0.1
 
 ## SEE ALSO
+[Future incompat report](../reference/future-incompat-report.html)
+
 [cargo(1)](cargo.html)

src/doc/src/reference/config.md

@@ -87,6 +87,9 @@ ENV_VAR_NAME_2 = { value = "value", force = true }
 # Value is relative to .cargo directory containing `config.toml`, make absolute
 ENV_VAR_NAME_3 = { value = "relative/path", relative = true }
 
+[future-incompat-report]
+frequency = 'always' # when to display a notification about a future incompat report
+
 [cargo-new]
 vcs = "none"              # VCS to use ('git', 'hg', 'pijul', 'fossil', 'none')
 
@@ -1058,3 +1061,16 @@ Sets the width for progress bar.
 [revision]: https://git-scm.com/docs/gitrevisions
 [registries]: registries.md
 [crates.io]: https://crates.io/
+
+### `[future-incompat-report]`
+
+The `[future-incompat-report]` table controls setting for [future incompat reporting](../reference/future-incompat-report.html)
+
+#### `future-incompat-report.frequency`
+* Type: string
+* Default: "always"
+
+Controls how often we display a notification to the terminal when a future incompat report is available. Possible values:
+
+* `always` (default): Always display a notification when a command (e.g. `cargo build`) produces a future incompat report
+* `never`: Never display a notification

src/etc/man/cargo-report.1

@@ -43,4 +43,6 @@ cargo report future\-incompat \-\-package my\-dep:0.0.1
 .RE
 .RE
 .SH "SEE ALSO"
+\fIFuture incompat report\fR <https://doc.rust\-lang.org/cargo/reference/future\-incompat\-report.html>
+.sp
 \fBcargo\fR(1)