Beefy Boxes and Bandwidth Generously Provided by pair Networks
We don't bite newbies here... much

Re^2: mkdir in perldoc

by QM (Parson)
on Jan 09, 2013 at 11:41 UTC ( #1012451=note: print w/replies, xml ) Need Help??

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

Everything is a file...
Yes, but in the documentation filename is used 2 ways, first as a standin for the wordy "file system entity", and second as an ordinary file (not a directory or somesuch). But since its use in mkdir is not the generic file system entity, it's misleading. (I'm particularly amused by rmdir's description.)

Quantum Mechanics: The dreams stuff is made of

Replies are listed 'Best First'.
Re^3: mkdir in perldoc
by marto (Bishop) on Jan 09, 2013 at 11:53 UTC

    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.

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://1012451]
[haukex]: Corion: Yes exactly, in the author tests I don't worry about portability as much, I also don't list the author tests' dependencies in Makefile.PL
[haukex]: I figure someone who wants to contribute will know how to install the missing modules ;-) Not the nicest way to go but I don't think many people are using my modules yet
[ambrus]: Corion: some of these stupid syntax highlighters assume that too. just look at the table in http://perldoc. functions/pack. html for example.
[haukex]: ..."yet" ;-) I haven't had to deal with Dist::Zilla yet but I've heard about how it's a big setup
[ambrus]: I really don't like automagic stuff. I'm happy when computers do exactly what I tell them, even if that means they sometimes do the wrong thing.

How do I use this? | Other CB clients
Other Users?
Others surveying the Monastery: (14)
As of 2017-02-27 12:41 GMT
Find Nodes?
    Voting Booth?
    Before electricity was invented, what was the Electric Eel called?

    Results (385 votes). Check out past polls.