README.md revision 0d22642b 
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" (make sure to install "cmdtest" from
15http://liw.fi/cmdtest/). The installation is done by "make install".
16
17III. COMMUNICATION
18------------------
19
20All questions regarding this software should be directed at the
21Xorg mailing list:
22
23  https://lists.x.org/mailman/listinfo/xorg
24
25The primary development code repository can be found at:
26
27  https://gitlab.freedesktop.org/xorg/app/xauth
28
29Please submit bug reports and requests to merge patches there.
30
31For patch submission instructions, see:
32
33  https://www.x.org/wiki/Development/Documentation/SubmittingPatches
34
35IV. RELEASING
36-------------
37
38This section describes how to release a new version of xauth to the
39public. A detailed description of this process can be found at
40https://www.x.org/wiki/Development/Documentation/ReleaseHOWTO with a
41few clarification below.
42
43Remember, that the last commit _must_ include the version string in
44its diff (not the commit message). This is typically done by
45incrementing the version string in configure.ac.
46
47For releasing under Fedora make sure, that
48/usr/share/util-macros/INSTALL exists. If not, then please create that
49file.
50
51To release a new version of xauth, please follow this steps:
52
53 * git clone ssh://git.freedesktop.org/git/xorg/app/xauth
54 * cd xauth ; ./autogen.sh ; make ; make check
55 * follow ReleaseHowto inside this directory.
56
57Ignore these errors shown during release.sh:
58
59    /bin/sh: ../.changelog.tmp: Permission denied
60    git directory not found: installing possibly empty changelog.
61    
62    cp: cannot create regular file '../.INSTALL.tmp': Permission denied
63    util-macros "pkgdatadir" from xorg-macros.pc not found: installing possibly empty INSTALL.
64
65[eof]
66