home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 030.lha / Dme.doc < prev    next >
Encoding:
Text File  |  1986-11-10  |  20.5 KB  |  558 lines
  1.  
  2. DOC.TXT
  3.  
  4. DME V1.25 (c)CopyRight 1987, Matthew Dillon.  All Rights Reserved. This
  5. software may be distributed for non profit only.  This software is
  6. shareware, but I won't get on anybody's case or whine if I don't make any
  7. money from it.
  8.  
  9.     Matthew Dillon        contribute if you wish.
  10.     891 Regal Rd
  11.     Berkeley, Ca. 94708
  12.  
  13.     USENET   ihnp4!ucbvax!dillon
  14.     ARPANET  dillon@ucbvax.berkeley.edu
  15.  
  16. ---------------------------------------------------------------------------
  17.  
  18. I   Overview
  19. II  Keymapping        keymapping
  20. III Command Sequences    DME commands
  21. IV  File Particulars    notes on loading and saving files
  22. V   Revision Summary    revision numbering
  23. VI  Compiling        compiling instructions
  24.  
  25.                     I
  26.                  OVERVIEW
  27.  
  28. See REVISIONS section for revisions.  DME is a WYSIWYG editor designed
  29. mainly for programmers.  Although it is not a word processor, it does
  30. include some word processing features such as Word-Wrap and automatic
  31. paragraph formatting.  Here is a quick 'features' list:
  32.  
  33.     -control language based on a rich command set accessed manually
  34.      or via arbitrary mapping of keys.  (Every key may be mapped to 16
  35.      different things)
  36.  
  37.     -fast visual response (it scrolls quickly)
  38.  
  39.     -title-line statistics showing your current position in the file,
  40.      file name, whether the file has been modified or not, etc...
  41.  
  42.     -Multiple Windows, ability to iconify windows
  43.  
  44.     -Word Wrap and automatic paragraph formatting.
  45.  
  46. DME has been designed to allow easy expansion, and I intend to make many
  47. future improvments.  It has not been designed for user friendliness, but is
  48. straight forward if you read this document fully.
  49.  
  50. DME can take any number of arguments.  Any argument without a '-' in front
  51. of it is considered to be a file.   Normally, DME will automatically SOURCE
  52. two script file, S:.EDRC, and the .EDRC in your current directory. These
  53. files do not have to exist. These script files usually contain mappings and
  54. do things like turn on word wrap and set the right margin.
  55.  
  56.     FLAGS:
  57.         -ffilename        -source this script file instead of .EDRC
  58.         -b            -normally when multiple files are specified,
  59.                  DME opens them with small windows.  This opens
  60.                  them with normal sized windows.
  61.  
  62.         -tN     -Open the window on scan line N
  63.         -lN     -Open the window offset N scan columns
  64.         -wN     -Make the window N pixels wide
  65.         -hN     -Make the window N pixels high
  66.  
  67.  
  68.  
  69.                     II
  70.                  KEYMAPPING
  71.  
  72. MOUSE SELECT (LEFT ) BUTTON:
  73.     There is no designation to map the left button.
  74.  
  75.     positions cursor at the indicated spot.  The cursor now tracks the
  76.     mouse.
  77.  
  78.  
  79. MOUSE MENU (RIGHT) BUTTON:
  80.     There is no designation to map the right button.
  81.  
  82.     This button iconifies the current active window if not iconified, and
  83.     de-iconifies the window if iconified (Try IT!).  The iconification
  84.     features:
  85.     -Remembers original window size and placement
  86.     -Remembers placement of iconified window when you re-iconify later.
  87.  
  88.     Currently, you will crash the machine if you run out of memory and DME
  89.     is unable to open the icon window or original window, so be careful.
  90.  
  91.  
  92. KEYBOARD:
  93.  
  94. The rest of the Functional interface for DME is based on keymappings and a
  95. rich command set.  Unlike other text editors, any non-qualifier key in DME
  96. may have any meaning whatsoever.  It just so happens that the default
  97. keymappings assign such things as the `return' key to the RETURN function,
  98. the `up' key to the UP function, etc...  Keys are named by their keycap
  99. labels with the following exceptions:
  100.  
  101.     the name for Back-Space is    BS
  102.     the name for numeric keypad keys are prepended with an NK, except for
  103.     the Enter key which is named 'ENTER'.
  104.     The four cursor control keys are labeled UP, DOWN, LEFT, and RIGHT
  105.  
  106. *NOTE*    You must type commands in lower-case, except for text, which can be
  107. either lower or upper case, and for upper-case alpha keys when specifying
  108. keymaps (i.e.  A and s-a are the same key).  The exception is the AMIGA
  109. qualifier key, which uses 'A' instead of 'a'(Alt).
  110.  
  111. Each key may be qualified with any combination of CTRL, ALT, SHIFT, or
  112. AMIGA Keys.  With four qualifier keys, you can assign up to 16 different
  113. meanings per physical (except qualifier keys) key on the keyboard.
  114.  
  115. NOTE: The CAPS-LOCK, when lit, is equivalent to SHIFT only for Alpha keys.
  116.  
  117. NOTE: The AMIGA-ALT (aA) combination isn't very usable since Intuition uses
  118. the sequence to duplicate a Mouse SELECT.  Other AMIGA sequences are used
  119. by intuition for mouse movement and other things.
  120.  
  121.     ***EXAMPLES:***
  122.  
  123.     tab tab
  124.     a-a ALT a
  125.     A-a AMIGA a
  126.     sA-a    SHIFT AMIGA a
  127.     s-tab    SHIFT tab
  128.     c-tab    CTRL tab
  129.     ac-?    ALT-CTRL ?
  130.     s-f5    SHIFT F5
  131.     nk0 Numeric Keypad 0
  132.     cs-nk0    CTRL SHIFT Numeric Keypad 0
  133.  
  134.     ***************
  135.  
  136. The Default Mappings are as follows:
  137.  
  138.     All Printable Ascii keys mapped to their ascii equivalent
  139.     BS, DEL, UP, DOWN, LEFT, RIGHT, TAB, S-TAB, ENTER mapped properly
  140.  
  141.     `s- '       Shift Space is Mapped to space
  142.     backspace    Back Space
  143.     tab Tab
  144.     s-tab    Back tab
  145.     enter    the RETURN command
  146.     return    `return insline up firstnb down'
  147.     esc Escape into command mode
  148.     del Delete character
  149.     s-del    Delete line
  150.     c-del    Remove to end of line
  151.     up        cursor up
  152.     down    cursor down
  153.     left    cursor left
  154.     right    cursor right
  155.     s-up    top of text
  156.     s-down    bottom of text
  157.     s-left    first column
  158.     s-right    last column (one past the last non-blank on a line)
  159.     c-up    page up
  160.     c-down    page down
  161.     c-q Quit
  162.     c-w TOGGLE WORD WRAP MODE
  163.     f1        Prompts for file to insert
  164.     f2        Prompts for new file to replace current text with
  165.     f3        Prompts for new file to place into new window
  166.     f7        Prompts for filename to save marked block to
  167.     f8        Saves current text and then does an 'f2'
  168.     f9        Saves current text, but does not quit
  169.     f10 Saves current text and quits.
  170.     c-r Word Right
  171.     c-l Word Left
  172.     c-i insert mode on
  173.     c-o insert mode off
  174.     c-/ Prompts for search pattern
  175.     c-p search previous occurance
  176.     c-n search next occurance
  177.     c-s `split first down' ... fancy split line
  178.     c-u Unblock a block
  179.     c-b Mark start/end of a block
  180.     a-s SOURCE a block of text as if it were a script file
  181.     sa-s    SOURCE the current line of text as if it were a script file
  182.     a-d delete block
  183.     a-c copy block
  184.     a-m move block
  185.     c-f reformat paragraph
  186.     c-g Prompts for line to GOTO to.
  187.     c-j join next line to this line.
  188.  
  189.  
  190.                     III
  191.                  COMMAND SEQUENCES
  192.  
  193. DME has a rich command set which allows you to embed commands within
  194. commands, or specify multiple commands in a row.  A command consists of a
  195. KEYWORD followed by a FIXED number of arguments (0, 1, 2...).  The argument
  196. delimeter in DME is a SPACE.  Therefore, to embed strings containing spaces
  197. as a single argument, you must surround the string with `string'
  198. (backquote-string-quote).  TEXT to be written as if typed is also specified
  199. via a string in backquote-quotes.  For example:
  200.  
  201.     right right `hello' right right `hello' enter down
  202.     map f4 `right right' map f5 `left left'
  203.     map f4 ``hello''
  204.  
  205. Reiterating (because this is important!)... If a command expects ONE
  206. argument, then it really does expect a single argument, and any remaining
  207. arguments are thought to be the next command... so:
  208.  
  209.     map f4 right
  210.                     -right is only one word, so no need
  211.                      for `'.
  212.     map f4 `right right'
  213.                     -we want to map f4 to two rights... we
  214.                      need the `' or the second right will
  215.                      not be part of the map.
  216.  
  217.     map c-del `repeat cright del'
  218.                     -this is already implimented as REMEOL,
  219.                      but shown here for clarity.
  220.  
  221. Some arguments will eventually be fed through the command interpreter more
  222. than once.  The MAP command is a good example.    When you execute a MAP
  223. command, the first run through the command interpreter installs the map
  224. string minus a set of quotes.  So, if you want to specify text, you must
  225. enclose the text in two sets of ``text'' because the map string gets passed
  226. through the command interpreter again when you hit the mapped key.  Here
  227. are some more complex examples:
  228.  
  229.     map f4 `right right `hello' left left'      *RIGHT*
  230.     map f4 right right hello left left        *WRONG*
  231.  
  232.     map f4 `map f4 ``hello'''
  233.                     -the first time you hit F4, it's command
  234.                      is to re-map itself to the TEXT `hello'.
  235.                      (gads!).
  236.  
  237.     map c-i `repeat tr `` '''
  238.                     -example of how to embed a space in a
  239.                      map and repeat (goes through command
  240.                      interpreter three times!).
  241.  
  242.  
  243. An easy way to fool around executing commands or making maps is either to
  244. use the ESC key (which enters command mode), or  a-S (alt-shift-s), which
  245. EXECUTES the current DME line that the cursor is on.... so you can use DME
  246. to edit and test your new keymappings.
  247.  
  248.  
  249. !!!!!!!!!! NOTE NOTE NOTE NOTE NOTE !!!!!!!!!!!!!! You must type commands
  250. in LOWER case. They are in upper case here for visibility.
  251.  
  252.     COMMAND LIST
  253.  
  254.  
  255.  
  256.     `text'          -enter text as if typed.
  257.     key     -execute a keymap as a macro (example:  c-a)
  258.     IF cnd act        -IF/WHILE/IFELSE.. SEE BELOW
  259.     WHILE cnd act
  260.     IFELSE cnd ifact elseact
  261.  
  262.     ESC     -toggle manual command entry mode
  263.     ESCIMM arg        -go into command entry mode prompting with a predefined
  264.              string.
  265.     LAST        -move one beyond the last non-space in a line.
  266.     FIRST        -move to column 1
  267.     DOWNADD        -cursor down.  If at bottom of text, add a line.
  268.     MAP key map     -map a key to a keymap
  269.     UNMAP key        -unmap a key
  270.     UP            -cursor up
  271.     DOWN        -cursor down
  272.     LEFT        -cursor left
  273.     RIGHT        -cursor right
  274.     PAGEUP        -pageup a partial page (see PAGESET)
  275.     PAGEDOWN        -pagedown a partial page (see PAGESET)
  276.     PAGESET n        -n PERCENT (0 to 100). page step size relative to the
  277.              current number of rows in the window.
  278.     RETURN        -same as `FIRST DOWNADD'
  279.     WLEFT        -move to beginning of previous word.  If in the middle
  280.              of a word, move to beginning of current word.
  281.  
  282.     WRIGHT        -move to beginning of next word
  283.     BS            -backspace, moving text to the right of the cursor
  284.              leftward.
  285.     BACK        -same as BS
  286.     DEL     -delete char under cursor (cursor does not move),
  287.              moving text to the right leftward.
  288.     INSLINE        -insert line
  289.     DELINE        -delete line
  290.     TAB     -forward tab
  291.     BACKTAB        -backward tab
  292.     TABSTOP N        -Set tab stops every N
  293.     NEWFILE name    -replace current text with new file
  294.     INSFILE name    -insert a file into the current text.
  295.     TLATE [+/-]N    -translate character by +N or -N, or set character to
  296.              exactly N if no + or -. (e.g. TLATE +65 TLATE 3)
  297.     SAVEOLD        -save current text under current name
  298.     SAVEAS file     -save current text under a different name
  299.     TOP     -Move to Top of File
  300.     BOTTOM        -Move to Bottom of File
  301.     SOURCE file     -source a script file
  302.     BSOURCE        -source current text block as if it were a script file
  303.     FIRSTNB        -Move to first non-blank in line.
  304.     REMEOL        -Remove text under and beyond the cursor.
  305.     QUIT        -quit
  306.     FINDSTR string  -SET the search string pattern
  307.     REPSTR string   -SET the replace string pattern
  308.     FIND string     -SET the search pattern and do a NEXT
  309.     NEXT        -find next occurance of search pattern
  310.     PREV        -find previous occurance of search pattern
  311.     FINDR s1 s2     -Set find and replace patterns and do one find/rep.
  312.     NEXTR        -find next occurance and replace
  313.     PREVR        -find previous occurance and replace
  314.     SPLIT        -Split line at cursor
  315.     JOIN        -join next line to line at cursor
  316.     REPEAT cnt comm -SEE BELOW
  317.     INSERTMODE what -set INSERTMODE.  what = on, off, or toggle
  318.     SCREENTOP        -Move cursor to the top of the screen
  319.     SCREENBOTTOM    -Move cursor to the bottom of the screen.
  320.     GOTO BLOCK        -Goto the beginning of the marked block
  321.     GOTO [+/-]N     -Goto an absolute or relative line number
  322.     BLOCK        -Set start or end of block
  323.     UNBLOCK        -clear the block markers.
  324.     BCOPY        -copy block before cursor line
  325.     BMOVE        -move block before cursor line
  326.     BDELETE        -delete the block
  327.     BSAVE file        -save the block to a file
  328.     SAVEMAP file    -save user keymappings
  329.     SAVESMAP file   -save all keymappings, including system keymaps
  330.     TOGGLE N        -flip toggle array entry N    (See IF)
  331.     SETTOGGLE N     -set toggle array entry N
  332.     RESETTOGGLE N   -clear toggle array entry N
  333.     NEWWINDOW        -open newwindow
  334.     SAVETABS on/off -Optimize file saves by crunching spaces to tabs.  The
  335.              default is OFF.
  336.     LEFTEDGE N        -set leftedge in pixels for any new window
  337.     TOPEDGE N        -set topedge in pixels for any new window
  338.     WIDTH N        -set width in pixels for any new window
  339.     HEIGHT N        -set height in pixels for any new window
  340.     RESIZE cols rows-Resize current window. E.G:  `resize 70 23'
  341.     MARGIN N        -set WordWrap and paragraph formatting margin
  342.     WORDWRAP on/off/toggle  -Word Wrap mode
  343.     REFORMAT        -reformat paragraph using the margin.
  344.  
  345.  
  346.     -------------------------------------------------------------------
  347.     Command which cause a command line to abort (e.g. in repeat, while):
  348.  
  349.     FIND[R]/NEXT[R]/PREV[R]  when the string is not found.  NEXT stops at
  350.     the end of the file, PREV stops at the beginning.
  351.  
  352.     DOWN,LEFT,RIGHT,UP    when the operation cannot be done.
  353.     -------------------------------------------------------------------
  354.  
  355.  
  356.     REPEAT N arg    -Repeat `arg' N times.  Apart from being a number, N
  357.              can also be one of:
  358.  
  359.             line    Current line # (lines begin at 1)
  360.             lbot    #lines to the bottom, including current line
  361.             cleft    column # (cols begin at 0)
  362.             cright    #chars to eol, including current char under cursor
  363.             tr    #char positions to next tab
  364.             tl    #char positions to next back tab
  365.  
  366.             Certain commands can abort a REPEAT loop.  Specifically,
  367.             any FIND[R], NEXT[R], or PREV[R] in which the search
  368.             string is NOT found will abort a REPEAT.
  369.  
  370.             Specifying -1 as N causes REPEAT to go on forever
  371.             (well, actually, 0xFFFFFFFF times) or until an abort.
  372.  
  373.     IF [!]condition arg
  374.     WHILE [!]condition arg
  375.     IFELSE [!]condition arg elsearg
  376.  
  377.         If the specified condition is true, execute the argument.  For
  378.         WHILE, the argument is executed until the condition is false
  379.         (be careful!).
  380.  
  381.         the optional '!' inverts the logic.
  382.  
  383.         Conditions:
  384.  
  385.         #        if toggle entry # is SET
  386.         t        if On line 1
  387.         b        if On last line
  388.         l        if At column 0
  389.         r        if At end of line (spaces below and beyond)
  390.         m        if Text has been modified
  391.         i        if in insert mode
  392.         x[<=>]# if column position (starts at 1) is (any OR combo of
  393.             <, =, or >) than some number.  Example:   x<20
  394.         y[<=>]# if Line number (starts at 1) is (same as for x)
  395.         cl        character under cursor is lower case alpha
  396.         cu        character under cursor is upper case alpha
  397.         ca        character under cursor is alpha-numeric
  398.         cn        character under cursor is numeric
  399.         c[<=>]# character under cursor is ascii code # (# in decimal)
  400.             optional conditionals as in 'x' and 'y'.
  401.         cb        cursor within a block
  402.  
  403.     Example: simulating an insert mode toggle: ALT-i (not CTL-i)
  404.  
  405.      map a-i `ifelse 0 `toggle 0 insertmode OFF' `toggle 0 insertmode ON''
  406.  
  407.     Example: while lower case, map to upper case and move right.
  408.  
  409.      map c-U `while cl `tlate -32 right''
  410.  
  411.      if c<32 ``char under cursor is smaller than 32''
  412.      if c<>32 ``char under cursor is not equal to 32''
  413.      while !b down
  414.  
  415.  
  416.     WARNING:    It is possible to get into infinite loops with REPEAT and
  417.         WHILE.    Currently, BREAK is *not* handled by the open
  418.         window, but by whatever executed DME.  That is, you must
  419.         either Ctl-C from your CLI, or send a BREAK to the DME
  420.         process.  I hope to fix this soon.
  421.  
  422.  
  423.                     IV
  424.                  FILE PARTICULARS
  425.  
  426. No Matter what you set internal tabs to, tabs in disk files will be 8. DME
  427. by default doesn't bother to optimize when writing out files and simply
  428. uses spaces.  If you `SAVETABS on' before saving (or in your S:.EDRC,
  429. etc...), DME will attempt to optimize the file by placing TABS in
  430. appropriate places.  DME will not place any TABS after the first single,
  431. back, or double quote is encountered in a line.  If this does not cover
  432. every situation in your particular application that you want to be *sure*
  433. no tabs will occur in sensitive sections, then you should not use `SAVETABS
  434. on'.
  435.  
  436. The command to save the current document under the default name is SAVEOLD,
  437. *not* SAVE.  SAVE is not a valid command.  This is to prevent people who
  438. have not read the documentation from assuming 'save' takes an argument (and
  439. screwing up their work).  SAVEOLD does NOT take an argument, SAVEAS does.
  440.  
  441.  
  442.                     V
  443.                   REVISION SUMMARY
  444.  
  445. Problems Still not resolved:
  446.  
  447.     -cannot block move/copy accross windows (must BSAVE to, say, the pipe:
  448.      device)
  449.     -still problems if you resize the window while DME is doing
  450.      continuous screen operations (think it's the graphics library).
  451.     -cannot type CTRL-C to break out of infinite loop... must use
  452.      workbench C:BREAK command.
  453.     -Blocks are not highlighted.
  454.     -no 'dumb user' prompts.
  455.     -no 'change working directory'... though this really isn't a bug.
  456.      putting it in means that I would have to backtrace every filename
  457.      so DME wouldn't get confused.  As it is, I think typing in paths
  458.      isn't much of a big deal for people, so.... poof.
  459.  
  460.  
  461. V1.25 RELEASE
  462.  
  463.     -BSAVE does NOT UNBLOCK after saving (switch in functionality yet again)
  464.     -various bugs fixed (IF, tabs on file save)
  465.     -New Commands: MARGIN, REFORMAT, WORDWRAP, RESIZE,
  466.            TOPEDGE, LEFTEDGE, WIDTH, HEIGHT
  467.     -Command line options added for setting the window size and an optional
  468.      specified script file (when specified, local .EDRC not sourced).
  469.  
  470.     -Enhanced Commands: IF  ..more control with conditions, addition of
  471.                   a couple more specifications.
  472.                JOIN .. functionality slightly changed
  473.     -keymaps may now be used as macros in other commands. (macros)
  474.     -New keymaps added to the default set.
  475.     -Mouse movement cleaned up a little.
  476.  
  477. V1.24 Internal
  478.  
  479. V1.23 RELEASE
  480.     -S:.EDRC now sourced instead of C:.EDRC
  481.     -User keymappings now work in COMMAND mode (when you hit ESC).
  482.     -You can now map the Amiga keys ('A' for Amiga, since 'a' is alt).
  483.     -Enhanced Commands: IF/IFELSE/WHILE (optional '!' in front of cond)
  484.             new condition 'cb' 'character in selected block'
  485.             GOTO (can now say `goto block')
  486.     -NewCommands:    PAGESET SAVETABS
  487.     -Writing TABS (always 8) out to disk to save space now supported.
  488.  
  489. V1.22 RELEASE (BUF FIXES FROM 1.20)
  490.     -'newfile' fixed
  491. V1.21 RELEASE (BUG FIXES FROM 1.20)
  492.     -iconify and window handling fixed
  493.     -left mouse button now tracks the mouse.
  494. V1.20 RELEASE
  495.     -bug fixes: bsave now unmarks the block, bdelete now sets 'modified' flag.
  496.         (other small fixes).
  497.     -enhancements: overwrite mode status indicator, find, find-replace now
  498.         completely implemented (yahhoo!!!)
  499.     -changed commands:    FIND NEXT PREV: no longer loop back to the top of
  500.         file or top->bottom in the case of PREV.  DELINE will now delete
  501.         text on the line if there is only one line of text.
  502.     -enhanced commands: GOTO REPEAT
  503.     -new commands: SAVEMAP SAVESMAP TOGGLE SETTOGGLE RESETTOGGLE TLATE
  504.            IF IFELSE WHILE BSOURCE
  505.            FINDSTR REPSTR FINDR NEXTR PREVR
  506.            NEWWINDOW
  507.     -new keymappings: (see a-s, a-S, f3)
  508.     -window iconification with mouse menu button.
  509.  
  510.  
  511. V1.12 RELEASE
  512.     -cursor is now pen #3 rather than #1.
  513.     -changeover to AZTEC C, smaller executable.
  514.     -now maps shift space to a space.
  515.     -new commands: REMEOL, WLEFT, WRIGHT
  516.     -display bug fixes (SPLIT)
  517.     -FIND/PREV/NEXT will now abort a REPEAT if string not found.
  518.  
  519. V1.11 RELEASE NOTES
  520.     -Bug fixes (mainly graphical mistakes).
  521.     -User keymappings are disabled in command mode (so you can unmap
  522.       single ascii characters you may have mapped).
  523.     -Illegal key combinations no longer give garbage (e.g. ALT-CURSOR-DOWN)
  524.       you can, of course, still map them to anything you wish.
  525.     -Save now checks for error conditions on write.
  526.     -Uses Default Console Keymap (i.e. no longer assumes USA)... but there
  527.       *is* some stangeness.
  528.  
  529. V1.00 RELEASE NOTES
  530.     -has find, but no replace function
  531.     -marked blocks are not highlighted
  532.     -assumes USA keyboard            (fixed 1.11)
  533.     -disk files written out use spaces instead of tabs&spaces
  534.     -No scroll bar yet.
  535.  
  536.  
  537.                     VI
  538.                 COMPILING
  539.  
  540.  
  541. DME now compiles under AZTEC.  You must compile with the 32 bit int option,
  542. but may use the small code/data model.    You must use V3.00 or above of
  543. MY.LIB    (MY32.LIB), dated MARCH 1987
  544.  
  545.     cc +L -S NAME.c        (for each .C module)
  546.     ln *.o -lmy32 -lc32 +Q
  547.  
  548.  
  549. To compile DME under lattice requires the MY.LIB version 3.00 or above:
  550.  
  551.     lc1 -oram: -iinclude: NAME.C
  552.     lc2 -s -v -oNAME.o ram:NAME.q
  553.  
  554.     blink lattice:Astartup.obj library lib:my.lib+lib:amiga.lib to ram:dme ND
  555.  
  556.  
  557.  
  558.