From 267b56d49526ab51ee0cdc94c9dc1815f0c08adb Mon Sep 17 00:00:00 2001
From: Michael Davidsaver <mdavidsaver@gmail.com>
Date: Tue, 10 Feb 2026 18:23:55 -0800
Subject: [PATCH] doc

---
 modules/libcom/src/misc/epicsString.h | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/modules/libcom/src/misc/epicsString.h b/modules/libcom/src/misc/epicsString.h
index eee26553a..5b36ebb94 100644
--- a/modules/libcom/src/misc/epicsString.h
+++ b/modules/libcom/src/misc/epicsString.h
@@ -156,6 +156,15 @@ LIBCOM_API int epicsStrnGlobMatch(const char *str, size_t len, const char *patte
  /** \brief Extract tokens from string
   *
   * Implements strtok_r from the C standard library
+  *
+  * @code
+  * char *input = ...; // string will be temporarily modified
+  * char *saved = nullptr;
+  * for(char* word = epicsStrtok_r(input, " ", &saved)
+  *     ; word
+  *     ; word = epicsStrtok_r(NULL, " ", &saved))
+  * { } // act on word
+  * @endcode
   */
 LIBCOM_API char * epicsStrtok_r(char *s, const char *delim, char **lasts);