pitrou commented on code in PR #14632: URL: https://github.com/apache/arrow/pull/14632#discussion_r1021524941
########## cpp/src/arrow/table.h: ########## @@ -286,7 +286,22 @@ struct ARROW_EXPORT ConcatenateTablesOptions { static ConcatenateTablesOptions Defaults() { return {}; } }; -/// \brief Construct table from multiple input tables. +/// \brief Construct a new table from multiple input tables. +/// +/// The new table is assembled from existing column chunks without copying, +/// if schemas are identical. If schemas do not match exactly, an attempt is +/// made to unify them, and then column chunks are converted to their Review Comment: Yes, you can reference `PromoteTableToSchema` here. And, yes, we can publish the doc to the latter in the Sphinx API docs. -- 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. To unsubscribe, e-mail: github-unsubscr...@arrow.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org