From b2953e82cb609db26035c71b4c9506d1d2f9e499 Mon Sep 17 00:00:00 2001 From: Thomas Goyne Date: Sun, 21 Apr 2013 15:49:30 -0700 Subject: [PATCH] Add the beginnings of a README file --- README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ aegisub/README | 1 - 2 files changed, 48 insertions(+), 1 deletion(-) create mode 100644 README.md delete mode 100644 aegisub/README diff --git a/README.md b/README.md new file mode 100644 index 000000000..b92b93b9b --- /dev/null +++ b/README.md @@ -0,0 +1,48 @@ +# Aegisub + +For binaries and general information [see the homepage](http://www.aegisub.org). + +The bug tracker can be found at http://devel.aegisub.org. + +Support is available on [the forums](http://forum.aegisub.org) or [on IRC](irc://irc.rizon.net/aegisub). + +## Building Aegisub + +### Windows + +Prerequisites: + +1. Visual Studio 2012. Express edition might work. +2. A recent Windows SDK +3. A recent DirectX SDK +4. A MSYS install with git and c99conv. Note that mingw is not required. + +There are a few optional dependencies: + +1. msgfmt, to build the translations +2. WinRAR, to build the portable installer +3. InnoSetup, to build the regular installer + +All other dependencies are either stored in the repository or are included as submodules. + +Building: + +1. Clone Aegisub's repository recursively to fetch it and all submodules: `git clone --recursive git@github.com:Aegisub/Aegisub.git` +2. Disable autocrlf for ffmpeg, as its build system manages to not support Windows newlines: `cd aegisub/deps/ffmpeg && config --local core.autocrlf && git rm --cached -r . && git reset --hard` +3. Open Aegisub.sln +4. Build the "! Update Dependencies" project +5. Open the properties for the Aegisub project and set the location of MSYS in Configuration Properties > Aegisub > Library paths +6. Build Aegisub +7. Copy the contents of an existing Aegisub install into the aegisub/aegisub/bin directory (not strictly required, but you'll be missing a lot of functionality otherwise). + +There's a pile of other files such as dictionaries, VSFilter and avisynth + +For actual development work you will probably want to mostly use the +"Debug-MinDep" configuration (which disables building most of the projects), as +the dependency checking is pretty slow. + +## License + +All source files in this repository are licensed under either 3-clause BSD or +ISC licenses. In practice, Aegisub binaries are usually GPL licensed due to the +dependencies. diff --git a/aegisub/README b/aegisub/README deleted file mode 100644 index 94ad03826..000000000 --- a/aegisub/README +++ /dev/null @@ -1 +0,0 @@ -* To be written.