[Bug other/107620] New: Build errors when using sphinx

[Bug other/107620] New: Build errors when using sphinx

[vvinayag at arm dot com]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107620

            Bug ID: 107620
           Summary: Build errors when using sphinx
           Product: gcc
           Version: unknown
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: other
          Assignee: unassigned at gcc dot gnu.org
          Reporter: vvinayag at arm dot com
  Target Milestone: ---

I am noticing errors with use of sphinx when building:
Build machine: x86_64-none-linux-gnu
Host: x86_64-none-linux-gnu
Target: aarch64-none-elf or arm-none-eabi


SPHINXBUILD=

make[2]: Entering directory '/.../src/gcc/doc'

b "html" -d
/.../build-aarch64_be-none-elf/obj/gcc2/gcc/doc/fortran/html/doctrees  -j auto
-q  /.../src/gcc/gcc/fortran/doc/gfortran
"/.../build-aarch64_be-none-elf/obj/gcc2/gcc/doc/fortran/html/html"

/bin/sh: b: command not found

make[2]: [Makefile:96: html] Error 127 (ignored)

make[2]: Leaving directory '/.../src/gcc/doc'

test -z "/.../build-aarch64_be-none-elf/install/share/doc/" || /bin/sh
/.../src/gcc/gcc/../mkinstalldirs
"/.../build-aarch64_be-none-elf/install/share/doc/"

 /usr/bin/install -C -m 644 '/.../src/gcc/gcc/doc/fortran/html/html/index.html'
'/.../build-aarch64_be-none-elf/install/share/doc//index.html'

/usr/bin/install: cannot stat
‘/.../src/gcc/gcc/doc/fortran/html/html/index.html’: No such file or directory


Is the above error due to not installing sphinx 5.3.0?
I assumed installing sphinx 5.3.0 would help, but after installing sphinx
5.3.0, I get a different error:

Extension error:
Could not import extension gcc_sphinx (exception: No module named 'gcc_sphinx')
Makefile:84: recipe for target 'info' failed

[Bug other/107620] Build errors when using sphinx

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107620

Martin Liška <marxin at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
     Ever confirmed|0                           |1
             Status|UNCONFIRMED                 |ASSIGNED
           Assignee|unassigned at gcc dot gnu.org      |marxin at gcc dot gnu.org
   Last reconfirmed|                            |2022-11-11
                 CC|                            |marxin at gcc dot gnu.org

--- Comment #1 from Martin Liška <marxin at gcc dot gnu.org> ---
Confirmed. Btw. what revision do you build and what command do you use?

[Bug other/107620] Build errors when using sphinx

[vvinayag at arm dot com]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107620

--- Comment #2 from vvinayag at arm dot com ---
(In reply to Martin Liška from comment #1)
> Confirmed. Btw. what revision do you build and what command do you use?

Could you please clarify what you are referring to, for the revision and
command?

[Bug other/107620] Build errors when using sphinx

[ramana at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107620

Ramana Radhakrishnan <ramana at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |ramana at gcc dot gnu.org

--- Comment #3 from Ramana Radhakrishnan <ramana at gcc dot gnu.org> ---
I worked around this by installing everything in $SRCDIR/doc/requirements.txt.

pip3 install -r requirements.txt 


 I found that using that allowed me to build html documentation. However I
seemed to need in addition a whole bunch of stuff to build latex and pdf
documentation.

Ramana

[Bug other/107620] Build errors when using sphinx

[cvs-commit at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107620

--- Comment #4 from CVS Commits <cvs-commit at gcc dot gnu.org> ---
The master branch has been updated by Martin Liska <marxin@gcc.gnu.org>:

https://gcc.gnu.org/g:5e749ee3019d7917184af30dab8d09c933c0a4a1

commit r13-3940-g5e749ee3019d7917184af30dab8d09c933c0a4a1
Author: Martin Liska <mliska@suse.cz>
Date:   Sun Nov 13 15:07:17 2022 +0100

    configure: always set SPHINX_BUILD

    During the Sphinx-migration development, I used
    SPHINX_BUILD='' in order to skip building info and manual
    pages in gcc folder. However, we've got HAS_SPHINX_BUILD
    which is the correct flag for that.

    With the patch, one will get a nicer error message when
    sphinx-build is missing and one builds (explicitly) a target which
    depends on it.

            PR other/107620

    gcc/ChangeLog:

            * configure: Regenerate.
            * configure.ac: Always set sphinx-build.

    libgomp/ChangeLog:

            * configure: Regenerate.
            * configure.ac: Always set sphinx-build.

    libiberty/ChangeLog:

            * configure: Regenerate.
            * configure.ac: Always set sphinx-build.

    libitm/ChangeLog:

            * configure: Regenerate.
            * configure.ac: Always set sphinx-build.

    libquadmath/ChangeLog:

            * configure: Regenerate.
            * configure.ac: Always set sphinx-build.

[Bug other/107620] Build errors when using sphinx

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107620

--- Comment #5 from Martin Liška <marxin at gcc dot gnu.org> ---
> Is the above error due to not installing sphinx 5.3.0?

Yes, and you should get a better message now.

> I assumed installing sphinx 5.3.0 would help, but after installing sphinx
> 5.3.0, I get a different error:
> 
> Extension error:
> Could not import extension gcc_sphinx (exception: No module named
> 'gcc_sphinx')
> Makefile:84: recipe for target 'info' failed

Should be fixed with r13-3871-g70f1c41061b2b5.

[Bug other/107620] Build errors when using sphinx

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107620

Martin Liška <marxin at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         Resolution|---                         |FIXED
             Status|ASSIGNED                    |RESOLVED

--- Comment #6 from Martin Liška <marxin at gcc dot gnu.org> ---
> 
> I found that using that allowed me to build html documentation. However I
> seemed to need in addition a whole bunch of stuff to build latex and pdf
> documentation.

Yes, these dependencies are usually installed if you install
python3-Sphinx-latex package.