File: NEWS

package info (click to toggle)
slang2 2.3.1-5
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 10,580 kB
  • ctags: 10,851
  • sloc: ansic: 96,830; sh: 3,373; makefile: 1,033; pascal: 143
file content (561 lines) | stat: -rw-r--r-- 16,392 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
NEWS for version 2.3.x                                             -*-text-*-

24 bit color support (new for version 2.3.1)
============================================

  The SLtt interface has been modified to support 24 bit (true)
  colors.  Until the next major release (version 3), this feature is
  available for 64 bit Unix/VMS systems to keep binary compatibility.
  Support for 32 bit systems will be added in version 3.

  Since not all terminals support true color, and it is not supported
  by terminfo, 24 bit color is disabled by default.  A list of
  terminals that support true color may be found at
  <https://gist.github.com/XVilka/8346728>.

  To indicate that a terminal supports true color, set the value of
  the environment variable COLORTERM to either "24bit" or "truecolor",
  e.g.,

      export COLORTERM=truecolor

  Then to use 24 bit color in applications such as jed and slrn, use a
  24bit RGB value in the form "#RRGGBB" as the name of the color.
  For example, to set the color of the status line in jed to AliceBlue
  (#F0F8FF) on a SlateGray (#708090) background, use

      set_color ("status", "#F0F8FF", "#708090");

  in the .jedrc file.  In slrn, to set the color of the author name to
  the above colors use

      color author "#F0F8FF" "#708090"

  in the .slrnrc file.  Also note other character attributes may be
  specified, e.g., "#F0F8FF;italics;underline".

New Modules
===========

   1. base64: A base64 encoder/decoder module
   2. chksum: A module for computing various checksums (currently md5
      and sha1)
   3. stats: A statistics module
   4. histogram: A histogram module
   5. json: Encode/decode json structures

Intrinsic Functions
===================

   The following intrinsic functions have been added for 2.3.x:

     sincos : returns both sin and cos in one function call

     get/setitimer: get/set an interval timer

     wherefirstmin/max, wherelastmin/max: returns index for first/last
       min/max values of an array

     wherefirst_eq/ne/gt/lt/ge/le, where_last_eq/ne/gt/lt/ge/le:
     returns first/last index of an array where the array value is
     eq/ne/gt/lt/ge/le of a specified value. (version 2.3.1)

     wherediff: returns indices where adjacient elements of an array
       differ.

     bstrjoin, bstrcat: like strjoin/strcat but for binary strings.

     get_environ: returns an array of currently defined environment variables.

     getrusage: Get resource usage

     lchown: Change ownership of a symbolic link

     get/set_printable_bstring_size: Get/set the length of the
     printable representation of binary strings. (version 2.3.1)

     statvfs: Intrinsic that wraps statvfs POSIX function that returns
     file system statistics. (version 2.3.1)

     _ftime:  returns the number of (wallclock) seconds since an epoch
     (version 2.3.1)

     wchars_to_string/string_to_wchars: Convert a UTF-8 encoded string
     to and from an array of Unicode characters. (version 2.3.1)

   The following functions have been enhanced:

     array_map modified to support multiple return values.

     is_substrbytes: Added support for an optional offset into the
       string.

     _push_struct_field_values: An optional argument may be used to
     specify the fields to be pushed. (version 2.3.1)

Interpreter Syntax
==================

   The step parameter was made optional for the _for statement.

   Struct field names may be an arbitrary string:

         X = struct {"some-field", some_other_field };
         X.some_other_field = 3;
         X."some-field" = 4;

   String literals now support \uABCD to specify a 32 bit unicode
   character.  Previously, the braces were required (\u{ABCD}).
   (version 2.3.1)

Module Updates
==============

   stats-module: Added Anderson-Darling normality and
   k-sample tests (version 2.3.1)


slsh library (used by conforming slang apps such as jed, slrn, ...)
===================================================================

   fswalk.sl: Functions that facilitate walking the filesystem.

   listfuns.sl: Set of functions dealing with lists and list-based
     structures (e.g., heaps).

   rearrange: Performs an in-place arrangement of values in an array
     or list (defined in arrayfuns.sl).


slsh
====

   Using "who" at the slsh> prompt will list the names/values of
   variables and functions defined at the prompt.

API News
========

   Note: The slang 2.3.x API is backward binary compatible with slang
   2.y.z.

   Font attributes (italics, bold, underline, ...) may be enabled for
   terminals that support them by using a color name with a qualifier:

       SLtt_set_color ("menu", "white;italics", "blue");
       SLtt_set_color ("comment", "black;underline;italics", "cyan");

   SLang_init_tty: if flow control parameter is negative, the
   terminal's flow control setting will not be changed.

   New functions:

     Functions for dealing with qualifiers passed to intrinsic
     functions:
        SLang_qualifier_exists;
	SLang_get_int_qualifier;
	SLang_get_long_qualifier;
	SLang_get_double_qualifier;
	SLang_get_string_qualifier;

     Callback functions that allow an app additional hooks into the
     slang readline functions:

        SLrline_set_free_update_cb;
	SLrline_set_update_clear_cb;
	SLrline_set_update_preread_cb;
	SLrline_set_update_postread_cb;
	SLrline_set_update_width_cb;
	SLrline_get_update_client_data;

     Functions for dealing with interpreter associative arrays:

	SLang_create_assoc;
	SLang_push_assoc;
	SLang_pop_assoc;
	SLang_free_assoc;
	SLang_assoc_put;
	SLang_assoc_get;
	SLang_assoc_key_exists;

     Functions for dealing with interpreter list objects:

        SLang_create_list;
	SLang_list_append;
	SLang_list_insert;
	SLang_push_list;
	SLang_pop_list;
	SLang_free_list;

     Functions for dealing with interpreter structures:

        SLang_create_struct;
	SLang_push_struct_field;
	SLang_pop_struct_field;
	SLang_pop_struct_fields;

     Miscellaneous Functions:

        SLstack_exch;
	SLcompute_string_hash;
	SLpath_getcwd;

=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=

NEWS for version 2.2.x                                             -*-text-*-

Interpreter Enhancements
========================

   1.  The ternary expression was added:

           expression = condition ? val1 : val2

       If condition is non-zero, then expression = val1,
        otherwise expression = val2

   2.  The break and condition statements support an optional integer
       that indicates how many loop levels the statement affects, e.g.,
       the break statement in

           while (1)
	     {
	         loop (10)
		    {
		        break 2;
		    }
	     }

       will cause both loops to be terminated.

   3.  Multiline strings have been added:

           "This is a \
	    multiline \
	    string"

           `This is
	    another multiline
	    string that
	    does not require
	    a \ for continuation`

    4.  List_Type objects may be indexed using an array of indices
        instead of just a single scalar index.

    5.  (v2.2.3) Binary literal integers of the form 0bxx...x are supported.
        Here, x is 0 or 1.  The printf "%B" format specifier was added
	to format integers as binary.

    6.  (v2.2.3) The dereference operator (@) may be used in a structure
        definition to include the fields from the dereferenced
	structure, e.g.,

	  space = struct {x, y, z};
	  spacetime = struct {@space, t};

    7.  (v2.2.3) Dereferencing a scalar or vector class type now
       results in duplication of the object, e.g, @7 will produce 7.

    8.  (v2.2.3) Mergesort was made the default sorting algorithm.  See the
        array_sort for details.

Modules
=======

   1.  zlib: A module that wraps the popular z compression library.

   2.  fork: A module that wraps the fork, exec*, and waitpid functions.

         slsh/lib/process.sl utilizes this module to allow an
	 application to easily create subprocesses and pipelines.

   3.  sysconf: Module that implements interfaces to the posix
       sysconf, pathconf, etc. functions.

   4.  (2.2.3) csv: A module that supports the reading and writing of
       so-called Comma Separated Values files.

Intrinsic Functions
===================

   The following intrinsic functions have been added for 2.2.x:

      sumsq
          equivalent to sum(x*x)

      expm1
          More accurate version of exp(x)-1 for x near 0.

      log1p
          More accurate version of log(1+x) for x near 0

      list_to_array
          Creates an array from a list.

      string_matches
          A convenient alternative to string_match and string_match_nth
	  functions.

      strskipbytes (v2.2.3)
          Skip a range of bytes in a byte string.

      is_substrbytes (v2.2.3)
          Like is_substr except this works with binary strings
	  containing embedded null characters.

      strskipchar, strbskipchar (v2.2.3)
         Analogous to C ch=*p++ and ch=*p-- for UTF-8 encoded strings.

      _close
          Close an integer descriptor
      _fileno
          Returns the descriptor as an integer

      dup2, getsid, killpg, getpriority/setpriority
          Wraps the corresponding system functions.

      utime (v2.2.3)
          Change a file's last access and modification time.

      ldexp, frexp:
          If x == a*2^b, where 0.5<=a<1.0 then (a,b)=frexp(x),
	  and x=ldexp(a,b).

      islower, isupper, isxdigit, isalnum, isalpha, iscntrl, isprint,
      isgraph, ispunct, isblank, isascii, isspace (v2.2.3):
          Character classification functions.

      list_append, list_join (v2.2.3)
          Functions for merging two lists together.

      ttyname (v2.2.3)
          Get the name of the terminal

      timegm (v2.2.3)
          Inverse of gmtime

   The following functions have been enhanced:

      hypot
          If given a single array argument, it returns the equivalent
	  of sqrt(sum(X*X)).

          Support for N arrays added for e.g., the Euclidean norm in
	  an N dimensional space (v2.2.3)

      _min, _max: (v2.2.3)
          Added support for more than two elements.

      polynom
          The calling interface to this function was changed and
	  support added for arrays.

      strjoin (v2.2.3)
          delimiter made optional

      strreplace (v2.2.3)
          New usage designed to facilitate the most common case where
	  one wants to replace all the substrings.

      strtrans (v2.2.3)
          Additional character classes added (see documentation).

      string_match, string_matches (v2.2.3)
          The position argument made optional

   The following string functions have been vectorized to act upon
   arrays of strings (v2.2.3):

       is_substr
       str_delete_chars
       strbytelen
       strcharlen
       strcmp
       strcompress
       strlen
       strlow
       strnbytecmp
       strncharcmp
       strncmp
       strtrans
       strtrim
       strtrim_beg
       strtrim_end
       strup


slsh
====
      slang readline enhancements:
         New functions:
	   rline_up/down_hist
	      Behaves similar to zsh up/down-line-or-search functions (v2.2.3).

	   rline_call_editor
           rline_edit_history
	   rline_edit_line
	      Call external editor for line/history editing. (v2.2.3)

         Structure field completion. (v2.2.3)

         Instead of scrolling horizontally when editing a line,
	 attempt to wrap the line. (v2.2.3)

         setfuns.sl: Various set functions: unique, intersection,
	 complement,union (v2.2.3)

Misc
====

   Unicode tables updated to version 5.1.

=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x=x

NEWS for version 2.1

Building the library
====================

   `make install' installs the shared version of the library.
   Previously `make install' installed just the static version and a
   separate step (`make install-elf') was required to install the
   shared version.  Now, `make install-static' is necessary to install
   the static one.

Interpreter News
=================

Syntax enhancements:
--------------------

   1.  Short circuiting boolean operators:

           if ((x == y) || (y == 3) && (x != 4)) ...

       (orelse and andelse are deprecated)

   2.  Structure definitions allow embdedded assignment expressions:

           s = struct {x = 3, name="foo", a = [1:10]};

   3.  Qualifiers (aka "keywords") added to the language:

           save_file ("foo.c"; overwrite=1);
	   plot_points ([1:10], sin([1:10]); color="red", style="solid");

   3.  Expressions such as (a < b < c) now interpreted to mean
       (a<b)and(b<c).

   4.  New keywords: ifnot, then

       ifnot may be used instead of !if, which has been deprecated.
       For "then" see the next item.

   5.  Looping constructs support a "then" clause that will get
       executed if the loop runs to completion, e.g.,

           loop (20)
	    {
	       if (this ())
	         break;  % The then clause will NOT get executed
	    }
	   then do_that ();

   6.  A floating point array of exactly N elements may be created
       using the form [a:b:#N], where the elements are uniformly
       spaced and run from a to b, inclusive.

   7.  References to array elements and structure fields are
       supported, e.g., &A[3], &s.foo.

   8.  An exception may be rethrown by calling "throw" without any
       arguments:

           try { something (); }
	   catch AnyError: { do_this (); throw; }

New Intrinsic Functions:
------------------------

   wherenot(x) :
              Equivalent to where (not(x))

   _$(str) :
              Evaluates strings with embedded "dollar" variables, e.g.,
              _$("$TERM");

   __push_list/__pop_list :
              Push list items onto the stack

   prod(x) :
              Computes the product of an array a[0]*a[1]*...

   minabs(x), maxabs(x):
              Equivalent to min(abs(x)) and max(abs(x))

   getpgrp,setgid, getpgid:
              Get and set the process group (Unix)
   setsid  :
              Create a new session

API News
========

  Although not new I feel that this point should be stressed now
  because it was not emphasized earlier: The SLarray_* functions that
  deal with indices or sizes use `SLindex_Type' instead of `int'.
  Currently, `SLindex_Type' is typedefed to be an `int', but this will
  change in a future version.  So for future compatibility, use
  `SLindex_Type' instead of `int' in functions that deal with slang
  arrays.  Similarly, instead of using SLang_pop_int for obtaining an
  array index, use SLang_pop_array_index.  See the array-specific
  examples in the documentation for more information.

  There have been significant enhancements to the slang readline
  interface.  The interface has been opened up to the interpreter
  allowing for such features as completion and a persistent history
  mechanism.  Applications wishing to take advantage of these features
  should use the new function `SLrline_open2' instead of
  `SLrline_open'.  For an example, see how this function is used in
  slsh/src/readline.c.

  SLclass_patch_intrin_fun_table was added to facilitiate the patching
  of intrinsic tables during runtime.  If you have created dynamically
  loaded modules, then you may have a good idea what this function is
  for.

  The SLang_Traceback variable is now interpreted as a bitmapped
  integer providing greater flexibility and control over traceback
  messages.

  SLerr_throw was added to permit applications to mimic the semantics
  of the `throw' statement.

  SLang_verror_va was added to support calling the error routines with
  a va_list argument.

slsh enhancements
=================

  When configured to use slang's readline routines, new features
  include filename completion and persistent history.

  The profiler was rewritten to be much more friendly, flexible, and
  more accurate.

  struct_filter and struct_combine defined in structfuns.sl have been
  made more flxible.  See their documentation for more information.

  A new function called readascii may be used for reading
  non-binary (or so-called "ascii") data files.

New modules
===========

  The following modules have been added:

      iconv:  Performs character-set conversion using the iconv library.
      onig:   A regular expression module using oniguruma RE library.
      rand:   A random number module