mqy opened a new pull request #9299:
URL: https://github.com/apache/arrow/pull/9299


   ### Problem
   
   Currently, comments in FB files are directly copied to rust and c++ source 
codes. That's great but `rust` suffers from the generated codes, for example:
   
   - array element `abc[1]` or link label `[smith2017knl]` causes `broken intra 
doc links` warning
   - example code/figure blocks are flatten into one line, see [arrow 2.0.0 
doc](https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType)
   
   The above problems may lead to failures or warnings when run `rust test 
--doc` or `rust doc`.
   So the generated `.rs` files have to be manually modified to fix the above 
problems.
   
   ### This PR
   
   This PR changed three FB files by formatting some comments to make them 
friendly to rust.


----------------------------------------------------------------
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]


Reply via email to