[projects/rc-scripts.git] / DEVELOPMENT

	   READ THIS BEFORE CHANGEING SOMETHING IN RC-SCRIPTS PACKAGE
		    Arkadiusz Miskiewicz <misiek@pld-linux.org>
	    $Id$

1)
	consult all major changes with people on pld-rc-scripts@pld-linux.org
mailing list. This is very important.

2)
	use 'local' for local variables in functions for example:

function_ble ()
{
local qw er=0
qw=$(tty)
er=/dev/console
echo "$qw $er"
}

3)
	use $() instead `` for command execution for example

something=$(whoami)
instead of
something="`whoami`"

Warning! The following snippet will not work, use `` in such cases:
There is one ')' too many there.

interfaces_boot=$(
	case $i in
		*ifcfg-lo) continue ;;
	esac
)

4)	don't use sed ! It only causes one more Requires.
	Use awk ' { gsub(/pattern/,"replaced"); print $0; } ' for that.
	Also try to replace grep calls with awk calls.
	
5)
	(PL) Tlumaczac komunikaty na PL nalezy uzywac formy bezosobowej np:

uruchamianie uslugi
zamiast
uruchamiam usluge


HOW TO MAKE A RELEASE

- svn up
- ./autogen.sh
- make distcheck
- update configure.ac release and commit it
- svn up && ./changelog.sh && svn ci ChangeLog
- make dist
- ./make-tag.sh
- upload tarball to distfiles, update rc-scripts.spec:HEAD
Commit	Line	Data
	1	READ THIS BEFORE CHANGEING SOMETHING IN RC-SCRIPTS PACKAGE
	2	Arkadiusz Miskiewicz <misiek@pld-linux.org>
	3	$Id$
	4
	5	1)
	6	consult all major changes with people on pld-rc-scripts@pld-linux.org
	7	mailing list. This is very important.
	8
	9	2)
	10	use 'local' for local variables in functions for example:
	11
	12	function_ble ()
	13	{
	14	local qw er=0
	15	qw=$(tty)
	16	er=/dev/console
	17	echo "$qw $er"
	18	}
	19
	20	3)
	21	use $() instead `` for command execution for example
	22
	23	something=$(whoami)
	24	instead of
	25	something="`whoami`"
	26
	27	Warning! The following snippet will not work, use `` in such cases:
	28	There is one ')' too many there.
	29
	30	interfaces_boot=$(
	31	case $i in
	32	*ifcfg-lo) continue ;;
	33	esac
	34	)
	35
	36	4) don't use sed ! It only causes one more Requires.
	37	Use awk ' { gsub(/pattern/,"replaced"); print $0; } ' for that.
	38	Also try to replace grep calls with awk calls.
	39
	40	5)
	41	(PL) Tlumaczac komunikaty na PL nalezy uzywac formy bezosobowej np:
	42
	43	uruchamianie uslugi
	44	zamiast
	45	uruchamiam usluge
	46
	47
	48
	49	HOW TO MAKE A RELEASE
	50
	51	- svn up
	52	- ./autogen.sh
	53	- make distcheck
	54	- update configure.ac release and commit it
	55	- svn up && ./changelog.sh && svn ci ChangeLog
	56	- make dist
	57	- ./make-tag.sh
	58	- upload tarball to distfiles, update rc-scripts.spec:HEAD