From Jason Turner

[fs.op.create.dir.symlk]

Diff to HTML by rtfpessoa

tmp/tmpx_lc5148/{from.md → to.md} RENAMED
@@ -1,10 +1,10 @@
1
  #### Create directory symlink <a id="fs.op.create.dir.symlk">[[fs.op.create.dir.symlk]]</a>
2
 
3
  ``` cpp
4
- void create_directory_symlink(const path& to, const path& new_symlink);
5
- void create_directory_symlink(const path& to, const path& new_symlink,
6
  error_code& ec) noexcept;
7
  ```
8
 
9
  *Effects:* Establishes the postcondition, as if by POSIX `symlink()`.
10
 
@@ -12,13 +12,13 @@ void create_directory_symlink(const path& to, const path& new_symlink,
12
  an unspecified representation of `to`.
13
 
14
  *Throws:* As specified in  [[fs.err.report]].
15
 
16
  [*Note 1*: Some operating systems require symlink creation to identify
17
- that the link is to a directory. Portable code should use
18
- `create_directory_symlink()` to create directory symlinks rather than
19
- `create_symlink()` — *end note*]
20
 
21
  [*Note 2*: Some operating systems do not support symbolic links at all
22
  or support them only for regular files. Some file systems (such as the
23
  FAT file system) do not support symbolic links regardless of the
24
  operating system. — *end note*]
 
1
  #### Create directory symlink <a id="fs.op.create.dir.symlk">[[fs.op.create.dir.symlk]]</a>
2
 
3
  ``` cpp
4
+ void filesystem::create_directory_symlink(const path& to, const path& new_symlink);
5
+ void filesystem::create_directory_symlink(const path& to, const path& new_symlink,
6
  error_code& ec) noexcept;
7
  ```
8
 
9
  *Effects:* Establishes the postcondition, as if by POSIX `symlink()`.
10
 
 
12
  an unspecified representation of `to`.
13
 
14
  *Throws:* As specified in  [[fs.err.report]].
15
 
16
  [*Note 1*: Some operating systems require symlink creation to identify
17
+ that the link is to a directory. Thus, `create_symlink()` (instead of
18
+ `create_directory_symlink()`) cannot be used reliably to create
19
+ directory symlinks. — *end note*]
20
 
21
  [*Note 2*: Some operating systems do not support symbolic links at all
22
  or support them only for regular files. Some file systems (such as the
23
  FAT file system) do not support symbolic links regardless of the
24
  operating system. — *end note*]