HACKING 2.73 KB
Newer Older
1
2
3
4
5
This file contains some information intended for the developers of
lyskomd.  It is probably only useful if you have access to the CVS
repository (there is no anoncvs access at this time) or if you are
about to make a new release of lyskomd.

Per Cederqvist's avatar
Per Cederqvist committed
6
See also doc/lyskomd.texi.
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


Support programs
================

It is important to use the correct version of some support programs
when creating the distribution.



Automake (anoncvs '1999-05-21 12:00:00 GMT')
--------

All released versions of automake have problems that are hard to work
around.  The current snapshot in the public cvs archive appears to be
working fine, however.  See http://sourceware.cygnus.com/automake/

Use these commands to retrieve the version that was used to build
lyskom-server-2.0.0:

 cvs -z 9 -d :pserver:anoncvs@sourceware.cygnus.com:/cvs/automake login
     (password is ``anoncvs'')
 cvs -z 9 -d :pserver:anoncvs@sourceware.cygnus.com:/cvs/automake co \
	-D '1999-05-21 12:00:00 GMT' automake



Autoconf 2.13
--------

You need autoconf 2.13.



Perl 5.005_02
----

The perl version should not matter.

46
47
48
49
Bison and flex
--------------

You may need the Gnu tools bison and flex. The standard lex and yacc
50
are not flexible enough. You should have bison version 1.27 or later
51
52
53
and flex version 2.5.4 or later.


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
85
86
87
88
89
90
91
92
93
94
95
96


Release generation
==================

Follow these steps:

* Check that the following files are updated:

	doc/Protocol-A.texi
	doc/lyskomd.texi
	README
	NEWS

* If this is release 2.0.1 or 2.1.0: remove all man-pages and this line.

* Set the version number in these files:

	versions
	configure.in

* Fix the Copyright statement in these files:

	scripts/update-copyright
	scripts/lyskomd-copyrights

* Write a note such as "* Release 1.9.0." in ChangeLog.

* Commit everything.

* Update the copyright statements by running

	scripts/lyskomd-copyrights

  repeatedly until nothing happens.

* Commit everything.

* Run these commands:

	./mkmi
	./configure
	make distclean    # We want to recompute all dependencies.
97
	./configure
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
	make		  # Recompute them.
	make distcheck

  Make sure that the host where you do this have TeX installed, so
  that you ensure that the dvi target is working.

* Compare the resulting file with the previous release, and ensure
  that no unexpected differences exists.

* Test the resulting archive on several architectures.  Repeat until
  no failure.

* Set a tag:

	cvs tag server-2-0-0

* Copy the tar file to the FTP server.

* Create a diff.

	tar xfz /lysator/ftp/pub/lyskom/server/lyskom-server-1.9.0.tar.gz
	tar xfz /lysator/ftp/pub/lyskom/server/lyskom-server-2.0.0.tar.gz
	diff -u --recursive --unidirectional-new-file \
		lyskom-1.9.0 lyskom-server-2.0.0

Per Cederqvist's avatar
Per Cederqvist committed
123
  Publish the diff only if it works and is small enough.
124
125

* Announce the release in "Nyheter (om) LysKOM".