← Back to team overview

yade-dev team mailing list archive

Re: Building Documentation

 

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<mailto:Alexander.Eulitz@xxxxxxxxxxxxxxxx>> wrote:
Sorry, I indeed did make doc in build folder :(


Von: Robert Caulk [mailto:rob.caulk@xxxxxxxxx<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<mailto: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<mailto:yade-dev-bounces%2Balexander.eulitz>=iwf.tu-berlin.de@xxxxxxxxxxxxxxxxxxx<mailto:iwf.tu-berlin.de@xxxxxxxxxxxxxxxxxxx>] Im Auftrag von Robert Caulk
Gesendet: Montag, 22. Oktober 2018 10:29
An: jerome.duriez@xxxxxxxxx<mailto: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<mailto: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<mailto: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<mailto: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<mailto:yade-dev@xxxxxxxxxxxxxxxxxxx>
Unsubscribe : https://launchpad.net/~yade-dev
More help   : https://help.launchpad.net/ListHelp

Follow ups

References