Local manual not recognized

Linux 19.1 Cinnamon
Audacity 2.2.1
Installed via LM’s Software Manager

I followed the instructions for installing a local version of the manual. (See attached screenshot.)
But when I start up the program it doesn’t seem to recognize that it’s there. Any thoughts?
This isn’t crucial because most times I will have an internet connection for the online manual, but I thought I’d ask.

Thanks in advance.
audacity.png

That “help” folder is in the correct place (assuming that you installed Audacity from the repository).
What’s inside the “help” folder?

The directory structure should look like this:

share/
   audacity/
      help/
         manual/
            m/
            man/
            manual/
            favicon.ico
            index.html
            quick_help.html

Yes, that is the structure.
audacity2.png

OK, so now check in preferences:
“Edit menu > Preferences > Interface”
and ensure that “Location of manual” is set to “Local”.

Indeed it is.

You mean, “it is set to local, but the local manual still does not open from the Audacity Help menu” ?

What happens if you double click on the “quick_help.html” file?

Correct, it has always been set to local, but the manual has never opened.

If I double click “quick_help.html” it opens in the browser (see pic), and the same happens upon double clicking “index.html,” and the internal links of the latter seem to work, also.
audacity3.png

So what does happen when you select “Quick Help” from Audacity’s Help menu?

The same message as with the manual, that it does not seem to be installed.
audacity4.png

Enter this in a terminal:

which audacity

What does it say?

Launch Audacity by typing this in a terminal:

audacity

and then go to “Help menu > Quick Help”

Attached is a copy of what the terminal showed. After program opened, clicking on “Quick Help” brought up the same error message as above.

Maybe I should try an uninstall-reinstall, ha.
audacity printout.txt (41.5 KB)

With Audacity closed, try deleting these 3 files, then restart Audacity:
~/.audacity-data/audacity.cfg
~/.audacity-data/pluginregistry.cfg
~/.audacity-data/pluginsettings.cfg

The above will reset Audacity to “factory defaults”.

(“.audacity-data” is a hidden folder in your home directory)

Deleted the files (plus, tried uninstall/install, even trying the Flathub version available in the LM Software Manager, too), but no different result through it all. Thanks for all the suggestions.

I missed this the first time around - that’s not correct.
It should be:

share/
   audacity/
      help/
         manual/
            m/
            man/
            manual/
            favicon.ico
            index.html
            quick_help.html

but you have got:

share/
   audacity/
      help/
        m/
        man/
        manual/
        favicon.ico
        index.html
        quick_help.html

You have a folder called “manual” twice. If that’s correct, clearly something is not right on the install end, because only one folder so named is being created.

Is it enough for me simply to create a folder called “manual” inside of help/ and then move m/, man/, manual/, favicon.ico, index.html and quick_help.html inside of that new folder?

Yes, you can manually (pun intended) create a new folder “/usr/share/audacity/manual” and then move the “help” folder and all of its contents into the new folder. The easiest way to do this is to launch your file browser with root privileges. For example, if your default file browser is Nautilus:

sudo nautilus

Done! (LM makes it easy, so my preferred method is to navigate to the directory I want & then within it right click to bring up the “Open as Root” option. Easy!)

Creating that folder & moving those files did it. Thanks much. Let’s hope that the installation gets corrected so that people don’t need to manually create a folder and move the files.

Thanks again.

SOLVED