Default.sublime-package (downstream/fork)

I use this repository for versioning some files of the Sublime Text default packages Default.sublime-package over git using two repositories strategy:

1. The first repository is mirror of some files I need to change from the latest Sublime Text development build version I am using. Every time a new development version is released, and I install it, I would unpack it, replace the files on this repository with them and commit its changes to this repository. This is a repository just for mirroring them. Would never be send changes back to this upstream from a fork repository as at every new release of Sublime Text, this mirror (upstream) files would be replaced and any changes would be lost lost.

2. The second repository would be a fork of this upstream mirror, on it would be included changes to the files at upstream mirror of Sublime Text default packages Default.sublime-package. Every Sublime Text development release would be merged the changes from the upstream mirror, if any. Therefore we can keep our changes while staying up-to-date with the latest version of Default.sublime-package.

Related topics about Sublime Text Default Packages:

1. CoreIssues$621 Looking for a strategy to Open Source the "Default Packages"
2. SublimeForum$4648 REQUEST: Move all Default Packages into Source Control
3. SublimeForum$15254 Packages are on GitHub
4. SublimeForum$22111 Reuse code of the Default packages
5. SublimeForum$14278 ★ Looking for a strategy to Open-Source the Default Packages

Related repositories:

1. https://github.com/twolfson/sublime-files

Installation

By Package Control

1. Download & Install Sublime Text 3 (https://www.sublimetext.com/3)
2. Go to the menu Tools -> Install Package Control, then, wait few seconds until the installation finishes up
3. Now, Go to the menu Preferences -> Package Control
4. Type Add Channel on the opened quick panel and press Enter
5. Then, input the following address and press Enter

   https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json
   

6. Go to the menu Tools -> Command Palette... (Ctrl+Shift+P)
7. Type Preferences: Package Control Settings – User on the opened quick panel and press Enter
8. Then, find the following setting on your Package Control.sublime-settings file:

   "channels":
   [
       "https://packagecontrol.io/channel_v3.json",
       "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json",
   ],

9. And, change it to the following, i.e., put the https://raw.githubusercontent... line as first:

   "channels":
   [
       "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json",
       "https://packagecontrol.io/channel_v3.json",
   ],

   • The https://raw.githubusercontent... line must to be added before the https://packagecontrol.io... one, otherwise, you will not install this forked version of the package, but the original available on the Package Control default channel https://packagecontrol.io...
10. Now, go to the menu Preferences -> Package Control
11. Type Install Package on the opened quick panel and press Enter
12. Then, search for Default and press Enter

See also:

1. ITE - Integrated Toolset Environment
2. Package control docs for details.

Monkey Patch sublime and sublime_plugin

On the file monkey_patch_sublime_modules.py, we patch the sublime and sublime_plugin files because they have some very annoying bugs, not fixed so far:

1. SublimeTextIssues/Core#2113 OSError: resource not found (Which one?)

   raise IOError("resource not found")
   # -->
   raise IOError("resource `%s` not found" % (name))

Zzz Reload Default

This repository also has the custom plugin zz_reload_default_package.py, which reload overridden Default.sublime-package files because by default, Sublime Text on start up does not reload the overridden Default packages modules on Packages/Default.

It also creates the package 0_packages_loader.sublime-package every time the default settings files on *.sublime-settings.hide are updated. As we ship the Default.sublime-package by PackagesManager, we cannot install the Default.sublime-package as a .sublime-package because we cannot disable the Default.sublime-package. And to update a packed package (Default.sublime-package), we need to disable it before updating. Then, we ship it as a unpacked package, which allows it to be upgraded by PackagesManager because we do not need to disable it for updating.

However, due the settings loader order, we cannot let Sublime Text find the default settings files *.sublime-settings on the unpacked packages directory, otherwise, it would override all other packages defined settings/keybindings. Therefore, we create the 0_packages_loader.sublime-package on the packed packages directory, based on the *.sublime-settings.hide settings file.

Synced Side Bar Watcher

This repository also has the custom plugin synced_side_bar_watcher.py, which creates the command synced_side_bar_reveal_in_side_bar, to hide the default context menu command reveal_in_side_bar, when the package SyncedSideBar is installed.

forum#22753 How to add/remove a default menu entry when a X package is/isn’t enabled/installed?

Packages Manager Support

This repository also has the custom plugin install_package_control_extended.py, which creates the command install_package_control_extended, to replace the default context menu command install_package_control.

The command install_package_control_extended is used to hide the command install_package_control when my fork/version of Package Control called PackagesManager is installed. See description and differences from Package Control at:

1. https://github.com/evandrocoan/PackagesManager
2. https://github.com/evandrocoan/PackagesManager/commits/master

This is useful, so the user does not accidentally install 2 Packages Managers which conflicts with each other. When there is no Packages Manager installed, the default behavior of the command install_package_control still installing the standard Package Control is preserved.

License

The only purpose of this repository is to early include my fixes or enhancements into the Sublime Text Default.sublime-package. This repository code/information cannot be used by any other means not authorised by Jon Skinner @ SUBLIME HQ PTY LTD.

The file Find Results.hidden-tmLanguage contains content Copyrighted by (c) 2014 Allen Bargi under the MIT license, included at the end of the file on the Acknowledgements section.

The new code or changes created by Evandro Coan are licensed under the same license as Sublime Text (as described later), except for the file Find Results.hidden-tmLanguage, which is licensed under MIT license and it created by Allen Bargi and modified by Evandro Coan.

Jon Skinner @ SUBLIME HQ PTY LTD is welcome to incorporate any change/code or this whole repository code back into Sublime Text next version.

To see which changes are from SUBLIME HQ PTY LTD or Evandro Coan access the git history and read the commit messages. The commit messages will explicitly state when the code changes are coming from the next Sublime Text version. Otherwise, when the commit message or any committed code changes does not explicitly state from where the code changes come, it is implied they are coming from Evandro Coan and are licensed under the same license as Sublime Text (as described later).

You can see the commit history only by accessing the following address:

1. https://github.com/evandrocoan/SublimeDefault/commits/master

Or clone this repository and run following git client command:

1. git log
2. https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History

Most files on this repository were initially downloaded from https://www.sublimetext.com/3dev and are synced with the Sublime Text mirror at https://github.com/evandroforks/DefaultSublimePackage.

Sublime Text which has the following license known as End User License Agreement https://www.sublimetext.com/eula by SUBLIME HQ PTY LTD:

The SOFTWARE PRODUCT (SUBLIME TEXT) is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. The SOFTWARE PRODUCT is licensed, not sold.

1. LICENSES

   SUBLIME TEXT is licensed as follows:

   1. Installation and Usage.

      Licenses are per user and valid for use on all supported operating systems. License keys may be used on multiple computers and operating systems, provided the license key holder is the primary user. Businesses must purchase at least as many licenses as the number of people using SUBLIME TEXT.

   2. Backup Copies.

      You may make copies of the license key and or SUBLIME TEXT for backup and archival purposes.

2. DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS

   1. Maintenance of Copyright Notices.

      You must not remove or alter any copyright notices on any copy of SUBLIME TEXT.

   2. Distribution.

      You may not distribute or sell license keys or SUBLIME TEXT to third parties. Licenses will be revoked if distributed or sold to third parties.

   3. Rental.

      You may not rent, lease, or lend the license key or SUBLIME TEXT.

3. COPYRIGHT

   All title, including but not limited to copyrights, in and to SUBLIME TEXT and any copies thereof are owned by SUBLIME HQ PTY LTD.

4. NO WARRANTIES

   SUBLIME HQ PTY LTD expressly disclaims any warranty for SUBLIME TEXT, which is provided 'as is' without any express or implied warranty of any kind, including but not limited to any warranties of merchantability, non-infringement, or fitness of a particular purpose.

5. LIMITATION OF LIABILITY

   In no event shall SUBLIME HQ PTY LTD be liable for any damages due to use of SUBLIME TEXT, to the maximum extent permitted by law. This includes without limitation, lost profits, business interruption, or lost information. In no event will SUBLIME HQ PTY LTD be liable for loss of data or for indirect, special, incidental, consequential (including lost profit), or other damages. SUBLIME HQ PTY LTD shall have no liability with respect to the content of SUBLIME TEXT or any part thereof, including but not limited to errors or omissions contained therein, libel, trademark rights, business interruption, loss of privacy or the disclosure of confidential information.

Acknowledgements

<File `Find Results.hidden-tmLanguage`>
Copyright (c) 2014 Allen Bargi (https://twitter.com/aziz)

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.