Session Manager: Difference between revisions

From NARS2000
Jump to navigationJump to search
No edit summary
No edit summary
 
(8 intermediate revisions by 3 users not shown)
Line 5: Line 5:
* Text may be selected with the mouse and copied using Ctrl-C or <u>C</u>opy from the Context (right-click) or <u>E</u>dit menus.
* Text may be selected with the mouse and copied using Ctrl-C or <u>C</u>opy from the Context (right-click) or <u>E</u>dit menus.
* Text may be pasted into the Session Manager from various formats.  If the source text is all Unicode, Ctrl-V or <u>P</u>aste from the Context or <u>E</u>dit menus may be used.  If the source text includes APL characters in a format different from Unicode, try one of the options in the Paste APL choice from the Context or <u>E</u>dit menus.  Text coming from the ISO Extended APL Standard, APL+Win, APL2, and PC/3270 is supported.  If you know of other systems that use a character mapping not covered by these choices, please let us know by sending a message on one of the [mailto:nars2000-discuss@googlegroups.com forums].
* Text may be pasted into the Session Manager from various formats.  If the source text is all Unicode, Ctrl-V or <u>P</u>aste from the Context or <u>E</u>dit menus may be used.  If the source text includes APL characters in a format different from Unicode, try one of the options in the Paste APL choice from the Context or <u>E</u>dit menus.  Text coming from the ISO Extended APL Standard, APL+Win, APL2, and PC/3270 is supported.  If you know of other systems that use a character mapping not covered by these choices, please let us know by sending a message on one of the [mailto:nars2000-discuss@googlegroups.com forums].
* Multiple workspaces may be open at the same time by used of tabs along the top of the Session Manager window.  Click on a tab to bring the corresponding workspace to the forefront.
* Multiple workspaces may be open at the same time by use of tabs along the top of the Session Manager window.  Click on a tab to bring the corresponding workspace to the forefront.
* Workspaces are saved as plain text ASCII files with an extension of <apll>.ws.nars</apll>.
* Workspaces are saved as plain text ASCII files with an extension of <apll>.ws.nars</apll>.
* To invoke the function editor, type <apll>∇</apll> by itself, or <apll></apll> followed by a name, or <apll>)EDIT</apll> by itself, or <apll>)EDIT</apll> followed by a name, or double-right-click on a function name in the session manager or function editor windows.
* To invoke the function editor, type <apll>∇</apll> or type <apll>)EDIT</apll> by itself, or type <apll></apll> or <apll>)EDIT</apll> followed by a name, or double-right-click on a function name in the session manager or function editor windows.
* The function editor supports a multilevel Undo.  That is, pressing Ctrl-Z reverts back to the previous text.
* The function editor supports a multilevel Undo.  That is, pressing Ctrl-Z reverts back to the previous text.
* Each function's undo buffer is saved with the function for reuse the next time that function is edited.
* Each function's undo buffer is saved with the function for reuse the next time that function is edited.
* All function's undo buffers are saved with the workspace for reuse on the next load.
* Every function's undo buffers are saved with the workspace for reuse on its next load.
* The text entered in both the Session Manager and Function Editor is colored according to its content with respect to the syntax being used.
* '''Alt-<i>nnnn</i>''' may be used to enter arbitrary Unicode characters in decimal.  For example, '''Alt-9735''' is a lightning bolt (<apll>☇</apll>).
 
==APL Font==
 
As NARS2000 is a Unicode-based program, you'll need an appropriate Unicode APL font to correctly display all of the characters.  To that end, I've made an arrangement with Phil Chastney to bundle a version of his APL Unicode font '''SImPL''' called '''SImPL medium'''.  From the '''NARS2000.zip''' file, extract the '''SImPL-Medium.ttf''' file to your Windows fonts directory.  Note that this font is licensed for distribution with NARS2000 only.  Other APL Unicode fonts likely will work well as long as they contain all of the characters we use such as infinity (<apll>∞</apll>), zilde (<apll>⍬</apll>), circle-middle-dot (<apll>⊙</apll>), dieresis-jot (<apll>⍤</apll>), dieresis-tilde (<apll>⍨</apll>), etc.  Also, in order to display the circled numbers on the left of each workspace tab, you'll need a font like '''Code2000''' which you can [http://www.ffonts.net/Code2000.font.zip download] from the 'net.
 
For more details about APL fonts, see [[APL_Font|here]].


==Keyboard Mapping==
==Keyboard Mapping==


The mapping of APL characters to the keyboard is similar to that of APL+Win, although other keyboard mappings may be supported in the future. To see a graphic display of the current keyboard, take a look at [http://www.sudleyplace.com/APL/Keyboard.ahtml NARS2000 Keyboard].
The mapping of APL characters to the keyboard is [[Customization|controlled by the end user]] and can be viewed from within NARS2000 through the menu "Edit | Customize... | Keyboards". Various national language keyboards are supported such as Danish, French, German, UK, and US.
 
==Installing Uniscribe==


This facility is part of Windows and is needed to implement Font Fallback. This latter feature substitutes a glyph from one font when the original font does not have that glyph. For example, in NARS2000 '''Alt-f''' displays an [[Infinity]] symbol (<apll>{infinity}</apll>) only if you have Uniscribe installed; otherwise is shows an empty box to indicate that the glyph is missing in the chosen screen font.
For different look at the US keyboard, visit [http://www.sudleyplace.com/APL/Keyboard.ahtml NARS2000 Keyboard].


To install Uniscribe, bring up the Control Panel, double-click on the "Regional and Language Options" icon, then click on the "Languages" tab to show something like
==Output Debugging==


[[Image:RLO.png|Regional and Languages Options]]
Sometimes the displayed output may appear oddly spaced. This may be due to several reasons one of which is the presence of non-printing ASCII characters (whose character code is in the range 0x00 to 0x1F, excluding CR and LF).  For that case, you may turn on Output Debugging through the menu items '''Edit | Customize... | User Preferences'''.  When enabled, this feature changes the way in which non-printing characters are displayed – instead of the normal behavior of ignoring them, those characters are displayed using a special font which displays each character with its four digit hex code inside a box.  For example,


Check the indicated box (you'll get a message box, click OK on it), then click OK again and dig out your OS install disk.  Point to the '''System32''' directory on your OS install disk and finish the installation.  Finally, reboot your system.
<apll>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;32⍴⎕AV</apll><br />
<span style="font-family:Fallback00-1F;">? !"#$%&'()*+,<br/>
./0123456789:;<=>?</span>

Latest revision as of 16:44, 12 July 2017

The Session Manager is similar to the one in APL+Win (which was modeled after an old product of mine, TallScreen).

Features

  • The cursor may move about the screen changing text as desired. If you press Enter on a line, the original text of that line is restored, the changed line is copied to a new line at the bottom of the screen buffer and executed.
  • Text may be selected with the mouse and copied using Ctrl-C or Copy from the Context (right-click) or Edit menus.
  • Text may be pasted into the Session Manager from various formats. If the source text is all Unicode, Ctrl-V or Paste from the Context or Edit menus may be used. If the source text includes APL characters in a format different from Unicode, try one of the options in the Paste APL choice from the Context or Edit menus. Text coming from the ISO Extended APL Standard, APL+Win, APL2, and PC/3270 is supported. If you know of other systems that use a character mapping not covered by these choices, please let us know by sending a message on one of the forums.
  • Multiple workspaces may be open at the same time by use of tabs along the top of the Session Manager window. Click on a tab to bring the corresponding workspace to the forefront.
  • Workspaces are saved as plain text ASCII files with an extension of .ws.nars.
  • To invoke the function editor, type or type )EDIT by itself, or type or )EDIT followed by a name, or double-right-click on a function name in the session manager or function editor windows.
  • The function editor supports a multilevel Undo. That is, pressing Ctrl-Z reverts back to the previous text.
  • Each function's undo buffer is saved with the function for reuse the next time that function is edited.
  • Every function's undo buffers are saved with the workspace for reuse on its next load.
  • The text entered in both the Session Manager and Function Editor is colored according to its content with respect to the syntax being used.
  • Alt-nnnn may be used to enter arbitrary Unicode characters in decimal. For example, Alt-9735 is a lightning bolt ().

APL Font

As NARS2000 is a Unicode-based program, you'll need an appropriate Unicode APL font to correctly display all of the characters. To that end, I've made an arrangement with Phil Chastney to bundle a version of his APL Unicode font SImPL called SImPL medium. From the NARS2000.zip file, extract the SImPL-Medium.ttf file to your Windows fonts directory. Note that this font is licensed for distribution with NARS2000 only. Other APL Unicode fonts likely will work well as long as they contain all of the characters we use such as infinity (), zilde (), circle-middle-dot (), dieresis-jot (), dieresis-tilde (), etc. Also, in order to display the circled numbers on the left of each workspace tab, you'll need a font like Code2000 which you can download from the 'net.

For more details about APL fonts, see here.

Keyboard Mapping

The mapping of APL characters to the keyboard is controlled by the end user and can be viewed from within NARS2000 through the menu "Edit | Customize... | Keyboards". Various national language keyboards are supported such as Danish, French, German, UK, and US.

For different look at the US keyboard, visit NARS2000 Keyboard.

Output Debugging

Sometimes the displayed output may appear oddly spaced. This may be due to several reasons one of which is the presence of non-printing ASCII characters (whose character code is in the range 0x00 to 0x1F, excluding CR and LF). For that case, you may turn on Output Debugging through the menu items Edit | Customize... | User Preferences. When enabled, this feature changes the way in which non-printing characters are displayed – instead of the normal behavior of ignoring them, those characters are displayed using a special font which displays each character with its four digit hex code inside a box. For example,

      32⍴⎕AV
? !"#$%&'()*+,
./0123456789:;<=>?