*xml_move.txt*  support moving around various objects in XML documents

Version 0.0.2
Copyright (C) 2007-2008 kana <http://whileimautomaton.net/>
License: MIT license  {{{
    Permission is hereby granted, free of charge, to any person obtaining
    a copy of this software and associated documentation files (the
    "Software"), to deal in the Software without restriction, including
    without limitation the rights to use, copy, modify, merge, publish,
    distribute, sublicense, and/or sell copies of the Software, and to
    permit persons to whom the Software is furnished to do so, subject to
    the following conditions:

    The above copyright notice and this permission notice shall be included
    in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
    IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
    CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
    TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
    SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
}}}

CONTENTS                                        *xml_move-contents*

Introduction            |xml_move-introduction|
Interface               |xml_move-interface|
  Key Mappings            |xml_move-key-mappings|
Bugs                    |xml_move-bugs|
Changelog               |xml_move-changelog|




==============================================================================
INTRODUCTION                                    *xml_move-introduction*

*xml_move* is an additional Vim filetype plugin to provide mappings to move
various objects in XML documents, e.g.  start-tags, end-tags, attributes and
text nodes.


Requirements:
- Vim 7.0 or later

Latest version:
http://github.com/kana/config/commits/vim-xml_move

Document in HTML format:
http://kana.github.com/config/vim/xml_move.html




==============================================================================
INTERFACE                                       *xml_move-interface*

------------------------------------------------------------------------------
KEY MAPPINGS                                    *xml_move-key-mappings*

The following key mappings are global.
Note that all moving commands are |exclusive|.

<Plug>XmlMove_SObjNextHeadSR                    *<Plug>XmlMove_SObjNextHeadSR*
                        Move to the head of the next SObj that is one of the
                        following objects:
                        * start-tag (<p>, <pre>, ...)
                        * start-sign of a comment (<!--)
                        * start-sign of a CDATA section (<![CDATA[)
                        * processing instructions (<?xml-stylesheet ... ?>)
                        * various decralations (<!ENTITY ... >)

<Plug>XmlMove_SObjNextTailSR                    *<Plug>XmlMove_SObjNextTailSR*
                        Move to the tail of the next SObj.

<Plug>XmlMove_SObjPrevHeadSR                    *<Plug>XmlMove_SObjPrevHeadSR*
<Plug>XmlMove_SObjPrevTailSR                    *<Plug>XmlMove_SObjPrevTailSR*
                        Move to the head or the tail of the previous SObj.

<Plug>XmlMove_EObjNextHeadSR                    *<Plug>XmlMove_EObjNextHeadSR*
<Plug>XmlMove_EObjNextTailSR                    *<Plug>XmlMove_EObjNextTailSR*
<Plug>XmlMove_EObjPrevHeadSR                    *<Plug>XmlMove_EObjPrevHeadSR*
<Plug>XmlMove_EObjPrevTailSR                    *<Plug>XmlMove_EObjPrevTailSR*
                        Like <Plug>XmlMove_SObjNextHeadSR and others, but move
                        to an EObj that is one of the following objects:
                        * end-tag (</p>, </pre>, ...)
                        * end-sign of a comment (-->)
                        * end-sign of a CDATA section (]]>)

<Plug>XmlMove_TextNextHeadSR                    *<Plug>XmlMove_TextNextHeadSR*
<Plug>XmlMove_TextNextTailSR                    *<Plug>XmlMove_TextNextTailSR*
<Plug>XmlMove_TextPrevHeadSR                    *<Plug>XmlMove_TextPrevHeadSR*
<Plug>XmlMove_TextPrevTailSR                    *<Plug>XmlMove_TextPrevTailSR*
                        Like <Plug>XmlMove_SObjNextHeadSR and others, but move
                        to a range of text that satisfies the following
                        conditions:
                        * is enclosed in SObj and/or EObj.
                        * contains at least one non-space character.
                        * its head and its tail are not space characters.

<Plug>XmlMove_AttrAllNextHeadSR              *<Plug>XmlMove_AttrAllNextHeadSR*
<Plug>XmlMove_AttrAllNextTailSR              *<Plug>XmlMove_AttrAllNextTailSR*
<Plug>XmlMove_AttrAllPrevHeadSR              *<Plug>XmlMove_AttrAllPrevHeadSR*
<Plug>XmlMove_AttrAllPrevTailSR              *<Plug>XmlMove_AttrAllPrevTailSR*
                        Like <Plug>XmlMove_SObjNextHeadSR and others, but move
                        to an attribute in start-tags or empty-element tags.

<Plug>XmlMove_AttrNameNextHeadSR            *<Plug>XmlMove_AttrNameNextHeadSR*
<Plug>XmlMove_AttrNameNextTailSR            *<Plug>XmlMove_AttrNameNextTailSR*
<Plug>XmlMove_AttrNamePrevHeadSR            *<Plug>XmlMove_AttrNamePrevHeadSR*
<Plug>XmlMove_AttrNamePrevTailSR            *<Plug>XmlMove_AttrNamePrevTailSR*
                        Like <Plug>XmlMove_AttrAllNextHeadSR and other, but
                        move to the name of an attribute in start-tags or
                        empty-element tags.

<Plug>XmlMove_AttrValueNextHeadSR          *<Plug>XmlMove_AttrValueNextHeadSR*
<Plug>XmlMove_AttrValueNextTailSR          *<Plug>XmlMove_AttrValueNextTailSR*
<Plug>XmlMove_AttrValuePrevHeadSR          *<Plug>XmlMove_AttrValuePrevHeadSR*
<Plug>XmlMove_AttrValuePrevTailSR          *<Plug>XmlMove_AttrValuePrevTailSR*
                        Like <Plug>XmlMove_AttrAllNextHeadSR and other, but
                        move to the value of an attribute in start-tags or
                        empty-element tags.


The following key mappings are local to each buffer.
These mappings are not defined if the mappings already exist.

Key sequence            Mapped to ~
                             *<LocalLeader>j* *<LocalLeader>f* *<LocalLeader>F*
                                              *<LocalLeader>r* *<LocalLeader>R*
<LocalLeader>j          <Plug>XmlMove_SObjNextHeadSR
<LocalLeader>f          <Plug>XmlMove_SObjNextHeadSR
<LocalLeader>F          <Plug>XmlMove_SObjNextTailSR
<LocalLeader>r          <Plug>XmlMove_SObjPrevHeadSR
<LocalLeader>R          <Plug>XmlMove_SObjPrevTailSR
                             *<LocalLeader>k* *<LocalLeader>d* *<LocalLeader>D*
                                              *<LocalLeader>e* *<LocalLeader>E*
<LocalLeader>k          <Plug>XmlMove_EObjNextHeadSR
<LocalLeader>d          <Plug>XmlMove_EObjNextHeadSR
<LocalLeader>D          <Plug>XmlMove_EObjNextTailSR
<LocalLeader>e          <Plug>XmlMove_EObjPrevHeadSR
<LocalLeader>E          <Plug>XmlMove_EObjPrevTailSR
                                              *<LocalLeader>s* *<LocalLeader>S*
                                              *<LocalLeader>w* *<LocalLeader>W*
<LocalLeader>s          <Plug>XmlMove_TextNextHeadSR
<LocalLeader>S          <Plug>XmlMove_TextNextTailSR
<LocalLeader>w          <Plug>XmlMove_TextPrevHeadSR
<LocalLeader>W          <Plug>XmlMove_TextPrevTailSR
                                              *<LocalLeader>a* *<LocalLeader>A*
                                              *<LocalLeader>q* *<LocalLeader>Q*
<LocalLeader>a          <Plug>XmlMove_AttrAllNextHeadSR
<LocalLeader>A          <Plug>XmlMove_AttrAllNextTailSR
<LocalLeader>q          <Plug>XmlMove_AttrAllPrevHeadSR
<LocalLeader>Q          <Plug>XmlMove_AttrAllPrevTailSR
                                              *<LocalLeader>g* *<LocalLeader>G*
                                              *<LocalLeader>t* *<LocalLeader>T*
<LocalLeader>g          <Plug>XmlMove_AttrNameNextHeadSR
<LocalLeader>G          <Plug>XmlMove_AttrNameNextTailSR
<LocalLeader>t          <Plug>XmlMove_AttrNamePrevHeadSR
<LocalLeader>T          <Plug>XmlMove_AttrNamePrevTailSR
                                              *<LocalLeader>h* *<LocalLeader>H*
                                              *<LocalLeader>y* *<LocalLeader>Y*
<LocalLeader>h          <Plug>XmlMove_AttrValueNextHeadSR
<LocalLeader>H          <Plug>XmlMove_AttrValueNextTailSR
<LocalLeader>y          <Plug>XmlMove_AttrValuePrevHeadSR
<LocalLeader>Y          <Plug>XmlMove_AttrValuePrevTailSR




==============================================================================
BUGS                                            *xml_move-bugs*

* Moving around sibling tags.

* More better key mappings.

* ...




==============================================================================
CHANGELOG                                       *xml_move-changelog*

0.0.2   2008-04-27T12:02:50+09:00               *xml_move-changelog-0.0.2*
        - Add key mappings to move around attribute names and values.

0.0.1   2007-05-10                              *xml_move-changelog-0.0.1*
        - Fix the bug that all moving commands doesn't work in Visual mode,
          i.e. visual selection will be canceled after moving.

0.0.0   2007-04-24                              *xml_move-changelog-0.0.0*
        - First release.




==============================================================================
vim:tw=78:ts=8:ft=help:norl:fen:fdl=0:fdm=marker: