
                                       Browse this file with 
=================================     PgUp/Down, Caps Shift+1,2
******   Lnx Text Editor   ******
_____      FDMA edition     _____


Lnx Text Editor is a simple text editor that supports basic
editing functions plus several advanced options. Its main
advantage over the most, older ZX Spectrum text editors is
that the LnxTEd opens and stores ASCII files directly from/to
FAT formatted SD card.

Main features of the editor are

   - operating memory for 64KB text files (approx. 30 pages)
   - clipboard and UNDO functions
   - esxDOS I/O support, file requester/browser
   - ZX and PC keyboards with two layouts and extra characters
   - K-Mouse support

LnxTEd is designed for the eLeMeNt ZX, a superb ZX Spectrum,
Pentagon and ZX-Uno clone with a HDMI (video and audio) output,
two SD slots (divSD) and a lot of popular ZX-interfaces
built-in.

LnxTEd runs in the high-resolution graphics mode (HGFX, 512*384
pixels, 4 colours, FastDMA acceleration) and uses fine 8x16
fonts with 224 characters (No. 32 to 255). Currently it has
only one charset implemented, providing characters of German,
Czech, Slovak and other languages of the Central Europe. You
can switch between two keyboard layouts, English (ENG) and
Czech (CZE).

LnxTEd is designed to serve well for making notes, editing
(esxDOS) INI files and creating READ.ME, NFO and DIZ files.  
In this first version, don't look for files bigger than 64KB
and with more than 8190 lines, or for functions like
'overwrite' and 'search'. 

For a download, visit ilnx.cz
Try out my other programs:  LnxCopy, LnxCommander, LnxViewer

Do you want to know more about the eLeMeNt ZX?
Go to the website 128land.com, visit Bytefest, bytefest.cz
or FOReVER, forever.zeroteam.sk

					 2024, Lanex


Content:

   1. Basic text editing
   2. Info/menu bar
   3. Selection mode and clipboard
   4. ZX keyboard layouts
   5. PC keyboard layouts
   5. File handling  
   6. Integration with esxDOS
   7. Extras (charset)



1. Basic text editing  ----------------------------------------

The keyboard of the LnxTEd preserves the meaning of the most
ZX Spectrum keys and adds several new features (editing
function and extra characters), as easily accessible
as possible.

For clarity, let's have these abbreviations of the basic
ZX Spectrum shifting keys:

	Caps Shift ... CS        Symbol Shift ... SS

		Extended (CS+SS) ... EXT

Note: The EXT+SS+... or EXT+SS+... combinations of keys mean
      that first you press CS+SS to get into the Extended mode
      and in this EXT mode you then press CS+... or SS+....

      The EXT+SS+key is not needed on PC keyboards. Simply
      press CTRL+key instead.

In addition to cursor keys (CS+5 to 8), you can move the
cursor by 23 lines forward and backward (per screen) with
PageUp and PageDown keys assigned to the CS+1 and CS+2. Get to
the top of the file with CS+3, to the end with CS+4. 

Move over words to the left or right. On the ZX keyboard,
switch to the Extended mode (press Caps Shift + Symbol Shift)
The red label 'EXT' appears in the menu/info line. Then move
the cursor to the left or to the right, CS+5 or CS+8.

Or use Alt + Left or Right on the PC keyboard. Similarly CS+7,
Home and CS+6, End make the cursor to jump to the start or end
of line.

All movement keys, combinations with the Caps Shift key,
work in both EXTended and SELection modes. 

Note: Use the mouse pointer to change the position of
      the cursor.

Next to the ZX-DELETE, CS+0 (BACKSPACE), the classic
PC-DELETE is implemented, on CS+9, to erase characters to
the right (of the cursor).

The editor does not mark the end of every line. A line break
must be inserted by the ENTER key. Another special formatting
character is a tabulator, available by pressing Tab or
SS+SPACE, that jumps to the nearest fixed position (of eight
characters).

The series of last eight important editing steps (changes of
text after operations like Enter, Cut, Paste, Delete, Open or
New) is recorded and stored in a temporary memory. The edited
text file can be returned to a previous state by an 'Undo'
function, with EXT+SS+Z/Y.



2. Info/menu bar  ---------------------------------------------

The menu in the top part of the screen offers file operations,
functions of the clipboard, Y/Z and ZX/PC keyboard switch and
the help screen. Make a selection from the menu by the mouse
pointer or open it through CTRL+1,2,3 or EXT+SS+1,2,3.

On the far right is a number of the row currently being
edited. Next is indicated the keyboard type. To change
a keyboard layout, click on the indicator or press CTRL+K,
EXT+SS+K.

All function and commands, with corresponding key combinations
are listed in the help-screen (CTRL+H, EXT+SS+H). 

In the information bar are also presented, in red letters,
enabled working modes, SELection mode and EXTended mode.   

The info bar does not any show system messages. If some file
I/O issue occures (e.g. missing SD card), a message window
with an esxDOS error number is displayed. If an editing
command cannot be executed, such a limitation or impossibility
of the text operation is indicated immediately by a change of
both background and border colours.



3. Selection mode and clipboard  ------------------------------

The Selection mode can be turned on and off with a combination
of keys SS+ENTER (Shift+ENTER on the PC keyboard). The red
label SEL appears in the menu/info bar. Move the cursor then,
per chars, lines, words or per screens ("pages"). The selected
text will be highlighted with a blue backgroud.

With the ZX keyboard, you have to enter the EXTended mode.
The red label 'EXT' appears in the menu/info bar. Use the
classic combination of Cut-Copy-Paste functions, press EXT,
then SS+X, SS+C or SS+V.

On the PC keyboard, use CTRL+X,C,V.

You can join two separate text files into a big one. Load
a file, select all (CTRL+A, EXT+SS+A), copy to clipboard
(CTRL+C, EXT+SS+C), load a second new file and paste the
previous text from the clipboard (CTRL+V, EXT+SS+V). However,
the whole size of joined files cannot exceed 65535 bytes.



4. ZX Keyboard layout  ----------------------------------------

Any key carries up to 6 different characters, editing functions
or commands.

Following description of modes and switches is used:  

Normal Mode             +Caps Shift  (mostly edit functions)
---------------------------------------------------------------
Normal Mode             character, +Caps Shift, +Symbol Shift
Extended Mode           character, +Caps Shift
---------------------------------------------------------------
Extended Mode           +Symbol Shift  (commands)


Examples:

 Key ...................1............5............A..........

 Norm. +CS              PageUp       Crsr left    
 ------------------------------------------------------------
 Norm. char,+CS,+SS     1, ,!        5, ,%        a,A,~
 Ext. char,+CS          1, nothing   5,MWB        ,
 ------------------------------------------------------------
 Ext. char,+SS          Menu No.1    nothing      Select All

Note: MWB means Move (cursor over) Word Back (to the left)
      MWF       Move (cursor over) Word Forward (to the right)
      MEL       Move (cursor) to End of Line (position 63)
      MSL       Move (cursor) to Start of Line (position 0)

Commands of EXT+SS have always the same keys, regardless of the
selected keyboard layout. 


ENG keyboard with German characters:

PGUP  PGDN  TOP   END   LEFT  DOWN  UP    RIGHT DEL   BACKSPACE
---------------------------------------------------------------
1 !   2 @   3 #   4 $   5 %   6 &   7 '   8 (   9 )    0 _   
 1     2     3     4     5,MWB 6,MEL 7,MSL 8,MWF 9      0 
---------------------------------------------------------------
MENU1 MENU2 MENU3  
_______________________________________________________________
  qQ   wW   eE   rR <  tT >  yY [  uU ]  iI   oO ;  pP "
                                                     
---------------------------------------------------------------
  QUIT                          UNDO              OPEN
_______________________________________________________________
    aA ~  sS |  dD \  fF {  gG }  hH ^  jJ -  kK +  lL =
                         
---------------------------------------------------------------
 SEL.ALL  SAVE SAV.AS             HELP        KEYB
_______________________________________________________________
      zZ :  xX   cC ?  vV /  bB *  nN ,  mM .       
                                                    
---------------------------------------------------------------
      UNDO  CUT   COPY  PASTE       NEW                   


CZE keyboard with Slovak and German characters:

PGUP  PGDN  TOP   END   LEFT  DOWN  UP    RIGHT DEL   BACKSPACE
---------------------------------------------------------------
1 !    @    #    $    %    &    '    (    )     _   
 1     2     3     4     5,MWB 6,MEL 7,MSL 8,MWF 9      0 
---------------------------------------------------------------
MENU1 MENU2 MENU3       
_______________________________________________________________
  qQ   wW   eE   rR <  tT >  zZ [  uU ]  iI   oO ;  pP "  
                                        
---------------------------------------------------------------
  QUIT                          UNDO              OPEN
_______________________________________________________________
    aA ~  sS |  dD \  fF {  gG }  hH ^  jJ -  kK +  lL =
                                     
---------------------------------------------------------------
 SEL.ALL  SAVE SAV.AS             HELP        KEYB
_______________________________________________________________
      yY :  xX   cC ?  vV /  bB *  nN ,  mM .       
           ߣ                                
---------------------------------------------------------------
      UNDO  CUT   COPY  PASTE       NEW                   



5. PC Keyboard layout  ---------------------------------------

Three modes are available: non-SHIFTed, SHIFTed and ALTed.
For extra operations, use CTRL and (usually) the first letter
of the function, instead of the old ZX keyboard switch EXT+SS.
German characters are also present.


PC ENG keyboard
............................................................
 `~ 1!  2@  3#  4$  5%  6^  7&  8*  9(  0)  -_ =+ BCKSPC
:...:...:...:...:...:...:...:...:...:...:...:...:...:......:
MENU1 MENU2 MENU3
------------------------------------------------------------
  TAB  qQ wW  eE rR  tT  yY  uU iI oO pP [{ ]}  ENT
:.....:...:...:...:...:...:...:...:...:...:...:...:...:.   :
  QUIT                     UNDO       OPEN
-------------------------------------------------------:
  CAPS  aA sS dD  fF  gG hH  jJ  kK  lL  ;: '" \|
:......:...:...:...:...:...:...:...:...:...:...:...:...:...:
       ALL SAVE S.AS       HELP    KEYB
------------------------------------------------------------
 C.SHIFT  zZ  xX cC vV bB nN mM ,< .> /?  C.SHIFT
:........:...:...:...:...:...:...:...:...:...:...:.........:
         UNDO CUT COPY PASTE  NEW                   
------------------------------------------------------------
 SYMB  ZX  ALT          SPACE           ALT   ZX  ALT2 SYMB
:....:....:....:.......................:....:....:....:....:


PC CZE keyboard

The fourth group of characters is added to the layout,
in order to get special characters with diacritical marks,
like  etc. The key before the backspace, in the upper
(numeric row), hold various diacritics switchers, shifted and
non-shifted. 

1. row		normal, shift, alt
2. row		switcher
3. row		shift + switcher

............................................................
 ; +1! 2@ 3# 4$ 5% 6^ 7& 8* 9( 0) =%     BCKSPC
      
:...:...:...:...:...:...:...:...:...:...:...:...:...:......:
MENU1 MENU2 MENU3
------------------------------------------------------------
  TAB  qQ\ wW| eE rR tT zZ  uU iI Oo pP / )(  ENT
                               
                              
:.....:...:...:...:...:...:...:...:...:...:...:...:...:.   :
  QUIT                     UNDO       OPEN
-------------------------------------------------------:
  CAPS  aA~ sS dD fF[ gG] hH^ jJ kK lL "$ ! \'
                                    
                                   
:......:...:...:...:...:...:...:...:...:...:...:...:...:...:
       ALL SAVE S.AS       HELP    KEYB
------------------------------------------------------------
 C.SHIFT  yY xX# cC& vV@ bB{ nN} mM ,?< .:> -_*  C.SHIFT
                              
                              
:........:...:...:...:...:...:...:...:...:...:...:.........:
         UNDO CUT COPY PASTE  NEW                   
------------------------------------------------------------
 SYMB  ZX  ALT          SPACE           ALT   ZX  ALT2 SYMB
:....:....:....:.......................:....:....:....:....:



6. File handling  --------------------------------------------

A new file will be created using EXT+SS+N or CTRL+N. Use
EXT+SS+O or CTRL+O to open and load a file from the SD card.
When done, save this file with EXT+SS+S or CTRL+S. You can
also change a filename or make a backup file with 'Save As',
EXT+SS+D or CTRL+D. 

The LnxTEd checks whether the file has been changed since
the last saving and offers you an option to save. 

The program uses a file requester already known from the
LnxCopy utility. You can go through directories and filelists,
select a file or create a new folder. Choose a directory and
press D to make a file operation. 

Currently it is not possible to choose between first or second
SD slot. The program works only with a SD card from which it
was started. Also please note, in this beta version of the
editor, the mouse is not active in the file requester.



7. Integration with esxDOS  -----------------------------------

The LnxTEd supports the esxDOS and the DivSD with FAT formatted
SD cards. It is not intended to edit older, legacy, non-ASCII
formats and cannot handle various tape- and disk-images.


* Autostart of the LnxTEd

You can run the editor on every start of your eLeMeNt ZX with
the AUTOBOOT.BAS file located in the SYS directory. 

Check (and edit directly with the LnxTEd)
this file: /SYS/CONFIG/ESXDOS.CFG and set, how the autoboot
will proceed (never, always, cold/warm boot).

The AUTOBOOT.BAS should use these LOAD commands,
running from a TAP file:
				.tapein LNXTED.TAP
				LOAD ""
or directly from SD card:
				.cd LNXTED
				LOAD *"LNXTED.BAS"


* make a shortcut to the program

Launch the LnxTEd easily, no matter what directory you are in.
Create a linking dot-command with the utility Launcher, made
by ub880d.

	.LAUNCHER add link-name /LNXTED/LNXTED.BAS
or (for a TAP file)
	.LAUNCHER add link-name LNXTED.TAP

Example: If the link-name is TED, run the LnxTEd
         with a new dot-cmd .TED then.


* quick start from the ZX Basic edit-line

Copy the dot-command LNXTED to the BIN direcory. If needed,
rename this file to whatever you like, e.g. to shorter 'E'.

To run a program in order to start a new text, type
.LNXTED
or, if the editor was renamed, use .E instead :-)

To start with a specific textfile, type
.LNXTED TEXTFILE.TXT


* other esxDOS software

ZX Basic files are editable in ASCII format, use import- and
export- dot-commands .LOAD, .SAVE, .MERGE by Nagydani.

Z-80 assembler source files written in the LnxTEd can be
converted with the dot command .SAIMPORT into sources for
the powerful SPECASM assembler.
https://github.com/markdryan/specasm

To check bytes in LnxTEd textfiles, you can view them by the
excellent esxDOS Hex Monitor and Editor
by namco/hexgen software  2021.



8. Extras  ----------------------------------------------------

* Formatting characters

Formatting characters are special characters with a value lower
than 32 (0x20), that are kept in the textfile.

Line break (placed on the ENTER key), or Line Feed, LF, aka
End Of Line, EOL, contains the value 10 (0x0A). Tabulator (HT,
Horizontal Tabulator) on Tab or SS+SPACE keys, has the value 9.
 
A byte with the Carriage Return code (CR, value 13, 0x0D) is
preserved in the imported text. When saving this file, an
automatic conversion CR>LF is made. In other words, the LnxTEd
accepts any Win/Mac/Unix text file with LF, CR or CR+LF codes,
but it saves files only with all line endings converted to
Unix/Linux standard (LF bytes). 

The null character, a control character with a value zero, is
not used in the text file either. If found while loading a
text file, such a byte stops the text, terminates any loading
of next bytes.  


* Codepage 1250 character table (codes in hexadecimal)


          _0 _1 _2 _3 _4 _5 _6 _7 _8 _9 _A _B _C _D _E _F   
   
     2_       !  "  #  $  %  &  '  (  )  *  +  ,  -  .  /

     3_    0  1  2  3  4  5  6  7  8  9  :  ;  <  =  >  ?

     4_    @  A  B  C  D  E  F  G  H  I  J  K  L  M  N  O

     5_    P  Q  R  S  T  U  V  W  X  Y  Z  [  \  ]  ^  _

     6_    `  a  b  c  d  e  f  g  h  i  j  k  l  m  n  o

     7_    p  q  r  s  t  u  v  w  x  y  z  {  |  }  ~  

     8_                                  

     9_                                  

     A_                                  

     B_                                  

     C_                                  

     D_                                  

     E_                                  

     F_                                  


* Memory Usage

For text files, undo operations and for the clipboard, the
LnxTEd uses eLeMeNt's Ultimate RAM (Protected mode). It has the
memory management which is prepared to coexist with some other
programs, e.g. with the file manager, the LnxCommander.


_________________________________________
LNXTED.MAN, 2024-02-14, typed by samista
