For general documentation, see the RES Wiki (http://redditenhancementsuite.com:8080/wiki/index.php?title=Main\_Page), at least until the new documentation is finished.

FIRST, a note

Hi there! Thanks for checking out RES on GitHub. A few important notes:

1. RES is licensed under GPLv3, which means you're technically free to do whatever you wish in terms of redistribution. However, I ask out of courtesy that should you choose to release your own, separate distribution of RES, you please name it something else entirely. Unfortunately, I have run into problems in the past with people redistributing under the same name, and causing me tech support headaches.

2. Related: RES is not submitted to browser extension pages like the Chrome Extension Gallery, AMO, etc, because the hope/intent is to provide simultaneous releases for all four browsers at once. This isn't possible given the variable approval times in each gallery, though. I ask that you please do not submit your own RES that isn't renamed there just to get browser syncing of extensions going - because like in #1, it has caused me issues in the past. Someone decided to submit to Chrome's gallery, then I was getting tech support requests from people who were on an old (his) version and weren't getting auto updated through my distribution channel.

I can't stop you from doing any of this. I'm just asking out of courtesy because I already spend a great deal of time providing tech support and chasing down bugs, and it's much harder when people think I'm the support guy for a separate branch of code.

Thanks!

Steve Sobel steve@honestbleeps.com

OKAY! On to what you came to the readme for - how is this project structured?

• README - (YOU ARE HERE - unless you're on GitHub browsing)

• changelog.txt - self explanatory

• lib/reddit_enhancement_suite.user.js This is the core userscript. You will need to create a set of hard links from this script under each browser specific folder. Unfortunately, Github does not maintain these hard links on committing. Note that because Safari's extension builder barfs on symlinks, you must use hard links instead.

• Chrome/ This directory contains the following: - background.html - the "background page" for RES, necessary for chrome extensions - manifest.json - the project manifest - icon.png, icon48.png, icon128.png - icons! - jquery-1.6.4.min.js - jquery 1.6.4! - reddit_enhancement_suite.user.js - a hard link to ../lib

• Opera/ This directory contains the following: - index.html - the "background page" for RES, necessary for opera extensions - config.xml - Opera's equivalent of Chrome's manifest.json - logo.gif - a logo gif! - includes/reddit_enhancement_suite.user.js - a hard link to ../lib

• RES.safariextension/ NOTE: This directory must have .safariextension in the name, or Safari's extension builder pukes. This directory contains the following: - background-safari.html - the "background page" for RES, necessary for safari extensions - Info.plist - the project manifest - icon.png, icon48.png, icon128.png - icons! - jquery-1.6.4.min.js - jquery 1.6.4! - reddit_enhancement_suite.user.js - a hard link to ../lib

• XPI/ NOTE: An XPI is a Firefox addon... This is compiled using the Addon SDK. This directory contains the following: - lib/main.js - this is firefox's sort of "background page" for RES, like what chrome has, but just a JS file - data/jquery-1.6.4.min.js - jquery 1.6.4! - data/reddit_enhancement_suite.user.js - a hard link to ../lib - doc/main.md - "documentation" file that's not currently being used. - README.md - "documentation" file that's not currently being used. - package.json - the project manifest for the Firefox addon

Building development versions of the extension

One thing to note is that if you switch branches this will break you hard links. Therefore, you must create them when checking out new pieces of code.

Chrome

1. Go to Settings->Extensions and tick the Developer Mode checkbox
2. Choose Load unpacked extension and point it to the Chrome folder. Make sure you have created the hard link to lib/reddit_enhancement_suite.js before doing this. Make sure you only have one RES version running at a time.
3. Any time you make changes to the script you must go back to the Settings->Extensions page and Reload the extension.

Firefox

1. Download the addon SDK from here.
2. Start a terminal and source the python script so that you can run the cfx commands. In Unix this is usually . bin/activate or source bin/activate and in Windows this usually involves running Scripts/activate.bat.
3. In the terminal, cd to the XPI folder and run the command cfx run, which should launch a new Firefox browser using a temporary profile with only RES installed. Make sure you have create the hard link to lib/reddit_enhancement_suite.js before doing this.

Safari (assumes Mac)

1. Open the Preferences by going to Safari->Preferences or pressing ⌘,, then go to Advanced and check the checkbox for Show develop menu in menu bar.
2. Navigate to Develop->Show Extension Builder to open the extensions menu. Add a new extension by pressing the + in the bottom left and choosing Add extension.
3. Navigate to the RES.safariextension folder for RES and select it. Make sure you have created the hard link to lib/reddit_enhancement_suite.js before doing this.
4. It will likely say you cannot install it becase no Safari development certificate exists. You will need to visit the Safari Dev Center and create an account (right hand side).
5. You then need to visit the Safari Developer Program site and sign up for a FREE account.
6. You can then visit your member page and use the certificate utility to create a new Safari Developer Certificate. Follow the instructions to install the certificate. If you have an error involving it being signed by an unknown authority, then doubleclick the certificate and under the Trust setting choose Always Trust. You should then be able to install the extension from the Extension Builder menu.

Opera

1. Click Tools->Extensions->Manage Extensions
2. Drag the config.xml file in the Opera directory in to the extensions window and release. You should now have installed the extension. Make sure you have created the hard link to lib/reddit_enhancement_suite.js before doing this.

Building release versions of the extension

Chrome

1. Go to Settings->Extensions and choose Pack extension. Choose the Chrome folder for RES. You can also choose to sign the extension with a private key.
2. This will generate a .crx and .pem file for your extension that you can install by dropping the .crx file in Chrome.

Firefox

1. Make sure you have the addons SDK installed as described in the development section.
2. In your terminal, cd to the XPI folder and run cfx xpi. This should build an .xpi file that you can use to install RES.

Opera

1. Opera extensions are simply zip files. So all you need to do is zip up the contents of the Opera folder, but not the folder itself. So the zip should contain everything inside the Opera folder. Rename the .zip file to have the extension .oex instead. See here for more information.

Safari

1. Navigate to the Extension Builder panel as described in the development instructions. Assuming you have followed those instructions and installed RES, you can now choose build in the top right. This will generate a .safariextz file (signed by your certificate) that you can use to install RES.