but perhaps significantly, index.html can’t be accessed there - the browser (any browser: FF, Chrome, Opera) won’t load it, but the text editor will. (The file is not damaged, it’s accessible with a browser where I downloaded and unzipped it.) So if the installed path is correct, it looks to me like a permissions problem. The directories are all “drwxr-xr-x”. The files are all “-rw-r–r–”.
OS is Ubuntu Linux 18.04.4
Manual files are dated 15 Nov 2019
Having powered down the machine, and therefore restarted Audacity for a second time, index.html will now open from /usr/share/audacity/help/manual/index.html, but still not from inside Audacity.
Indeed it is. Because I’m on a metered Internet tariff, having the manual local makes a lot of sense.
After my last post, I changed ownership of everything below “/usr/share/audacity” from “root root” to be the same as “/usr/share/audacity”, which was “root users” - to no effect. I am not a member of “users”, but making myself a member also had no effect.
I confirm I’m still getting the “Help on the Internet” window that starts “The Manual does not appear to be installed. Please view the Manual online or download the Manual…” either when clicking “Manual” in “Welcome to Audacity - How to get help” as Audacity starts up, or via the top menu “Help… > Manual”
This does not make sense. By default, html files will open in the default web browser. There must have been some reason why it didn’t, and rebooting is not going to change that. Somehow you must have change the file association of html files, and then somehow partially fixed it, but not completely fixed it. Do you recall doing anything to change the default file association for html files?
In the “Preferred Applications” app, what is set for “Web Browser”?
It’s not making sense to me either. My normal default browser is Opera. I have not knowingly changed anything, yet now I can open the HTML files in situ by doing Open with other application… Firefox (or Chrome) but not by double-clicking, which invokes Opera - it reports “Not allowed to load local resource: file:///usr/share/audacity/help/manual/index.html”. But if I extract the files from the zip download into my Downloads directory, they open immediately in Opera. Which is why I thought it’s a permissions/ownership problem.
I’ve got to ask you to confirm the directory structure I have is correct, because it wasn’t totally clear to me – I think because the directory “manual” was included in the zip package but “help” was not, exactly what the final file structure should be. Who should be the owner of /usr/share/audacity and its subdirectories, and what should the permissions there and below be?
This is the first mention of it being a snap package.
That will be the problem. Snap packages run in a “sandboxed” environment which, for security reasons, limits the application’s access to the outside world.
I don’t use snap packages myself, so I don’t know a lot about them and I can’t test, but you could perhaps try putting the help folder inside:
One obvious comment: the manual installation note needs to mention that the instructions don’t apply in that case.
So, is it worth pursuing, is it likely that Audacity will be patched to accept either location, or would you recommend removing Audacity and re-installing using Apt (it still appears to be available that way)?
And thank you for the time and effort you’ve put into this.
You could log a bug with Ubuntu for the missing manual.
The Audacity documentation assumes that package builders build Audacity according to the instructions. If the package maintainers decide to do something different (which we don’t know about), then it is arguably their responsibility to inform their users of limitations / bugs in their package. We have no control over what Ubuntu do with our source code.
I suggest that you try moving the help folder from
and let us know what happens.