From 3a572358ae6cfafa90748178292a6e24c9ab9321 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Apr 2025 10:59:37 +0200
Subject: [PATCH] Update the build script to mention that it does not support
 Windows

---
 _build/build.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/_build/build.php b/_build/build.php
index 454553d459e..b80d8e0e51e 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -15,6 +15,13 @@
     ->addOption('generate-fjson-files', null, InputOption::VALUE_NONE, 'Use this option to generate docs both in HTML and JSON formats')
     ->addOption('disable-cache', null, InputOption::VALUE_NONE, 'Use this option to force a full regeneration of all doc contents')
     ->setCode(function(InputInterface $input, OutputInterface $output) {
+        // the doc building app doesn't work on Windows
+        if ('\\' === DIRECTORY_SEPARATOR) {
+            $output->writeln('<error>ERROR: The application that builds Symfony Docs does not support Windows. You can try using a Linux distribution via WSL (Windows Subsystem for Linux).</error>');
+
+            return 1;
+        }
+
         $io = new SymfonyStyle($input, $output);
         $io->text('Building all Symfony Docs...');