This file is indexed.

/usr/share/psychtoolbox-3/PsychDocumentation/UseTheSource.m is in psychtoolbox-3-common 3.0.9+svn2579.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
84
% 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 Subversion code
% management system. 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 http://psychtoolbox-3.googlecode.com/svn/trunk/Psychtoolbox/ /Users/kleinerm/MyPTB/
%
%    This command would download the full 'beta' distribution instead,
%    which corresponds to the most recent official, tested, production release:
%
%    svn checkout http://psychtoolbox-3.googlecode.com/svn/beta/Psychtoolbox/ /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!
%
%    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 SVN repository.
%
%    Be aware that you can only download code from the repository. If
%    you want to participate in PTB's development you'll need write access
%    to the repository. Contact David Brainard or Mario Kleiner if you want
%    to apply for write access. Make yourself familiar with the Subversion
%    toolchain or 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.
%
%    You can browse the source code and all development logs via a
%    web interface: http://code.google.com/p/psychtoolbox-3/source/list
%
%    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).
%