dotfill.txt	DotFill					Oct 16, 2012

Author:    Charles E. Campbell  <NdrOchip@ScampbellPfamily.AbizM>
           (remove NOSPAM from Campbell's email first)
Copyright: (c) 2006-2012 Charles E. Campbell	DotFill-copyright
           Permission is hereby granted to use and distribute this code,
           with or without modifications, provided that this copyright
           notice is copied with it. Like anything else that's free,
           DotFill.vim is provided *as is* and comes with no warranty
           of any kind, either expressed or implied. By using this
           plugin, you agree that in no event will the copyright
           holder be liable for any damages resulting from the use
           of this software.

==============================================================================
1. Contents					dotfill dotfill-contents

  1. Contents.....................................: dotfill-contents
  2. Installation.................................: dotfill-install
  3. Usage........................................: dotfill-usage
  4. History......................................: dotfill-history


==============================================================================
2. Installation						dotfill-install

* To use this plugin, one must have:
  - vim 7.0
  - v18 or later of the vimball plugin
  - Align/AlignMaps plugin

* You may get the plugins from either

    http://www.drchip.org/astronaut/vim/index.html#VimFuncs
    see "Alignment Maps" and "Vimball Archiver"

  or from

    http://vim.sourceforge.net/scripts/script.php?script_id=294    (Align)
    http://vim.sourceforge.net/scripts/script.php?script_id=1502   (vimball)

  Be sure to remove vim70/plugin/vimballPlugin.vim and
  vim70/autoload/vimball.vim before installing any new
  vimball plugin.

* To install this plugin:
  vim DotFill.vba.gz
  :so %
  :q


==============================================================================
3. Usage						dotfill-usage

     :[range]DotFill .       Simply select a range of lines.  Any lines
     :[range]DotFill -       which contain three or more contiguous copies
     etc                     of the fill-character will be aligned and
                             separated by the fill character.

    Example:

     Original:
        one...two
        three...four
        five...six
        seven...eight

    Using DotFill:   :%DotFill .
        one.....two
        three...four
        five....six
        seven...eight

==============================================================================
4. DotFill History				dotfill-history {{{1
   v1	Sep 21, 2006	* initial release as v1a
   	Aug 25, 2011	* repeated applications of DotFill were causing
			  increasing fillchar lengths.  Amount of fill now
			  remains constant during repeated applications.


==============================================================================
Modelines: {{{1
vim:tw=78:ts=8:ft=help:fdm=marker: