Doc links no longer work

61 次查看(过去 30 天)
Petr Krysl
Petr Krysl 2024-11-14
评论: Christopher Kollett 2024-12-3,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 个评论
Paul
Paul 2024-11-16
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 2024-11-16
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.

请先登录,再进行评论。

回答(3 个)

Esther
Esther 2024-11-19
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 个评论
Christopher Kollett
Christopher Kollett 2024-12-3,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.

请先登录,再进行评论。


埃博拉酱
埃博拉酱 2024-11-15
编辑:埃博拉酱 2024-11-18
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 个评论
Steven Lord
Steven Lord 2024-11-15
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 2024-11-16
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.

请先登录,再进行评论。


Matt J
Matt J 2024-11-15
编辑:Matt J 2024-11-15
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 个评论
Paul
Paul 2024-11-15
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 2024-11-15
编辑:Matt J 2024-11-15
@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.

请先登录,再进行评论。

类别

Help CenterFile Exchange 中查找有关 Startup and Shutdown 的更多信息

标签

产品


版本

R2024b

Community Treasure Hunt

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

Start Hunting!

Translated by