Merge pull request MicrosoftDocs#4128 from dpaoliello/nmake

denrea · web-flow · commit ab4dd11107c6 · 2022-02-24T12:21:21.000-08:00
Document the new NMake functions (lowercase, uppercase), add specific version information for other functions.
diff --git a/docs/build/reference/nmake-function-abspath.md b/docs/build/reference/nmake-function-abspath.md
@@ -28,7 +28,7 @@ A [list](using-an-nmake-macro.md#function-list-syntax) with each of the items fr
 
 `abspath` supports extended-length paths, either by using the `\\?\` prefix, or when long paths are enabled. For more information about long paths, see [Maximum Path Length Limitation](/windows/win32/fileio/maximum-file-path-limitation).
 
-This macro function is available starting in Visual Studio 2022, in NMAKE version 14.30 or later.
+This macro function is available starting in Visual Studio 2022 version 17.1, in NMAKE version 14.31 or later.
 
 ## Example
 
diff --git a/docs/build/reference/nmake-function-basename.md b/docs/build/reference/nmake-function-basename.md
@@ -30,7 +30,7 @@ A [list](using-an-nmake-macro.md#function-list-syntax) with each of the items fr
 
 The `basename` function is equivalent to using the [`R` modifier in a filename macro](special-nmake-macros.md#filename-macros).
 
-This macro function is available starting in Visual Studio 2022, in NMAKE version 14.30 or later.
+This macro function is available starting in Visual Studio 2022 version 17.1, in NMAKE version 14.31 or later.
 
 ## Example
 
diff --git a/docs/build/reference/nmake-function-lowercase.md b/docs/build/reference/nmake-function-lowercase.md
@@ -0,0 +1,40 @@
+---
+description: "Learn more about: lowercase NMAKE function"
+title: "lowercase NMAKE function"
+ms.date: "2/23/2022"
+helpviewer_keywords: ["lowercase NMAKE function", "NMAKE function, lowercase"]
+monikerRange: '>=msvc-170'
+---
+# `lowercase` NMAKE function
+
+Evaluates to a string where all characters have been converted to their lowercase equivalent.
+
+## Syntax
+
+```makefile
+$(lowercase input)
+```
+
+### Parameters
+
+*`input`*\
+The string to convert.
+
+## Return value
+
+Returns *`input`*, but all characters have been converted to their lowercase equivalent.
+
+## Remarks
+
+This macro function is available starting in Visual Studio 2022 version 17.2, in NMAKE version 14.32 or later.
+
+## Example
+
+```makefile
+$(lowercase Hello World!) # Evaluates to "hello world!"
+```
+
+## See also
+
+[Macros and NMAKE](macros-and-nmake.md)\
+[NMAKE functions by category](using-an-nmake-macro.md#functions-by-category)
diff --git a/docs/build/reference/nmake-function-patsubst.md b/docs/build/reference/nmake-function-patsubst.md
@@ -35,7 +35,7 @@ Returns *`input`*, but each item that matches *`pattern`* is replaced by *`repla
 
 `patsubsti` is the case-insensitive version of `patsubst`.
 
-This macro function is available starting in Visual Studio 2022, in NMAKE version 14.30 or later.
+This macro function is available starting in Visual Studio 2022 version 17.1, in NMAKE version 14.31 or later.
 
 ## Example
 
diff --git a/docs/build/reference/nmake-function-uppercase.md b/docs/build/reference/nmake-function-uppercase.md
@@ -0,0 +1,40 @@
+---
+description: "Learn more about: uppercase NMAKE function"
+title: "uppercase NMAKE function"
+ms.date: "2/23/2022"
+helpviewer_keywords: ["uppercase NMAKE function", "NMAKE function, uppercase"]
+monikerRange: '>=msvc-170'
+---
+# `uppercase` NMAKE function
+
+Evaluates to a string where all characters have been converted to their uppercase equivalent.
+
+## Syntax
+
+```makefile
+$(uppercase input)
+```
+
+### Parameters
+
+*`input`*\
+The string to convert.
+
+## Return value
+
+Returns *`input`*, but all characters have been converted to their uppercase equivalent.
+
+## Remarks
+
+This macro function is available starting in Visual Studio 2022 version 17.2, in NMAKE version 14.32 or later.
+
+## Example
+
+```makefile
+$(uppercase Hello World!) # Evaluates to "HELLO WORLD!"
+```
+
+## See also
+
+[Macros and NMAKE](macros-and-nmake.md)\
+[NMAKE functions by category](using-an-nmake-macro.md#functions-by-category)
diff --git a/docs/build/reference/using-an-nmake-macro.md b/docs/build/reference/using-an-nmake-macro.md
@@ -93,7 +93,9 @@ $(filter \\a%f,\\abcdef) # Evaluates to "\\abcdef" - any `\\` that isn't directl
 | Function | Purpose |
 |--|--|
 | [`findstring`, `findstringi`](nmake-function-findstring.md) | Checks if the input contains a string. |
+| [`lowercase`](nmake-function-lowercase.md) | Converts a string to lowercase. |
 | [`subst`, `substi`](nmake-function-subst.md) | Replaces all instances of one string with another. |
+| [`uppercase`](nmake-function-uppercase.md) | Converts a string to uppercase. |
 
 #### List functions
 
diff --git a/docs/build/toc.yml b/docs/build/toc.yml
@@ -1168,12 +1168,16 @@ items:
                       href: ../build/reference/nmake-function-filterout.md
                     - name: findstring, findstringi
                       href: ../build/reference/nmake-function-findstring.md
+                    - name: lowercase
+                      href: ../build/reference/nmake-function-lowercase.md
                     - name: patsubst, patsubsti
                       href: ../build/reference/nmake-function-patsubst.md
                     - name: strip
                       href: ../build/reference/nmake-function-strip.md
                     - name: subst, substi
                       href: ../build/reference/nmake-function-subst.md
+                    - name: uppercase
+                      href: ../build/reference/nmake-function-uppercase.md
                 - name: Special NMAKE macros
                   href: ../build/reference/special-nmake-macros.md
             - name: Inference rules
