2 files changed, 21 insertions, 9 deletions

diff --git a/bootstrap/neovim-win.ps1 b/bootstrap/neovim-win.ps1
index 1ea3b3c..8af6140 100644
--- a/bootstrap/neovim-win.ps1
+++ b/bootstrap/neovim-win.ps1
@@ -12,11 +12,14 @@
     .\bootstrap\neovim-win.ps1
 
   Hinweis: Einzelne winget-Paket-IDs (v.a. GnuWin32.Gawk, GnuWin32.Libxml2,
-  google.yamlfmt, mvdan.shfmt, astral-sh.ruff, zig.zig) konnten in dieser
-  Session nicht gegen eine aktuelle winget-Quelle verifiziert werden.
-  Schlaegt eine Installation fehl, meldet das Skript das als Warnung
-  (bricht nicht ab) und nennt den Befehl zum manuellen Nachschlagen
-  ("winget search <name>").
+  google.yamlfmt, mvdan.shfmt, astral-sh.ruff) konnten in dieser Session
+  nicht gegen eine aktuelle winget-Quelle verifiziert werden. Schlaegt eine
+  Installation fehl, meldet das Skript das als Warnung (bricht nicht ab)
+  und nennt den Befehl zum manuellen Nachschlagen ("winget search <name>").
+
+  C-Compiler fuer nvim-treesitter: kein winget-Paket enthalten, da MSVC auf
+  den Zielsystemen bereits vorhanden ist. Neovim muss dafuer aus einer
+  "Developer PowerShell for VS" gestartet werden (siehe Install-Tools).
 #>
 
 $ErrorActionPreference = "Stop"
@@ -122,8 +125,13 @@ function Install-Tools {
   Install-WingetPackage -Binary "fd" -Id "sharkdp.fd"
   Install-NpmPackage -Binary "tree-sitter" -Package "tree-sitter-cli"
 
-  # C-Compiler, damit nvim-treesitter Parser kompilieren kann.
-  Install-WingetPackage -Binary "zig" -Id "zig.zig"
+  # C-Compiler fuer nvim-treesitter: kein winget-Paket noetig, MSVC (cl.exe)
+  # ist auf diesen Systemen bereits vorhanden. nvim-treesitter findet cl.exe
+  # automatisch, ABER nur wenn INCLUDE/LIB gesetzt sind - das passiert nicht
+  # in einer normalen PowerShell, sondern nur in einer "Developer PowerShell
+  # for VS" bzw. "x64 Native Tools Command Prompt". Neovim also immer aus
+  # so einer Shell heraus starten, sonst schlaegt die Parser-Kompilierung
+  # mit "cannot find <header>.h" o.ae. fehl, obwohl cl.exe selbst gefunden wird.
 
   # opt.makeprg = "gmake" (nvim/lua/config/options.lua) - Alias liegt in
   # windows/bin/gmake.cmd, reicht an "make" durch. Einmalig windows\bin
diff --git a/neovim-windows-setup.md b/neovim-windows-setup.md
index 935bb68..4faecd8 100644
--- a/neovim-windows-setup.md
+++ b/neovim-windows-setup.md
@@ -13,6 +13,7 @@ Alle Windows-Skripte in diesem Repo sind reines PowerShell (kein Git Bash, kein
 - **Nach jedem Skript-Lauf ein neues Terminal öffnen**, bevor `nvim` das erste Mal gestartet wird. PATH-Änderungen (durch winget/npm-Installer oder `install-win.ps1`) landen in der Registry, aber die aktuell offene Shell bekommt das nicht automatisch mit.
 - **PATH-Registrierung stichprobenartig prüfen**, vor allem bei den GnuWin32-Paketen (`jq`, `gawk`, `make`, `libxml2`/`xmllint`) – ältere/portable winget-Pakete tragen sich nicht immer automatisch in den PATH ein. Nach einem neuen Terminal kurz `Get-Command jq, gawk, make, xmllint` aufrufen; fehlt eins, dessen Installationsordner manuell zum User-PATH hinzufügen (gleiches Muster wie `Add-BinToUserPath` in `install-win.ps1`).
 - **Reihenfolge**: `install-win.ps1` und `bootstrap/neovim-win.ps1` sind unabhängig voneinander, `bootstrap/neovim-dict-win.ps1` ebenso. Empfehlenswert: erst Neovim/Git/Node (Abschnitt 1) installieren, dann beide Bootstrap-Skripte laufen lassen, dann neues Terminal öffnen, dann `nvim` starten (lädt beim ersten Start automatisch alle Lua-Plugins via `lazy.nvim` – Internetverbindung nötig).
+- **Neovim immer aus einer "Developer PowerShell for VS" starten** (Startmenü-Eintrag, den Visual Studio/die Build Tools mitbringen), nicht aus normalem Windows Terminal/PowerShell. `cl.exe` (MSVC) braucht die `INCLUDE`/`LIB`-Umgebungsvariablen aus `vcvarsall.bat`, die nur in dieser Developer-Shell gesetzt sind – siehe Abschnitt 4.
 
 ## 1. Grundwerkzeuge installieren
 
@@ -22,7 +23,7 @@ winget install Git.Git
 winget install OpenJS.NodeJS.LTS
 ```
 
-(Kein Python nötig – der Python-Provider ist in `options.lua` deaktiviert, siehe Abschnitt 4.)
+(Kein Python nötig – der Python-Provider ist in `options.lua` deaktiviert. Auch kein separater C-Compiler nötig – MSVC ist auf den Zielsystemen bereits vorhanden, siehe Abschnitt 3/4.)
 
 ## 2. Konfiguration einrichten (Windows-nativer Weg)
 
@@ -49,7 +50,9 @@ Nach Änderungen im Repo `install-win.ps1` erneut ausführen, um die Kopien zu a
 .\bootstrap\neovim-win.ps1
 ```
 
-Installiert per `winget`/`npm`: Git, Node, Formatter (jq, prettier, ruff, shfmt, stylua, yamlfmt, gawk, xmllint), Tools (ripgrep, fd, tree-sitter-cli, zig als C-Compiler für Treesitter, make) und LSP-Server (basedpyright, bash-language-server, clangd, shellcheck, vscode-langservers-extracted, lua-language-server, prisma, vtsls). Einzelne Pakete, die fehlschlagen, werden als Warnung gemeldet statt das Skript abzubrechen – Details siehe Kopfkommentar im Skript (einige winget-IDs, v. a. GnuWin32.Gawk/Libxml2, google.yamlfmt, mvdan.shfmt, astral-sh.ruff, zig.zig, sind ungeprüft).
+Installiert per `winget`/`npm`: Git, Node, Formatter (jq, prettier, ruff, shfmt, stylua, yamlfmt, gawk, xmllint), Tools (ripgrep, fd, tree-sitter-cli, make) und LSP-Server (basedpyright, bash-language-server, clangd, shellcheck, vscode-langservers-extracted, lua-language-server, prisma, vtsls). Einzelne Pakete, die fehlschlagen, werden als Warnung gemeldet statt das Skript abzubrechen – Details siehe Kopfkommentar im Skript (einige winget-IDs, v. a. GnuWin32.Gawk/Libxml2, google.yamlfmt, mvdan.shfmt, astral-sh.ruff, sind ungeprüft).
+
+Kein C-Compiler-Paket enthalten: MSVC ist auf den Zielsystemen bereits vorhanden, `nvim-treesitter` nutzt `cl.exe`. Dafür muss Neovim aber aus einer "Developer PowerShell for VS" gestartet werden (siehe Abschnitt 4).
 
 `windows\bin` (enthält `gmake.cmd`, Wrapper für `opt.makeprg = "gmake"`) danach einmalig zum PATH hinzufügen (PowerShell, User-Scope – nicht `setx PATH "%PATH%;..."` verwenden, das würde den kompletten Prozess-PATH inkl. System-Anteil dauerhaft in den User-PATH kopieren):
 ```powershell
@@ -59,6 +62,7 @@ $userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
 
 ## 4. Bekannte Stolpersteine
 
+- **C-Compiler für `nvim-treesitter` (MSVC)**: `cl.exe` findet `nvim-treesitter` automatisch, aber nur wenn `INCLUDE`/`LIB` gesetzt sind – das passiert ausschließlich in einer "Developer PowerShell for VS" bzw. "x64 Native Tools Command Prompt", nicht in einer normalen PowerShell/Windows Terminal-Sitzung. Ohne das schlägt die Parser-Kompilierung mit einer Meldung wie "cannot find `<header>`.h" fehl, obwohl `cl.exe` selbst gefunden wird. Neovim also immer aus dieser Developer-Shell heraus starten.
 - **Rechtschreibprüfung (Deutsch)**: `bootstrap/neovim-dict-win.ps1` ausführen – lädt `de.utf-8.spl`/`.sug` nach `%LOCALAPPDATA%\nvim-data\site\spell` (nativer Windows-Datenpfad von Neovim).
 - **`scripts/sonarqube.sh`** (`:SonarIssues`): reines POSIX-Shellskript, kein Windows-Pendant vorhanden. Läuft nur, wenn ein `sh` im PATH liegt (z. B. `sh.exe` aus Git for Windows im PATH verfügbar machen); ansonsten `:SonarIssues` auf Windows nicht nutzen.
 - **Clipboard** (`unnamedplus`): funktioniert nativ unter Windows-Neovim ohne Zusatztool – anders als unter WSL, wo `win32yank` nötig wäre.