amoeba commented on code in PR #41411:
URL: https://github.com/apache/arrow/pull/41411#discussion_r1583719907
##########
cpp/src/arrow/filesystem/azurefs.h:
##########
@@ -226,7 +226,7 @@ struct ARROW_EXPORT AzureOptions {
/// overwriting.
/// - When you use the ListBlobs operation without specifying a delimiter, the
results
/// include both directories and blobs. If you choose to use a delimiter,
use only a
-/// forward slash (/) -- the only supported delimiter.
+/// forward slash (/) \--- the only supported delimiter.
Review Comment:
This was to work around what appears might be a breathe issue, see
https://github.com/breathe-doc/breathe/issues/963 for what I think is a similar
report. Once whatever the issue is is fixed, we could revert this since it's
surprising behavior.
Doxygen turns `---` into `<mdash/>` and turns `\---` into `---`. For
`<mdash/>`, Sphinx/Breathe generates `&#8212;` instead of `—` so the
fix here makes Sphinx output `---` which works.
--
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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
