@@ -3421,19 +3421,19 @@ public override int Read(byte[] buffer, int offset, int count)
3421
3421
/// <summary>
3422
3422
/// Provides a static way to obtain a source of data for an entry.
3423
3423
/// </summary>
3424
- /// <remarks>The </remarks>
3425
3424
public interface IStaticDataSource
3426
3425
{
3427
3426
/// <summary>
3428
- /// Get a data source .
3427
+ /// Get a source of data by creating a new stream .
3429
3428
/// </summary>
3430
3429
/// <returns>Returns a <see cref="Stream"/> to use for compression input.</returns>
3430
+ /// <remarks>Ideally a new stream is created and opened to achieve this, to avoid locking problems.</remarks>
3431
3431
Stream GetSource ( ) ;
3432
3432
}
3433
3433
3434
3434
/// <summary>
3435
- /// Represents a source of data that dynamically provide multiple <see cref="Stream">data sources</see>
3436
- /// based on the parameters passed.
3435
+ /// Represents a source of data that can dynamically provide
3436
+ /// multiple <see cref="Stream">data sources</see> based on the parameters passed.
3437
3437
/// </summary>
3438
3438
public interface IDynamicDataSource
3439
3439
{
@@ -3443,11 +3443,12 @@ public interface IDynamicDataSource
3443
3443
/// <param name="entry">The <see cref="ZipEntry"/> to get a source for.</param>
3444
3444
/// <param name="name">The name for data if known.</param>
3445
3445
/// <returns>Returns a <see cref="Stream"/> to use for compression input.</returns>
3446
+ /// <remarks>Ideally a new stream is created and opened to achieve this, to avoid locking problems.</remarks>
3446
3447
Stream GetSource ( ZipEntry entry , string name ) ;
3447
3448
}
3448
3449
3449
3450
/// <summary>
3450
- /// Default implementation of a <see cref="IStaticDataSource"/>
3451
+ /// Default implementation of a <see cref="IStaticDataSource"/> for use with files stored on disk.
3451
3452
/// </summary>
3452
3453
class StaticDiskDataSource : IStaticDataSource
3453
3454
{
@@ -3479,7 +3480,7 @@ public Stream GetSource()
3479
3480
3480
3481
3481
3482
/// <summary>
3482
- /// Default implementation of <see cref="IDynamicDataSource"/>
3483
+ /// Default implementation of <see cref="IDynamicDataSource"/> for files stored on disk.
3483
3484
/// </summary>
3484
3485
class DynamicDiskDataSource : IDynamicDataSource
3485
3486
{
0 commit comments