Merge pull request MicrosoftDocs#4652 from TylerMSFT/smallfix

BCS2022 · web-flow · commit 64cff4c9d4df · 2022-11-03T16:45:52.000-07:00
smooth out how refer to range adaptors
diff --git a/docs/standard-library/path-class.md b/docs/standard-library/path-class.md
@@ -3,7 +3,6 @@ description: "Learn more about: path Class"
 title: "path Class"
 ms.date: 06/17/2022
 f1_keywords: ["filesystem/std::experimental::filesystem::path"]
-ms.custom: devdivchpfy22
 ---
 
 # `path` Class
@@ -63,7 +62,7 @@ class path;
 |[`is_absolute`](#is_absolute)|For Windows, the function returns `has_root_name() && has_root_directory()`. For POSIX, the function returns `has_root_directory()`.|
 |[`is_relative`](#is_relative)|Returns `!is_absolute()`.|
 |[`make_preferred`](#make_preferred)|Converts each separator to a `preferred_separator` as needed.|
-|[`native`](#native)|Returns `myname`.|
+|[`native`](#native)|Returns the native representation of the path.|
 |[`parent_path`](#parent_path)|Returns the parent path component of `myname`.|
 |[`preferred_separator`](#preferred_separator)|The constant object gives the preferred character for separating path components, depending on the host operating system. |
 |[`relative_path`](#relative_path)|Returns the relative path component of `myname`. |
@@ -436,12 +435,30 @@ path& make_preferred();
 
 ## <a name="native"></a> `path::native`
 
-Returns `myname`.
+Get the native string representation of the path.
 
 ```cpp
 const string_type& native() const noexcept;
 ```
 
+### Remarks
+
+The path is available in a portable generic format (see [`generic_string()`](#generic_string)) or the native format of the path. This function returns the native string. On a POSIX system, the generic format and the native format are the same.
+
+In the following example running on Windows 11, the generic path string is `c:/t/temp/temp.txt` and the native string is `c:\\t\\temp.txt`
+
+```cpp
+// Compile with /std:c++17 or higher
+#include <filesystem>
+
+int main()
+{
+    std::filesystem::path p(R"(c:\t\temp.txt)");
+    auto native = p.native(); // Windows: L"c:\\t\temp.txt"
+    auto generic = p.generic_string(); // Windows: "c:/t/temp.txt"
+}
+```
+
 ## <a name="op_as"></a> `path::operator=`
 
 Replaces the elements of the path with a copy of another path.
diff --git a/docs/standard-library/range-adaptors.md b/docs/standard-library/range-adaptors.md
@@ -1,11 +1,11 @@
 ---
 description: "Learn more about range adaptors, which create views on ranges."
 title: "Range adaptors"
-ms.date: 11/2/2022
+ms.date: 11/3/2022
 f1_keywords: ["ranges/std::all", "ranges/std::all_t", "ranges/std::common", "ranges/std::counted", "ranges/std::drop", "ranges/std::drop_while", "ranges/std::elements", "ranges/std::filter", "ranges/std::iota", "ranges/std::join", "ranges/std::keys", "ranges/std::lazy_split", "ranges/std::reverse", "ranges/std::split", "ranges/std::subrange", "ranges/std::take", "ranges/std::take_while", "ranges/std::transform"]
 helpviewer_keywords: ["std::ranges [C++], all", "std::ranges [C++], all_t", "std::ranges [C++], common", "std::ranges [C++], counted", "std::ranges [C++], drop", "std::ranges [C++], drop_while", "std::ranges [C++], elements", "std::ranges [C++], filter", "std::ranges [C++], iota", "std::ranges [C++], join", "std::ranges [C++], keys", "std::ranges [C++], lazy_split", "std::ranges [C++], reverse", "std::ranges [C++], split", "std::ranges [C++], subrange", "std::ranges [C++], take", "std::ranges [C++], take_while", "std::ranges [C++], transform"]
 ---
-# `ranges` adaptors
+# Range adaptors
 
 Range adaptors create a *view* (one of the [View classes](view-classes.md) in the `std::views` namespace) from a range. We recommend that you use an adaptor in `std::ranges::views` instead of creating the view types directly. The adaptors are the intended way to access views. They're easier to use, and in some cases more efficient, than creating instances of the view types directly.
 
diff --git a/docs/standard-library/range-concepts.md b/docs/standard-library/range-concepts.md
@@ -416,5 +416,5 @@ Use `std::ranges::views::all()` to convert a range to a view.
 ## See also
 
 [`<ranges>`](ranges.md)\
-[`<ranges>` adaptors](range-adaptors.md)\
+[Range adaptors](range-adaptors.md)\
 [View classes](view-classes.md)
diff --git a/docs/standard-library/ranges.md b/docs/standard-library/ranges.md
@@ -134,6 +134,6 @@ The range concepts mirror the hierarchy of iterator categories. The following ta
 ## See also
 
 [`<ranges>` functions](range-functions.md)\
-[`<ranges>` adaptors](range-adaptors.md)\
 [`<ranges>` concepts](range-concepts.md)\
+[Range adaptors](range-adaptors.md)\
 [Header files reference](../standard-library/cpp-standard-library-header-files.md)
diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml
@@ -930,8 +930,6 @@ items:
           href: range-concepts.md
         - name: <ranges> functions
           href: range-functions.md
-        - name: <ranges> adaptors
-          href: range-adaptors.md
         - name: <ranges> view classes
           href: view-classes.md
           expanded: false
@@ -980,6 +978,8 @@ items:
               href: values-view-class.md
             - name: view_interface
               href: view-interface.md
+        - name: Range adaptors
+          href: range-adaptors.md
     - name: <ratio>
       href: ratio.md
     - name: <regex>
