[llvm-dev] Need help in setting up sphinx

[James Henderson via llvm-dev]

I assume you're referring to the html file that is supposed to be produced
by your build? What happens if you delete that file and then rerun? Is
there any log output? Without more info, I can't really help further.

On Sat, 26 Jun 2021 at 10:24, Pooja Yadav <pyadav2299 at gmail.com> wrote:

> Hi! Thanks @James! I installed recommonmark 0.7.1 and build was
> successfully. But now when I open the html file where I made the changes it
> doesn't show those changes. What could be the reason ?
> Thanks!
> Pooja
>
> On Thu, Jun 24, 2021, 18:14 James Henderson <jh7370.2008 at my.bristol.ac.uk>
> wrote:
>
>> Have you tried installing a more recent recommonmark version? I have
>> version 3.4.3 of Sphinx, and version 0.7.1 of recommonmark installed and
>> can build the docs (well, actually I can't currently because the LLVM
>> version I checked out has a bug in the docs, but that's not related to the
>> issue you have reported).
>>
>> James
>>
>> On Thu, 24 Jun 2021 at 11:54, Pooja Yadav <pyadav2299 at gmail.com> wrote:
>>
>>> Hi James,
>>> Thanks for replying. I have installed sphinx version 3.5.4 and
>>> recommonmark version 0.4.0
>>>
>>> Pooja
>>>
>>> On Thu, Jun 24, 2021 at 2:02 PM James Henderson <
>>> jh7370.2008 at my.bristol.ac.uk> wrote:
>>>
>>>> What version of Sphinx and recommonmark have you installed? It's been a
>>>> while, but in the past, there have been issues using specific versions of
>>>> the tools, so using the latest may not actually work.
>>>>
>>>> (In response to Michael's opinion - a warning is there for a reason -
>>>> it means the user is likely doing something wrong and they should fix it,
>>>> not ignore it)
>>>>
>>>> James
>>>>
>>>> On Wed, 23 Jun 2021 at 23:02, Michael Kruse via llvm-dev <
>>>> llvm-dev at lists.llvm.org> wrote:
>>>>
>>>>> Since it is a warning, you could try ignoring it using
>>>>> -DSPHINX_WARNINGS_AS_ERRORS=OFF
>>>>>
>>>>> (General opinion: Warnings are not errors for a reason and should not
>>>>> be treated as errors by default)
>>>>>
>>>>> Michael
>>>>>
>>>>>
>>>>> Am Mi., 23. Juni 2021 um 15:13 Uhr schrieb Pooja Yadav via llvm-dev
>>>>> <llvm-dev at lists.llvm.org>:
>>>>> >
>>>>> > Hi everyone!
>>>>> > I have installed python3-recommonmark using pip as well as apt-get
>>>>> but I am getting following error for ninja doc-llvm-html command. What am I
>>>>> missing?
>>>>> > Should I make some changes in the conf.py file. Where can I find my
>>>>> conf.py file in ubuntu?
>>>>> >
>>>>> > Thanks!
>>>>> >
>>>>> > Pooja
>>>>> >
>>>>> > _______________________________________________
>>>>> > LLVM Developers mailing list
>>>>> > llvm-dev at lists.llvm.org
>>>>> > https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev
>>>>> _______________________________________________
>>>>> LLVM Developers mailing list
>>>>> llvm-dev at lists.llvm.org
>>>>> https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev
>>>>>
>>>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20210628/1f8c3ac4/attachment.html>