Yuki Okushi ab1ae48cce Rollup merge of #96568 - EliasHolzmann:fmt_doc_fixes, r=joshtriplett ... std::fmt: Various fixes and improvements to documentation This PR contains the following changes: - **Added argument index comments to examples for specifying precision** The examples for specifying the precision have comments explaining which argument the specifier is referring to. However, for implicit positional arguments, the examples simply refer to "next arg". To simplify following the comments, "next arg" was supplemented with the actual resulting argument index. - **Fixed documentation for specifying precision via `.*`** The documentation stated that in case of the syntax `{<arg>:<spec>.*}`, "the `<arg>` part refers to the value to print, and the precision must come in the input preceding `<arg>`". This is not correct: the <arg> part does indeed refer to the value to print, but the precision does not come in the input preciding arg, but in the next implicit input (as if specified with {}). Fixes #96413. - **Fix the grammar documentation** According to the grammar documented, the format specifier `{: }` should not be legal because of the whitespace it contains. However, in reality, this is perfectly fine because the actual implementation allows spaces before the closing brace. Fixes #71088. Also, the exact meaning of most of the terminal symbols was not specified, for example the meaning of `identifier`. - **Removed reference to Formatter::buf and other private fields** Formatter::buf is not a public field and therefore isn't very helpful in user- facing documentation. Also, the other public fields of Formatter were removed during stabilization of std::fmt (4af3494bb0) and can only be accessed via getters. - **Improved list of formatting macros** Two improvements: 1. write! can not only receive a `io::Write`, but also a `fmt::Write` as first argument. 2. The description texts now contain links to the actual macros for easier navigation.		2022-05-02 10:41:58 +09:00
..
benches	Add VecDeque::extend benchmark	2022-04-27 21:10:20 +02:00
src	Rollup merge of #96568 - EliasHolzmann:fmt_doc_fixes, r=joshtriplett	2022-05-02 10:41:58 +09:00
tests	Rollup merge of #94126 - ssomers:alloc_prep_1, r=Mark-Simulacrum	2022-05-02 10:41:54 +09:00
Cargo.toml	Switch all libraries to the 2021 edition	2021-12-23 19:03:47 +08:00