From 8d2c1bf4fced29d91ca360f5ab6bbe75ed5ca8a1 Mon Sep 17 00:00:00 2001
From: Tomas Juhasz <tjuhasz@redhat.com>
Date: Jul 30 2025 14:05:35 +0000
Subject: Update guidelines/modules/ROOT/pages/Directory_Replacement.adoc


Add a short note explaining the possibility that `-n` option could be necessary in order for dnf upgrade to invoke the scriplet for specfiles which build multiple packages.
---

diff --git a/guidelines/modules/ROOT/pages/Directory_Replacement.adoc b/guidelines/modules/ROOT/pages/Directory_Replacement.adoc
index dc309fe..b4fbba3 100644
--- a/guidelines/modules/ROOT/pages/Directory_Replacement.adoc
+++ b/guidelines/modules/ROOT/pages/Directory_Replacement.adoc
@@ -48,6 +48,13 @@ in packages that need this transition,
 replacing `+/path/to/dir+`
 with the path to the directory that is being converted.
 
+In cases where multiple rpms are genereted
+by a single specfile
+it may be necessary to add
+the `+-n <your_package_name>+` argument,
+to the scriplet header
+as without it the scriplet may not be invoked by dnf upon upgrade.
+
 === Scriptlet to replace a directory
 
 RPM cannot simply remove a directory