1I. OVERVIEW
2-----------
3
4The xauth program is used to edit and display the authorization
5information used in connecting to the X server.
6The underlying "Authorization Protocol for X" is described in the
7README file of the libXau module of X11.
8
9II. BUILDING
10------------
11
12Use "./autogen.sh" to configure the package and "make" to compile it.
13A black box check for the correctness of the package can be initiated
14by "make check". The installation is done by "make install".
15
16III. COMMUNICATION
17------------------
18
19All questions regarding this software should be directed at the
20Xorg mailing list:
21
22  https://lists.x.org/mailman/listinfo/xorg
23
24The primary development code repository can be found at:
25
26  https://gitlab.freedesktop.org/xorg/app/xauth
27
28Please submit bug reports and requests to merge patches there.
29
30For patch submission instructions, see:
31
32  https://www.x.org/wiki/Development/Documentation/SubmittingPatches
33
34IV. RELEASING
35-------------
36
37This section describes how to release a new version of xauth to the
38public. A detailed description of this process can be found at
39https://www.x.org/wiki/Development/Documentation/ReleaseHOWTO with a
40few clarification below.
41
42Remember, that the last commit _must_ include the version string in
43its diff (not the commit message). This is typically done by
44incrementing the version string in configure.ac.
45
46For releasing under Fedora make sure, that
47/usr/share/util-macros/INSTALL exists. If not, then please create that
48file.
49
50To release a new version of xauth, please follow this steps:
51
52 * git clone ssh://git.freedesktop.org/git/xorg/app/xauth
53 * cd xauth ; ./autogen.sh ; make ; make check
54 * follow ReleaseHowto inside this directory.
55
56Ignore these errors shown during release.sh:
57
58    /bin/sh: ../.changelog.tmp: Permission denied
59    git directory not found: installing possibly empty changelog.
60    
61    cp: cannot create regular file '../.INSTALL.tmp': Permission denied
62    util-macros "pkgdatadir" from xorg-macros.pc not found: installing possibly empty INSTALL.
63
64[eof]
65