Re: [Oorexx-devel] Ad documentation on array's sort versions
Absolutely not. The stable version is important because of the guarantee of stability. There is no guarantee with the others. The might be using the same algorithm currently, but there is no guarantee that this will always be the case. We may find a faster solution that is not stable and are free to make the switch at any time. Rick On Thu, Apr 9, 2020 at 8:42 AM Rony G. Flatscher wrote: > There are four sort methods according to rexxref.pdf, 5.3.6.33 - 5.3.6.36: > >- sort >- sortWith >- stableSort >- stableSortWith > > The sort* methods have the following documentation in common: > > Sorts the Array of Comparable items into ascending order using an > algorithm that* is not guaranteed to* > *be stable*, and returns the sorted Array. > > The stableSort* methods have the following documentation in common: > > Sorts the Array of Comparable items into ascending order using *a stable > Mergesort algorithm*, and > returns the sorted Array. > > AFAIK it turned out to be the case that the mergesort algorithm was faster > (or at least as fast) as the original (unstable) sort algorithm, such that > sort* now also employ the stable mergesort algorithm. > > Therefore > >- the documentation needs to be corrected, if possible dropping the >term "stable" as this makes newcomers unsecure (does that really mean that >the sorting order may be changed?) who do not know the meaning of "stable" >in the context of sort algorithms, > >- the stableSort* versions have become useless and should be either >marked prominently as deprecated in the documentation or left out >altogether (but leaving it in the interpreter for backlevel support). > > What do you think? > > ---rony > > > ___ > Oorexx-devel mailing list > Oorexx-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/oorexx-devel > ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
Re: [Oorexx-devel] Ad documentation
On the first point, I am just as annoyed as you are at they way that links position you when you click on them. Unfortunately, after hours of experimenting some time ago, it appears this is an artefact of the way we produce the PDF using the TEX processor. The fop program produces what you and I consider the correct result, but fop has other problems which do produce good results for production types of work. While I also agree with you on the second point, Rick convinced me that the classes should be in the order in which you would want them if you were reading the manual for the first time. I still somewhat disagree with that but the reference manual has been organized that way for some time now. Perhaps you would like to put together a section that would go at the very beginning of the classes chapter that lists them alphabetically as links? David Ashley On 06/30/2011 06:57 AM, Rony G. Flatscher wrote: Lately, I have started to use the PDF documentation a little bit more intensively, than in the past. From intense usage two questions: * When following a link one is positioned right at the first sentence of the section the link pointed to. This usually means that the section header the link points to is not scrolled into the PDF-window. Sometimes one is not sure whether the correct link was used and one has to scroll up manually to get to see the heading immediately above the first paragraph. Would it be possible to place the target of the links to the begin of the heading the link points to, such that jumping to it will display immediately the heading in the PDF window? * As by now there are quite a few classes in ooRexx, it is quite a few times the case, that locating certain classes is much more cumbersome than it needs to be. The reason being that some of the classes are not listed in alphabetical order. This means that sometimes one has to look-up and down the list off unordered classes to be sure that one has not overlooked the sought one. Would it be possible to order all classes alphabetically within their section, such that one is able to quickly either spot a sought for class or know that the class (one thought would exist) does in fact not exist? ---rony -- David Ashley ooRexx Development Team -- All of the data generated in your IT infrastructure is seriously valuable. Why? It contains a definitive record of application performance, security threats, fraudulent activity, and more. Splunk takes this data and makes sense of it. IT sense. And common sense. http://p.sf.net/sfu/splunk-d2d-c2___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
Re: [Oorexx-devel] Ad documentation
On Thu, Jun 30, 2011 at 6:00 AM, David Ashley david.ashley@gmail.com wrote: On the first point, I am just as annoyed as you are at they way that links position you when you click on them. Unfortunately, after hours of experimenting some time ago, it appears this is an artefact of the way we produce the PDF using the TEX processor. The fop program produces what you and I consider the correct result, but fop has other problems which do produce good results for production types of work. That's what I figured. I also think you get posititioned in the wrong place. I played around with the ooDialog reference some and everything I did made it worse. While I also agree with you on the second point, Rick convinced me that the classes should be in the order in which you would want them if you were reading the manual for the first time. I still somewhat disagree with that but the reference manual has been organized that way for some time now. Perhaps you would like to put together a section that would go at the very beginning of the classes chapter that lists them alphabetically as links? In the ooDialog reference I'm putting a table at the start of each section (for a class) and listing all the methods with links to them. Then the doc for the methods are in an order that makes sense. You might want to look at that Rony, the same idea could be applied to classes. -- Mark Miesfeld -- All of the data generated in your IT infrastructure is seriously valuable. Why? It contains a definitive record of application performance, security threats, fraudulent activity, and more. Splunk takes this data and makes sense of it. IT sense. And common sense. http://p.sf.net/sfu/splunk-d2d-c2 ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
Re: [Oorexx-devel] Ad documentation
On 30.06.2011 15:00, David Ashley wrote: On the first point, I am just as annoyed as you are at they way that links position you when you click on them. Unfortunately, after hours of experimenting some time ago, it appears this is an artefact of the way we produce the PDF using the TEX processor. The fop program produces what you and I consider the correct result, but fop has other problems which do produce good results for production types of work. Hmm, thank you for this information! Do you think it to be possible to come up with some program to do a post-processing of the PDF-file where the link-targets could be moved to a prior paragraph? (This would only be feasible, if the sequence of text in the PDF would match the source sequence. This may not be the case as PDF would allow one to scatter text all around while giving coordinates that make them appear in sequence on display.) If so, I could try to assign this task to a student in the winter semester (which may incur a lot of research, experiments and work for such a student which would last until the end of January 2012). While I also agree with you on the second point, Rick convinced me that the classes should be in the order in which you would want them if you were reading the manual for the first time. I still somewhat disagree with that but the reference manual has been organized that way for some time now. Perhaps you would like to put together a section that would go at the very beginning of the classes chapter that lists them alphabetically as links? This might be a possibility. However when wording with the PDF-reference, the table of contents is displayed in the left frame with the classes listed in the sequence they are found in the PDF. If this list was in alphabetical order, like it is with e.g. the BIF section, one could locate/find classes as quickly as BIFs. ---rony -- All of the data generated in your IT infrastructure is seriously valuable. Why? It contains a definitive record of application performance, security threats, fraudulent activity, and more. Splunk takes this data and makes sense of it. IT sense. And common sense. http://p.sf.net/sfu/splunk-d2d-c2___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
Re: [Oorexx-devel] Ad documentation
On 30.06.2011 15:40, Mark Miesfeld wrote: On Thu, Jun 30, 2011 at 6:00 AM, David Ashley david.ashley@gmail.com wrote: On the first point, I am just as annoyed as you are at they way that links position you when you click on them. Unfortunately, after hours of experimenting some time ago, it appears this is an artefact of the way we produce the PDF using the TEX processor. The fop program produces what you and I consider the correct result, but fop has other problems which do produce good results for production types of work. That's what I figured. I also think you get posititioned in the wrong place. I played around with the ooDialog reference some and everything I did made it worse. Interesting (and who knows what the PDF stream looks like then) ! While I also agree with you on the second point, Rick convinced me that the classes should be in the order in which you would want them if you were reading the manual for the first time. I still somewhat disagree with that but the reference manual has been organized that way for some time now. Perhaps you would like to put together a section that would go at the very beginning of the classes chapter that lists them alphabetically as links? In the ooDialog reference I'm putting a table at the start of each section (for a class) and listing all the methods with links to them. Then the doc for the methods are in an order that makes sense. You might want to look at that Rony, the same idea could be applied to classes. Will do (maybe that is what David was contemplating as well)! ---rony -- All of the data generated in your IT infrastructure is seriously valuable. Why? It contains a definitive record of application performance, security threats, fraudulent activity, and more. Splunk takes this data and makes sense of it. IT sense. And common sense. http://p.sf.net/sfu/splunk-d2d-c2 ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
Re: [Oorexx-devel] Ad documentation
On 30.06.2011 21:16, Mark Miesfeld wrote: On Thu, Jun 30, 2011 at 11:42 AM, Rony G. Flatscher rony.flatsc...@wu-wien.ac.at wrote: On 30.06.2011 15:40, Mark Miesfeld wrote: In the ooDialog reference I'm putting a table at the start of each section (for a class) and listing all the methods with links to them. Then the doc for the methods are in an order that makes sense. You might want to look at that Rony, the same idea could be applied to classes. Will do (maybe that is what David was contemplating as well)! Be warned, that I haven't completed that for every chapter, but Chapter 11 Static Controls is one that is done. Thank you for that hint, Mark. From a usability point of view, the first thing I do is click on the plus-sign next to the TOC (table of content) frame on the left hand side. This opens the drop down of that chapter (11 in this case) and one gets to see a list of methods, which is not ordered alphabetically, hence it takes a while to orientate and make sure that one has not overlooked a method. Now, one needs to know somehow, that if one clicks on the chapter link and then with some scrolling that one arrvies at the method table. The method table is fine as it groups the methods by class and instance methods. Though they are not ordered alphabetically either (e.g. connectStaticEvent is at the end of the method table, newStatic at the beginning, and all create*-methods in between (and it seems that they are ordered alphabetically. Personally, I would find it very helpful, if the TOC-entries list the items alphabetically (maybe grouped by class, methods etc.). This would allow to find and link directly from the TOC-frame on the left hand side. ---rony -- All of the data generated in your IT infrastructure is seriously valuable. Why? It contains a definitive record of application performance, security threats, fraudulent activity, and more. Splunk takes this data and makes sense of it. IT sense. And common sense. http://p.sf.net/sfu/splunk-d2d-c2 ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
