From e5fbe88708103781ee8d60f5280ea1ad4bed21f5 Mon Sep 17 00:00:00 2001 From: Ahmad Samir Date: Mon, 3 Feb 2025 00:03:53 +0200 Subject: [PATCH] QDirListing: clarify the ExcludeSpecial flag API docs Amends e583c3d5163a5512abac85e32359652e28a053f7. Pick-to: 6.9 6.8 Change-Id: I2ed231990778d03384045bc417efc58a6019fc14 Reviewed-by: Thiago Macieira --- src/corelib/io/qdirlisting.cpp | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/src/corelib/io/qdirlisting.cpp b/src/corelib/io/qdirlisting.cpp index 501f00dc86c..ffac95900cf 100644 --- a/src/corelib/io/qdirlisting.cpp +++ b/src/corelib/io/qdirlisting.cpp @@ -76,12 +76,14 @@ links to directories will be excluded too. \value ExcludeSpecial - Don't list special system files: + Don't list file system entries that are \e not directories, regular files, + nor symbolic links. \list - \li On Unix: an entry that is not a directory, regular file or - symbolic link (including broken symlinks). That is, FIFO, - socket, character device, or block device. - \li On Windows: \c {.lnk}. + \li On Unix, an example of a special file system entry is a FIFO, socket, + character device, or block device. For more details on Linux, see the + \l{https://www.man7.org/linux/man-pages/man2/mknod.2.html}{mknod manual page}. + \li On Windows (for historical reasons) \c .lnk files are considered special + file system entries. \endlist \value ResolveSymlinks