/usr/share/psychtoolbox-3/PsychDocumentation/UseTheSource.m is in psychtoolbox-3-common 3.0.11.20140816.dfsg1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 | % UseTheSource - How to access the Psychtoolbox source code.
%
% If you are interested in the source code for the C language
% modules of Psychtoolbox (i.e., the MEX file extensions
% like Screen, WaitSecs, GetSecs, PsychHID, ...) then use the
% following procedure.
%
% The Psychtoolbox source code is stored in a Git code repository at
% GitHub.
%
% To download the source code:
%
% 1. Open a Unix terminal window on OS-X or Linux or a NT command
% shell on M$-Windows.
%
% 2. Use the "svn" commandline tool to download source code. On
% OS-X or Linux, the svn tool is usually stored in the
% /usr/local/bin directory, you may want to add this to your
% PATH. On Windows, the svn client should be already in your
% %PATH%
%
% 3. The following command would download the current development branch of
% the full PTB distribution into the subdirectory /Users/kleinerm/MyPTB :
%
% svn checkout https://github.com/Psychtoolbox-3/Psychtoolbox-3/ /Users/kleinerm/MyPTB/
%
% This command would download the full 'beta' distribution instead,
% which corresponds to the most recent official, tested, production release:
%
% svn checkout https://github.com/Psychtoolbox-3/Psychtoolbox-3/branches/beta/ /Users/kleinerm/MyPTB/
%
% Inside the /Users/kleinerm/MyPTB folder you would see the following
% subfolders:
%
% Psychtoolbox/ -- The regular Psychtoolbox folder.
% managementools/ -- Miscellaneous scripts for managing PTB releases.
% PsychSourceGL/ -- The C source code for Psychtoolbox.
%
% Inside PsychSourceGL you will find everything you need to understand
% or to modify Psychtoolbox inner working if you are brave and patient
% enough ;-)
%
% As already mentioned, the toolbox itself is split into multiple branches:
%
% trunk - The code that is currently under development. May or may not
% compile and work at any given point in time, may or may not
% be consistent. For developers and early testers only! This is
% a view onto the GitHub Git "master" branch.
%
% beta - Source code corresponding to the current 'beta' release, derived
% from 'trunk'. This is what normal users should use, because
% it is somewhat tested.
%
% If you type the command "PsychtoolboxVersion" in Matlab or Octave, it
% will tell you the flavor (trunk or beta) and SVN revision number of
% your currently installed PTB distribution. This allows you to locate
% the corresponding code in the GIT/SVN repository.
%
% Be aware that you can only download code from the repository. If you
% want to participate in PTB's development contact Mario Kleiner or
% David Brainard for instructions. Make yourself familiar with Git if
% you want to do serious work.
%
% An even more recent view of current development can be found on
% GitHub, where our master and experimental branches are hosted. If you
% intend to contribute to C code development or other complex parts of
% the software, we will require you to use git instead of Subversion and
% you will work with the git repository at GitHub.
%
% For almost all source code, i.e., unless otherwise stated in the
% source files themselves or accompanying documentation, the MIT license
% applies. See the file License.txt in the Psychtoolbox root folder for
% more details.
%
% Components & Libraries which are not covered by the MIT license, but
% other MIT compatible free software licenses will carry individual
% descriptions of their licenses inside the source files or in
% accompanying license files within the corresponding subfolders. Such
% libraries are usually contained in the PsychSourceGL/Cohorts/
% subdirectory of the distribution.
%
% Good luck and "Use the source" (Master Yoda).
%
|