mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-06-09 21:40:33 +02:00
Code Activity

Clean up NEWS for bitvectors.

Browse source 
* NEWS: Cleanups.
This commit is contained in:
Andy Wingo 2020-05-12 10:18:02 +02:00
parent 9c4c6322f5
commit 00a163add4
1 changed files with 35 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

69
NEWS
View file

@ -9,84 +9,85 @@ Changes in 3.0.3 (since 3.0.2)
* New interfaces and functionality * New interfaces and functionality
** New bitvector-count, bitvector-count-bits, bitvector-position ** Refreshed bitvector facility
procedures
See "Bit Vectors" in the manual, for more on all of these.
*** New bitvector-count, bitvector-count-bits, bitvector-position
procedures
These replace the wonky "bit-count", "bit-count*", and "bit-position" These replace the wonky "bit-count", "bit-count*", and "bit-position"
procedures. See "Bit Vectors" in the manual, for more. procedures.
** New bitvector-bit-set?, bitvector-bit-clear? procedures *** New bitvector-bit-set?, bitvector-bit-clear? procedures
These replace bitvector-ref. The reason to migrate is that it's an These replace bitvector-ref. The reason to migrate is that it's an
opportunity be more efficient in 3.0 (because no generic array support), opportunity be more efficient in 3.0 (because the new procedures only
easier to read (no need for 'not' when checking for false bits), and work on true bitvectors, and not generic bit arrays), easier to read (no
more consistent with other bitvector procedures. need for 'not' when checking for false bits), and more consistent with
other bitvector procedures.
** New bitvector-set-bit!, bitvector-clear-bit! procedures *** New bitvector-set-bit!, bitvector-clear-bit! procedures
These replace bitvector-set!, for similar reasons as the bitvector-ref These replace bitvector-set!, for similar reasons as the bitvector-ref
replacement above. replacement above.
** New bitvector-set-all-bits!, bitvector-clear-all-bits! procedures *** New bitvector-set-all-bits!, bitvector-clear-all-bits! procedures
These replace bitvector-fill!. These replace bitvector-fill!.
** New bitvector-flip-all-bits! procedure *** New bitvector-flip-all-bits! procedure
This replaces bit-invert!. This replaces bit-invert!.
** New bitvector-set-bits!, bitvector-clear-bits! procedures *** New bitvector-set-bits!, bitvector-clear-bits! procedures
These replace the wonky "bit-set*!" procedure. See "Bit Vectors" in the These replace the wonky "bit-set*!" procedure.
manual, for more.
* New deprecations * New deprecations
** bit-count, bit-position deprecated ** Old bitvector interfaces
Use bitvector-count or bitvector-position instead. See "Bit Vectors" in See "Bit Vectors" in the manual, for details on all of these
the manual. replacements.
** 'bitvector-ref' deprecated *** bit-count, bit-position deprecated
Use bitvector-count or bitvector-position instead.
*** 'bitvector-ref' deprecated
Use 'bitvector-bit-set?' or 'bitvector-bit-clear?' instead. Use 'bitvector-bit-set?' or 'bitvector-bit-clear?' instead.
** 'bitvector-set!' deprecated *** 'bitvector-set!' deprecated
Use 'bitvector-set-bit!' or 'bitvector-clear-bit!' instead. Use 'bitvector-set-bit!' or 'bitvector-clear-bit!' instead.
** 'bitvector-fill!' deprecated *** 'bitvector-fill!' deprecated
Use 'bitvector-set-all-bits!' or 'bitvector-clear-all-bits!' instead. Use 'bitvector-set-all-bits!' or 'bitvector-clear-all-bits!' instead.
** 'bit-invert!' deprecated *** 'bit-invert!' deprecated
Use 'bitvector-flip-all-bits! instead. Use 'bitvector-flip-all-bits! instead.
** 'bit-set*!' deprecated *** 'bit-set*!' deprecated
Use 'bitvector-set-bits!' or 'bitvector-clear-bits!' instead. Use 'bitvector-set-bits!' or 'bitvector-clear-bits!' instead.
** 'bit-count*' deprecated *** 'bit-count*' deprecated
Use 'bitvector-count-bits' instead, subtracting from 'bitvector-count' Use 'bitvector-count-bits' instead, subtracting from 'bitvector-count'
on the mask bitvector if you are counting unset bits. on the mask bitvector if you are counting unset bits.
** Passing a u32vector to 'bit-set*!' and 'bit-count*' deprecated *** Accessing generic arrays using the bitvector procedures deprecated
These functions had an interface that allowed the second bit-selection
argument to be a u32vector of bit indices to select. This added only
complexity and no efficiency compared to just calling 'bitvector-set!'
or 'bitvector-ref' in a loop.
** Accessing generic arrays using the bitvector procedures deprecated
For the same efficiency reasons that use of 'vector-ref' on generic For the same efficiency reasons that use of 'vector-ref' on generic
arrays was deprecated in Guile 2.0.10, using 'bitvector-ref' and similar arrays was deprecated in Guile 2.0.10, using 'bitvector->list' and
procedures on 1-dimensional boolean-typed arrays is now deprecated. Use similar procedures on 1-dimensional boolean-typed arrays is now
'array-ref' and similar procedures on arrays. deprecated. Use 'array-ref' and similar procedures on arrays.
** scm_istr2bve deprecated *** scm_istr2bve deprecated
This C-only procedure to parse a bitvector from a string should be This C-only procedure to parse a bitvector from a string should be
replaced by calling `read' on a string port instead, if needed. replaced by calling `read' on a string port instead, if needed.