zahiraam added a comment.

In D114483#3281731 <https://reviews.llvm.org/D114483#3281731>, @aaron.ballman 
wrote:

> In D114483#3281718 <https://reviews.llvm.org/D114483#3281718>, @aaron.ballman 
> wrote:
>
>> In D114483#3281714 <https://reviews.llvm.org/D114483#3281714>, @zahiraam 
>> wrote:
>>
>>> In D114483#3280905 <https://reviews.llvm.org/D114483#3280905>, @MaskRay 
>>> wrote:
>>>
>>>> Closed by 8ba9c794feb30cd969b9776c39873def10c51bff 
>>>> <https://reviews.llvm.org/rG8ba9c794feb30cd969b9776c39873def10c51bff>.
>>>>
>>>> If the commit message contained `Differential Revision:`, the differential 
>>>> would be closely automatically when you pushed it to the git repo.
>>>> Please ensure the tag is contained next time. `arc diff` adds this tag 
>>>> automatically.
>>>>
>>>> `clang/include/clang/Basic/AttrDocs.td` had some formatting issues and 
>>>> caused (`-DLLVM_ENABLE_SPHINX=ON`) `ninja docs-clang-html` to fail.
>>>> I fixed it. Please test this build target for `.rst` and `AttrDocs.td` 
>>>> changes.
>>>
>>> @MaskRay OK thanks. I see other clang-format issues. Should those be fixed 
>>> too?
>>
>> The issues aren't from clang-format, they're from the RST file contents not 
>> building in sphinx due to formatting issues in AttrDocs.td.
>>
>> https://lab.llvm.org/buildbot/#/builders/92/builds/20791/steps/5/logs/stdio
>> https://lab.llvm.org/buildbot/#/builders/92/builds/21098/steps/5/logs/stdio
>>
>> are two such examples that stem from your patch. Basically, you have to 
>> build the attribute documentation (converting AttrDocs.td into 
>> AttributeReference.rst) and then build the sphinx documents locally to 
>> ensure you're not introducing new issues. Or, you can try to speculatively 
>> fix based on the errors the bot gives you, but sometimes those errors are 
>> super cryptic and take multiple tries to fix (like the "can't lex as C++" 
>> one above), which is why trying to reproduce locally is a good first step.
>
> I've pushed a fix for it in a10ff373ddfa82a67c580a87f6258aa6ab8dd595 
> <https://reviews.llvm.org/rGa10ff373ddfa82a67c580a87f6258aa6ab8dd595> and the 
> sphinx builder is happy again.

Thanks @aaron.ballman !


CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D114483/new/

https://reviews.llvm.org/D114483

_______________________________________________
cfe-commits mailing list
cfe-commits@lists.llvm.org
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to