Documentation doesn't have the power to make something "not a bug". It shows that the behavior was not unintentional. But with such "powerful" justifications, can one ever hope to get the bug fixed?

But remove the trailing slash from the resulting string, because it doesn't look good,

The only "look" about it is that it makes it look like a Unix directory path, not a non-directory path. Though, I've run into enough things that just ignore trailing slashes that I've learned to append "/." (not just "/") to my directories when it really matters.

isn't necessary,

rsync, for one, disagrees. Specifying the intent that a directory is meant is often important and only "not necessary" if "in a perfect world". "mv foo bar/" is only the same as "mv foo bar" if you are 100% sure that bar already exists and is a directory.

and confuses OS/2.

Rather vague, there. That sounds like it might be a reason to strip the final '/' when on OS/2. So it might be a reason to impact the behavior of File::Spec::OS2. It is almost silly to mention that in File::Spec::Unix documentation (yes, they are two separate modules).

But I suspect the first justification is the real one and will actually end up being a powerful block against getting this improved. So more literal '/'s for all.

- tye        


In reply to Re^3: Directory Separator (none) by tye
in thread Directory Separator by Anonymous Monk

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":



  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.