Web lists-archives.com

Need help with Kapidox - messes up my work




Hi everyone,

can someone explain me how (not) to use Kapidox?

I tried to build Okular class documentation with Kapidox, whether that is 
easier than with doxygen.

So I followed the README on https://cgit.kde.org/kapidox.git/tree/README.md, 
and got a kapidox_generate in ~/kde/kapidox/src/. 'python setup.py install' 
and so on.

Then I mkdir-cd-ed to html_kapidox/ in the okular base directory, and called 
kapidox_generate with the okular base directory as argument. Of course, 
html_kapidox/ was still empty.

Results:
It complained that it won’t draw graphs, 
Then it deleted the whole directory instead of building documentation. WTF? 
See below:

david@doro:~/kde/src/konsole/html$ cd ~/Qt/okular
david@doro:~/Qt/okular$ mkdir html_kapidox
david@doro:~/Qt/okular$ cd html_kapidox/
david@doro:~/Qt/okular/html_kapidox$ ~/kde/kapidox/src/ka
bash: /home/david/kde/kapidox/src/ka: No such file or directory
david@doro:~/Qt/okular/html_kapidox$ ~/kde/kapidox/src/kapidox_generate ..
16:42:48 WARNING Missing Graphviz dependency: diagrams will not be generated.
16:42:48 DEBUG Found cached identities file at /home/david/.cache/kapidox/kde-
accounts
16:42:49 INFO # Generating doc for Okular
16:42:50 INFO Running Doxygen
16:43:05 INFO # Rebuilding Okular for interdependencies
Traceback (most recent call last):
  File "/home/david/kde/kapidox/src/kapidox_generate", line 110, in <module>
    main()
  File "/home/david/kde/kapidox/src/kapidox_generate", line 106, in main
    copyright=kde_copyright)
  File "/home/david/kde/kapidox/src/kapidox/hlfunctions.py", line 126, in 
do_it
    shutil.rmtree(lib.outputdir)
  File "/usr/lib/python2.7/shutil.py", line 270, in rmtree
    onerror(os.rmdir, path, sys.exc_info())
  File "/usr/lib/python2.7/shutil.py", line 268, in rmtree
    os.rmdir(path)
OSError: [Errno 39] Directory not empty: '..'
david@doro:~/Qt/okular/html_kapidox$ ls
david@doro:~/Qt/okular/html_kapidox$ ls ..
david@doro:~/Qt/okular/html_kapidox$ 

I had already run kapidox_generate in other project directories, where it only 
generated an index.html with some blue navigation bars (like on api.kde.org).

This is probably not the intended behaviour. Am I stupid? If yes/no/else: What 
am I doing wrong? Which information do you need to help?

Cheers, David