.vim/doc/ZoomWin.txt

   1 *ZoomWin.txt*   Zoom into/out-of a window               Apr 24, 2008
   2 Authors: Charles E. Campbell, Jr.                       *zoomwin*
   3          Ron Aaron
   4 Copyright: (c) 2004-2008 by Charles E. Campbell, Jr.    *zoomwin-copyright*
   5            The VIM LICENSE applies to ZoomWin.vim and ZoomWin.txt
   6            (see |copyright|) except use "ZoomWin" instead of "Vim"
   7            No warranty, express or implied.  Use At-Your-Own-Risk.
   8
   9 ==============================================================================
  10 1. Usage                                                *zoomwin-usage*
  11
  12    :call ZoomWin()
  13    :ZoomWin
  14    <c-w>o
  15
  16    Either of the two commands or the normal mode <c-w>o will toggle between
  17         * selecting the current window for display as the only window or
  18         * to restore the original multiple-window view.
  19
  20 ==============================================================================
  21 2. Setup                                                *zoomwin-setup*
  22
  23    Simply put ZoomWin.vim into your .vim/plugin directory (you may need to
  24    make such a directory first).  Under Windows that should be
  25    vimfiles\plugin.  ZoomWin now uses the HelpExtractor method to
  26    automatically extract help and to make it known to vim by running helptags
  27    on it.
  28
  29 ==============================================================================
  30 3. History                                              *zoomwin-history*
  31
  32         v23 Apr 24, 2008 : * when |'scrollbind'| was activated: when ZoomWin
  33                              attempted to restore multiple-windows, the cursor
  34                              position was incorrect.  Fixed.
  35         v22 Apr 10, 2006 : * "only" was occasionally issuing an "Already one
  36                              window" message, which is now prevented
  37                            * SavePosn() issued error message when handling an
  38                              empty buffer
  39                            * saves yank registers and restores them on each
  40                              zoom/unzoom
  41         v21 Oct 12, 2004 : * v14 fixed a bug when wmw and/or wmv equal to 0;
  42                              v21 will invoke the patch only if the version <= 603.
  43                              For vim version 6.3 users, this fix allows more files
  44                              to be handled by ZoomWin.
  45             May 10, 2005   * When :version shows -mksession, and the vim version
  46                              is at least 6.3, ZoomWin will now do a partial zoom
  47         v20 Jul 26, 2004 : * bugfix - ZoomWin didn't always retain the
  48                              position in the former zoomed-in window after
  49                              the window layout was restored.  It was restoring
  50                              the position when the zoom-in occurred.
  51         v19 May 26, 2004 : * bugfix - winmanager has events firing that,
  52                              amongst other things, reset the bufhidden
  53                              option to delete for some windows while
  54                              ZoomWin worked.  ZoomWin now works
  55                              successfully with winmanager.
  56         v18 May 20, 2004 : * bugfix - didn't adversely affect anything, but
  57                              ZoomWin was deleting its session file twice.
  58                            * bugfix -- a multi-source file + minibufexplorer
  59                              + Taglist interaction bug -- minibufexplorer's
  60                              autocmd events were firing, generating a new
  61                              window while ZoomWin was attempting to restore
  62                              the display.  ZoomWin didn't have restoration
  63                              information for the new window and so reported
  64                              an error.  Events are now temporarily disabled
  65                              while ZoomWin is restoring the layout.
  66         v17 Mar 26, 2004 : * ZoomWin command installed.  Works nicely with
  67                              taglist:  vim +Tlist +ZoomWin filename
  68         v16 Dec 22, 2003 : * handles bufhidden and nobl windows (TagList support).
  69                            * Now also works with quickfix window (:copen) but
  70                              still not with |cmdline-window| (q:)
  71         v15 Dec 19, 2003 : * SavePosn()/RestorePosn() needed to be preceded
  72                              by s: to prevent clashes
  73         v14 Dec 18, 2003 : * works around a restoration-bug with mksession
  74                              when either wmw or wmh settings are zero
  75                            * Bwipes internal temporary buffers
  76                            * Known bugs: will not work with command-line
  77                            * Editing window (|cmdline-window|) nor the
  78                              quickfix window (|copen|).
  79         v13 Dec 18, 2003 : Uses eventignore to prevent events/autocmds from
  80                             firing while changing the mksession results.
  81         v12 Dec 12, 2003 : uses hidden and a minimalist mksession save
  82         v11 Oct 14, 2003 : bug fix: apparently RestorePosn()'s variables,
  83                             which were b:, weren't always defined, so s:
  84                             ones are now used.
  85         v10 Sep 22, 2003 : Bug fix: when a single window is showing, the user
  86                             moves the cursor, then <c-w>o used to restore
  87                             screen, the current cursor position wasn't retained
  88                            Restores v:this_session.
  89                            Bug fix: change a window, use <c-w>o, then write.
  90                            Was saving file only to temporary file instead of
  91                             actual file, but when the actual file was brought back,
  92                             the changes were lost.
  93         v9 Aug 15, 2003 :  v8 managed to trash syntax highlighting on
  94                            reload, this one removes the eventignore
  95                            handling.  Will need more pondering...
  96         v8 Aug 14, 2003 :  now handles not-modified but not filereadable
  97                            buffers, nowrite buffers uses eventignore to
  98                            bypass autocmd firing
  99         v7 May 23, 2003 :  bugfix - GotoWinNum() didn't always get the
 100                            cursor into the correct window
 101         v6 Mar 25, 2003 :  more cleanup included
 102         v5 Mar 14, 2003 :  includes support for handling scratch buffers,
 103                            no-name buffer windows, and modified-buffer
 104                            windows.  All windows' contents will be saved to
 105                            temporary buffers
 106         v4 Dec 12, 2002 :  Zak Beck contributed code to clean up temporary
 107                            session files if one leaves vim while zoomed-in
 108         v3 Dec 11, 2002 :  plugin-ized
 109         v2 Nov 08, 2002 :  A guaranteed-to-be-unique to this
 110                            session file is used for session information.
 111                            Modified but not yet saved files are made hidden
 112                            during zoom in.
 113         v1 the epoch    :  Ron Aaron's original
 114
 115 vim:tw=78:ts=8:ft=help