From 8b7a3d6e10345753c6811cdeaae63e8a789914b4 Mon Sep 17 00:00:00 2001
From: RedYetiDev <38299977+RedYetiDev@users.noreply.github.com>
Date: Sat, 9 Nov 2024 10:59:58 -0500
Subject: [PATCH 1/2] fix(man-page): account for optional flag arguments

---
 src/generators/man-page/utils/converter.mjs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/src/generators/man-page/utils/converter.mjs b/src/generators/man-page/utils/converter.mjs
index 6352e6d8..5bc55444 100644
--- a/src/generators/man-page/utils/converter.mjs
+++ b/src/generators/man-page/utils/converter.mjs
@@ -78,7 +78,12 @@ export function flagValueToMandoc(flag) {
   }
 
   // Split the flag into the name and value based on the separator ('=' or space).
-  const value = flag.split(sep)[1];
+  let value = flag.split(sep)[1];
+
+  // If the value ends with ']', the flag's argument is optional.
+  if (value.endsWith(']')) {
+    value = '[' + value;
+  }
 
   // If there is no value, return an empty string.
   if (!value) {
@@ -89,12 +94,12 @@ export function flagValueToMandoc(flag) {
   const prefix = sep === ' ' ? '' : ' Ns = Ns';
 
   // Combine prefix and formatted value.
-  return `${prefix} Ar ${value.replace(/\]$/, '')}`;
+  return `${prefix} Ar ${value}`;
 }
 
 const formatFlag = flag =>
   // 'Fl' denotes a flag, followed by an optional 'Ar' (argument).
-  `Fl ${flag.split(/[= ]/)[0].slice(1)}${flagValueToMandoc(flag)}`;
+  `Fl ${flag.split(/\[?[= ]/)[0].slice(1)}${flagValueToMandoc(flag)}`;
 
 /**
  * Converts an API option metadata entry into the Mandoc format.

From 7e4a16cb2ab51f6424bf698a15569ad0a73e9f5c Mon Sep 17 00:00:00 2001
From: RedYetiDev <38299977+RedYetiDev@users.noreply.github.com>
Date: Sat, 9 Nov 2024 11:02:11 -0500
Subject: [PATCH 2/2] fixup! fix(man-page): account for optional flag arguments

---
 src/test/man-page.test.mjs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/test/man-page.test.mjs b/src/test/man-page.test.mjs
index 0e358d1e..3c349fbe 100644
--- a/src/test/man-page.test.mjs
+++ b/src/test/man-page.test.mjs
@@ -94,6 +94,10 @@ describe('Mandoc Conversion', () => {
           expected: ' Ns = Ns Ar value1,value2,value3',
         },
         { input: '-x', expected: '' },
+        {
+          input: '--flag[=optional value]',
+          expected: ' Ns = Ns Ar [optional value]',
+        },
       ];
       runTests(cases, flagValueToMandoc);
     });