Doc links no longer work

61 vues (au cours des 30 derniers jours)
Petr Krysl
Petr Krysl le 14 Nov 2024
Commenté : Christopher Kollett le 3 Déc 2024 à 20:23
I wrote a toolbox sometime ago. It had voluminous documentation. This used to work: doc AETNA. It would bring up a window with the documentation, and clicking on provided links would lead to further information.
This is now broken. How do I get back the previous behavior?
  14 commentaires
Paul
Paul le 16 Nov 2024
Yes, the doc page in 2024b does imply that Contents.m is still supported. The 2024b release notes talk about the removal of the doc browser, but makes no mention of any implications on Contents.m functionality. Of course, even if that's an issue for 2024b it doesn't explain why you're also having problems with 2024a.
When I tried doc myfolder in 2024a, the Contents opened in a window like you showed above, and when I clicked a link for a file, that same window transitioned to the help for that file, i.e., not tabbed browsing. I only mention this because you stated above that in 2024a "(no further tabs are opened)" in case there's a difference between what I'm seeing now and what you used to see in prior versions.
Petr Krysl
Petr Krysl le 16 Nov 2024
This is typical of the way Mathworks treats the programmers that create its ecosystem: high-handed disregard.
I am done with Matlab. I will rewrite my only package that I still use in the classroom in Python and good riddance Mathworks.
Thank you all for your help.

Connectez-vous pour commenter.

Réponses (3)

Esther
Esther le 19 Nov 2024
Doc on a folder with a Contents.m file is not currently working correctly. As a workaround, the undocumented function helpwin can be used instead of doc for these folders till we get this bug fixed.
  1 commentaire
Christopher Kollett
Christopher Kollett le 3 Déc 2024 à 20:23
The development team has identified the cause of this bug and has a fix in progress. We have also determined how we can update our tests to ensure that this functionality will not regress again in the future. We will apply the fix as soon as possible and hope to include it in an update to the current release.

Connectez-vous pour commenter.


埃博拉酱
埃博拉酱 le 15 Nov 2024
Modifié(e) : 埃博拉酱 le 18 Nov 2024
This should be a bug. According to Contents.m's documentation, it should work well with the doc command.
If this feature is very important to you, I recommend that you contact technical support. Or you can step through the doc command in both the old and new versions of MATLAB to observe the differences, and then modify the new version of the code.
Update 20241118:
My technical suppoert replied:
This is a regression in the doc command in R2024b. Doc on a folder with a Contents.m file is not currently working correctly.
As a workaround, the undocumented function "helpwin" can be used instead of doc for these folders.
Actually helpwin IS documented, but just deprecated. It works fine in my environment.
  3 commentaires
Steven Lord
Steven Lord le 15 Nov 2024
Please contact Technical Support directly using this link. They can work with you and/or the developers responsible for the help and documentation systems to determine the root cause and see if there are any workarounds for this problem. [I don't work on the help and documentation systems except as a consumer of the help and doc.]
Petr Krysl
Petr Krysl le 16 Nov 2024
Thank you for the suggestion. I did open a ticket. Their suggestion was to use R2024a. Alas, that one is broken too. How exactly they test the releases is a puzzle to me.

Connectez-vous pour commenter.


Matt J
Matt J le 15 Nov 2024
Modifié(e) : Matt J le 15 Nov 2024
I experienced this and found it was because of name conflict between one of my user-authored mfiles and a MathWorks-authored mfile that had been introduced in a newer Matlab version. Either matlabrc.m or some other startup Mcode made use of the command and, because it was using my version instead of the MathWorks-authored version, failed to set up properly.
The solution to getting doc running properly would be to make sure all of your user-authored mfiles are below MathWorks-authored mfiles in the path. However, this means your version of the mfile command will be shadowed. If your personal code depends on this command, you could probably track it down by running it in the debugger and waiting for a crash.
  5 commentaires
Paul
Paul le 15 Nov 2024
How did you determine the issue was a name conflict, and how did you determine that strip was the offender? Might be useful information for others who might be having similar/same problem, even if it's not the OP's problem.
Matt J
Matt J le 15 Nov 2024
Modifié(e) : Matt J le 15 Nov 2024
@Paul It's too long ago. I wouldn't be able to reconstruct the troubleshooting steps. I imagine if you create a startup.m file and insert,
dbstop if caught error
and then relaunch Matlab, it might be a way to trap Matlab startup problems, even if that wasn't precisely what I did.

Connectez-vous pour commenter.

Catégories

En savoir plus sur Startup and Shutdown dans Help Center et File Exchange

Produits


Version

R2024b

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Translated by