--------------------------------------
Source package information for PCSX2
--------------------------------------

 * Examples for how to download an upstream source.
   - To download a specific version from git:
      VER=master debian/rules get-orig-source
      VER=v1.2 debian/rules get-orig-source
      VER=f9dd6277e336e5808bde235c9fdc01905c1f59a4 debian/rules get-orig-source

   - To download the latest version in debian/changelog:
      debian/rules get-orig-source

   - To download an old version in debian/changelog:
      VER=1.2.1-728-g7328e55 debian/rules get-orig-source
 * The source for the pdf documentation is in:
   - pcsx2/Docs/PCSX2_FAQ.doc
   - pcsx2/Docs/PCSX2_Readme.doc
 * The upstream repository contains all sorts of cruft, files with proprietary
   licenses and files without copyright information. To get around this the 
   following is done:
   - The complete source code is initially downloaded from the git repository.
   - The version control files get removed (.git gitignore).
   - Files and directories included in get-orig-source-remove are removed from
     the generated source. Most of these files have either proprietary licenses,
     missing copyright information, non-DFSG-free material, and/or GPL
     incompatible licenses. Here is a list of some of the files and directories
     that get removed from the source and a short reason for their removal:
     + 3rdparty => embedded code (libraries).
     + bin/Langs => Remove the pre-generated language files.
     + common/src/Utilities/x86/MemcpyFast.cpp => AMD copyright/license.
     + plugins/CDVDiso => Missing copyright information.
     + plugins/CDVDisoEFP => Missing copyright information.
     + plugins/CDVDlinuz => Missing copyright information.
     + plugins/CDVDolio => Missing copyright information.
     + plugins/CDVDpeops => Missing copyright information.
     + plugins/GSdx/baseclasses => Microsoft copyright/license.
     + plugins/PeopsSPU2 => Missing copyright information.
     + plugins/SSSPSXPAD => Missing copyright information.
     + plugins/USBqemu => Missing copyright information and not distributable.
     + plugins/dev9ghzdrk => Missing copyright information and Microsoft copyright/license.
     + plugins/xpad => Missing copyright information.
     + plugins/zerogs => Missing copyright information.
     + plugins/zerospu2 => Missing copyright information.
     + plugins/zzogl-pg/opengl/Win32/aviUtil.h => Missing copyright information.
     + plugins/zzogl-pg/opengl/Win32/ps2hw.dat => pre-built shader file.
     + plugins/zzogl-pg/opengl/ZeroGSShaders/zlib => embedded code (library).
     + plugins/zzogl-pg/opengl/ps2hw.dat => pre-built shader file.
     + tools => Missing copyright information.
     + unfree => Missing copyright information. Possibly non-DFSG-free.
     + Files autogenerated by Microsoft Visual C++
       > pcsx2/windows/resource.h
       > pcsx2/windows/wxResources.rc
       > plugins/FWnull/Windows/FireWireNull.rc
       > plugins/FWnull/Windows/resource.h
       > plugins/GSdx/GSdx.rc
       > plugins/GSdx/resource.h
       > plugins/GSnull/Windows/GS.rc
       > plugins/GSnull/Windows/resource.h
       > plugins/LilyPad/LilyPad.rc
       > plugins/LilyPad/resource.h
       > plugins/PadNull/Windows/PadNull.rc
       > plugins/PadNull/Windows/resource.h
       > plugins/SPU2null/Windows/SPU2null.rc
       > plugins/SPU2null/Windows/resource.h
       > plugins/USBnull/Windows/USBnull.rc
       > plugins/USBnull/Windows/resource.h
       > plugins/cdvdGigaherz/src/Windows/cdvdGigaherz.rc
       > plugins/cdvdGigaherz/src/Windows/resource.h
       > plugins/spu2-x/src/Windows/Spu2-X.rc
       > plugins/spu2-x/src/Windows/resource.h
       > plugins/zzogl-pg/opengl/Win32/resource.h
       > plugins/zzogl-pg/opengl/Win32/resrc1.h
       > plugins/zzogl-pg/opengl/Win32/zerogs.rc
   - The amount of missing copyright information varies greatly and can range
     from one or two file to most if not all of them. Also, most of the removed
     plug-ins are also deprecated and no longer compiled by the build scripts.
     The best and safest solution is to remove the deprecated plug-ins instead
     of just removing each file that has missing copyright information.
   - If additional files and/or directories need to be removed they can get
     added to get-orig-source-remove. The copyright file might need an update to
     reflect the removal of those files.
 * The resulting package will have all the plug-ins and functionality needed to
   be usable in a Linux environment after being given a proper configuration by
   the user.

 -- Miguel A. Colón Vélez <debian.micove@gmail.com>  Tue, 23 Feb 2016 17:07:24 -0500
