Docs: Add note on lsearch for IPv4-mapped IPv6 addresses
[exim.git] / Readme.pod
1 =head1 Exim Development Repository
2
3 This is the Exim (Mail Transport Agent) Development Repository. Please
4 read the following information if you wish to use or contribute to the
5 Exim development process - this is to prevent your or our time being
6 unnecessarily wasted.
7
8 If you just want to use, build or get information on Exim then have a
9 look at the pointers further down this file at L<General Exim Information>.
10
11 =head2 General Development Information
12
13 The general Exim development process and resources are documented in
14 the wiki page at L<http://wiki.exim.org/EximDevelopment> - although
15 the wiki is likely to be moved and rehashed in the near future.
16
17 The sections below this duplicate much of the information form the
18 wiki document.
19
20 =head2 Development Repositories
21
22 Exim development is kept within a  git (L<https://git-scm.com/>)
23 repository. The master repository is at L<git://git.exim.org/exim.git>
24 with a web interface giving change and source visibility at
25 L<https://git.exim.org/exim.git>
26
27 There is a secondary repository on github at
28 L<https://github.com/Exim/exim> managed by the Exim Organisation
29 - however this may currently fall out of synchronisation with the
30 main one.
31
32 =head2 Bug Tracking
33
34 Currently this is all done using Bugzilla at L<https://bugs.exim.org/>
35 - please do not use github issue tracking.
36
37 =head2 Mailing List
38
39 Development issues are normally discussed on the exim-dev mailing list
40 - see L<https://www.exim.org/maillist.html>
41
42 =head2 Exim Release Process
43
44 Some documentation on the release process can be found at
45 L<http://wiki.exim.org/EximRelease>.
46
47 =head2 General Exim Information
48
49 The best place to get general information is on the website at
50 L<https://www.exim.org/>.
51
52 You can find Download locations L<https://www.exim.org/mirrors.html>,
53 Mailing list info L<https://www.exim.org/maillist.html> and Full
54 Documentation L<https://www.exim.org/docs.html> on that website.
55
56 If you are using a Linux or other freely available Unix like operating
57 system it is very likely that your system will have Exim packaged for
58 it already. In this case it is probably prudent to use these packages
59 unless you have specialised requirements.
60
61 In any case you can always ask on the
62 Exim Users mailing list L<https://lists.exim.org/mailman/listinfo/exim-users>
63 for further information.
64
65 [End]