[squeak-dev] reason why HelpBrowser does not respect page order on display? Fix? Bug? or Feature?

gettimothy gettimothy at zoho.com
Sun Oct 10 09:20:11 UTC 2021

Ok, I found the why on the top bar->SqueakHelp  sorts the help topics.

It is:   HelpTopicListItemWraper >> contents

Remove that sordid "sorted" and I get expected behavior.

Here is my rationale for this.  If I am writing documentation, It is reasonable to expect that the publisher respect the page ordering of the book. If not, we get confusion.

Say I write chapters "one" "two" "three" in that order. I expect to see them in that order when published.

Now, do a Print-It on these two:

OrderedCollection  with:'one' with:'two' with:'three'. --> an OrderedCollection('one' 'two' 'three')

(OrderedCollection  with:'one' with:'two' with:'three') sorted. ---> an OrderedCollection('one' 'three' 'two')


---- On Sun, 10 Oct 2021 05:02:19 -0400 gettimothy <mailto:gettimothy at zoho.com> wrote ----

I found the culprit.  

HelpBrowser openOn: FooHelp.   ends up about three sends later in

HelpBrowser >> rootTopic: aHelpTopic

rootTopic: aHelpTopic

"set the root topic and work out the top level sub-topics that it implies. Add the search topic at the end of the list"

rootTopic := aHelpTopic asHelpTopic.

self toplevelTopics: ((rootTopic ifNil: [#()] ifNotNil: [rootTopic subtopics]) sorted, {self searchTopic}).

self toplevelTopics: ((rootTopic ifNil: [#()] ifNotNil: [rootTopic subtopics ifEmpty: [{rootTopic}]]) sorted, {self searchTopic}).

self changed: #windowTitle.

When I remove that "sorted" I get the results I expect.

However....when I go to the top bar Help->SqueakHelp   it reverts back to the "incorrect" behavior.

gonna hunt that down next.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.squeakfoundation.org/pipermail/squeak-dev/attachments/20211010/6a1e8bbf/attachment.html>

More information about the Squeak-dev mailing list