Make some use of `\sarg` in manual examples

[muzimuzhi]

\sarg is supported since v6.0.2 (see #193) and it is designed to represent an optional star as one of command arguments.

Currently there are two examples that document commands accepting an optional star, but for now such stars are both part of command names, hence visually non optional.

In two examples for docCommand env

I feel like \foomakedocSubKey and \foomakedocSubKey* are not a good pair of examples, since the real command \tcbmakedocSubKey doesn't have a starred form.

Either the second example for \foomakedocSubKey* can be removed or \foomakedocSubKey(*) can be replaced by some command that does have a starred form, like \section

• Current
• Suggested

  \begin{dispExample}
  \begin{docCommand}{section}{\sarg\oarg{short title}\marg{title}}
  Starts a section.
  \end{docCommand}
  \end{dispExample}
  \begin{dispExample}
  \begin{docCommand}[color definition=blue]{section}{\sarg\marg{title}}
  Starts an unnumbered section.
  \end{docCommand}
  \end{dispExample}

In the example for docCommands env

• Current
• Suggested

  \begin{dispExample}
  \begin{docCommands}[
    doc no index,  %  no index entries for this example
    doc name = newtheorem
  ]
  {
    { doc parameter = \sarg\marg{envname} },
    { doc parameter = \marg{envname}\oarg{numbered within} },
    { doc parameter = \oarg{numbered like}\marg{envname} }
  }
  example
  \end{docCommands}
  \end{dispExample}

PS: For highlighting, \sarg need to be added to \lstdefinestyle{mydocumentation}{...} in tcolorbox.doc.s_main.sty

diff --git a/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty b/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
index 5aaf1b5..f2c5339 100644
--- a/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
+++ b/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
@@ -205,6 +205,7 @@
     meta,marg,
     oarg,
     refCom,refEnv,refKey,
+    sarg,
     tcbmakedocSubKey,tcbdocmarginnote,tcbdocnew,tcbdocupdated,
     % skins
     tcbincludegraphics,tcbincludepdf,pdfpages,imagepage,imagepath,imagename,

[T-F-S]

The \foomakedocSubKey example is needed for later reference, but I can replace the \foomakedocSubKey* by a \section* example as suggested. Also, I will change the newtheorem example. Thank you.

[muzimuzhi]

resolved in eb19e7e (6.2.0 (Preview 3), 2023-11-24).

[T-F-S]

Done with https://github.com/T-F-S/tcolorbox/releases/tag/v6.2.0