[mew-int 00624] Re: <DEL> behaviour

[sen_ml at example.com]

From: Werner LEMBERG <wl at example.com>
Subject: [mew-int 00623] Re: <DEL> behaviour
Date: Tue, 11 Dec 2001 17:15:39 +0100 (CET)

> The documentation is quite mysterious.  My value of
> mew-mark-afterstep-spec is currently
> 
>   ((42 0 0 0 0 0 0 0)
>    (64 0 0 0 0 0 0 0)
>    (68 2 0 2 0 0 0 0)
>    (88 2 0 2 0 0 0 0)
>    (111 2 0 2 0 0 0 0))
> 
> What are the numbers `42', `64', etc.?  Of course, this isn't
> documented in mew.texinfo :-)

I wondered the same thing myself, and looked directly in
`mew-vars2.el' (the link to this showed up when I did C-h v for
`mew-mark-afterstep-spec').

What I found was:

(defvar mew-mark-afterstep-spec
  `((,mew-mark-review 0 0 0 0 0 0 0)
    (,mew-mark-multi  0 0 0 0 0 0 0)
    (,mew-mark-delete 2 0 2 0 0 0 0)
    (,mew-mark-unlink 2 0 2 0 0 0 0)
    (,mew-mark-refile 2 0 2 0 0 0 0))

So I presume:

  42, 64, 68, 88, 111

correspond to:

  mew-mark-{review,multi,delete,unlink,refile}

[ Do C-h v for `mew-mark-review' and then follow the link to `mew-vars2'
  to see what the numbers are. ]

As a side note, since the docstring says that
`mew-mark-afterstep-spec' is a list of cursor actions, perhaps it
would make sense to describe the structure of an individual cursor
action.  I think this might make things clearer.

How about something along the lines of:

  *A list of cursor actions after marking.

  Each cursor action is a list of eight elements.  The initial element
  represents a mark type, while the remaining seven elements represent
  post-marking cursor movement instructions for various situations.

  The mark types are:

    `mew-mark-review'
    `mew-mark-multi'
    `mew-mark-delete'
    `mew-mark-unlink'
    `mew-mark-refile'

  The seven situations are:

    1. No marks.

    2. The new mark is equal to the old mark.

    3. The level of the new mark is greater than that of the old one.

    4. The old and new marks have the same level, the old mark has state,
       and the old mark has been overridden.

    5. The old and new marks have the same level, the old mark has state,
       and the old mark has not been overridden.

    6. The old and new marks have the same level, and the old mark does not
       have state.

    7. The level of the new mark is less than that of the old one.

  See the code for `mew-mark-put-mark' and `mew-mark-afterstep' for
  more details.