Reload help page doesn't pick up changes?

Development
1

Not sure if this is a regression bug if I’m remembering the older behavior incorrectly, so I thought I’d ask here before filing a bug report.

I’m pretty sure in 3.14 and earlier, if I make some changes to the contents of a .schelp file, and then reload the page in the help browser, that it would detect that the modified timestamp is newer than the HTML file in the cache, and it would re-render the HTML and display the new contents. (I recall in 3.14, if you changed the structure of a document by adding or deleting section headings, it was necessary to reindex by SCDoc.indexAllDocuments(clearCache: true) to get the section changes to be visible. But I’m pretty sure it was not necessary to do this for content changes within an unchanged structure.)

I’m definitely seeing today in 3.15 that it is not re-rendering in this exact case.

help-didnt-rerender
help-didnt-rerender1434×772 260 KB

I’ve reloaded multiple times, but the new content that is highlighted in green in Emacs is not showing up. I have definitely saved the file in Emacs.

EDIT: After SCDoc.indexAllDocuments(clearCache: true), it still isn’t displaying new content. And I opened the schelp file in a different editor and confirmed that the new contents are definitely saved on disk. :confused:

Can someone confirm?

hjh

2

I have trouble with this too, and seem to need to do both SCDoc.indexAllDocuments(clearCache: true) and rebuilding the library. If there are small errors in the doc file, it also might not get picked up, but recompiling shows some errors. But yes, I can confirm that it takes time.
Also I sometimes need to hit the reload button in the Help browser, and cmd-r for reload usually only works once, but then quits after that.

3

FWIW, I updated SC today to test the fix for an issue I had logged a while ago. Now I can’t reproduce the help re-rendering problem. So I think I’ll wait, keep an eye on it – if it happens again, I’ll log a bug.

hjh