EMDEBIAN-TOOLS README
			=====================

SVN-BUILDPACKAGE
----------------
	The generated manpages have been removed from SVN but are
	needed for the package, ensure ./doc/genmanpages is run before
	trying to run svn-buildpackage -uc -us -rfakeroot

TRANSLATORS
-----------
	emdebian-tools supports two kinds of translation - the debconf
	templates and the manpages. Debconf PO files live in debian/po
	and are already translated into many languages. Manpage translation
	support is new and involves translating a lot of strings (over 1,600).

	To save needless SVN churn, the POT file for manpage translation is
	NOT packaged in the emdebian-tools source package. However, it can
	be generated, either from an SVN working copy or from the source
	package using:

	$ ./doc/genmanpages

	This also generates the manpages themselves, including any that are
	already translated. The command can be used repeatedly to update the
	translated manpages as new strings / languages are added.

	To start a new translation of the manpages, run genmanpages, and 
	make a copy of po/emdebian-tools.pot using the locale name for your
	translation, e.g. po/fr.po or po/pt_BR.po. Edit the PO file in your
	preferred translation editor, setting the PO headers as appropriate.

	To update an existing translation, just run genmanpages which will
	merge any new strings from po/emdebian-tools.pot into your PO file,
	marking any modified strings as "fuzzy", adding new strings and
	removing old ones. Edit your modified PO file to resolve the "fuzzy"
	translations and provide translations for new strings.

	To clean up your working directory, use:

	$ fakeroot debian/rules clean

	Note that this is run automatically during the build and will remove
	all the generated manpages prior to generating them afresh during the
	build. *Do NOT attempt to edit the manpages themselves*

	Either commit your PO changes if you have access, or send your modified
	PO file (not the POT file) to the debian-embedded mailing list or as an
	i18n wishlist bug against emdebian-tools. (Once TDebs are supported in
	Debian, new translations can be added directly without needing a bug
	report or any action by the maintainer.)

MANPAGE CONTENT
---------------

	The manpage documentation for emdebian-tools is quite extensive and
	alternative formats are available for easier reading:

	From Emdebian SVN, yelp can provide much nicer formatting (but only
	for manpages derived from the XML, not those built from POD):
	$ yelp ghelp:/$PWD/emdebian-tools.1.xml

	genmanpages creates HTML using docbook and POD formatting and the
	files are regularly synced to the www:
	http://linux.codehelp.co.uk/emdebian/man/

emrootfslib
-----------

This is a shell library, it is not executable and must not have an
interpreter line specified at the start. The only reason that this
file is deliberately checked with check-bashisms is for syntax errors.
Despite the message from checkbashisms, the syntax check runs fine
without an interpreter line.