created new tag v0.3.4.5 (based on v0.3.4.3)

merged changeset 969
updated list of contributers

v0.3.4.5/stuff/debian-package.txt

@@ -0,0 +1,81 @@
+HOW TO UPLOAD A FRESH DEBIAN PACKAGE
+
+1) update the debian changelog
+Run "debchange -i" to create a new changelog entry. Leave some useful notes.
+
+BEWARE: all development releases must have the debian release no. "1" (the last
+part of the version following the dash) - e.g.: 0.2.50-1.
+
+You MUST increase the upstream version (before the dash) by one whenever you
+want to upload a new debian package to the repository - otherwise you will
+inevitably mess up the package repository - and you know, who will have to
+figure out, how to fix this :)
+
+
+2) create the package
+Change to the trunk directory of the project and run the followin:
+	../tags/make-deb.sh UPSTREAM_VERSION .
+(do not forget the final dot)
+
+The UPSTREAM_VERSION is the one, that you were using for the new debian
+changelog entry. Again: _never_ upload two different debian packages with the
+same upstream version number or you will go to hell!
+
+The package files will get copied to ../tags/packages/debian/.
+
+The version number in src/cryptobox/__init__.py gets updated automatically by
+the make-deb.sh script.
+
+3) double check the package
+Run the two testing programs "lintian" and "linda" with the new
+package.
+	lintian ../tags/packages/debian/cryptobox-server...deb
+	linda ../tags/packages/debian/cryptobox-server...deb
+
+Try to install the new package on a system with dpkg and see if it went fine.
+
+4) upload the package
+You should use dupload - it is the preferred uploading program for debian
+packages:
+	apt-get install dupload
+See http://www.debian-administration.org/articles/286 for more details.
+
+Create the following configuration file as ~/.dupload.conf:
+	package config;
+	$preupload{'changes'} = "";
+	$default_host = "sao";
+	$cfg{"sao"} = {
+		fqdn => "sao",
+		login => "uml-www",
+		method => "scpb",
+		incoming => "/data/deb-repo/incoming/unstable",
+		dinstall_runs => 1,
+	};
+	1;
+
+Furthermore you need the following entry in your ~/.ssh/config:
+	Host sao
+	Hostname systemausfall.org
+	Port 2200
+(otherwise it is impossible to change the ssh port in dupload)
+
+To upload the latest debian package you could do the following:
+	dupload $(ls -tr ../tags/packages/debian/*.changes | tail -1)
+(this will only use the latest changes-file)
+
+
+5) import the package into the repository
+It would be nice, if the web interface would work - but it does not.
+Please wait for etch - then we will update reprepro.
+
+For now you have to login to the www-uml:
+	ssh uml-www@sao
+
+Switch to the deb-repo user:
+	su - deb-repo
+
+Import all incoming packages:
+	scripts/import.sh
+
+You did it!
+

v0.3.4.5/stuff/known_problems

@@ -0,0 +1,4 @@
+Bug-Report: twill/other-packages/ClientForm.py: uncomment line 846 ("XHTMLCompatibleFormParser" instead of default parser) - this solves an eternal loop-problem caused by line 958 ("fp.feed(ch)")
+
+Bug-Report: testoob - loading of a TestSuite (as advertised by the commandline help) does not work (due to unittest.py/loadTestsFromModule)
+

v0.3.4.5/stuff/language_specification.txt

@@ -0,0 +1,33 @@
+Some important notes regarding the language files:
+
+1) warning/success messages
+
+Attributes:
+	Title	- title of the message
+	Text	- text of the message
+	Link.Text	- textual representation of a link
+	Link.Abs	- absolute URL e.g. http://cryptobox.org/trac
+	Link.Prot	- 'http' or 'https'
+	Link.Rel	- relative url (based on the cgi root)
+	Link.Attr[12].[name|value]	- arguments to be added to the link
+
+	The "Link" attributes are only necessary if the (warning) message can be resolved by
+	some action. Otherwise it is not necessary to define any "Link" attribute.
+
+	All values are optional, but you should follow these rules:
+		- at least one of "Title" and "Text" should be defined
+		- if there are "Link" attributes, then you should also define "Link.Text"
+		- "Link.Abs" can not be combined with "Link.Prot", "Link.Rel" or "Link.Attr..."
+		- "Link.Rel" and "Link.Prot" may be used together
+	(see plugin/volume_format_fs/lang/en.hdf for a good example for links)
+	
+
+2) adding a new language
+	- add the language code (e.g. "de") to the ALL_LANGUAGES setting in
+	  scripts/update_po_files.py
+	- run "scripts/update_po_files.py && scripts/revert_unchanged_po_files.sh"
+	- svn add plugins/*/intl/NEW_LANG_CODE intl/NEW_LANG_CODE
+	- svn revert plugins/*/intl/NEW_LANG_CODE/*.mo intl/NEW_LANG_CODE/*.mo
+	- svn propset svn:ignore "*.mo" plugins/*/intl/NEW_LANG_CODE intl/NEW_LANG_CODE
+	- add it to /etc/pootle/pootle.prefs in the translation pootle server
+

v0.3.4.5/stuff/pootle-updates.txt

@@ -0,0 +1,33 @@
+We use a pootle server to allow online translation of our language data
+
+The following text should give you guide lines on how to:
+	- update and merge language data to (A) and from (B) the pootle server
+	- change english original texts (C)
+
+------------------------------------------------------------------------------
+
+A) update the pootle language files via svn
+ - log in to the pootle server (thorax)
+ - become root
+ - su - pootle
+ - svn up svn
+ - svn stat svn
+ 	- resolve potential conflicts
+
+
+B) commit pootle translations to svn
+ - log in to the pootle server (thorax)
+ - become root
+ - su - pootle
+ - use "svn stat" and "svn diff" to check local changes
+ - svn up
+	- resolve potential conflicts (svn stat)
+ - svn commit
+
+
+C) update language template files (after changing english texts)
+ - change the language.hdf file (of the base cryptobox or of a plugin)
+ - run scripts/update_po_files.py
+ - review the changes
+ - commit the changes
+

v0.3.4.5/stuff/uml-howto.txt

@@ -0,0 +1,5 @@
+debootstrap etch _builddir
+chroot _builddir
+	sed -i "/respawn:\/sbin\/getty/d" /etc/inittab
+	echo "0:1235:respawn:/sbin/getty 38400 console linux" >>/etc/inittab
+

v0.3.4.5/stuff/upload_and_release-policy.txt

@@ -0,0 +1,23 @@
+This file describes common procedures for commiting code and for releasing a
+new version.
+
+1) day-to-day commits:
+
+The usual steps before commit:
+	- scripts/update_po_files.py && scripts/revert_unchanged_po_files.sh
+	- run unittests:
+		- bin/uml-setup.py
+		- log into uml
+		- install the previously build package
+		- invoke-rc.d cryptobox-server stop
+		- hostfs/bin/do_unittests.sh
+	- check that CryptoBoxRootActions has OVERRIDE_FILECHECK = False
+
+
+2) release a new version
+
+	- follow the instructions in "debian-package-policy.txt"
+	- upload the tar/deb/iso to codecoop
+	- update the website: index and download
+	- announce the release on freshmeat: http://freshmeat.net/projects/cryptobox
+