F1 acting funky

Post here for help on using FreeCAD's graphical user interface (GUI).
Forum rules
and Helpful information
IMPORTANT: Please click here and read this first, before asking for help

Also, be nice to others! Read the FreeCAD code of conduct!
frecd
Posts: 113
Joined: Wed Dec 31, 2014 3:03 am

F1 acting funky

Post by 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
Veteran
Posts: 9471
Joined: Mon Dec 12, 2011 4:45 pm

Re: F1 acting funky

Post by triplus »

frecd wrote: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
Founder
Posts: 20241
Joined: Thu Feb 19, 2009 10:32 am
Contact:

Re: F1 acting funky

Post by wmayer »

So, that obviously is a packaging issue and should be properly fixed sometime: issue #0002271
triplus
Veteran
Posts: 9471
Joined: Mon Dec 12, 2011 4:45 pm

Re: F1 acting funky

Post by 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
Posts: 113
Joined: Wed Dec 31, 2014 3:03 am

Re: F1 acting funky

Post by 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
Posts: 23
Joined: Thu Oct 13, 2011 11:16 pm
Location: Brisbane Australia

Re: F1 acting funky

Post by 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 :D :D :D 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
Veteran
Posts: 2611
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Re: F1 acting funky

Post by renatorivo »

davec49 wrote: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
documentation.png (46.78 KiB) Viewed 3921 times
I have this only with the compiled version, not with the updated version from PPA
User avatar
sgrogan
Veteran
Posts: 6499
Joined: Wed Oct 22, 2014 5:02 pm

Re: F1 acting funky

Post by sgrogan »

renatorivo wrote: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.
"fight the good fight"
renatorivo
Veteran
Posts: 2611
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Re: F1 acting funky

Post by 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
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: F1 acting funky

Post by Kunda1 »

wmayer wrote:So, that obviously is a packaging issue and should be properly fixed sometime: issue #0002271
Any resolution in regards to issue #0002271 ?
Alone you go faster. Together we go farther
Please mark thread [Solved]
Want to contribute back to FC? Checkout:
'good first issues' | Open TODOs and FIXMEs | How to Help FreeCAD | How to report Bugs
Post Reply