Deprecate Writer::relaxEnclosure method

CHANGELOG.md

@@ -6,11 +6,11 @@ All Notable changes to `Csv` will be documented in this file
 
 ### Added
 
-- None
+- `Writer::necessaryEnclosure`
 
 ### Deprecated
 
-- None
+- `Writer::relaxEnclosure` use `Writer::necessaryEnclosure`
 
 ### Fixed
 

docs/9.0/writer/index.md

@@ -134,7 +134,7 @@ By default, `getFlushTreshold` returns `null`.
 
 ```php
 public Writer::forceEnclosure(): self
-public Writer::relaxEnclosure(): self
+public Writer::necessaryEnclosure(): self
 public Writer::noEnclosure(): self
 public Writer::encloseAll(): bool
 public Writer::encloseNecessary(): bool
@@ -149,6 +149,7 @@ With this feature, you can:
 
 <p class="message-warning">When this feature is activated the <code>$escape</code> character is completely ignored (it is the same as setting it to the empty string.)</p>
 <p class="message-warning">When no enclosure is used, the library <strong>DO NOT CHECK</strong> for multiline fields.</p>
+<p class="message-notice"><code>relaxEnclosure</code> is deprecated since version <code>9.22.0</code> and is replaced by <code>necessaryEnclosure</code></p>
 
 ```php
 <?php

src/Writer.php

@@ -226,7 +226,7 @@ public function setFlushThreshold(?int $threshold): self
         return $this;
     }
 
-    public function relaxEnclosure(): self
+    public function necessaryEnclosure(): self
     {
         $this->enclose_all = self::ENCLOSE_NECESSARY;
         $this->resetProperties();
@@ -338,4 +338,19 @@ public function setNewline(string $newline): self
     {
         return $this->setEndOfLine($newline);
     }
+
+    /**
+     * DEPRECATION WARNING! This method will be removed in the next major point release.
+     *
+     * @see Writer::necessaryEnclosure()
+     * @deprecated Since version 9.22.0
+     * @codeCoverageIgnore
+     *
+     * Sets the enclosure threshold to only enclose necessary fields.
+     */
+    #[Deprecated(message:'use League\Csv\Writer::necessaryEnclosure()', since:'league/csv:9.22.0')]
+    public function relaxEnclosure(): self
+    {
+        return $this->necessaryEnclosure();
+    }
 }

src/WriterTest.php

@@ -191,7 +191,7 @@ public function testForceEnclosure(): void
         self::assertStringContainsString('"value 2-0","value 2-1"'."\n", $csv);
         self::assertStringContainsString('"to""to","foo\"bar"'."\n", $csv);
 
-        $writer->relaxEnclosure();
+        $writer->necessaryEnclosure();
         self::assertFalse($writer->encloseAll());
     }