Hi Jakob,
do you have any means to definitively retrievethis note when you or anyone else actually writes the release notes? ;-)
Thank you for raising this question! For the last release notes, I did a quick search in Squeak Inbox Talk for "breaking change" in the timespan of the previous alpha version and skimmed the results quickly, which yielded 17 conversations that I was able to skim pretty quickly.
However, this step is not documented anywhere. The entire process of writing release notes could benefit from some better documentation. (I also have too many other changes lying around in my working copy of SIT, one of them is a filter to search for versions for a particular release only which I used for the 6.0 release. I should really find some time to commit all of this stuff ...)
maybe initialize these release notes right now
As already mentioned earlier [1], I wanted to propose that we migrate the release notes into the image using the HelpBrowser (similar to Help-Squeak-Project, maybe create another package for it?). Serializing, versioning, and deploying them through the squeak-app repository really felt unconvenient for me. We still could maintain a generated HTML version of them if we feel a need for this.
Best, Christoph
[1] http://lists.squeakfoundation.org/pipermail/squeak-dev/2022-June/221167.html
--- Sent from Squeak Inbox Talk
On 2022-11-28T17:21:25+01:00, jakres+squeak@gmail.com wrote:
Hi Christoph,
Question to present you: do you have any means to definitively retrieve this note when you or anyone else actually writes the release notes? ;-)
If there is a practical means to do so, maybe initialize these release notes right now and already write it down.
Kind regards, Jakob
Am Mo., 28. Nov. 2022 um 16:10 Uhr schrieb < christoph.thiede at student.hpi.uni-potsdam.de>:
Note for future self: This is a breaking change that should be documented in the next release notes. :-)
Best, Christoph
On 2022-09-06T16:03:35+00:00, commits at source.squeak.org wrote:
David T. Lewis uploaded a new version of Chronology-Core to project The
Trunk:
http://source.squeak.org/trunk/Chronology-Core-dtl.80.mcz
==================== Summary ====================
Name: Chronology-Core-dtl.80 Author: dtl Time: 19 May 2022, 12:03:05.720962 pm UUID: 1b1b97c4-bc35-408d-b548-f0d0376a0808 Ancestors: Chronology-Core-dtl.79
Change DateAndTime>>offset: to be compliant with the ANSI draft spec.
The offset: method should answer an instance equivalent to the receiver, where equivalent means having the same UTC time.
Let #offset: adopt the prior behavior of #utcOffset: and let #utcOffset:
be a compatibility synonym for #offset:. Add #asLocalAt: to the squeak protocol and let it implement the prior behavior of #offset: Change existing code and tests to use #asLocalAt: but otherwise retain existing behavior.
Issue reported at
https://github.com/squeak-smalltalk/squeak-object-memory/issues/23
=============== Diff against Chronology-Core-dtl.79 ===============
Item was added:
- ----- Method: DateAndTime>>asLocalAt: (in category 'squeak protocol')
- asLocalAt: anOffset
"Answer a DateAndTime for a different time zone offset that hasthe same
year, month, day, hour, minute, and second as this instance, andwith
printString that matches except for time zone offset."| newOffset newMicros |newOffset := anOffset asDuration asSeconds.newMicros := localOffsetSeconds - newOffset * 1000000 +utcMicroseconds.
^ self class utcMicroseconds: newMicros offset: newOffset- !
Item was changed: ----- Method: DateAndTime>>offset: (in category 'ansi protocol') ----- offset: anOffset
"Answer a <DateAndTime> equivalent to the receiver but with itslocal time
being offset from UTC by offset.
"Answer a DateAndTime for a different time zone offset that hasthe same
year, month, day, hour, minute, and second as this instance, andwith
printString that matches except for time zone offset."
See asLocalAt: for the earlier behavior of this method."^ self classutcMicroseconds: utcMicrosecondsoffset: anOffset asDuration asSeconds!
| newOffset newMicros |newOffset := anOffset asDuration asSeconds.newMicros := localOffsetSeconds - newOffset * 1000000 +utcMicroseconds.
^ self class utcMicroseconds: newMicros offset: newOffset- !
Item was changed: ----- Method: DateAndTime>>utcOffset: (in category 'squeak protocol')
utcOffset: anOffset
"Compatiblity. Answer a DateAndTime equivalent to the receiver butoffset from UTC by anOffset."
^ self offset: anOffset!
"Answer a DateAndTime equivalent to the receiver but offset fromUTC by anOffset"
^ self classutcMicroseconds: utcMicrosecondsoffset: anOffset asDuration asSeconds!Item was changed: ----- Method: Timespan class>>current (in category 'squeak protocol')
current
^ self starting: (DateAndTime now asLocalAt: self defaultOffset)!
^ self starting: (DateAndTime now offset: self defaultOffset)!