Packages

# Sublime Packages

## Requirements

These packages are developed
against the latest build of Sublime Text
in the [`dev` channel](https://www.sublimetext.com/dev).

The latest release of Packages shipped with Sublime Text
should be tagged via git in this repository.
You can find a list at <https://github.com/sublimehq/Packages/tags>.

Bugs may exist on older builds
and the format used is **not compatible**
with builds older than Build 4095.

## Installation

To make changes to these packages
and test them locally,
fork this repository.
Then symlink the changed packages
into your [`Packages`][packages] folder.
(Replace `Python` in the following commands
with the name of the syntax to install.)

### OS X

```bash
$ git clone https://github.com/sublimehq/Packages.git
$ ln -s `pwd`/Packages/Python ~/Library/Application\ Support/Sublime\ Text/Packages/
```

### Linux

```bash
$ git clone https://github.com/sublimehq/Packages.git
$ ln -s `pwd`/Packages/Python ~/.config/sublime-text/Packages/
```

### Windows

On Windows,
you can use directory junctions instead of symlinks
(symlinks require administrative rights;
directory junctions don't):

```powershell
# Using PowerShell
PS> git clone https://github.com/sublimehq/Packages.git
PS> cmd /c mklink /J "$env:APPDATA/Sublime Text/Packages/Python" (convert-path ./Packages/Python)
```

Alternatively, download the portable version
and clone this repository directly as a subdirectory of the `Data` folder.

### ⚠️ Things to keep in mind

After you've finished,
keep in mind that you're now overriding a default package.

- If other people make upstream changes to an overridden package,
  yours will be out-of-date when Sublime Text updates to a new version.
  To get the latest version,
  pull the changes from this repository.

- If you delete/rename files,
  but they still exist in the package version
  that was shipped with the build of Sublime Text you are using,
  those original files will still be picked up by Sublime,
  unless you replace the entire shipped package
  with an installed package of the same name.

  For example, if your build of Sublime has a `syntax_test_sql.sql` file
  inside the root of `<ST Installation Dir>/Packages/SQL.sublime-package`,
  then you symlink the SQL folder
  from this repository to `<ST User Data Dir>/Packages/SQL`,
  move that file to a `tests` subfolder,
  and then run all syntax tests,
  the old syntax test file will still get picked up
  in addition to the new one.

  To prevent this,
  you can create an empty zip file
  in your `<ST User Data Dir>/Installed Packages` directory like `SQL.sublime-package`
  and that will cause ST to load this one in place of the shipped one.
  In the end, you are just overriding an empty package
  instead of merging new files into an existing package.

  A quick way to create such an empty zip file is via:
  ```bash
  $ printf "PK\x05\x06\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00" > empty.zip
  # or
  $ touch d