Make ResetAcl opt-in instead of opt-out
Rob Mensching committed
Mar 16, 2021 at 16:10 UTC
6c58ee03306e50e44c6a7f57a991da9572811c49
1 file changed
+34
-2
src/WixToolset.Extensibility/Data/ILayoutContext.cs
+34
-2
@@ -6,27 +6,59 @@ namespace WixToolset.Extensibility.Data
6
using System.Collections.Generic;
7
using System.Threading;
8
9
-#pragma warning disable 1591 // TODO: add documentation
9
+ /// <summary>
10
+ /// Context for laying out files.
11
+ /// </summary>
12
public interface ILayoutContext
13
{
14
+ /// <summary>
15
+ /// Service provider.
16
+ /// </summary>
17
IServiceProvider ServiceProvider { get; }
18
19
+ /// <summary>
20
+ /// Extensions for use during layout.
21
+ /// </summary>
22
IEnumerable<ILayoutExtension> Extensions { get; set; }
23
24
+ /// <summary>
25
+ /// Set of tracked of files created during processing to be cleaned up.
26
+ /// </summary>
27
IEnumerable<ITrackedFile> TrackedFiles { get; set; }
28
29
+ /// <summary>
30
+ /// Set of files to transfer.
31
+ /// </summary>
32
IEnumerable<IFileTransfer> FileTransfers { get; set; }
33
34
+ /// <summary>
35
+ /// File to capture list of content files.
36
+ /// </summary>
37
string ContentsFile { get; set; }
38
39
+ /// <summary>
40
+ /// File to capture list of output files.
41
+ /// </summary>
42
string OutputsFile { get; set; }
43
44
+ /// <summary>
45
+ /// Intermediate folder.
46
+ /// </summary>
47
string IntermediateFolder { get; set; }
48
49
+ /// <summary>
50
+ /// List of built output files.
51
+ /// </summary>
52
string BuiltOutputsFile { get; set; }
53
28
- bool SuppressAclReset { get; set; }
54
+ /// <summary>
55
+ /// Reset ACLs on file transfers.
56
+ /// </summary>
57
+ bool ResetAcls { get; set; }
58
59
+ /// <summary>
60
+ /// Cancellation token.
61
+ /// </summary>
62
CancellationToken CancellationToken { get; set; }
63
}
64
}