Skip to content

Commit

Permalink
P1164R1 Make create_directory() Intuitive
Browse files Browse the repository at this point in the history
For create_directory copying attributes from existing_p,
- Removed 'already' from failure description, to align with
simple create_directory.
- Removed 'The signature with argument ec returns false
if an error occurs.'; this was struck in the parallel cases
and is omitted entirely (not shown as struck) in the editing
instructions.
  • Loading branch information
jensmaurer committed Mar 3, 2019
1 parent 6f34b05 commit df29285
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions source/iostreams.tex
Original file line number Diff line number Diff line change
Expand Up @@ -14742,8 +14742,6 @@
\returns \tcode{true} if a new directory was created
for the directory \tcode{p} resolves to,
otherwise \tcode{false}.
The signature with argument \tcode{ec}
returns \tcode{false} if an error occurs.

\pnum
\throws As specified in~\ref{fs.err.report}.
Expand All @@ -14767,11 +14765,11 @@
\effects Creates the directory \tcode{p} resolves to,
as if by POSIX \tcode{mkdir()} with a second argument of
\tcode{static_cast<int>(perms::all)}.
Creation failure because \tcode{p} already exists is not an error.
If \tcode{mkdir()} fails because \tcode{p} resolves to an existing directory,
no error is reported. Otherwise on failure an error is reported.

\pnum
\returns \tcode{true} if a new directory was created, otherwise \tcode{false}.
The signature with argument \tcode{ec} returns \tcode{false} if an error occurs.

\pnum
\throws As specified in~\ref{fs.err.report}.
Expand All @@ -14789,7 +14787,8 @@
directory \tcode{p} resolves to, with
attributes copied from directory \tcode{existing_p}. The set of attributes
copied is operating system dependent.
Creation failure because \tcode{p} already exists is not an error.
If \tcode{mkdir()} fails because \tcode{p} resolves to an existing directory,
no error is reported. Otherwise on failure an error is reported.
\begin{note} For POSIX-based operating systems, the
attributes are those copied by native API \tcode{stat(existing_p.c_str(), \&attributes_stat)}
followed by \tcode{mkdir(p.c_str(), attributes_stat.st_mode)}. For
Expand All @@ -14798,8 +14797,9 @@
\end{note}

\pnum
\returns \tcode{true} if a new directory was created, otherwise \tcode{false}.
The signature with argument \tcode{ec} returns \tcode{false} if an error occurs.
\returns \tcode{true} if a new directory was created
with attributes copied from directory \tcode{existing_p},
otherwise \tcode{false}.

\pnum
\throws As specified in~\ref{fs.err.report}.
Expand Down

0 comments on commit df29285

Please sign in to comment.