Re: [boost] [Filesystem V3] Filesystem Version 3 beta 1 available for download and comment

Subject: Re: [boost] [Filesystem V3] Filesystem Version 3 beta 1 available for download and comment
From: Stewart, Robert (Robert.Stewart_at_[hidden])
Date: 2010-02-18 14:14:54

Beman Dawes wrote:
> On Thu, Feb 18, 2010 at 10:35 AM, Stewart, Robert
> <Robert.Stewart_at_[hidden]> wrote:
> >
> > "stem" means nothing to me.  I followed the Reference link
> > to the path class documentation and find no description of
> > it there.
>
> Added a direct link to the reference doc description. Added an example
> to the reference doc description.

I found it.  It would be easier to understand stem() as returning p.filename() without p.extension().  Perhaps you could add that to the description ahead of the more technical description you've used.

> > Similarly, unique_path() is poorly named because "unique
> > path" is not a verbal.  The function should be named
> > "make_unique_path."
>
> I also considered "make_unique_path", but worried that people might
> expect the actual path to be created in the external file system,
> rather than just returning a path object. Does that concern you, or do
> you still consider "make_unique_path" better?

I understand your concern.  However, path does not create any files or directories in a filesystem, so why would anyone suppose "make_unique_path" would do so?  Also note that one normally speaks of "creating" a file, not "making" one.

Rob Stewart
Software Engineer, Core Software
Susquehanna International Group, LLP robert.stewart_at_[hidden]

using std::disclaimer;
http://www.sig.com

IMPORTANT: The information contained in this email and/or its attachments is confidential. If you are not the intended recipient, please notify the sender immediately by reply and immediately delete this message and all its attachments. Any review, use, reproduction, disclosure or dissemination of this message or any attachment by an unintended recipient is strictly prohibited. Neither this message nor any attachment is intended as or should be construed as an offer, solicitation or recommendation to buy or sell any security or other financial instrument. Neither the sender, his or her employer nor any of their respective affiliates makes any warranties as to the completeness or accuracy of any of the information contained herein or that this message or any of its attachments is free of viruses.