0031 - a.vim.json

{
  "script_id": "31",
  "display_name": "a.vim",
  "summary": "Alternate Files quickly (.c --> .h etc)",
  "name": "a.vim",
  "script_type": "utility",
  "description": "A few of quick commands to swtich between source files and header files quickly.\n\n:A switches to the header file corresponding to the current file being edited (or vise versa)\n:AS splits and switches\n:AV vertical splits and switches\n:AT new tab and switches\n:AN cycles through matches\n:IH switches to file under cursor\n:IHS splits and switches\n:IHV vertical splits and switches\n:IHT new tab and switches\n:IHN cycles through matches\n<Leader>ih switches to file under cursor\n<Leader>is switches to the alternate file of file under cursor (e.g. on  <foo.h> switches to foo.cpp)\n<Leader>ihn cycles through matches\n\nE.g. if you are editing foo.c and need to edit foo.h simply execute :A and you will be editting foo.h, to switch back to foo.c execute :A again. \n\nCan be configured to support a variety of languages. Builtin support for C, C++ and ADA95",
  "install_details": "Drop a.vim into your favorite plugin directory or source the script from your .vimrc file\nDrop alternate.txt into you doc directory and run helptags",
  "versions": [
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=7218",
      "filename": "a.vim",
      "script_version": "2.18",
      "date": "2007-06-07",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Recent versions since 2.16 broke user defined alternate specifications. This patch fixes that."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=7162",
      "filename": "a.vim",
      "script_version": "2.17",
      "date": "2007-05-23",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Fix a bug were spaces in filenames and/or directory names would prevent the alternate file being openned. Thanks to Nathan Stien (for the bug report and patch) and Soeren Sonnenburg (for the bug report)."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=6886",
      "filename": "a.vim",
      "script_version": "2.16",
      "date": "2007-03-16",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Recent patches broke the script in some area, mainly in the area of file extensions which contain a dot...e.g. aspx.cs. Switched to using a dictionary instead of the curly brace variable things."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=6347",
      "filename": "alternate.txt",
      "script_version": "2.15 doc",
      "date": "2006-10-27",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Docs for 2.15"
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=6346",
      "filename": "a.vim",
      "script_version": "2.15",
      "date": "2006-10-27",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Initial support for jumping to files under the cursor. New commands IH, IHS, IHV, IHT and IHN. Added sample macros for jumping to the source file corresponding to the header file under the cursor (e.g. jumping on #include <myfile.h> will find myfile.cpp).\n\nSee documentation for more details."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=5698",
      "filename": "a.vim",
      "script_version": "2.14",
      "date": "2006-05-14",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added new :AN command which cycles through all matches after switching to a new file. E.g. vi a.c, :A switches to a.h, :AN might switch to a.hpp if a.h and a.hpp exist. Will only likely be an issue in a big project with with same named source/header files around the place. Will likely only be an issue if you are using the search path and regex features of a.vim."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=5697",
      "filename": "alternate.txt",
      "script_version": "2.14 doc",
      "date": "2006-05-14",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Documentation for a.vim v2.14. Drop it in your doc directory and run helptags."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=5653",
      "filename": "a.vim",
      "script_version": "2.13",
      "date": "2006-05-07",
      "vim_version": "7.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added new \"AT\" command which finds the alternate file and opens in a new tab. Similarly to the \"A\" and \"AS\" commands, if the buffer is already open it simply switches to that buffer in the corresponding tab/window. This script will only work with VIM7 from this version forward."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=4154",
      "filename": "a.vim",
      "script_version": "2.12",
      "date": "2005-04-12",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added alternate mappings for OCaml. Nothing more. No reason to upgrade...unless you use OCaml."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=3563",
      "filename": "a.vim",
      "script_version": "2.11a",
      "date": "2004-10-19",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Fix a minor bug when adding alternate extensions. Thanks ilya."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=3479",
      "filename": "a.vim",
      "script_version": "2.11",
      "date": "2004-09-24",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Fix some bugs which have recently crept in. I gave this some regression testing...so I hope all are fixed now. Mot notably, vim foo/a.c would not alternate to foo/a.h. Not sure how that broke...but it is fixed now. Other features still appear to work. Let me know if there are issues."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=3455",
      "filename": "a.vim",
      "script_version": "2.10",
      "date": "2004-09-15",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added a new variable (g:alternateNoDefaultAlternate) which can be set in the .vimrc/_vimrc file to prevent a.vim from creating new files. This is useful when it is not desired to have a.vim to alternate to the default alternation for a particular extension. E.g. if a.c is being editted and a.h does not exist anywhere and :A is done then if g:alternateNoDefaultAlternate is non-zero a.h will not be created. By default the value of g:alternateNoDefaultAlternate is 0 to maintain existing behaviour."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=3439",
      "filename": "a.vim",
      "script_version": "2.9",
      "date": "2004-09-10",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Allow the extension of a file to be more than the text after the last dot. E.g. adding settings like\n\nlet g:alternateExtensions_{'aspx'} = \"aspx.cs,aspx.CS\"\nlet g:alternateExtensions_{'aspx.cs'} = \"aspx,ASPX\"\n\nwill allow a.vim to alternate between foo.aspx and foo.aspx.cs and vice versa. Previous versions would not accept .aspx.cs as an exstension. This version is ok with that."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=3200",
      "filename": "a.vim",
      "script_version": "2.8",
      "date": "2004-07-01",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "[CORRECTION]More enhancements from Bindu Wavell. A new search path type \nof \"reg:\" wasadded. This version allows alternation of files based on regxes. E.g.\n\"reg:/inc/src/g/\" will replace every instance of 'inc' with 'src' in the source\nfile path. This is useful for alternating between /some/path/inc/project/foo.h\nto /some/path/src/project/foo.c. Similarly \"reg:/src/inc/g/\" is the opposite\nalternation. See the comments for ExpandAlternatePath() for more information.\nSoon I will produce some formal documentation for this...until then the script\nis reasonably well commented."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=3028",
      "filename": "a.vim",
      "script_version": "2.7",
      "date": "2004-05-16",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Reworked all the logic for finding alternate files. The files in memory are prefered to files on disk now too. When there are multiple matches for a file found the file in memory is favour, files in the current directory are favoured over files on the path. Hopefully this fixes the inconsistencies in previous versions. Hopefully everything still works too."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=2833",
      "filename": "a.vim",
      "script_version": "2.6a",
      "date": "2004-03-14",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Remove reference to Decho which was accidentally left in after previous debuging. Sorry all."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=2830",
      "filename": "a.vim",
      "script_version": "2.6",
      "date": "2004-03-13",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Implemented a fix from Matt Perry, vi test.cc junktest.h and the :A would alternate to junktest.h and not test.h. Also some minor clean up of the directory search code. \n"
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=2669",
      "filename": "a.vim",
      "script_version": "2.5",
      "date": "2004-01-20",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Fixed an inconsistency. In 2.4 :A would always switch to the alternate file, regardless of whether unsaved changes were in the current file. In some cases it was possible to lose changes. This update changes :A back to 2.3 behaviour, but with a nicer error message, and provides support for a :A! command which will force the switch. This seems more consistent with the builtin vim/vi commands. Please let me know if there are any problems. "
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=2010",
      "filename": "a.vim",
      "script_version": "2.4",
      "date": "2003-05-21",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Fix error which occured when alternating from a file which had not been saved."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=1240",
      "filename": "a.vim",
      "script_version": "2.3",
      "date": "2002-09-24",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added support provided by Bindu Wavell to search for the alternate file across directories."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=657",
      "filename": "a.vim",
      "script_version": "2.2",
      "date": "2002-03-06",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "minor clean up. Remove repeated code used to \nsetup the default alternate file mappings. No changes in functionality. No reason to upgrade."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=531",
      "filename": "a.vim",
      "script_version": "2.1",
      "date": "2002-02-02",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "simplified the config using vim's curly brace variables. Should behave the same way version 2.0X behaves....no huge reason to upgrade."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=518",
      "filename": "a.vim",
      "script_version": "2.0.1",
      "date": "2002-01-29",
      "vim_version": "6.0",
      "author": {
        "user_id": "104",
        "user_name": "leifw",
        "first_name": "Leif",
        "last_name": "Wickland",
        "email": "leifw at bigfoot , com",
        "homepage": "http://wickland.globalcon.net"
      },
      "release_notes": "Adds support for vertically splitting via the command :AV"
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=384",
      "filename": "a.vim",
      "script_version": "2.0b",
      "date": "2001-11-29",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added support for Ada95 extensions\nminor bug fixed too."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=381",
      "filename": "a.vim",
      "script_version": "2.0a",
      "date": "2001-11-27",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "bug fix. handle the cases were the is no alternate file."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=380",
      "filename": "a.vim",
      "script_version": "2.0",
      "date": "2001-11-27",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Complete rewrite. Now the supported extensions are configurable instead of being part of the code.\nNotes on how to configure are in the comments in the file. Expect bugs, please be brave. Will fix reported issue quickly."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=379",
      "filename": "a.vim",
      "script_version": "1.4",
      "date": "2001-11-27",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added support for .hpp/.HPP files. "
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=334",
      "filename": "a.vim",
      "script_version": "1.3",
      "date": "2001-11-10",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Take care of some issues with case-sensitivity of the extension on windows platforms."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=333",
      "filename": "a.vim",
      "script_version": "1.2",
      "date": "2001-11-10",
      "vim_version": "6.0",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Minor changes to cater for \"files\" which are in vim buffers but not on disk (yet)."
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=163",
      "filename": "a.vim",
      "script_version": "1.1",
      "date": "2001-09-12",
      "vim_version": "6.0",
      "author": {
        "user_id": "104",
        "user_name": "leifw",
        "first_name": "Leif",
        "last_name": "Wickland",
        "email": "leifw at bigfoot , com",
        "homepage": "http://wickland.globalcon.net"
      },
      "release_notes": "This is a plugin-ized version of 1.1 for vim 5.7"
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=129",
      "filename": "a.vim",
      "script_version": "1.1",
      "date": "2001-08-22",
      "vim_version": "5.7",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Added copyright information.\nSupport .cc, .cxx, .C extensions for C++ too.\n"
    },
    {
      "url": "http://www.vim.org/scripts/download_script.php?src_id=44",
      "filename": "a.vim",
      "script_version": "1.0",
      "date": "2001-07-09",
      "vim_version": "5.7",
      "author": {
        "user_id": "49",
        "user_name": "feline",
        "first_name": "Mike",
        "last_name": "Sharpe",
        "email": "feline@irendi.com",
        "homepage": "http://www.irendi.com"
      },
      "release_notes": "Corrected vim version. The script works with 5.7, but should work with 6.0 too. "
    }
  ]
}