You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/markdown/documentation/cli/commands.md
+22-22Lines changed: 22 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -94,31 +94,32 @@ The `cp` command can copy resources between Solid pod locations, across Solid po
94
94
If the source location is a container or directory, it will recursively copy the container and all sub-containers recursively copying the whole underlying resource tree, including empty containers.
95
95
<!-- todo: check if empty containers are included. -->
96
96
The default copying behavior ignores `.meta`, `.acl` and `.acp` resources, which can be changed using the `--all` flag.
97
-
The default behavior is to overwrite files, the `--interactive-override` and `--no-override` options provide alternative behaviors.
97
+
The copy command automatically copies the full recursive resource tree. At the moment this behavior cannot be altered.
98
+
In terms of overriding resources, the default setting is that every time a resource is found to already exist, an interactive prompt is shown.
99
+
This behavior can be altered either by the `--never-override` or the `--override` options.
98
100
99
101
#### arguments
100
102
```
101
103
Arguments:
102
-
src file or directory to be copied
103
-
dst destination to copy file or directory to
104
+
src resource or container to be copied
105
+
dst destination to copy file or directory to
104
106
```
105
107
The `src` argument is the location of the resource or container to be moved. If the URL starts with `http(s)://`, the resource is assumed to be a remote resource, if not the resource is assumed to be local and matched with the local file system. The `dst` argument is the destination to which the source resource is to be copied. Similarly it uses the `http(s)://` prefix to decide if the location is local or remote.
106
108
The default behavior ignores context resources such as `.meta`, `.acl` and `.acp` present in the directories. The `--all` flag ignores this behavior, though note that for authorization resources, as the target URIs are not edited, copying resources with these authorization resources does not imply they will result in the same access controls as the location they were copied from!
107
-
The default behavior always automatically works recursively. At the moment this behavior cannot be altered.
108
109
109
110
#### options
110
111
```
111
112
Options:
112
-
-a, --all Copy .acl files in recursive directory copies
113
-
-i, --interactive-override Interactive confirmation prompt when overriding existing resource
114
-
-n, --no-override Do not override existing files
115
-
-v, --verbose Log all read and write operations
113
+
-a, --all Copy .acl files in recursive directory copies
The `--all` option includes `.meta`, `.acl` and `.acp` files in the listing.
118
119
<br />
119
-
The `--interactive-override` option provides an interactive prompt when a copy will override an existing resource.
120
+
The `--override` option automatically overrides existing resources.
120
121
<br />
121
-
The `--no-override` option ignores existing resources.
122
+
The `--never-override` option automatically mitigates resource overrides.
122
123
<br />
123
124
The `--verbose` option shows warnings.
124
125
@@ -156,33 +157,32 @@ If the source location is a container or directory, it will recursively move the
156
157
When moving from the local file system, files will not be deleted!
157
158
<!-- todo: check if empty containers are included. -->
158
159
The default copying behavior ignores `.meta`, `.acl` and `.acp` resources, which can be changed using the `--all` flag.
159
-
The default behavior is to overwrite files, the `--interactive-override` and `--no-override` options provide alternative behaviors.
160
-
The default behavior always automatically works recursively. At the moment this behavior cannot be altered.
160
+
The move command automatically moves the full recursive resource tree. At the moment this behavior cannot be altered.
161
+
In terms of overriding resources, the default setting is that every time a resource is found to already exist, an interactive prompt is shown.
162
+
This behavior can be altered either by the `--never-override` or the `--override` options.
161
163
162
164
#### arguments
163
165
```
164
166
Arguments:
165
-
src file or directory to be moved
166
-
dst destination of the move
167
+
src resource or container to be moved
168
+
dst destination of the move
167
169
```
168
170
The `src` argument is the location of the resource or container to be moved. If the URL starts with `http(s)://`, the resource is assumed to be a remote resource, if not the resource is assumed to be local and matched with the local file system. The `dst` argument is the destination to which the source resource is to be copied. Similarly it uses the `http(s)://` prefix to decide if the location is local or remote.
169
171
The default behavior ignores context resources such as `.meta`, `.acl` and `.acp` present in the directories. The `--all` flag ignores this behavior, though note that for authorization resources, as the target URIs are not edited, copying resources with these authorization resources does not imply they will result in the same access controls as the location they were copied from!
170
172
171
-
172
-
173
173
#### options
174
174
```
175
175
Options:
176
-
-a, --all Move .acl files when moving directories recursively
177
-
-i, --interactive-override Interactive confirmation prompt when overriding existing files
178
-
-n, --no-override Do not override existing files
179
-
-v, --verbose Log all operations
176
+
-a, --all Copy .acl files in recursive directory copies
0 commit comments