add doc reference and modify CHANGELOG

CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 
-## [v4.0] - 2024-
+## [v4.0] - soon ...
+
+### This is a breaking release compared with v3.8
+
+Some 'invalid' `Point` methods have been removed:
+
+- broadcasting `between.(pt1, pt2, range)` now needs `Ref`; `between.(Ref(pt1), Ref(pt2), range)` (or use the new for 4.0 method `between(pt1, pt2, range)`)
+
+- `Point(x, y) .+ n` is no longer valid. Use `Point(x, y) .+ Point(m, n)`.
 
 LaTeX support is still under development. 
 See https://github.com/JuliaGraphics/Cairo.jl/pull/357.
@@ -10,8 +18,8 @@ See https://github.com/JuliaGraphics/Cairo.jl/pull/357.
 - `textformat()`
 - `polysmooth()` has `close` option
 - `markcells()` and `getcells()`
-- package extension for LaTeX
-- CompatHelper git workflow
+- use package extension for LaTeX support
+- add CompatHelper git workflow
 
 ### Changed
 

docs/src/howto/animation.md

@@ -5,13 +5,14 @@ DocTestSetup = quote
 ```
 # Animation helper functions
 
-
 !!! note
 
     [Javis.jl](https://github.com/JuliaAnimators/Javis.jl) is the best way to make animated graphics  with Julia.
 
 Luxor provides some functions to help you create simple animations. It provides some assistance in creating lots of individual frames, and you have the option of stitching these together to form a moving animation in the animated GIF format.
 
+If you're looking for a way to display animations in another window, with live updates, see the [Interactive graphics and Threads](@ref) section.
+
 There are four steps to creating an animation.
 
 1 Use `Movie` to create a Movie object which determines the title and dimensions.
@@ -24,6 +25,7 @@ There are four steps to creating an animation.
 
 You can use the `creategif = true` option to make an animated GIF. But if you want to generate many thousands of frames, you might want to keep the `creategif` option set to the default value of false, and build the animation later. 
 
+
 ## Example
 
 ```julia