summaryrefslogtreecommitdiff
path: root/README.md
blob: 0349adb85b4748e823fdc6ed998f156de131bd82 (plain)
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
I. OVERVIEW
-----------

The xauth program is used to edit and display the authorization
information used in connecting to the X server.
The underlying "Authorization Protocol for X" is described in the
README file of the libXau module of X11.

II. BUILDING
------------

Use "./autogen.sh" to configure the package and "make" to compile it.
A black box check for the correctness of the package can be initiated
by "make check". The installation is done by "make install".

III. COMMUNICATION
------------------

All questions regarding this software should be directed at the
Xorg mailing list:

  https://lists.x.org/mailman/listinfo/xorg

The primary development code repository can be found at:

  https://gitlab.freedesktop.org/xorg/app/xauth

Please submit bug reports and requests to merge patches there.

For patch submission instructions, see:

  https://www.x.org/wiki/Development/Documentation/SubmittingPatches

IV. RELEASING
-------------

This section describes how to release a new version of xauth to the
public. A detailed description of this process can be found at
https://www.x.org/wiki/Development/Documentation/ReleaseHOWTO with a
few clarification below.

Remember, that the last commit _must_ include the version string in
its diff (not the commit message). This is typically done by
incrementing the version string in configure.ac.

For releasing under Fedora make sure, that
/usr/share/util-macros/INSTALL exists. If not, then please create that
file.

To release a new version of xauth, please follow this steps:

 * git clone ssh://git.freedesktop.org/git/xorg/app/xauth
 * cd xauth ; ./autogen.sh ; make ; make check
 * follow ReleaseHowto inside this directory.

Ignore these errors shown during release.sh:

    /bin/sh: ../.changelog.tmp: Permission denied
    git directory not found: installing possibly empty changelog.
    
    cp: cannot create regular file '../.INSTALL.tmp': Permission denied
    util-macros "pkgdatadir" from xorg-macros.pc not found: installing possibly empty INSTALL.

[eof]