aaron.ballman added a comment.

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.


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