View Issue Details
|ID||Project||Category||View Status||Date Submitted||Last Update|
|0002271||FreeCAD||Bug||public||2015-09-20 08:04||2017-03-25 00:43|
|Priority||low||Severity||minor||Reproducibility||have not tried|
|Target Version||0.17||Fixed in Version||0.17|
|Summary||0002271: FreeCAD documentation can't be loaded on Debian/Ubuntu|
Debian Policy states:
"Additional documentation included in the package should be installed under /usr/share/doc/package. If the documentation is packaged separately, as package-doc for example, it may be installed under either that path or into the documentation directory for the separate documentation package (/usr/share/doc/package-doc in this example). However, installing the documentation into the documentation directory of the main package is preferred since it is independent of the packaging method and will be easier for users to find."
The PPA package follows the Debian policy, so contrary to what you say in that topic Werner, this is not a packaging issue, because FreeCAD is not looking for the file in the correct place.
Prior topic: http://forum.freecadweb.org/viewtopic.php?f=3&t=10606&start=10#p85466
||Note to myself: check content of debian/freecad-doc.docs and freecad-doc.doc-base.|
I tested this with a local build on Ubuntu 12.04 and Windows and there the documentation comes up. So, the help files themselves are correct.
Afterwards I updated my FreeCAD installation from ppa and also installed the doc. There it doesn't work. When I look at the path name inside the Synaptic GUI then it gives the correct path according to the Debian policy:
However, FreeCAD expects it to be under /usr/lib/freecad/doc instead. This is an indication that not the freecad-doc.docs and freecad-doc.doc-base are wrong but in the "rules" file something is missing.
And in fact in the rules file there should be added a further line to the extra_flags:
I couldn't test it but this should be the way how to fix it.
I'm sorry, this is not fixed for me. I just built a test deb 0.16.6700 package for trusty, with the extra_flags line added to debian/rules as per comment above. I installed freecad-doc package, and upon hitting F1 I get an error window stating
(translated to English):
"FreeCAD help files not found (/usr/share/doc/freecad-doc/freecad.qhc). You may have to install the FreeCAD documentation package."
OS: Ubuntu 14.04.4 LTS
Word size of OS: 64-bit
Word size of FreeCAD: 64-bit
Version: 0.16.6700 (Git)
Build type: None
Python version: 2.7.6
Qt version: 4.8.6
Coin version: 4.0.0a
OCC version: 6.7.0
(very old version of OCC because package was built with pbuilder in a chroot environment from the Ubuntu repo available libraries)
I added the file debian/freecad-doc.install with the following content:
The freecad.qhc file is now properly installed, and F1 now opens Qt Assistant, but it is empty of content, with the following message in the main window:
The page could not be found.
I have the same problem with FreeCAD compiled from master.
||Is this still a problem? According to http://forum.freecadweb.org/viewtopic.php?t=15290#p121678 it looks like it's resolved now.|
Last edited: 2016-05-05 20:34
This is fixed for the stable releases PPA
It is still being tested for the daily PPA, and has problems
sgrogan@sgrogan-HP-ZBook-17:~$ sudo apt-get install freecad-daily-doc
[sudo] password for sgrogan:
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following packages were automatically installed and are no longer required:
Use 'apt-get autoremove' to remove them.
The following NEW packages will be installed:
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 81.4 MB of archives.
After this operation, 82.2 MB of additional disk space will be used.
Get:1 http://ppa.launchpad.net/clhclh/sgrogan/ubuntu/ trusty/main freecad-daily-doc all 0.17~alpha1+git201605032021~ubuntu14.04.1 [81.4 MB]
Fetched 81.4 MB in 8min 51s (153 kB/s)
Selecting previously unselected package freecad-daily-doc.
(Reading database ... 289057 files and directories currently installed.)
Preparing to unpack .../freecad-daily-doc_0.17~alpha1+git201605032021~ubuntu14.04.1_all.deb ...
Unpacking freecad-daily-doc (0.17~alpha1+git201605032021~ubuntu14.04.1) ...
dpkg: error processing archive /var/cache/apt/archives/freecad-daily-doc_0.17~alpha1+git201605032021~ubuntu14.04.1_all.deb (--unpack):
trying to overwrite '/usr/share/doc-base/freecad-development-documentation', which is also in package freecad-doc 1:0.16.6703-1ppa1~ubuntu14.04.1
dpkg-deb: error: subprocess paste was killed by signal (Broken pipe)
Errors were encountered while processing:
E: Sub-process /usr/bin/dpkg returned an error code (1)
The daily builds are deployed to my personal PPA for testing
This is a packing problem, not a FreeCAD problem. When this is working NormandC or sgrogan will make a pull request to update the debian folder in the FreeCAD GitHub repo.
Assigned to @normandc as per his post in http://forum.freecadweb.org/viewtopic.php?t=15290#p121689
@wmayer issue says fixed in 0.16 should we unset that since there is a pending PR ?
EDIT: my mistake it is actually @sgrogan that will prepare the PR per http://forum.freecadweb.org/viewtopic.php?f=3&t=12532&start=10#p152550
Apologies, I shouldn't have assigned this ticket to anyone. Should I undo and re-assign to @wmayer or keep it as it is now?
Edit: sgrogan is OK with this per http://forum.freecadweb.org/viewtopic.php?f=8&t=19745&p=152500#p153042
Per @sgrogan of gitter.im:
I think we should close the issue as fixed. The debian folder in the FreeCAD sources is only tangentially related. We don't use it for the PPA. I don't think anybody uses it. Ideally we could come up with universal debian folder that would work on both debian and ubuntu, that could be included in the sources. If you want you can open a new issue (0002984) to update the debian folder in FreeCAD w/low priority and assign it to me.
Closing ticket and opened 0002984
|2015-09-20 08:04||wmayer||New Issue|
|2016-03-06 16:32||normandc||Note Added: 0006886|
|2016-03-10 12:05||normandc||Note Added: 0006900|
|2016-03-10 18:28||wmayer||Note Added: 0006902|
|2016-03-11 22:10||wmayer||Status||new => closed|
|2016-03-11 22:10||wmayer||Assigned To||=> wmayer|
|2016-03-11 22:10||wmayer||Resolution||open => fixed|
|2016-03-11 22:10||wmayer||Fixed in Version||=> 0.16|
|2016-04-14 04:14||normandc||Note Added: 0006961|
|2016-04-14 04:14||normandc||Status||closed => feedback|
|2016-04-14 04:14||normandc||Resolution||fixed => reopened|
|2016-04-14 04:14||normandc||Note Edited: 0006961||View Revisions|
|2016-04-14 10:55||normandc||Note Added: 0006962|
|2016-05-05 08:08||wmayer||Note Added: 0007044|
|2016-05-05 08:08||wmayer||Status||feedback => assigned|
|2016-05-05 08:09||wmayer||Status||assigned => feedback|
||Note Added: 0007050|
||Note Edited: 0007050||View Revisions|
|2017-01-11 22:12||Kunda1||Assigned To||wmayer => normandc|
|2017-01-11 22:12||Kunda1||Status||feedback => assigned|
|2017-01-11 22:14||Kunda1||Note Added: 0007658|
|2017-01-11 22:17||Kunda1||Note Edited: 0007658||View Revisions|
|2017-01-11 22:17||Kunda1||Assigned To||normandc => sgrogan|
|2017-01-12 15:08||Kunda1||Note Added: 0007670|
|2017-01-14 13:28||Kunda1||Note Edited: 0007670||View Revisions|
|2017-03-24 14:19||Kunda1||Target Version||=> 0.17|
|2017-03-24 14:23||Kunda1||Fixed in Version||0.16 =>|
|2017-03-24 16:19||Kunda1||Tag Attached: packaging|
|2017-03-25 00:40||Kunda1||Relationship added||related to 0002984|
|2017-03-25 00:43||Kunda1||Status||assigned => closed|
|2017-03-25 00:43||Kunda1||Resolution||reopened => fixed|
|2017-03-25 00:43||Kunda1||Fixed in Version||=> 0.17|
|2017-03-25 00:43||Kunda1||Note Added: 0008701|