http://www.perlmonks.org?node_id=1012461


in reply to Re^2: mkdir in perldoc
in thread mkdir in perldoc

The entries in mkdir and rmdir state:

"Creates the directory specified by FILENAME"

"Deletes the directory specified by FILENAME if that directory is empty."

Now the Microsoft documentation states:

"Note that a directory is simply a file with a special attribute designating it as a directory, but otherwise must follow all the same naming rules as a regular file. Because the term directory simply refers to a special type of file as far as the file system is concerned, some reference material will use the general term file to encompass both concepts of directories and data files as such."

I don't find any of this misleading. If you do feel free to make a case to improve the documentation in question to those who maintain it.