Updating doc files in trunk

git-svn-id: svn://svn.handbrake.fr/HandBrake/trunk@4492 b64f7644-9d1e-0410-96f1-a4d463321fa5

6 files changed, 305 insertions, 270 deletions

diff --git a/win/CS/doc/AUTHORS b/win/CS/doc/AUTHORS
index 682a5f72f..4d544e705 100644
--- a/win/CS/doc/AUTHORS
+++ b/win/CS/doc/AUTHORS
@@ -110,3 +110,10 @@ Mark Krenek (travistex)
 
 Kona 'mike' Blend (KonaBlend)
  + Build System and related guides
+ 
+David Rickard (RandomEngy)
++ HandBrake Interop Library
+
+Tim Walker (Rodeo)
++ Miscellaneous fixes and enhancements
+
diff --git a/win/CS/doc/COPYING b/win/CS/doc/COPYING
index d60c31a97..ecbc05937 100644
--- a/win/CS/doc/COPYING
+++ b/win/CS/doc/COPYING
@@ -1,12 +1,12 @@
-		    GNU GENERAL PUBLIC LICENSE
-		       Version 2, June 1991
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
 
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
-     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
-			    Preamble
+                            Preamble
 
   The licenses for most software are designed to take away your
 freedom to share and change it.  By contrast, the GNU General Public
@@ -15,7 +15,7 @@ software--to make sure the software is free for all its users.  This
 General Public License applies to most of the Free Software
 Foundation's software and to any other program whose authors commit to
 using it.  (Some other Free Software Foundation software is covered by
-the GNU Library General Public License instead.)  You can apply it to
+the GNU Lesser General Public License instead.)  You can apply it to
 your programs, too.
 
   When we speak of free software, we are referring to freedom, not
@@ -55,8 +55,8 @@ patent must be licensed for everyone's free use or not licensed at all.
 
   The precise terms and conditions for copying, distribution and
 modification follow.
-
-		    GNU GENERAL PUBLIC LICENSE
+
+                    GNU GENERAL PUBLIC LICENSE
    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
 
   0. This License applies to any program or other work which contains
@@ -110,7 +110,7 @@ above, provided that you also meet all of these conditions:
     License.  (Exception: if the Program itself is interactive but
     does not normally print such an announcement, your work based on
     the Program is not required to print an announcement.)
-
+
 These requirements apply to the modified work as a whole.  If
 identifiable sections of that work are not derived from the Program,
 and can be reasonably considered independent and separate works in
@@ -168,7 +168,7 @@ access to copy from a designated place, then offering equivalent
 access to copy the source code from the same place counts as
 distribution of the source code, even though third parties are not
 compelled to copy the source along with the object code.
-
+
   4. You may not copy, modify, sublicense, or distribute the Program
 except as expressly provided under this License.  Any attempt
 otherwise to copy, modify, sublicense or distribute the Program is
@@ -225,7 +225,7 @@ impose that choice.
 
 This section is intended to make thoroughly clear what is believed to
 be a consequence of the rest of this License.
-
+
   8. If the distribution and/or use of the Program is restricted in
 certain countries either by patents or by copyrighted interfaces, the
 original copyright holder who places the Program under this License
@@ -255,7 +255,7 @@ make exceptions for this.  Our decision will be guided by the two goals
 of preserving the free status of all derivatives of our free software and
 of promoting the sharing and reuse of software generally.
 
-			    NO WARRANTY
+                            NO WARRANTY
 
   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
 FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
@@ -277,9 +277,9 @@ YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
 PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
 POSSIBILITY OF SUCH DAMAGES.
 
-		     END OF TERMS AND CONDITIONS
-
-	    How to Apply These Terms to Your New Programs
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
 
   If you develop a new program, and you want it to be of the greatest
 possible use to the public, the best way to achieve this is to make it
@@ -303,17 +303,16 @@ the "copyright" line and a pointer to where the full notice is found.
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
 
-    You should have received a copy of the GNU General Public License
-    along with this program; if not, write to the Free Software
-    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
+    You should have received a copy of the GNU General Public License along
+    with this program; if not, write to the Free Software Foundation, Inc.,
+    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 
 Also add information on how to contact you by electronic and paper mail.
 
 If the program is interactive, make it output a short notice like this
 when it starts in an interactive mode:
 
-    Gnomovision version 69, Copyright (C) year  name of author
+    Gnomovision version 69, Copyright (C) year name of author
     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
     This is free software, and you are welcome to redistribute it
     under certain conditions; type `show c' for details.
@@ -336,5 +335,5 @@ necessary.  Here is a sample; alter the names:
 This General Public License does not permit incorporating your program into
 proprietary programs.  If your program is a subroutine library, you may
 consider it more useful to permit linking proprietary applications with the
-library.  If this is what you want to do, use the GNU Library General
-Public License instead of this License.
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.
\ No newline at end of file
diff --git a/win/CS/doc/CREDITS b/win/CS/doc/CREDITS
index 92ae696c6..26ea7fc69 100644
--- a/win/CS/doc/CREDITS
+++ b/win/CS/doc/CREDITS
@@ -1,175 +1,32 @@
 CREDITS file for HandBrake <http://handbrake.fr/>
 
 HandBrake uses many cool libraries from the GNU/Linux world.
-Thank their authors!
 
-liba52 authors:
-  Aaron Holtzman
-  Michel Lespinasse
-  Gildas Bazin
-  Billy Biggs
-  Eduard Hasenleithner
-  H�kan Hjort
-  Charles M. Hannum
-  Chris Hodges
-  Michael Holzt
-  Angelos Keromytis
-  David I. Lehn
-  Don Mahurin
-  Jim Miller
-  Takefumi Sayo
-  Shoji Tokunaga
-
-libavcodec authors:
-  Fabrice Bellard
-  Alex Beregszaszi
-  Brian Foley
-  Arpad Gereoffy
-  Philip Gladstone
-  Falk Hueffner
-  Zdenek Kabelac
-  Nick Kurshev
-  Michael Niedermayer
-  Fran�ois Revol
-  Dieter Shirley
-  Juan J. Sierralta
-  Lionel Ulmer
-
-libdca authors:
-  Gildas Bazin
-  Sam Hocevar
-
-libdvdread authors:
-  Bj�rn Englund
-  H�kan Hjort
-  Billy Biggs
-  Christian Wolff
-
-libfaac authors:
-  M. Bakker
-  Tony Lenox
-  RageOMatic
-  thebard
-  Ivan Dimkovic
-  Krzysztof Nikiel
-  
-libfaad2 authors:
-  M. Bakker
-  Alexander Kurpiers
-  Volker Fischer
-  Gian-Carlo Pascutto
-
-libmp3lame authors:
-  Mike Cheng
-  Robert Hegemann
-  Frank Klemm
-  Alexander Leidinger
-  Naoki Shibata
-  Mark Taylor
-  Takehiro Tominiga
-  Iv�n Cavero Belaunde
-  Gabriel Bouvigne
-  Florian Bomers
-  CISC
-  John Dahlstrom
-  John Dee
-  Albert Faber
-  Peter Gubanov
-  Lars Magne Ingebrigtsen 	
-  Yosi Markovich
-  Zdenek Kabelac
-  Iwasa Kazmi
-  Guillaume Lessard
-  Steve Lhomme
-  Don Melton
-  Viral Shah
-  Acy Stapp
-  Roel VdB
-
-libmp4v2 authors:
-  Dave Mackie
-  Alix Marchandise-Franquet
-  Bill May
-  Massimo Villari
-  Waqar Mohsin
-  Richard Chen
-  Rob Arnold
-  Howdy Pierce
-  Steven Schultz
-  [email protected]
-  Sean Gilligan
-  Michael Rossberg
-  Luis F. Ramirez
-  Petter Reinholdtsen
-
-libmpeg2 authors:
-  Aaron Holtzman
-  Michel Lespinasse
-  Bruno Barreyra
-  Gildas Bazin
-  Alexander W. Chin
-  Stephen Crowley
-  Didier Gautheron
-  Ryan C. Gordon
-  Peter Gubanov
-  H�kan Hjort
-  Nicolas Joly
-  Gerd Knorr
-  David I. Lehn
-  Olie Lho
-  Rick Niles
-  Real Ouellet
-  Bajusz Peter
-  Franck Sicard
-  Brion Vibber
-  Martin Vogt
-  Fredrik Vraalsen
-
-libogg authors:
-  Christopher Montgomery
-  
-libmkv authors:
-  John A. Stebbins
-  Nathan Caldwell
-  Mike Matsnev
-  Nathan Caldwell
-  Christophe Devine
-
-libsamplerate authors:
-  Erik de Castro Lopo
-
-libvorbis authors:
-  Christopher Montgomery
-
-libx264 authors:
-  Laurent Aimar
-  
-libtheora authors:
-  Monty
-  Ralph Giles
-  Timothy B. Terriberry
-  Dan B. Miller
-  Rudolf Marek
-  Wim Tayman
-  Dan Lenski
-  Nils Pipenbrinck
-  Aaron Colwell
-  Thomas Vander Stichele
-  Jan Gerber
-  Conrad Parker
-  Cristian Adam
-  Sebastian Pippin
-  Simon Hosie
-  Mauricio Piacentini
-  Silvia Pfeiffer
-  Michael Smith
-  Andre Pang
-  calc
-  Chris Cheney
-  Brendan Cully
-  Edward Hervey
-  Adam Moss
-  Colin Ward
-  Jeremy C. Reed
-  Arc Riley
-  Rodolphe Ortalo
+Thanks to the authors of the following libraries which help power HandBrake:
+See the local project AUTHORS files for details of the individuals involved.
+
+liba52
+libbzip2
+libfaac
+libfaad2
+libavcodec
+libfontconfig
+libfreetype
+liblame
+libass
+libbluray
+libdca
+libdvdnav
+libdvdread
+libiconv
+libmkv
+libogg
+libsamplerate
+libtheora
+libvorbis
+libxml2
+libmp4v2
+libmpeg2dec
+libpthreadsw32
+libx264
+libzlib
\ No newline at end of file
diff --git a/win/CS/doc/NEWS b/win/CS/doc/NEWS
index ed7b57d26..da6e5702d 100644
--- a/win/CS/doc/NEWS
+++ b/win/CS/doc/NEWS
@@ -1,5 +1,234 @@
 NEWS file for HandBrake <http://handbrake.fr/>
 
+Changes betwen 0.9.5 and 0.9.6:
+
+Encoders:
+---------
+
+-> Video:
+
+   - updated libx264 (revision 2146)
+   - MPEG-2 encoder (from libavcodec)
+   - advanced options support for libavcodec encoders
+     format: option1=value1:option2=value2
+             -bf 2 -trellis 2 becomes bf=2:trellis=2
+
+-> Audio:
+
+   - audio gain control (increase/decrease audio volume)
+
+   - updated libogg (1.3.0) and libvorbis (aoTuV b6.03)
+   - new AAC encoder (from libavcodec) (considered experimental)
+     (supported mixdowns: Mono/Stereo/Dolby, 5.1 will come later)
+     (should be on par with faac in terms of quality, sometimes better)
+   - FLAC encoder (16-bit, MKV container only)
+
+   - Mac OS X: HE-AAC encoding support, via Core Audio
+
+   - quality-based variable bitrate encoding support
+     works with: Lame MP3, Vorbis, Core Audio AAC
+     only implemented in CLI and Linux GUI
+
+   - AC3 encoder: set Dolby Surround flag in stream parameters when mixdown is Dolby Surround or Pro Logic II
+
+
+-> Audio Passthru:
+
+   - DTS Passthru to MP4 container (in addition to MKV) (supported by e.g. VLC, MPlayer)
+   - DTS-HD Passthru (MP4, MKV containers)
+   - MP3 Passthru (MP4, MKV containers)
+   - AAC Passthru (MP4, MKV containers)
+     (known issue: Magic Cookie not passed through from MPEG Program/Transport streams,
+      which will break playback in e.g. QuickTime Player)
+   - Auto Passthru: one encoder, multiple codecs
+     lets you define allowed codecs (from supported passthru codecs)
+     lets you pick a fallback encoder if passthru is not possible
+
+Muxers:
+-------
+
+   - start MKV clusters with a video keyframe whenever possible
+     should improve seeking and DLNA streaming
+
+   - bug fix: use ISO 639-2 bibliographic form for MKV language codes
+   - bug fix: fix crash due to division by zero in MP4 muxer
+   - bug fix: fix muxing of Closed Captions. Improper interleaving broke playback on some players
+
+Decoders:
+---------
+
+-> Video:
+
+   - updated libav* libraries from Libav (http://libav.org/) (v0.7-1696-gcae4f4b, late October 2011)
+     frame-based multithreading for H.264, VP8
+     10-bit decoding support for H.264, DNxHD
+     Apple ProRes decoding support
+   - improved average framerate detection
+   - duplicate frame detection for improved frame drop decision (CFR/PFR)
+   - new Same as source, Constant Framerate option
+     for devices that don't support variable framerate
+     automatically picks a constant framerate closest to the detected average framerate
+
+   - bug fix: fix problem when resolution changes in the middle of a video stream
+
+-> Audio:
+
+   - Blu-ray: make TrueHD, DTS-HD and E-AC3 Secondary Audio streams available for decoding and/or passthrough
+
+   - bug fix: libavcodec-decoded streams can now be decoded multiple times
+              previously, multiple decodes of the same source tracks weren't possible
+              and audio output tracks had to be dropped
+   - bug fix: fix audio screech at beginning of some audio tracks when decoding AC3
+   - bug fix: fix DTS decoder audio volume (was too low)
+   - bug fix: garbled audio when decoding DTS-HD audio from MKV containers
+   - bug fix: fix support for DTS-HD High Resolution Audio in MPEG Transport streams
+
+-> Subtitles:
+
+   - updated libass (0.10.0)
+   - improved handling of subtitles with overlapping timestamps
+   - improved handling of DVD subtitles without Stop Display commands
+   - SSA subtitles are now passed through to MKV without conversion to SRT/UTF-8
+
+   - bug fix: fix rendering problem with SSA subtitles when no font is embedded in the source video
+
+Demuxers:
+---------
+
+   - improved MPEG Program/Transport stream support
+     support for MPEG-1 Program streams
+     support for HD-DVD EVOB streams
+     improved handling of Transport streams that have no PCR
+   - WTV container support (via libavformat)
+
+   - bug fix: files with more than 20 tracks (video, audio, subtitles etc.) are now supported
+   - bug fix: some QuickTime MOV files were misdirected as MPEG Transport streams
+   - bug fix: fix detection of TrueType font attachments that don't have the correct MIME type
+
+Filters:
+--------
+
+   - new, much improved decomb filter (but slower)
+     new settings are default
+     old settings become decomb "Fast"
+
+Presets:
+--------
+
+   - improved "Normal" preset (much faster, similar file size and quality)
+   - removed obsolete legacy presets
+   - added new device presets for Android phones/tablets
+     recent and/or powerful devices recommended
+
+Mac OS X:
+---------
+
+-> DVD decryption:
+
+   - VLC 2.x or later will not work for DVD decryption
+     and is therefore unsupported as of HandBrake 0.9.6
+   - libdvdcss is now the preferred method for DVD decryption
+     already works with HandBrake 0.9.5
+     a .pkg installer is available from Videolan:
+     http://download.videolan.org/libdvdcss/last/macosx/
+
+-> Build system:
+
+   - support for Xcode 4 and Mac OS X 10.7 "Lion"
+   - Mac OS X 10.5 "Leopard" no longer supported
+
+Mac OS X GUI:
+-------------
+
+-> OS X 10.7 Lion support:
+
+   - bug fix: Live Preview window widgets updated to work under Lion
+   - bug fix: fixed positioning of widgets in the Audio panel under Lion
+
+-> Other:
+
+   - wider main window providing more room for various widgets
+
+Windows GUI:
+------------
+
+-> Preview window:
+
+   - complete redesign
+   - support for VLC or the system default video player
+   - dropped built-in QuickTime playback support
+
+-> Other:
+
+   - much improved control over the default audio and subtitle tracks selected (see Options)
+   - ability to set the minimal title length that will show up during a scan (see Options)
+   - several other usability improvements
+   - installer now has a silent option for easier network installs (launch the installer with /S)
+
+Linux GUI:
+----------
+
+-> Audio panel:
+
+   - new advanced audio options section for gain and audio track names
+   - dynamic range compression and samplerate moved to advanced audio options
+
+-> Other:
+
+   - minor UI tweaks and usability enhancements
+
+Miscellaneous:
+--------------
+
+   - Target Size is gone, and isn't coming back
+     Don't bother complaining on the forums
+
+   - CLI: support for x264 presets, tunes and profiles
+     new --x264-preset, --x264-tune and --x264-profile options
+
+   - DVD: fix issues with some discs (e.g. True Grit, Thor, Transformers 3)
+   - DVD: improved main feature detection
+
+   - updated libbluray (0.0.1-pre-213-ga869da8, late May 2011)
+
+
+Changes between 0.9.4 and 0.9.5:
+
+* Core Library
+  - BluRay disc structure support. (No decryption support) 
+  - Updated Libraries (x264, ffmpeg) 
+  - SSA Subtitle support. (Including burn-in) 
+  - MP3 audio now supported in MP4 files (Note: Limited Player compatibility) 
+  - VOBSUB subtitle now supported in MP4 files (Note: Limited Player compatibility) 
+  - Updated Presets for newer devices and better quality 
+  - AC3 encoding support.
+  - Many Bug fixes and other small improvements
+  - Improved DVD Main Feature detection (when using dvdnav)
+  - Universal audio downmix support (all audio types can be downmixed)
+
+*All GUIs
+  - Updated x264 Advanced Panel
+  - Video Quality Slider drops % value and only shows RF for x264
+  - Batch Scan (Scan Multiple files at once. N.B: Does not include multiple VIDEO_TS folders / Image files) 
+  - Peak framerate option (Capped VFR)
+  - Many Bug fixes
+  - Many Tweaks to improve usability.
+  - Ability to edit queue jobs
+  - Point-to-Point encoding (second or frame start and end times)
+
+* Mac GUI
+  - New Audio Panel supporting >4 Audio Tracks
+  - VLC detection in /Applications and ~/Applications
+
+* Windows GUI
+  - Encode Status in GUI. (CLI window is now always hidden)
+  - Improved Auto-Naming for Destination file name.
+  - Drag / Drop Video onto Main Window to scan.
+  
+* Linux GUI
+  - Multiple instance support (run multiple copies of ghb at once)
+  - Many Bug fixes and UI improvements. 
+  
 Changes between 0.9.3 and 0.9.4:
 
 Core:
diff --git a/win/CS/doc/THANKS b/win/CS/doc/THANKS
index cb388aefd..b5ee056cf 100644
--- a/win/CS/doc/THANKS
+++ b/win/CS/doc/THANKS
@@ -1,70 +1,29 @@
 THANKS file for HandBrake <http://handbrake.fr/>
 
-Several people noticeably contributed to MediaFork and HandBrake development
-without writing code (submitting/checking translations, DVD samples, etc).
-Let's thank them here!
+Hosting:
 
-Chris (audley)
- + Inspiration and example of patching mpeg4ip for iPod atom support
+Github (http://github.com)
+SourceForge(http://sourceforge.net/projects/handbrake)
+Eric Petit (Running the servers behind HandBrake.fr)
+Freenode IRC (http://freenode.net/)
 
-Omar Ahmad Bhatti
- + Intensive beta testing, suggestions. Convinced me to port HandBrake
-   to OS X, which finally was a pretty good idea.
+Software:
 
-Hanna Bauer
-Adrien Marquette
-Norbert Rittel
- + German translation
+ReviewBoard (http://www.reviewboard.org/)
+PhpBB (http://www.phpbb.com/)
+hlscript (http://badmofo.org/hlscript/)
+Jetbrains ReSharper (http://www.jetbrains.com/resharper/features/index.html?linklogos)
+VisualSVN (http://www.visualsvn.com)
 
-Paul B�n�chet
-Luidgi Esposito
-Andrea Gianarro
-Emilio Gelosi
- + Italian translation
+Forum Moderators:
 
-Adam
- + Polish translation
-
-Nik Roby
- + Russian translation
-
-Leendert
- + Dutch translation
-
-Eric Kornblum
- + Sent me a sample DVD with LPCM tracks
-
-migol Superkid
- + Spanish translation
-
-pgjw
- + Portuguese translation
-
-cygma
- + Japanese translation
-
-Michelle De Sio
- + Sent me a sample DVD with MPEG audio tracks
-
-Ian Rickard
- + Enhanced icon
-
-S�bastien No�l
- + Debian packages (http://www.twolife.org/debian/repository.php)
-
-People who sent me an iTunes gift certificate: a BIG thanks!
-
-Paul (baggss)
- + Forum Moderator
- 
-Du'Wayne Caviness (Cavalicious)
- + Forum Moderator
- 
+Paul (baggss), 
+Du'Wayne Caviness (Cavalicious) 
 Edward Jackson. (TedJ)
- + Forum Moderator
- 
 Chuck (cvk_b)
- + Testing Team Member
-
 Nate Thompson (nightstrm)
- + Forum Moderator
\ No newline at end of file
+
+Other:
+
+Thanks to all of you who have contributed time, patches, testing, uploaded test files etc. 
+There are too many to name here, but we do appreciate the effort.
diff --git a/win/CS/doc/TRANSLATIONS b/win/CS/doc/TRANSLATIONS
index c88258829..51550e941 100644
--- a/win/CS/doc/TRANSLATIONS
+++ b/win/CS/doc/TRANSLATIONS
@@ -1,23 +1,7 @@
-$Id: TRANSLATIONS,v 1.2 2004/03/22 18:20:30 titer Exp $
-
 TRANSLATIONS file for HandBrake <http://handbrake.fr/>
 
 Translating HandBrake
 =====================
 
-***** HandBrake does not currently have a localization scheme for any of its interfaces.
-***** Information below is obsolete and only useful for historical purposes:
-
-Only the OS X interface of HandBrake can be translated at the moment.
-Localization is not implemented in BeOS and GTK GUIs.
-
-HandBrake uses the NSLocalizedString() OS X function to translate every
-item in the interface. Therefore, you don't need (and mustn't) modify
-the nib files. All you have to do is to write a Localizable.strings for
-your language. You can get it (for the latest release) at
-<http://handbrake.m0k.org/Localizable.strings>.
-
-Edit it with Xcode, save it to HandBrake/macosx/i18n/xx.strings (where
-'xx' are the two letters representing your language), then add 'xx' to
-the language list in the Jamrules file.
+HandBrake does not currently have a localization scheme for any of its interfaces.