mr-smidge commented on a change in pull request #7158:
URL: https://github.com/apache/arrow/pull/7158#discussion_r428555751
##########
File path: csharp/src/Apache.Arrow/ArrowBuffer.Builder.cs
##########
@@ -22,51 +22,111 @@ namespace Apache.Arrow
{
public partial struct ArrowBuffer
{
+ /// <summary>
+ /// The <see cref="Builder{T}"/> class is able to append value-type
items, with fluent-style methods, to build
+ /// up an <see cref="ArrowBuffer"/> of contiguous items.
+ /// </summary>
+ /// <remarks>
+ /// Note that <see cref="bool"/> is not supported as a generic type
argument for this class. Please use
+ /// <see cref="BitPackedBuilder"/> instead.
+ /// </remarks>
+ /// <typeparam name="T">Value-type of item to build into a
buffer.</typeparam>
public class Builder<T>
where T : struct
{
private const int DefaultCapacity = 8;
private readonly int _size;
+ /// <summary>
+ /// Gets the number of items of current capacity.
Review comment:
I've used the sentence form from `StringBuilder` - good suggestion.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
