HACKING 2.72 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 50 51 52 53
Bison and flex
--------------

You may need the Gnu tools bison and flex. The standard lex and yacc
are not flexible enough. You should have bison version 1.25 or later
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 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121


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.
	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
122
  Publish the diff only if it works and is small enough.
123 124

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