docs: auto-generate OPTIONS.md from emmylua comments

Author: ibhagwan

.github/workflows/vimdoc.yaml

@@ -2,7 +2,7 @@ name: vimdoc
 
 on:
   push:
-    branches: [main, vimdoc]
+    branches: [main, vimdoc, fix-gen-opts]
 
 jobs:
   generate-docs:
@@ -24,11 +24,26 @@ jobs:
         run: |
           export PACKPATH=$HOME/.local/share/nvim/site
           nvim --headless -u ~/.local/share/nvim/site/pack/vendor/start/ts-vimdoc.nvim/scripts/init.lua -c "TSUpdateSync markdown" -c "TSUpdateSync markdown_inline" -c "qa"
-      - name: Generating docs
+      - name: Generating vimdoc
         run: |
           export PATH="${PWD}/build/:${PATH}"
           export PACKPATH=$HOME/.local/share/nvim/site
           nvim --headless -u ~/.local/share/nvim/site/pack/vendor/start/ts-vimdoc.nvim/scripts/init.lua  -c "lua require('ts-vimdoc').docgen({input_file='README.md', output_file='doc/fzf-lua.txt', project_name='fzf-lua', version='For Neovim >= 0.9.0'})" -c "qa"
+          nvim --headless -u ~/.local/share/nvim/site/pack/vendor/start/ts-vimdoc.nvim/scripts/init.lua  -c "lua require('ts-vimdoc').docgen({input_file='OPTIONS.md', output_file='doc/fzf-lua-opts.txt', project_name='fzf-lua-opts', table_of_contents_lvl_min = 2, table_of_contents_lvl_max = 3, version='For Neovim >= 0.9.0'})" -c "qa"
+      - name: Install emmylua_doc_cli
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -e
+          cd
+          gh release download -R EmmyLuaLs/emmylua-analyzer-rust -p emmylua_doc_cli-linux-x64.tar.gz -D emmylua_doc_cli
+          tar xzf emmylua_doc_cli/* -C emmylua_doc_cli
+          echo "${PWD}/emmylua_doc_cli/" >> $GITHUB_PATH
+          export PATH="${PWD}/emmylua_doc_cli/:${PATH}"
+          emmylua_doc_cli --version
+      - name: Generating OPTIONS.md
+        run: |
+          nvim --headless -l scripts/gen_options.lua
       - name: Commit changes
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -39,6 +54,6 @@ jobs:
           git config user.email "actions@github"
           git config user.name "Github Actions"
           git remote set-url origin https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git
-          git add doc/fzf-lua.txt
+          git add doc OPTIONS.md
           # Only commit and push if we have changes
           git diff --quiet && git diff --staged --quiet || (git commit -m "${COMMIT_MSG}"; git push origin HEAD:${GITHUB_REF})