>> << Ndx Usr Pri Phr Dic Rel Voc !: wd Help User

# Old Windows Release Notes (material not merged into general docs)

# J 4.06 Release

Data displayed with boxes is an important J feature. Previous versions of J for Windows, by default, used oem fonts with linedraw characters for boxes with solid lines. The alternative is `+-|` ascii characters. Linedraw boxes are pretty, but they are also a never ending nuisance. Oem fonts aren't ansi or unicode and are discouraged by Microsoft and other vendors. They aren't standard in Unix and J for Unix uses `+-|`. They are a problem in email. In theory html can handle oem fonts, but across platforms and browsers the reality is a nightmare. Jsoftware has decided that easy html documentation, email communication, and standard usage across platforms outweighs pretty boxes. If you want them for your own use, you can still have them.
Jsoftware favors ascii boxes and the default in this release is ansi "Courier New".
The online J books User, Primer, Phrases, Dictionary, and Release Notes are in html. Select menu Help|Help to get an overview of the J Help System and the integrated index.
A preliminary version of 'Learning J' by Roger Stokes and Ken Iverson's 'Computers and Mathematical Notation' are also available through the J Help System.
A new lab 'A J Introduction' by Ken Iverson is in the Languages category. There are five other new labs by Ken in the Live Texts category.
For details on new features in this release see the Release Notes in the J Help System. The following are a few topics covered in those notes.
By default, explicit definitions keep a copy of the original text with whitespace and comments. This is convenient for casual use and development, but can be a significant and unnecessary space overhead in large production systems. Foreign`9!:41` can change the default so that this space is not used. Production systems should startup with`9!:41[0` .
Locales are more efficient and limits have been removed.
Foreigns`9!:36` and`9!:37` provide output formatting control. Adjust output formatting with Edit|Configure|Parameters.
Dll callbacks are supported. See lab: DLL: Callback.
Symbol and unicode, significant new data types, have been added.
`try.` control structure has been extended and a new control word`throw.` has been added.
`assert.` is a new control word.

# J 4.05 Release

The prokey license was introduced in J 4.05

business

We have consolidated under the name Jsoftware. Iverson Software Inc. has changed its name to Jsoftware Inc. and does the marketing and sales activities previously run by Strand Software (the Strand staff now work directly with Jsoftware).

documentation

The Help for foreigns, wd commands, and runtime have not been updated. Use them in conjunction with the latest information here.

html help

Help menu item HTML Help runs your browser on documents for new J features. Of particular interest are: Performance Monitor, Mapped Boxed Arrays, Special Code, and Execution Time Limit.

labs

Ken Iverson's Lipshutz lab is a companion to the Seymore Lipshutz "Linear Algebra" of Schaum's Outline Series. Chris Burke's Performance Monitor Utilities lab is an overview of the new performance monitor.

undo/cut/copy/paste (ctrl+zxcv)

The old Win31 shortcuts (alt+backspace/shift+delete/ctrl+insert/shift+insert) are no longer supported in the session manager. This was necessary to simplify resolving conflicts between shortcuts for the session manager, forms, controls, and OCX.

debug

dbr 2 ( 13!:0[2 ) does not require a prokey and records information before clearing the stack. The debug latent expression ( 13!:15 ) executes after the stack is cleared and debug is reset. See HTML Help for more information. The stack information is recorded as:

`STACK_ERROR_INFO_base_=: (13!:11;13!:12;13!:13;18!:5) ''`

jfiles

A change in 3!:1 means that jfiles written with J version 405 cannot be read by earlier versions. J405 can read jfiles created by earlier versions. The change in 3!:1 supports writing and reading binaries in standard and reverse byte order. For more information, see Help|HTML Help|3!:1, 3!:2, and 3!:3 Extended.

regex and socket

The regex (16!:x) and socket foreigns (17!:x) have been decommitted. regex.ijs and socket.ijs scripts now use dll call (cd) to provide the same services. This is similar to how we previously decommitted the data driver (14!:x) foreigns. This results in a smaller, more portable J engine and in more open systems where you have full access to the scripts and underlying system services.

Socket verbs return the result code linked with the result, rather than catenated as in previous releases.

command line

The form is: [filename] [ /command [parameter] ] ..

Standard profile (system\extras\config\profile.ijs) is run unless there is a /jnoprofile command.

Filename is run after the standard profile.

There are 3 types of commands: windows, J startup, and application.

windows:

/register (or /regserver) - register JEXEServer and JDLLServer
/unregister (or /unregsever) - unregister JEXEServer and JDLLServer
/embedding - start as Automation server for COM client

J startup (start with j, as will new ones)

/jnoprofile - start without standard profile
/jtemp path - temp directory
/jddename servername
/jrt - runtime application (see runtime section)

Application commands can be used in the application (wd'qmdline').

Examples:

profile (show session)
c:\j.exe
profile (show session), run foo.ijs
c:\j.exe user\foo.ijs
profile (hide session), run foo.ijs (simple runtime app)
c:\j.exe user\foo.ijs /jrt
no profile, run foo.ijs (production runtime app)
c:\j.exe app.ijs /noprofile /jrt

window driver

wd'...' 65k argument limit removed and 65k result limit is now 500k.

makejr - decommitted (see runtime section)

makejl - decommitted (see runtime section)

picon filename n - set form icon with icon n from file (exe, dll, or ico file) wd'picon system\examples\data\jy.ico 0' qrt - decommitted (see runtime section) smicon filename n - set sm icon (see picon)

runtime

The J license is free and you can distribute runtime applications that include as much of the J system as required.

Simple runtime applications can use the standard profile. Production runtime systems should be built with the Project Manager.

/rt parameter is decommited. You have to rework old runtime applications.

/jrt parameter causes the standard profile to not do an smmfshow command to show the session manager. The runtime app can have the standard profile, but not show the session manager. If there is an error and the session manager is invisible, J terminates with a message box saying there was an error. If J finishes execution and the session manager is invisible and there are no forms, then J terminates.

wd'picon ...' sets form icons for the application.

wd commands makeijr and makeijl are desupported. ijr files are no longer supported. ijl files are created by 3!:6 .

system\examples\demo\runtime.ijs is a simple runtime application. Open and experiment with the script. Run it from an icon or Start|Run with command line:

`c:\j405\j.exe system\examples\demo\runtime.ijs /jrt`

system\examples\runtime\bldrt.bat creates a production runtime application setup and distribution. Study the bldrt.bat file and run it to create a distributable J runtime application.

ocx controls

OCX controls with ids with blanks are supported by the form editor with quotes. For example: "ocx:rmocx.RealPlayer G2 Control.1"

OLE command picture and object arguments start with a !. For example:

`wd'olemethod images listimages add ,, !picture:abc.bmp'`

If the argument contains blanks, it must be quoted, but then it can't be distinguished from quoted data. A ! by itself is an escape so that the next parameter can be a quoted picture or object argument. For example:

`wd'olemethod ... ,, ! "!picture:my abc file.bmp"`

'

addons (LAPACK and FFTW)

J addons are installed in the J addon directory. Old addon downloads won't install in the proper place for J4.05 and new downloads won't install in the proper place for previous releases.

COM

The j.exe and j.dll tlb files are now included as resources and are no longer separate files. The J installation registers both the JEXEServer and JDLLServer COM objects. Use jreg.bat to register or unregister.

# J 4.04 Release

Release 4.04 has sparse arrays, changes in J COM objects, and OCX license support.

Sparse arrays

Sparse arrays provide a compact and efficient storage form for very large arrays where most elements are zero or some other "sparse element". The sparse array representation does not store extra copies of the sparse element. J primitives work directly on sparse arrays. A new verb $. converts between sparse and dense representations of arrays.

In this release, only numeric arrays can be sparse. Subsequent releases will support sparse character and boxed arrays.

Run lab Sparse Arrays for a quick overview of the new facility. For detailed information, see Help|HTML Help|Sparse Arrays.

J COM objects

GetB and ErrorTextB methods in previous versions incorrectly returned a BSTR with a count that included the terminating NULL. This bug has been fixed. Applications with workarounds may need fixing.

Multiple JDLLServer COM objects are now supported. Each JDLLServer object created is a complete new instance of J. Previously each JDLLServer object shared the same globals (for example, symbol tables) and was not useful. It is now possible to efficiently create completely independent, in-process, J COM objects.These independent J COM objects can run in the same threads or in different threads.

The direct DLL interface to J requires new, explicit calls to create and free a J instance and the instance handle is a new parameter to all other calls. For example:

    	HANDLE pj = JInit(); // get handle for new J instance
    	JDo(pj, "a=:i.5");
    	JFree(pj);           // free J instance

OCX license

OCX controls distributed with a J application can be distributed in a runtime version that requires license information when they are created. On a system with the design time OCX installed, use olegetlic to get the license The progid is the same id used in the cc command (without the ocx: prefix). To create the OCX on a system with a runtime OCX, use olesetlic to set the license. The following example uses the FarPoint spreadsheet control.

       fpkey =: wd'olegetlic FPSpread.Spread.2'
       fpkey
    67 0 111 0 112 0 121 0 114 0 105 0 103 0 104 0 116 0 32 0 ...
       (".fpkey) { a.   NB. 2 byte unicode is often readable
    Copyright ...

       NB. in a distributed application set key before cc
       wd'olesetlic FPSpread.Spread.2 ',fpkey
       wd'cc ss ocx: FPSpread.Spread.2'

load utility

The load utility has changed, when loading scripts from a directory that includes a project file. If the left argument of load is not given, then a default locale is used. Previously, this locale was always base; now, if the directory contains a project file, the default locale used is that specified in the projects target locale. This makes it easy to work with individual scripts in a project, since they will automatically load into the projects target locale.

Debug

The Debug window now includes single-step and single-step-into buttons, plus several other commands available on shortcut keys.

The toolbar Open button now responds to the current cursor position. If the name at the cursor is a noun, its definition is displayed in a viewer; otherwise the script where the name is defined is opened.

See Debug for more details, or with the Debug window active, press Ctrl-H for a list of the available shortcut keys.

# J 4.03 Release

Code Editor

The new code editor was written by Andrei Stcherbatchenko and we're sure you'll find it makes life as a J programmer more exciting and productive.

- customized code coloring (Edit|Configure)
- large files (up to 10,000 lines)
- multiple undo and redo
- drag and drop editing
- standard arrow/home/end shortcuts (ctrl /shift modifiers)
- Ins toggles overstrike/insert
- left margin
- quick line selection with mouse
- ctrl+shift+0-9 toggles mark
- alt+0-9 scrolls mark visible
- ctrl+shift+F2 clears marks
- Tab indents (shift+Tab exdents) selected lines
- fixed pitch font required
- ijx output truncated with . . . at 256 characters
- ctrl+shift+up/down arrow recalls lines (used to be ctrl+up/down)

Form colors

You can set form and control (text, text background, and background) colors.

`wd'pcolor R G B' NB. form color wd'setcolor id textR G B textbkgndR G B bkgndR G B'`

You can add these commands in form initialization.

    abc_run=: 3 : 0
    wd ABC
    NB. initialize form here
    wd 'pcolor 0 0 255'
    wd 'setcolor cceditm 255 0 0 0 0 255 0 0 255'
    wd 'pshow;'
    )

The setcolor command can override the gray readonly edit boxes. The setcolor command has no effect on push buttons or the dropdown listbox of a combobox (unfortunate Window facts).

Debug

This release includes a preliminary version of a debug GUI. It is built on top of facilities that have been in J for some time. This version is not complete, and requires changes in the J engine before it can provide all the facilities we envision. However, we found that it is already so useful that we decided to include it in this release. It is a taste of things to come.

Start Debug with Run|Debug. Press the Help button to see documentation. Learn about Debug with the Debug lab.

HTML Publish

Use Run|HTML Publish, or Tools|HTML Publish from Project Manager, to convert scripts to HTML format for the web. Hold down the shift key to convert the active window.

Popup Menu

The release includes Oleg Kobchenko's popup menu, as enhanced by Alex Kornilovski. For more information, see scripts system\packages\winapi\menu.ijs and menudemo.ijs.

       load 'menu'
       wdmenu ' one two three'

ODBC

This release decommits the Data Driver foreign family 14!:x . This interface was written in C and was a closed, black box to J programmers. It didn't support newer versions of the ODBC API and was missing important features.

The new ODBC support was written by John D. Baker and is provided by scripts that use DLL calls to directly access the ODBC API. The J programmer now has the same ODBC access as the C programmer. The new script dd.ijs provides the same functionality as the previous version with DLL calls to the ODBC API, rather than with 14!:x calls. An application that uses dd.ijs should work with the new dd.ijs. There are some performance improvements and significant new functionality such as support for stored procedures. If you are interested in ODBC, work your way through the new ODBC labs.

FFTW AddOn

In addition to the Lapack AddOn, there is now an FFTW AddOn. FFTW is a collection of fast C routines for computing the Discrete Fourier Transform in one or more dimensions. It includes complex, real, and parallel transforms, and can handle arbitrary array sizes efficiently. The FFTW AddOn consists of a DLL incorporating the FFTW routines, plus supporting J scripts and labs. The AddOn is currently only available for Windows 9x/NT. For more information and to download the FFTW AddOn, visit www.jsoftware.com (or use the J cdrom AddOn directory).

Project Manager (PM)

There are several improvements in the Project Manager. If you're an experienced J user and you don't use PM, then we suggest it is time to start. It is great for both small and large projects. If you're new to J, start out right by using PM for all your projects. Start PM from menu command Run|Project Manager.

wd commands

New wd commands (documented in Help|wd commands):

- glgridspace x y - space in from upper left for text
- pcolor R G B - form background color
- setcolor id textR G B textbkgndR B G bkgndR B G - control color
- smcolor n R G B - code editor color
- smkeywords n keywords - code editor keywords (for color)
- smreplace text - replace selected text
- smgetscroll - scroll position of top line
- smflush [bool] - force immediate (unbuffered) output

Enter in a readonly editm control is an enter event.

Miscellaneous

File menu MRU (most recently used) files has 8 items and is retained between sessions.

Bug fixes (thanks to all you out there, particulary J forum members, for giving us the chance to fix them!).

    try. catch. honors debug stops.

Several performance improvements in the J engine.

# J 4.02 Release

Try the new demos pousse and eigenpictures (J LAPACK AddOn is required for eigenpictures).

Take a look at the new lab Fractals Visualization, & J.

Run labs Mapped Names and Files and Mapped File Database to learn about these new facilities. A mapped file can be accessed as if it were memory and a mapped name is an array that is a file.

Run labs DLL: Writing and Using a DLL and DLL: Using System DLLs (file examples) to learn about changes to the 15!:x DLL call facilities. The User Manual chapter DLLs and Memory Management has been updated to reflect the changes. Some of the changes are incompatible with previous releases. Previously this facility was only available in Win95 and NT. It will now be available on all platforms.

A J AddOn is a separately packaged installation that is added on to the base J installation.

The complete LAPACK library is now available with the J LAPACK AddOn. LAPACK (Linear Algebra Package) is a set of routines for solving systems of simultaneous linear equations, least-squares solutions of linear systems of equations, eigenvalue problems, and singular value problems. The associated matrix factorizations (LU, Cholesky, QR, SVD, Schur, generalized Schur) are also provided, as are related computations such as reordering of the Schur factorizations and estimating condition numbers.

Download jlapack.exe and run it after you have installed J4.02. This adds the LAPACK files to the J directory structure. When it is installed, run lab LAPACK to learn about this powerful new addition to J.

J 4.02 Interpreter

The dyad {. has been extended to accept infinities in the left argument, with an infinite value specifying the length of the corresponding axis.

       a=: i.4 5
       a
     0  1  2  3  4
     5  6  7  8  9
    10 11 12 13 14
    15 16 17 18 19
       2 _ {. a           NB. first 2 rows and all columns
    0 1 2 3 4
    5 6 7 8 9
       _ 2 {. a           NB. all rows and first two columns
     0  1
     5  6
    10 11
    15 16
       _1 __ {. a         NB. last row and all columns
    15 16 17 18 19
       _ {. a             NB. all rows and all columns
     0  1  2  3  4
     5  6  7  8  9
    10 11 12 13 14
    15 16 17 18 19

The monad i: has rank 0; i: n gives integers from -n to n inclusive; i: a j. b gives numbers from -a to a in b equal steps.

       i: 5
    _5 _4 _3 _2 _1 0 1 2 3 4 5
       i: _5
    5 4 3 2 1 0 _1 _2 _3 _4 _5
       i: 5j4
    _5 _2.5 0 2.5 5
       i: _5j4
    5 2.5 0 _2.5 _5
       i: 2.5j4
    _2.5 _1.25 0 1.25 2.5
       i: 5j_4
    |domain error
    |       i:5j_4

On extended precision arguments, the determinant -/ .* runs faster in less space.

       ts=: 6!:2 , 7!:2@]          NB. time and space
       ts '-/ .* h' [ h=: % >: +/~ i.10x
    0.14 37888
       ts '-/ .* h' [ h=: % >: +/~ i.20x
    2.073 291520

J 4.01 Release

Use =: for global definitions in scripts. Run|Window and Run|File use load and definitions made with =. are local to load and disappear when it finishes.

The J file suffix has changed from .j? to .ij? ( .js to .ijs ) to avoid javascript conflicts. Use system\extras\migrate\ext.ijs if you have lots of files.

system directory contains the other distributed directories (main\stdlib.js is now system\main\stdlib.ijs).

>> << Ndx Usr Pri Phr Dic Rel Voc !: wd Help User