[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-29 Thread Micah Kornfield (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Micah Kornfield updated ARROW-11179:

Component/s: Format

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>  Components: Documentation, Format
>Reporter: Qingyou Meng
>Priority: Trivial
>  Labels: pull-request-available
> Attachments: format-0ed34c83.patch
>
>  Time Spent: 1.5h
>  Remaining Estimate: 0h
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-29 Thread Micah Kornfield (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Micah Kornfield updated ARROW-11179:

Component/s: Documentation

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>  Components: Documentation
>Reporter: Qingyou Meng
>Priority: Trivial
>  Labels: pull-request-available
> Attachments: format-0ed34c83.patch
>
>  Time Spent: 1.5h
>  Remaining Estimate: 0h
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-23 Thread ASF GitHub Bot (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

ASF GitHub Bot updated ARROW-11179:
---
Labels: pull-request-available  (was: )

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: Qingyou Meng
>Priority: Trivial
>  Labels: pull-request-available
> Attachments: format-0ed34c83.patch
>
>  Time Spent: 10m
>  Remaining Estimate: 0h
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-16 Thread Qingyou Meng (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Qingyou Meng updated ARROW-11179:
-
Priority: Trivial  (was: Major)

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: Qingyou Meng
>Priority: Trivial
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread Qingyou Meng (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Qingyou Meng updated ARROW-11179:
-
Attachment: format-0ed34c83.patch

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: Qingyou Meng
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread Qingyou Meng (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Qingyou Meng updated ARROW-11179:
-
Attachment: (was: format-0ed34c83.patch)

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: Qingyou Meng
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with cargo doc:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * example code/figure blocks are flatten into one line, see example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}{color:#172b4d}[smith2017knl]:{color} 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
with git command
{code:java}
git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
where *0ed34c83* is this commit:

 

 
{noformat}
0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries in 
Windows wheel builds{noformat}
 

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}The attachment file `format-0ed34c83.patch` 
is{color}{color:#403294} created with git command ```{color}git diff 0ed34c83 
-p format{color:#403294}```,  where 0ed34c83 is this commit{color}

{color:#403294}```{color}

0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries in 
Windows wheel builds

{color:#403294}```{color}

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}{color:#172b4d}[smith2017knl]:{color} 
> {color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit:
>  
>  
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
>  
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with cargo doc:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * example code/figure blocks are flatten into one line, see example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]:{color} 
[http://shaden.io/pub-files/smith2017knl.pdf] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
with git command
{code:java}
git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
where *0ed34c83* is this commit: 
{noformat}
0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries in 
Windows wheel builds{noformat}
 

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with cargo doc:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * example code/figure blocks are flatten into one line, see example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}{color:#172b4d}[smith2017knl]:{color} 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
with git command
{code:java}
git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
where *0ed34c83* is this commit:

 

 
{noformat}
0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries in 
Windows wheel builds{noformat}
 

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
>  
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with cargo doc:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * example code/figure blocks are flatten into one line, see example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]:{color} 
[http://shaden.io/pub-files/smith2017knl.pdf] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
with git command
{code:java}
git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
where *0ed34c83* is this commit: 
{noformat}
0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries in 
Windows wheel builds{noformat}
[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with cargo doc:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * example code/figure blocks are flatten into one line, see example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]:{color} 
[http://shaden.io/pub-files/smith2017knl.pdf] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
with git command
{code:java}
git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
where *0ed34c83* is this commit: 
{noformat}
0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries in 
Windows wheel builds{noformat}
 

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with cargo doc:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * example code/figure blocks are flatten into one line, see example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]:{color} 
> [http://shaden.io/pub-files/smith2017knl.pdf] to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file *format-0ed34c83.patch*{color} is created 
> with git command
> {code:java}
> git diff 0ed34c83 -p format > format-0ed34c83.patch{code}
> where *0ed34c83* is this commit: 
> {noformat}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds{noformat}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}The attachment file `format-0ed34c83.patch` 
is{color}{color:#403294} created with git command ```{color}git diff 0ed34c83 
-p format{color:#403294}```,  where 0ed34c83 is this commit{color}

{color:#403294}```{color}

0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries in 
Windows wheel builds

{color:#403294}```{color}

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}{color:#403294}The attachment file `format-0ed34c83.patch` 
is{color}{color:#403294} {color}{color}

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}The attachment file `format-0ed34c83.patch` 
> is{color}{color:#403294} created with git command ```{color}git diff 0ed34c83 
> -p format{color:#403294}```,  where 0ed34c83 is this commit{color}
> {color:#403294}```{color}
> 0ed34c83c ARROW-9400: [Python] Do not depend on conda-forge static libraries 
> in Windows wheel builds
> {color:#403294}```{color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

{color:#172b4d}{color:#403294}The attachment file `format-0ed34c83.patch` 
is{color}{color:#403294} {color}{color}

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> {color:#172b4d}{color:#403294}The attachment file `format-0ed34c83.patch` 
> is{color}{color:#403294} {color}{color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Attachment: format-0ed34c83.patch

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
> Attachments: format-0ed34c83.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Attachment: (was: format-5504ee4.patch)

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Attachment: format-5504ee4.patch

> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
> Attachments: format-5504ee4.patch
>
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color} to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems with `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems with `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] 
> to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, 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 example [arrow 
2.0.0 
doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, 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 example [arrow 
> 2.0.0 
> doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] 
> to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```.
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}http://shaden.io/pub-files/smith2017knl.pdf{color}] to 
{color:#403294}[smith2017knl]({color}[{color:#403294}http://shaden.io/pub-files/smith2017knl.pdf){color}|http://shaden.io/pub-files/smith2017knl.pdf)_]

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, for example:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * figures/code blocks are flatten into one line [example from arrow 
> 2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```.
>  * change {color:#00875a}[smith2017knl]: 
> {color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] 
> to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-08 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ` and `
 * Escape text block with ```text and ```.
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] to 
{color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, for example:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * figures/code blocks are flatten into one line [example from arrow 
> 2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ` and `
>  * Escape text block with ```text and ```
>  * change {color:#00875a}[smith2017knl]: 
> {color}[{color:#00875a}[http://shaden.io/pub-files/smith2017knl.pdf]{color}] 
> to 
> {color:#403294}[smith2017knl]({color}{color:#403294}[http://shaden.io/pub-files/smith2017knl.pdf]){color}
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-07 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * change {color:#00875a}[smith2017knl]: 
{color}[{color:#00875a}http://shaden.io/pub-files/smith2017knl.pdf{color}] to 
{color:#403294}[smith2017knl]({color}[{color:#403294}http://shaden.io/pub-files/smith2017knl.pdf){color}|http://shaden.io/pub-files/smith2017knl.pdf)_]

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * change _[smith2017knl]: [http://shaden.io/pub-files/smith2017knl.pdf]_ to 
_[__smith2017knl]([http://shaden.io/pub-files/smith2017knl.pdf)_]

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, for example:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * figures/code blocks are flatten into one line [example from arrow 
> 2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ``
>  * Escape code block with ```.
>  * change {color:#00875a}[smith2017knl]: 
> {color}[{color:#00875a}http://shaden.io/pub-files/smith2017knl.pdf{color}] to 
> {color:#403294}[smith2017knl]({color}[{color:#403294}http://shaden.io/pub-files/smith2017knl.pdf){color}|http://shaden.io/pub-files/smith2017knl.pdf)_]
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-07 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * change _[smith2017knl]: [http://shaden.io/pub-files/smith2017knl.pdf]_ to 
_[__smith2017knl]([http://shaden.io/pub-files/smith2017knl.pdf)_]

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * 
change _[smith2017knl]: [http://shaden.io/pub-files/smith2017knl.pdf]_ to 
_[__smith2017knl](http://shaden.io/pub-files/smith2017knl.pdf)_

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, for example:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * figures/code blocks are flatten into one line [example from arrow 
> 2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ``
>  * Escape code block with ```.
>  * change _[smith2017knl]: [http://shaden.io/pub-files/smith2017knl.pdf]_ to 
> _[__smith2017knl]([http://shaden.io/pub-files/smith2017knl.pdf)_]
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-07 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * 
change _[smith2017knl]: [http://shaden.io/pub-files/smith2017knl.pdf]_ to 
_[__smith2017knl](http://shaden.io/pub-files/smith2017knl.pdf)_

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * remove square brackets from link label

[~emkornfield] may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, for example:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * figures/code blocks are flatten into one line [example from arrow 
> 2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ``
>  * Escape code block with ```.
>  * 
> change _[smith2017knl]: [http://shaden.io/pub-files/smith2017knl.pdf]_ to 
> _[__smith2017knl](http://shaden.io/pub-files/smith2017knl.pdf)_
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-07 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * remove square brackets from link label

[~emkornfield] may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * remove square brackets from link label

@Micah Kornfield may I create a pull request for this?


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, for example:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * figures/code blocks are flatten into one line [example from arrow 
> 2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ``
>  * Escape code block with ```.
>  * remove square brackets from link label
> [~emkornfield] may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc

2021-01-07 Thread meng qingyou (Jira)


 [ 
https://issues.apache.org/jira/browse/ARROW-11179?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

meng qingyou updated ARROW-11179:
-
Description: 
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * remove square brackets from link label

@Micah Kornfield may I create a pull request for this?

  was:
Currently, comments in flatbuffer files are directly copied to rust and c++ 
source codes.

That's great but there are some problems to `cargo doc`, for example:
 * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
links` warning
 * figures/code blocks are flatten into one line [example from arrow 
2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]

After flatc generating, those ipc files have to be updated manually to fix the 
above problems.

So I'm suggesting update flatbuffer comments to address this problem.
 * Escape inline code with ``
 * Escape code block with ```.
 * remove square brackets from link label


> [Format] Make comments in fb files friendly to rust doc
> ---
>
> Key: ARROW-11179
> URL: https://issues.apache.org/jira/browse/ARROW-11179
> Project: Apache Arrow
>  Issue Type: Improvement
>Reporter: meng qingyou
>Priority: Major
>
> Currently, comments in flatbuffer files are directly copied to rust and c++ 
> source codes.
> That's great but there are some problems to `cargo doc`, for example:
>  * array element abc[1] or link label [smith2017knl] causes `broken intra doc 
> links` warning
>  * figures/code blocks are flatten into one line [example from arrow 
> 2.0.0doc|https://docs.rs/arrow/2.0.0/arrow/ipc/gen/SparseTensor/struct.SparseTensorIndexCSF.html#method.indptrType]
> After flatc generating, those ipc files have to be updated manually to fix 
> the above problems.
> So I'm suggesting update flatbuffer comments to address this problem.
>  * Escape inline code with ``
>  * Escape code block with ```.
>  * remove square brackets from link label
> @Micah Kornfield may I create a pull request for this?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)