stages/mkdir: enhance stage documentation

Explicitly mention the stage behavior with regard to setting mode on
newly created or existing directories.

Signed-off-by: Tomáš Hozza <thozza@redhat.com>
This commit is contained in:
Tomáš Hozza 2023-01-20 11:56:39 +01:00 committed by Achilleas Koutsou
parent d3a63cf056
commit db1fa5b3c3

View file

@ -3,7 +3,14 @@
Create directories within the tree.
Can create one or more directories, optionally also the
intermediate directories.
intermediate directories. The stage can gracefully handle
directories that already exist.
Please note that the stage won't change the mode of existing
directories. If you want to change the mode of an existing
directory, you need to use the `org.osbuild.chmod` stage.
Mode is applied only to newly created directories and umask
value is taken into account.
"""
import os