F1 acting funky

[frecd]

I'm getting the DD, (daily download), of Freecad/Freecad-doc. When I try to use the F1 key to check the documentation, I get a pop-up window that says:

FreeCAD help files not found (/usr/lib/freecad/doc/freecad.qhc). You might need to install
the FreeCAD documentation package.

Another missing file problem, or what? Still seeing the previous one by the way.

Bill

OS: Kubuntu 12.04.5 LTS
Word size of OS: 64-bit
Word size of FreeCAD: 64-bit
Version: 0.16.5560 (Git)
Build type: Unknown
Branch: master
Hash: bb05d1759614b55a2e8832f8628bce6add609ad4
Python version: 2.7.3
Qt version: 4.8.1
Coin version: 3.1.3

[triplus]

I'm getting the DD, (daily download), of Freecad/Freecad-doc. When I try to use the F1 key to check the documentation, I get a pop-up window that says:

FreeCAD help files not found (/usr/lib/freecad/doc/freecad.qhc). You might need to install
the FreeCAD documentation package.

Another missing file problem, or what? Still seeing the previous one by the way.

Bill

OS: Kubuntu 12.04.5 LTS
Word size of OS: 64-bit
Word size of FreeCAD: 64-bit
Version: 0.16.5560 (Git)
Build type: Unknown
Branch: master
Hash: bb05d1759614b55a2e8832f8628bce6add609ad4
Python version: 2.7.3
Qt version: 4.8.1
Coin version: 3.1.3

Yes this is known issue and i think there is issue report made about it already. You can find the solution here:

viewtopic.php?f=3&t=10606&start=10#p85466

[wmayer]

So, that obviously is a packaging issue and should be properly fixed sometime: issue #0002271

[triplus]

12.3 Additional documentation:

https://www.debian.org/doc/debian-policy/ch-docs.html

Code: Select all

/usr/share/doc

Does seem like the correct location to be used instead of adding the documentation under /usr/lib.

[frecd]

Ok, here's how I got it working:

Following the provided topic reference above, I managed to get the FreeCAD User Manual to appear, but it was empty, nothing in it. So, go to Edit > Preferences > Documentation, and click on, "Add".
You'll get a file chooser window, displaying the wrong subdirectory. Near the top is the path, click on, "usr", and then on share, doc, and freecad-doc. You shoud then see the, ".qch", file. Select it, and click, "ok". Stick a fork in it, it's done. The F1 to manual link should now work.

Bill

[davec49]

I have no Edit->Preferences->Documentation tab or add button so this may not work for some versions .
I have used the symlink solution for the momen t. but that may not be satisfactory in the longer term. I get daily updates from ppa:/freecad-maintainers/freecad-daily.

OS: Linux Mint 17.2 Rafaela
Word size of OS: 64-bit
Word size of FreeCAD: 64-bit
Version: 0.16.6163 (Git)
Build type: None
Branch: master
Hash: 273131c08857464fe7a140331afc864b7ae752f8
Python version: 2.7.6
Qt version: 4.8.6
Coin version: 4.0.0a
OCC version: 6.8.0.oce-0.17


David

[renatorivo]

I have no Edit->Preferences->Documentation tab or add button so this may not work for some versions

it is here (Qt Assistant)

documentation.png (46.78 KiB) Viewed 3806 times

I have this only with the compiled version, not with the updated version from PPA

[sgrogan]

I have this only with the compiled version, not with the updated version from PPA

For a self compiled build without "make install" FreeCAD can find this file. For the PPA the file is installed into a place that FreeCAD isn't looking.
According to triplus's link the PPA puts the file in the correct location and FreeCAD is looking for it in the wrong place.
According to wmayer's post it is a packaging problem, implying the PPA should put the file where FreeCAD is looking.
So, being a Window's guy maintaining the Ubuntu PPA, is it acceptable to just install the doc's where FreeCAD is looking for them?
If so I can fix this, if not changes to the code are required.
EDIT: the reason this keeps dropping down my todo is that I use the wiki because this is more up to date, but that's just a personal preference and I rarely am using FreeCAD when I don't have internet access.

[renatorivo]

thanks Sgrogan,
it's all good, I said this, because it seems that someone tried the Documentation folder in the preferences of FreeCAD
Renato

[Kunda1]

So, that obviously is a packaging issue and should be properly fixed sometime: issue #0002271

Any resolution in regards to issue #0002271 ?