Port System.IO docs for .NET 9 APIs

[carlossanlop]

Below is the list of APIs that still show up as undocumented in dotnet-api-docs and were introduced in .NET 9.

Full porting instructions can be found in the main issue.

This task needs to be finished the day before the RC2 snap (September 15th).

P7 Undoc APIs as of 08/20: #105979 (comment)

Outdated

Scroll right to see the details:

API	Summary	Parameters	TypeParameters	ReturnValue
M:System.IO.File.AppendAllBytes(System.String,System.ReadOnlySpan{System.Byte})	Missing	Missing	NA	NA
M:System.IO.File.AppendAllBytes(System.String,System.Byte[])	Missing	Missing	NA	NA
M:System.IO.File.AppendAllBytesAsync(System.String,System.Byte[],System.Threading.CancellationToken)	Missing	Missing	NA	Missing
M:System.IO.File.AppendAllBytesAsync(System.String,System.ReadOnlyMemory{System.Byte},System.Threading.CancellationToken)	Missing	Missing	NA	Missing
M:System.IO.File.AppendAllText(System.String,System.ReadOnlySpan{System.Char},System.Text.Encoding)	Missing	Missing	NA	NA
M:System.IO.File.AppendAllText(System.String,System.ReadOnlySpan{System.Char})	Missing	Missing	NA	NA
M:System.IO.File.AppendAllTextAsync(System.String,System.ReadOnlyMemory{System.Char},System.Text.Encoding,System.Threading.CancellationToken)	Missing	Missing	NA	Missing
M:System.IO.File.AppendAllTextAsync(System.String,System.ReadOnlyMemory{System.Char},System.Threading.CancellationToken)	Missing	Missing	NA	Missing
M:System.IO.File.WriteAllBytes(System.String,System.ReadOnlySpan{System.Byte})	Missing	Missing	NA	NA
M:System.IO.File.WriteAllBytesAsync(System.String,System.ReadOnlyMemory{System.Byte},System.Threading.CancellationToken)	Missing	Missing	NA	Missing
M:System.IO.File.WriteAllText(System.String,System.ReadOnlySpan{System.Char},System.Text.Encoding)	Missing	Missing	NA	NA
M:System.IO.File.WriteAllText(System.String,System.ReadOnlySpan{System.Char})	Missing	Missing	NA	NA
M:System.IO.File.WriteAllTextAsync(System.String,System.ReadOnlyMemory{System.Char},System.Text.Encoding,System.Threading.CancellationToken)	Missing	Missing	NA	Missing
M:System.IO.File.WriteAllTextAsync(System.String,System.ReadOnlyMemory{System.Char},System.Threading.CancellationToken)	Missing	Missing	NA	Missing
M:System.IO.FileStream.CopyTo(System.IO.Stream,System.Int32)	Missing	Missing	NA	NA
M:System.IO.Path.Combine(System.ReadOnlySpan{System.String})	Missing	Missing	NA	Missing
M:System.IO.Path.Join(System.ReadOnlySpan{System.String})	Missing	Missing	NA	Missing
M:System.IO.StreamWriter.Write(System.String,System.ReadOnlySpan{System.Object})	Missing	Missing	NA	NA
M:System.IO.StreamWriter.WriteLine(System.String,System.ReadOnlySpan{System.Object})	Missing	Missing	NA	NA
M:System.IO.TextWriter.CreateBroadcasting(System.IO.TextWriter[])	Missing	Missing	NA	Missing
M:System.IO.TextWriter.Write(System.String,System.ReadOnlySpan{System.Object})	Missing	Missing	NA	NA
M:System.IO.TextWriter.WriteLine(System.String,System.ReadOnlySpan{System.Object})	Missing	Missing	NA	NA

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-system-io
See info in area-owners.md if you want to be subscribed.

[stephentoub]

@carlossanlop, I'm not clear about the actions here. For example, the first API in this table:
M:System.IO.File.AppendAllBytes(System.String,System.ReadOnlySpan{System.Byte})
is called out as missing summary and parameters, but it has both:

runtime/src/libraries/System.Private.CoreLib/src/System/IO/File.cs

Lines 789 to 806 in 483db3e

	/// <summary>
	/// Appends the specified byte array to the end of the file at the given path.
	/// If the file doesn't exist, this method creates a new file.
	/// </summary>
	/// <param name="path">The file to append to.</param>
	/// <param name="bytes">The bytes to append to the file.</param>
	/// <exception cref="ArgumentNullException"><paramref name="path"/> is null.</exception>
	/// <exception cref="ArgumentException"><paramref name="path"/> is empty.</exception>
	/// <exception cref="PathTooLongException">The specified path, file name, or both exceed the system-defined maximum length.</exception>
	/// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
	/// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
	/// <exception cref="UnauthorizedAccessException"><paramref name="path"/> specified a file that is read-only.</exception>
	/// <exception cref="UnauthorizedAccessException"><paramref name="path"/> specified a file that is hidden.</exception>
	/// <exception cref="UnauthorizedAccessException"><paramref name="path"/> specified a directory.</exception>
	/// <exception cref="UnauthorizedAccessException">The caller does not have the required permission.</exception>
	/// <exception cref="UnauthorizedAccessException">This operation is not supported on the current platform.</exception>
	/// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
	public static void AppendAllBytes(string path, ReadOnlySpan<byte> bytes)

What is the action required there?

[carlossanlop]

I see. Let me re-run the porting tool myself. It seems we missed some namespaces in the initial porting last week.

[carlossanlop]

@stephentoub here you go dotnet/dotnet-api-docs#10210

[carlossanlop]

P7 Undoc APIs as of 08/20:

Summary	Parameters	TypeParameters	ReturnValue	API
Present	Present	NA	Missing	M:System.IO.File.AppendAllBytesAsync(System.String,System.ReadOnlyMemory{System.Byte},System.Threading.CancellationToken)
Present	Present	NA	Missing	M:System.IO.File.AppendAllBytesAsync(System.String,System.Byte[],System.Threading.CancellationToken)
Missing	Missing	NA	NA	M:System.IO.FileStream.CopyTo(System.IO.Stream,System.Int32)

[jozkee]

M:System.IO.FileStream.CopyTo(System.IO.Stream,System.Int32)

Why does this only shows for 9.0 in the documentation? It is not a new override. cc @gewarren