[jira] [Updated] (ARROW-11179) [Format] Make comments in fb files friendly to rust doc
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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
[ 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)