Good evening Clinton, Thanks for the background information. The detail description that I am writing up is probably better for a supplementary document. It is a bit more verbose than would just fit directly into the Unicon Book.
When I finish it, I sort out an appropriate format and forward to you for review. regards Bruce Rennie On 14/04/15 17:43, Jeffery, Clint ([email protected]) wrote: > Dear Bruce, > > Ralph Griswold was fond of saying, more or less, that the source code of the > implementation was the final reference and operational semantics for the > language. The most detail I got from a quick scan of the Icon book 3rd > edition was > > The function center(s1, i, s2) centers s1 in a string of length i, padding on > the left and right, if necessary, with s2. If s1 cannot be centered exactly, > it is placed to the left of center. > > The Unicon book at present tends not to try and trump the Icon book in terms > of precise definition of behavior defined originally in Icon, but now is our > opportunity to improve it. If you want to author a supplementary detailed > reference doc you are welcome to do so. If we can agree on a > Unicon-programmer-friendly, reasonably concise set of > clarifications/expansions of the function descriptions that are in the Unicon > book, I would be more than happy to put them in there directly. > > Best regards, > Clint > ________________________________________ > From: Bruce & Breeanna Rennie <[email protected]> > Subject: [Unicon-group] Detailed explanation of how Unicon/Icon system > functions work > > Good morning Clinton, > > I am wondering if there is any documentation available that describes > the full functionality of each of the system functions available in > Unicon/Icon. > > for example we find the following explanation in the Programming with > Unicon Book: > > *center(s, i:1, s:” ”) : string* > center string > center(s1,i,s2) produces a string of i characters. If i > *s1 then s1 is > padded equally on the left and right with s2 to length i. If i < *s1 then the > center i characters of s1 are produced. > > However, this explanation does not give the detailed result that will be > obtained when the length of s1 is odd and when it is even. Neither does > it give the detailed results when the length of s2 is greater than 1. > > I am in the process of converting my UFT8 code to a class based format. > I am creating the UFT8 equivalents for each of the system defined string > functions. These will be able to be used in string scanning where the > &subject is an UFT8 string. > > If there is detailed documentation already done, I will use that as > comments within the code. As well as use it to verify the results > obtained from the UFT8 methods. > > If there is not, I will create a supplementary document that gives the > full details and will base it on the comments I place in the UFT8 class > file. > > I should note here that the class structure and usage that I am using > for this has some similarities to what may be seen in Python and > Javascript (sort of). I have been slowly converting a number of code > bases currently available in both of these languages to Unicon/Icon. As > a result, I have created a couple of analogues in Unicon for some of the > "features" found in the code bases. > > Hence, the documentation for the UFT8 class will have additional details > on how it is designed to work in conjunction with these additional > parent classes. I'll release as soon as I have completed the current > class development. > > regards > > Bruce Rennie > > ------------------------------------------------------------------------------ > BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT > Develop your own process in accordance with the BPMN 2 standard > Learn Process modeling best practices with Bonita BPM through live exercises > http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_ > source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF > _______________________________________________ > Unicon-group mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/unicon-group > ------------------------------------------------------------------------------ > BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT > Develop your own process in accordance with the BPMN 2 standard > Learn Process modeling best practices with Bonita BPM through live exercises > http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_ > source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF > _______________________________________________ > Unicon-group mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/unicon-group > ------------------------------------------------------------------------------ BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT Develop your own process in accordance with the BPMN 2 standard Learn Process modeling best practices with Bonita BPM through live exercises http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_ source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF _______________________________________________ Unicon-group mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/unicon-group
