← Back to team overview

yade-dev team mailing list archive

Re: Building Documentation

 

Well the doc is definitely failing to build, there is no doubt about that.
But the cause is not immediately clear to me. First, you might try
re-making as root user, as the error suggests. But it probably won't work,
so you should eliminate possible issues by recompiling a non debug version
of yade and re making the doc. In case that also fails, you might need to
take the deep dive and check out
/etc/sysctl.d/10-ptrace.conf/tmp/yade-wlbvKR/tmp-0 :-/.

On Mon, Oct 22, 2018 at 12:27 PM Eulitz, Alexander <
Alexander.Eulitz@xxxxxxxxxxxxxxxx> wrote:

> Yes of course.
>
> In case this matters: before building the doc I built Yade with DEBUG flag.
>
> build succeeded, 33 warnings.
>
> Traceback (most recent call last):
>
>   File
> "/home/sim/Dokumente/github/install/lib/x86_64-linux-gnu/yade-2018-10-12.git-57a3f21/py/yade/remote.py",
> line 128, in run
>
>     def run(self): self.func()
>
>   File "/usr/lib/python2.7/SocketServer.py", line 230, in serve_forever
>
>     r, w, e = _eintr_retry(select.select, [self], [], [],
>
> AttributeError: 'NoneType' object has no attribute 'select'
>
> SIGSEGV/SIGABRT handler called; gdb batch file is `/tmp/yade-wIbvKR/tmp-0'
>
> Traceback (most recent call last):
>
>   File
> "/home/sim/Dokumente/github/install/lib/x86_64-linux-gnu/yade-2018-10-12.git-57a3f21/py/yade/remote.py",
> line 128, in run
>
>     def run(self): self.func()
>
>   File "/usr/lib/python2.7/SocketServer.py", line 230, in serve_forever
>
>     r, w, e = _eintr_retry(select.select, [self], [], [],
>
> AttributeError: 'NoneType' object has no attribute 'select'
>
> Error in sitecustomize; set PYTHONVERBOSE for traceback:
>
> AttributeError: module 'sys' has no attribute 'setdefaultencoding'
>
> GNU gdb (Ubuntu 7.11.1-0ubuntu1~16.5) 7.11.1
>
> Copyright (C) 2016 Free Software Foundation, Inc.
>
> License GPLv3+: GNU GPL version 3 or later <
> http://gnu.org/licenses/gpl.html>
>
> This is free software: you are free to change and redistribute it.
>
> There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
>
> and "show warranty" for details.
>
> This GDB was configured as "x86_64-linux-gnu".
>
> Type "show configuration" for configuration details.
>
> For bug reporting instructions, please see:
>
> <http://www.gnu.org/software/gdb/bugs/>.
>
> Find the GDB manual and other documentation resources online at:
>
> <http://www.gnu.org/software/gdb/documentation/>.
>
> For help, type "help".
>
> Type "apropos word" to search for commands related to "word".
>
> Could not attach to process.  If your uid matches the uid of the target
>
> process, check the setting of /proc/sys/kernel/yama/ptrace_scope, or try
>
> again as the root user.  For more details, see /etc/sysctl.d/10-ptrace.conf
>
> /tmp/yade-wIbvKR/tmp-0:1: Error in sourced command file:
>
> ptrace: Operation not permitted.
>
> (gdb) Aborted (core dumped)
>
> CMakeFiles/doc.dir/build.make:60: recipe for target 'doc' failed
>
> make[3]: *** [doc] Error 134
>
> make[3]: Leaving directory '/home/sim/Dokumente/github/build'
>
> CMakeFiles/Makefile2:70: recipe for target 'CMakeFiles/doc.dir/all' failed
>
> make[2]: *** [CMakeFiles/doc.dir/all] Error 2
>
> make[2]: Leaving directory '/home/sim/Dokumente/github/build'
>
> CMakeFiles/Makefile2:77: recipe for target 'CMakeFiles/doc.dir/rule' failed
>
> make[1]: *** [CMakeFiles/doc.dir/rule] Error 2
>
> make[1]: Leaving directory '/home/sim/Dokumente/github/build'
>
> Makefile:165: recipe for target 'doc' failed
>
> make: *** [doc] Error 2
>
>
>
> Thanks
>
> Alex
>
>
>
> *Von:* Robert Caulk [mailto:rob.caulk@xxxxxxxxx]
> *Gesendet:* Montag, 22. Oktober 2018 11:55
> *An:* Eulitz, Alexander
> *Cc:* Yade developers
> *Betreff:* Re: [Yade-dev] Building Documentation
>
>
>
> I see. Hmm, can you share some of the warnings you notice during
> compilation? (especially the "final" one)?
>
>
>
> On Mon, Oct 22, 2018 at 11:44 AM Eulitz, Alexander <
> Alexander.Eulitz@xxxxxxxxxxxxxxxx> wrote:
>
> Sorry, I indeed did make doc in build folder :(
>
>
>
>
>
> *Von:* Robert Caulk [mailto:rob.caulk@xxxxxxxxx]
> *Gesendet:* Montag, 22. Oktober 2018 11:31
> *An:* Eulitz, Alexander
> *Cc:* Yade developers
> *Betreff:* Re: [Yade-dev] Building Documentation
>
>
>
> Yes, so you need to "make doc" inside the build folder instead.
>
>
>
> On Mon, Oct 22, 2018 at 11:21 AM Eulitz, Alexander <
> Alexander.Eulitz@xxxxxxxxxxxxxxxx> wrote:
>
> Hi Jerome, hi Robert,
>
> after “make doc” in install folder I end up with the .html files in:
>
> path/to/buildfolder/doc/sphinx/_build/html
>
>
>
> In install/share/doc/yade-version/yade.pdf there is just the yade logo but
> nothing else.
>
> Cheers,
>
> Alex
>
>
>
> *Von:* Yade-dev [mailto:yade-dev-bounces+alexander.eulitz=
> iwf.tu-berlin.de@xxxxxxxxxxxxxxxxxxx] *Im Auftrag von *Robert Caulk
> *Gesendet:* Montag, 22. Oktober 2018 10:29
> *An:* jerome.duriez@xxxxxxxxx
> *Cc:* Yade developers
> *Betreff:* Re: [Yade-dev] Building Documentation
>
>
>
> Hello Alex and Jerome,
>
>
>
> Just to clarify, you are running make doc from inside your build folder,
> right?
>
>
>
> When I run make doc after running make install, the yade.pdf appears in
> install/share/doc/yade-version/yade.pdf, as described in the yade install
> webpage.
>
>
>
> Cheers,
>
>
>
> Robert
>
>
>
> On Mon, Oct 22, 2018 at 9:45 AM Jerome Duriez <jerome.duriez@xxxxxxxxx>
> wrote:
>
> Hi Alex,
>
> At least, I get the same behavior as you, here.
>
> Cheers,
>
> Jérôme
>
> ------
> Chargé de Recherche / Research Associate
> Irstea, RECOVER
> 3275 route de Cezanne – CS 40061 13182 Aix-en-Provence Cedex 5 FRANCE
> +33 (0)4 42 66 99 21
>
> On 10/10/2018 18:05, Eulitz, Alexander wrote:
> >
> > Hi,
> >
> > I just tried building the documentation from source according to [1]
> > (just locally for evaluating changes I’d like to make at the doc).
> >
> > The build succeeded with some warnings. Anyway I cant find the
> > documentation in the folder given in the manual:
> >
> > /path/to/installfolder/share/doc/yade-your-version
> >
> > instead I can find it here:
> >
> > /path/to/buildfolder/doc/sphinx/_build/html
> >
> > Is this the usual behaviour?
> >
> > Cheers
> >
> > Alex
> >
> > [1] https://yade-dem.org/doc/installation.html#source-code
> >
> >
> > _______________________________________________
> > Mailing list: https://launchpad.net/~yade-dev
> > Post to     : yade-dev@xxxxxxxxxxxxxxxxxxx
> > Unsubscribe : https://launchpad.net/~yade-dev
> > More help   : https://help.launchpad.net/ListHelp
>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~yade-dev
> Post to     : yade-dev@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~yade-dev
> More help   : https://help.launchpad.net/ListHelp
>
> _______________________________________________
> Mailing list: https://launchpad.net/~yade-dev
> Post to     : yade-dev@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~yade-dev
> More help   : https://help.launchpad.net/ListHelp
>
>

References