rust/library/std/src
Dylan DPC 77d063b954
Rollup merge of #102058 - mqudsi:path_extension_docs, r=thomcc
Clarify Path::extension() semantics in docs abstract

State up-front and center what shape the returned extension will have, without making the user read through the description and examples.

This is a doc-only change. There are no changes to the API contract and the clarification is in line with what was already stated/promised in the existing doc text - just clarified, summarized, and served bright and early.

Rationale: Various frameworks and libraries for different platforms have their different conventions as to whether an "extension" is ".ext" or just "ext" and anyone that's had to deal with this ambiguity in the past is always double- or triple-checking to make sure the function call returns an extension that matches the expected semantics. Offer the answer to this important question right off the bat instead of making them dig to find it.

```@rustbot``` label +A-docs
2022-09-21 19:01:09 +05:30
..
backtrace Use implicit capture syntax in format_args 2022-03-10 10:23:40 -05:00
collections Fix std::collections::HashSet::drain documentation 2022-09-02 16:35:40 +02:00
env std: move "mod tests/benches" to separate files 2020-08-31 02:56:59 +00:00
error remove fn backtrace 2022-08-01 20:10:40 +00:00
f32 Semicolon after macro_rules definition. 2022-08-15 12:33:00 +02:00
f64 Semicolon after macro_rules definition. 2022-08-15 12:33:00 +02:00
ffi Guarantee try_reserve preserves the contents on error 2022-08-10 01:51:38 +09:00
fs Ignore hiberfil_sys test in CI 2022-07-18 15:06:07 +01:00
io stdio: Document no support for writing to non-blocking stdio/stderr 2022-09-07 14:22:57 +01:00
net Simplify clippy fix. 2022-09-12 19:46:51 +02:00
num rustc_expand: Mark inner #![test] attributes as soft-unstable 2020-11-20 19:35:03 +03:00
os Rollup merge of #100767 - kadiwa4:escape_ascii, r=jackh726 2022-09-12 15:21:30 +05:30
panic review: fix nits and move panic safety tests to the correct place 2020-09-25 23:10:24 +02:00
path make many std tests work in Miri 2022-08-18 18:07:39 -04:00
personality Move personality functions to std 2022-08-23 16:12:58 +08:00
prelude Finish bumping stage0 2022-05-27 07:36:17 -04:00
process Add test for issue #95178 2022-03-23 05:33:44 +00:00
sync Auto merge of #100576 - joboet:movable_const_remutex, r=Mark-Simulacrum 2022-09-04 22:53:58 +00:00
sys Auto merge of #100581 - joboet:sync_rwlock_everywhere, r=thomcc 2022-09-20 22:00:08 +00:00
sys_common Auto merge of #100581 - joboet:sync_rwlock_everywhere, r=thomcc 2022-09-20 22:00:08 +00:00
thread doc: fix minor typo 2022-09-09 11:30:40 +02:00
time make many std tests work in Miri 2022-08-18 18:07:39 -04:00
alloc.rs Forbid mixing System with sytem allocator calls 2022-09-03 16:47:12 -05:00
ascii.rs Remove use of #[rustc_deprecated] 2022-04-14 01:33:13 -04:00
backtrace.rs Adjust backtrace stabilization version to CURRENT_RUSTC_VERSION 2022-08-27 17:08:53 +02:00
env.rs add aliases for current_dir 2022-05-24 19:41:40 -07:00
error.rs error::Error: remove some comments 2022-08-25 07:42:07 +01:00
f32.rs Improve primitive/std docs separation and headers 2022-08-20 16:50:29 -05:00
f64.rs Improve primitive/std docs separation and headers 2022-08-20 16:50:29 -05:00
fs.rs updated description of File struct in std::fs 2022-09-03 11:09:06 -07:00
keyword_docs.rs Fix a bunch of typo 2022-08-31 18:24:55 +08:00
lazy.rs Move/rename lazy::Sync{OnceCell,Lazy} to sync::{Once,Lazy}Lock 2022-06-16 19:54:42 +04:00
lib.rs Rollup merge of #101798 - y86-dev:const_waker, r=lcnr 2022-09-19 17:55:19 +02:00
macros.rs stdio: Document no support for writing to non-blocking stdio/stderr 2022-09-07 14:22:57 +01:00
num.rs Add Saturating type (based on Wrapping type) 2021-08-10 19:27:01 +02:00
panic.rs Adding backtrace off option for fuchsia targets 2022-09-14 23:54:40 +00:00
panicking.rs std: use sync::RwLock for internal statics 2022-09-19 23:27:26 +02:00
path.rs Clarify Path::extension() semantics in docs abstract 2022-09-20 11:12:03 -05:00
personality.rs Move personality functions to std 2022-08-23 16:12:58 +08:00
primitive_docs.rs array docs - advertise how to get array from slice 2022-09-10 19:37:07 -07:00
process.rs Make doc for stdin field of process consistent 2022-08-21 01:56:26 -07:00
rt.rs unix_sigpipe: Make sigpipe param docs long-form 2022-09-01 06:45:04 +02:00
time.rs Support setting file accessed/modified timestamps 2022-07-15 02:54:06 -07:00