L---T5---T10--T15--T20--T25--T30--T35--T40--T45--T50--T55--T60--T65--T70--T--R78T1ý-T85--T10ý-T95--T20ý-T105-T30ý-T115-T40ý-T125-T50ý-T135-T60ý-T145-T70ý-T--T
.-Star.AF1 v3:89 EKP:-  Copyright l988,1989  David M. Brender  All rights reserved.
cF1 * Help for:          Gr* ACCESS KEY    (* is Gr*)
cF2 Unsave & exit.   (BCID keys are  Bksp CR Ins Del)  
             ***   Playback your Keyboard Macro.   See cF1 K
     Alt4 - Alt8   Self-Capture of Keyboard Macro. See cF1 K

        *[  *]     0: Break line at screen edge; more.
        *F2        1: Long ruler.
        *CR **CR   2: Alt K  Typing  at end of lines.
      *BCID  *Arr  2: The Gapper(tm); also Shadow motion.
     **BCID **Arr  3: Locked Gapper keypad.

        /*BCID     4: T-Block Deletion on delete keys.
         *Crnr     4: T-Block Motion once on corner keys.
        **Crnr     5: Locked T-Block Motion.
        **P        6: Plick Restoration (with P CR Gr+)
*R *. *: *ñ **ñ    7: AltG  Insertion of dot lines.
      /.   *Grñ    7: AltG  Deletion of dot line.  Finding AltG lines.

         *DnArr    Space-Repeat Down-Series (1st Ins or Del n times)  See cF1 D
        **DnArr    Text-Alignment DS (1st set cursor to desired spot) See cF1 D

To view: SCROLL or PAGE or  Click N directly  or  CLICK Gr+ to step N  or PRINT
Click the macro keys; don't hold them down. Wait.

0:-----------
     * is Gr*
**T  Type * symbol once.  Same as s*
**R  Repeat *****

**U  (not *U)  Unsave, and leave ** locked on.

 *(  Enclose sentence in parentheses; cursor at beginning of sentence.
 *)  Same for sentence on left, but cursor in space at end of sentence.
*s(  Remove matched pair of parentheses; cursor on ( at beginning of sentence.
*s)  Same, but cursor on ) at end of sentence, or on space at end.
     Removes ( & ), but not text inside them.

**(  or  **)  Enclose whole sentence in (), cursor anywhere inside sentence. 
**s( or **s)  Remove matched pair of () surrounding whole sentence. 

 *[  Break whole line at screen left edge, regardless of ruler margins.
     Cursor can be anywhere on line for *[ and *]
 *]  Break overly long line near R margin; aligns it onto new line.
     Breaks at word boundary.

*sCR  Break to align with indented line below, not with cursor line.

**F7 Reformat a T-block (if feasible) regardless of the ruler margin setting. 
**K  Reformat whole T-block (if feasible) from anywhere inside it, and respot.

(œ below is Scroll Lock key)
*œ    **œ    Toggle marking/marked, lock.
*œœ   **œœ   Start new marking, lock.
*œœœ  **œœœ  Start new marking, lock.
On locked keypads, use œ at anytime.


1:--------------- LONG RULERS & RULERS -------------------
You may read-in and use a special long ruler, which covers two screen widths
(80+78 = 158 columns) and provides 5 column tabs.

 *F2   Reads-in <EKP> long ruler as PC-W default ruler. Also use *F2 to re-read
       long ruler if damaged or changed.   (Reads from this file  Star.AF1)
        (Ruler on top line here. Inactive copy on BangD.QQQ)
 ŸF2   Remove visible ruler, respot.  (Also remove 2nd window, if present.)
ŸŸF2   Delete embedded ruler above cursor, respot.  (Not dot lines)
 /Gr-  Cancel top window (and ruler), starting from either window.
 /Gr+  Cancel bottom window (and ruler), starting from either window.
       /Grñ saves active file if canceling active window.


2:--- AltK on CR key ------- Ý*   Þ ---- GAP MOTION once ---------------------
A gap is three or more space characters (for *Arr) or three or more non-letter,
non-numeric characters which includes space characters (for **Arr).

'To Gap Left' goes left to the left side of a gap.  A backward search for a gap.
'To Gap Right' goes right to the right side of a gap.  A forward search for gap.
 Both macros expect text near the gap.

Gap Deletion affects only space characters.  
(Note: To deGap a whole para quickly, use ŸŸF7 or Alt F5 F5 F9)


Use * to act & exit. Use ** to lock gap motion and interlock all gapper keys.

*ßß Delete Gap left.                        Start Shadow motion.
 *Û Type Alt K & Break to align.         ß *ß  ß
**Û Go to line end,         To Gap Left *ß s5 *ß To Gap Right.
    type Alt K (no break),               ß  ß  ß
    and go UP to line end;
    locks CR to repeat.     Insert Gap *ßß   *ßß Delete Gap right.

SpBar  Exit.         s5 Respot, exit.


Note: *Bksp also deletes trailing blanks at end of line; leaves one.

 *CR  Types  & Breaks to align point.  Sets Wrap+ & Pushright for safety.
[*CR  Types  and Break to P or L margin (rather than align). Sets Pushright.

*UpArr CR (not shown)  Type  (Alt K) at end of line above and respot. No break.

*UpArr LftArr...  Shadow Left.     *UpArr RtArr...  Shadow Right.
SHADOW L/R is like Word L/R but follows words of line above; not cursor line.
Exit locked shadow motion with SpBar or DnArr.  Easy fingering with DnArr exit.


3:---- ÝGapperÞ ------ GAP MOTION on the locked GAPPER KEYPAD ---------------
 (See gap definitions in 2 above.)

Starts automatically with any:   **Gapper key   (Use ** once only)
       Gapper keys are  Bksp Ins Del & LftArr RtArr
All ½ flagged keys below lock and interlock for repetition.

ß½ Delete Gap left.                    Up a line to end.
 Û Break to selected               ß   ß½  ß                   Û Suspend.
 ß gap, & exit.       To Gap Left  ß½ s5   ß½ To Gap Right.    Ü  (CR resumes)
 Ü                                 ß   ß   ß                   ß To ‡‡Word.
                                       Exit         s5 Respot, exit.
                       Insert Gap ßß½     ßß½ Delete Gap right.

SpBar  Exits.

Leap to a gap with **RtArr, with one click use Gr+ to switch to ‡‡Word,
and continue word by word on arrow keys. 

**LftArr...CR    (See also ]*CR macro via cF1 ]
Break line at starting spot to align with Gap selected by arrow key.


4:--- Ý*    Þ ----- T-BLOCK MOTION once on corner keys ------------------
T-Blocks are text objects separated by one or more completely empty lines.
    No space chars allowed in empty line.  (See TutA.Doc)
    Ruler margins and text indents don't matter.  Variable indents allowed.

Use * to act once & exit.
Use ** to lock corner keys for block to block cursor motion.  See scrn 5:

 /*ßß Delete to Beg of Block, exit.              *ß Marking, lock.

                       Beg of Block *ß  ß *ß End of above Block.
  /*Û Delete Whole Block, exit.      ß  ß  ß
    ß            Beg of lower Block *ß  ß *ß End of Block.

Open Delete to Beg of Block, exit /*ßß  /*ßß Delete to End of Block, exit.

Note: Whole block deletion on /*CR includes empty lines at end of block.

MARKING: (Alternatives)
 o Use /*Crnr (not shown) to mark once to designated corner, & exit. (See cF1 /
 o Can start marking by any means before starting keypad,
   then mark one T-Block using *Crnr or many T-Blocks using **Crnr.
 o Can use **œœ to start new marking anytime after starting keypad,
   then mark T-Blocks using the Crnr keys.


5:---- Ý**CrnrÞ ------- Locked T-BLOCK MOTION on corner keys ---------------

Starts automatically using:  **Crnr
All ½ flagged keys below lock and interlock for repetition.
All unflagged keys execute and exit this keypad.

  ÜÜÜÜÜ Delete word left (& goto ‡‡Word)                    Marking ÛÛ½
/*ßßßßß Delete to Beg of Block, exit.                               ßß
                                        Exit.
     ÛÛ Suspend.       Beg of Block ÛÛ½ ÛÛ  ÛÛ½ End of above Block.  ÛÛ Suspend.
   /*ÛÛ Delete Whole Block, exit.   ßß  ßß  ßß                       ÛÛ (CR to
     ÛÛ              To ‡‡Word Left ÛÛ sÛÛ  ÛÛ To ‡‡Word right.          resume)
                                    ßß  ßß  ßß                       ÛÛ Toggle
     ÛÛ Toggle       Beg of lower   ÛÛ½ ÛÛ  ÛÛ½ End of Block         ÛÛ ‡‡Crnr.
     ßß ŸŸCrnr               block. ßß  ßß  ßß
                                        Exit.              s5 Internal Respot.
                      Insert Gap ÜÜÜÜÜ½  ÜÜÜÜÜ Delete word right (& goto ‡‡Word)
   Open Delete to Beg of Block /*ßßßßß /*ßßßßß Delete to End of Block, exit.
                      & exit.
SpBar  Exit.

Example: **TR TR TR Gr-    (TR is Top Right corner key)
Go up to the end of the 2nd block above and exit this locked **Corner keypad.

F3 F4 cF4 F5 F6 F7  Work normally; but keypad stays locked.
   From **Crnr use F6 repeatedly to mark and then move one or more t-blocks.

From **Crnr use:
F7   Reformats t-block (if feasible), locks.
K    Reformat whole t-block from end of it, or inside it. **Crnr locks.
Note direction connection to ‡‡Word on Bksp, Del, LftArr, and RtArr above.
You need not click ‡ or ‡‡.

Not shown: Within **Crnr
 Tab½  Space tab right.
sTab½  UnSpace tab left.


6:------------- PLICK RESTORATION --------------------
A horror to behold is the accidental reformatting of a list into paragraph form.
The following MacroSet will undo this tragedy if the original list was numbered
or if each line in the list began with some distinctive 'plick' symbol.

First set the FIND area to the plick symbol or to the search codes for numbers.
      For example,  F9 F5 ) Esc  will enable searching for 1) 2) 3) ...
      If plick symbol is a pair such as  --  use both in Find area.

With the cursor on the first line of the paragraph:
START the Plick MacroSet with:   **P    (which finds the first plick)
then  Ins (optional) Inserts a leading space in front of first plick. See Note.

then  CR  Breaks the highlited plick to a new aligned line, & finds next plick.
          Repeat CR as needed to restore each plick line, line by line,
            automatically aligning each line with line above.
      Gr+ Skips to next plick. (Use if search stopped at a non-plick symbol)
      Gr- Backs up by one plick.
      SpBar  Exits.   Exit when last plick is restored
             or when search jumps out of damaged list.

Example: Set up a list at the margin using o as plick symbol.  Reformat it.
To restore:  F9 o Space Esc   Sets Find area to lower case o as plick symbol.
Start at beginning of paragraph with **P, and continue with CR CR CR ...
   If the cursor lands on letter o rather than plick o
   use Gr+ to search for next plick o
  (Cursor can land on letter o if it is last letter of word.)
Exit with SpBar or DnArr.

Note: After restoration, indenting all list lines by one column will lessen
the chance of accidental reformatting.  Or achieve the same effect during the
restoration process by using Ins (above) once after starting, to force the
first restored plick line to be indented by one column.  The CR macro (above)
will cause all later lines to align on this first indented plick line (as long
as each list item takes only one line.)


7:--------- DOT LINES:   DELETING   INSERTING   FINDING AltG --------------
These macros facilitate working with Alt G dot lines.

/.   Delete first AltG dot line at or above cursor line and respot.
*F7  Reformat in spite of AltG.-    Leaves reformat-protect status un-altered.
**ñ  Go to beg of T-block, insert new line, type AltG.ñ at left edge, respot.
 Use this ** version to alter reformat-protect status on-the-fly while typing.

*ñ  Type  AltG.ñ  at left edge.     ßß      Up a line, lock.
    (don't shift for + or :)         Û   ß *ß  ß      *Û Up to AltG line.
*:  Type  AltG.:  at left edge.      ß   ß sß Respot
*.  Type  AltG.   at left edge.      ß   ß  ß  ß      *Û Dn to AltG line.
*/  Create empty line, lock * on.                   (Use Grñ alone to repeat)

*R  Types  AltG.R:  at left edge.  (Don't shift)
    First inserts new empty line automatically if cursor line has text on it.
*Letter  Types  AltG.Letter:  at left edge.  Works for all letters.

    Examples:
*QI    Types  AltG.Q:i  at left edge of new line, exits.
*L60   Types  AltG.L:60  at left edge.

*B  is different.  It types  AltG.LB: at left edge of new line, exits.

*RE CR *-
   *RE types  AltG.R:e  at the left edge of new line, exits.
   CR  just opens another line to existing Ruler margin, and
   *-  types  AltG.-  but at left edge & exits. 

End:--- * Help.

