summaryrefslogtreecommitdiffstats
path: root/RELNOTES
diff options
context:
space:
mode:
authorPaul A. Patience <paul@apatience.com>2021-07-10 13:19:33 -0400
committerKaz Kylheku <kaz@kylheku.com>2021-07-10 17:46:20 -0700
commit9ad7251772390c84754cf3798aed63f8e9893df0 (patch)
tree8cf92d87fbab4af97dd1445ed7e94e3bf175a0a1 /RELNOTES
parent5a75bbff7852752ffb09afc57b171dfcf4dbd51a (diff)
downloadtxr-9ad7251772390c84754cf3798aed63f8e9893df0.tar.gz
txr-9ad7251772390c84754cf3798aed63f8e9893df0.tar.bz2
txr-9ad7251772390c84754cf3798aed63f8e9893df0.zip
doc: improve.
* RELNOTES: Fix minor issues. * txr.1: Fix various grammatical errors, typos and other issues. Notably, use en dashes rather than hyphens for ranges of numbers; replace "exponential notation" with "E notation", which is more commonly used (according to Wikipedia; see https://en.wikipedia.org/wiki/Scientific_notation#E_notation); clarify that with-stream is better than with-resources for opening exactly one stream; and use past tense in the Compatibility Version Values section.
Diffstat (limited to 'RELNOTES')
-rw-r--r--RELNOTES24
1 files changed, 12 insertions, 12 deletions
diff --git a/RELNOTES b/RELNOTES
index 39e9278f..5be14bc8 100644
--- a/RELNOTES
+++ b/RELNOTES
@@ -5,20 +5,20 @@
Features
- requirements change in new long-suffix and short-suffix functions:
- - dot is now part of suffix
+ - dot is now part of suffix.
- leading dot is not a suffix delimiter: e.g. .bashrc is not a suffix.
- trailing path separators ignored, like in base-name.
- regex: optimization function exposed.
- constantp function now recognizes more kinds of expressions:
- - (+ 1 (* 3 4)) are constantp as is (symacrolet ((a (+ 2 2))) (* b 3)).
+ - (+ 1 (* 3 4)) is constantp, as is (symacrolet ((a (+ 2 2))) (* b 3)).
- doc function
- now handles situations in which xdg-open blocks until browser exits.
- now reacts to BROWSER variable, and if xdg-open is not found,
falls back on the first of a long list of possible browsers.
- - file system interface:
+ - filesystem interface:
- path-cat function is now variadic: (path-cat "a" "b" "c" ...).
- new path-search function, searches for an executable by name in path,
- defaulting to the system PATH.
+ defaulting to the system's PATH.
- sequences:
- new find-true function; like find-if, but returns the true value
that the predicate produces, rather than the item from the sequence.
@@ -26,7 +26,7 @@
- argument defaulting tightened; functions no longer treat a nil
value for the stream argument as a missing argument.
- stack limit:
- - minimum limit now imposed when the system stack limit is too low,
+ - minimum limit now imposed when the system's stack limit is too low,
rather than disabling the mechanism.
- stack limit is now always on, even if we don't obtain a value
from the system or that value indicates that there is no limit.
@@ -37,7 +37,7 @@
Bugs
- - build: regression in separate directory build.
+ - build: regression in separate-directory build.
- parser: regression: not working with byacc.
- compiler: a number of bugs in inline lambda implementation.
- op: subtle bug in do operator; code refactored.
@@ -45,7 +45,7 @@
- listener: end-of-line/buffer visual glitch in selection.
- trie: bugs in regex-from-trie function, now covered by tests.
- regex: print/read consistency problem printing n-ary operators.
- - doc: *doc-lookup* variable not special, as documented.
+ - doc: *doc-url* variable not special, as documented.
- getopts: throwing sys:opt-error instead of usr:opt-error.
- command line: lack of robustness in -b option fixed.
- documentation: numerous fixes.
@@ -91,9 +91,9 @@
- type mismatches when a string is expected now give
function name in error diagnostic.
- stack overflow protection is introduced:
- - In key places, TXR detects whether the stack pointer is over a
+ - in key places, TXR detects whether the stack pointer is over a
predetermined limit and throws a stack-overflow exception.
- - Controlled by set-stack-limit function.
+ - controlled by set-stack-limit function.
Bugs
@@ -304,7 +304,7 @@
- lib:
- New rel-path function for calculating relative path
between two directories.
- - format function's ~x/~X supports printig buffer
+ - format function's ~x/~X supports printing buffer
objects in hex.
- structural pattern matching:
- new each-match family of macros for iterating over
@@ -1285,7 +1285,7 @@
- configure:
- quote characters handled in config variable values.
- Doc:
- - existing lineno argumnt of read and iread documented.
+ - existing lineno argument of read and iread documented.
- Hashing:
- flaw in weak hash algorithm leading to spurious retention in situations
when keys are weak, but values have reference to keys, or vice versa.
@@ -2954,7 +2954,7 @@
Features
- - read an iread no longer record source code location info
+ - read and iread no longer record source-code location info
unconditionally
- now controlled by new *rec-source-loc* special variable.