tag 588962 patch thanks Hi Roger, Thomas,
Le 19/07/2010 13:24, David Prévot a écrit :
> Le 13/07/2010 18:23, Roger Leigh a écrit :
>> On Tue, Jul 13, 2010 at 10:00:03PM +0200, Thomas Blein wrote:
>>> [...] I saw that the documentation of the schroot package is not translated
>>> in any language. I would like to translate it French. For this, there is a
>>> need to change the source organisation so the documentation use po4a to
>>> allow us to translate it.
>>>
>>> I would like to know if such changes could be me made.
>
>> I'd be happy to make this sort of change, or accept patches to do this.
Please find attached a patch against the current git repository in order
to provide POT files to translators, and build translated documentation.
1. You first want to run "po4a man/po4a/po4a.cfg" in order to populate
the POT file (man/po4a/po/schroot-man.pot here, the name is arbitrary).
2. The POT file should then be proposed to translators. Once you
received one (fr.po for example), you just have to put it in
man/po4a/po/. If you receive an addendum (fr.add for example), just put
it a the new sub-directory man/po4a/add_fr/.
3. If there are some translations, run "po4a man/po4a/po4a.cfg" in order
to update PO and POT files and build the translated documentation (for
example, French translation of man/schroot.1.in will be build in
man/translated/fr/schroot.1.in).
4. You also probably want to add a clean rule in order to delete the
directory man/translated (which will contain, in subdirectories, the
translated documentation build by "po4a man/po4a/po4a.cfg"): it doesn't
need to be saved in your VCS, just keep the PO and POT files.
I'm not sure of how you want to configure stuff with Autotools, but:
point 1: just need to be done once you've applied the patch.
point 2: just need to be done once you receive a translation.
point 3: it should be done before creating the tarball, thus the
proposed rule added in the dist-hook target.
point 4: you should add a clean rule somewhere.
You also off course need to actually build and install the translated
manual pages (from man/translated/$lang/manpages.#.in), but it can wait
until you actually receive some translation. translated pdf and ps can
also be provided.
>> Currently the documentation is all in manual page format with some
>> GNU troff extensions; can po4a cope with this?
>
> Actually, a tiny problem in the Locale::Po4a::Man module don't permit it
> for the moment, but a patch is already on it's way.
po4a 0.40 released yesterday is now OK with GNU troff extensions used in
your manual pages.
> Anyway, in order to make translators life easier, Denis Barbier [...]
> proposed another version of schroot.1.in [2], fully
> compatible with the actual one (as far as I tried the manual pages and
> pdf generation, it provides exactly the same result). I fully agree with
> him : PO files are much more understandable this way (and sources too I
> think), so I ask you to consider similar changes into other manual pages.
>
> [2]http://lists.alioth.debian.org/pipermail/po4a-devel/attachments/20100719/8962358d/attachment-0001.obj
The patch includes Denis' proposition, it's updated against the current
version (in git) of schroot.1.in.
Cheers
David
diff -urN /mnt/donnees/1/debian/schroot//debian/control ./debian/control --- /mnt/donnees/1/debian/schroot//debian/control 2010-07-25 17:58:44.000000000 -0400 +++ ./debian/control 2010-07-28 22:09:54.000000000 -0400 @@ -3,7 +3,7 @@ Priority: optional Maintainer: Debian buildd-tools Developers <buildd-tools-de...@lists.alioth.debian.org> Uploaders: Roger Leigh <rle...@debian.org> -Build-Depends: debhelper (>= 7.0.0), autotools-dev, pkg-config (>= 0.20), libpam0g-dev (>= 0.79-3.1), uuid-dev, liblockdev1-dev (>= 1.0.2), libboost-dev (>= 1.39.0), libboost-program-options-dev (>= 1.39.0), libboost-regex-dev (>= 1.39.0), libboost-filesystem-dev (>= 1.39.0), gettext, libcppunit-dev, doxygen, graphviz +Build-Depends: debhelper (>= 7.0.0), autotools-dev, pkg-config (>= 0.20), libpam0g-dev (>= 0.79-3.1), uuid-dev, liblockdev1-dev (>= 1.0.2), libboost-dev (>= 1.39.0), libboost-program-options-dev (>= 1.39.0), libboost-regex-dev (>= 1.39.0), libboost-filesystem-dev (>= 1.39.0), gettext, libcppunit-dev, doxygen, graphviz, po4a (>= 0.40-1) Standards-Version: 3.9.0 Vcs-Browser: http://git.debian.org/?p=buildd-tools/schroot.git Vcs-Git: git://git.debian.org/git/buildd-tools/schroot diff -urN /mnt/donnees/1/debian/schroot//Makefile.am ./Makefile.am --- /mnt/donnees/1/debian/schroot//Makefile.am 2010-07-25 17:58:44.000000000 -0400 +++ ./Makefile.am 2010-07-28 22:09:54.000000000 -0400 @@ -36,6 +36,9 @@ git log > $(distdir)/ChangeLog; \ fi +# Update POT and POs for manual pages + po4a --rm-backups man/po4a/po4a.cfg + EXTRA_DIST = \ bootstrap \ debian \ diff -urN /mnt/donnees/1/debian/schroot//man/po4a/addendum.template ./man/po4a/addendum.template --- /mnt/donnees/1/debian/schroot//man/po4a/addendum.template 1969-12-31 20:00:00.000000000 -0400 +++ ./man/po4a/addendum.template 2010-07-28 22:09:54.000000000 -0400 @@ -0,0 +1,22 @@ +PO4A-HEADER:mode=after;position=^\.SH "SEE ALSO";beginboundary=^\.SH +.SH TRANSLATOR(S) +This manpage has been translated by TRANSLATOR NAME <email> on TRANSLATION +DATE. + +If you find any mistake in this translation, please send an e-mail to the +translator or to the +.nh +<\fidebian\-l10n\-langu...@lists.debian.org\fr>, +.hy +mailing-list. + +# Note to translators: +# Please translate this text in a file called language_code.add +# The addendum MUST use the same encoding as your po file +# Feel free to adapt the text at your convenience. +# Do not forget to translate "SEE ALSO" and "TRANSLATOR(S)" +# The "SEE ALSO" part in the header must be *exactly* the same translation +# as the one in your xx.po file. +# Do not include this comment in your addendum (i.e. all lines starting +# with a #). +# See po4a(7) for further information. diff -urN /mnt/donnees/1/debian/schroot//man/po4a/po/schroot-man.pot ./man/po4a/po/schroot-man.pot --- /mnt/donnees/1/debian/schroot//man/po4a/po/schroot-man.pot 1969-12-31 20:00:00.000000000 -0400 +++ ./man/po4a/po/schroot-man.pot 2010-07-28 22:09:54.000000000 -0400 @@ -0,0 +1 @@ + diff -urN /mnt/donnees/1/debian/schroot//man/po4a/po4a.cfg ./man/po4a/po4a.cfg --- /mnt/donnees/1/debian/schroot//man/po4a/po4a.cfg 1969-12-31 20:00:00.000000000 -0400 +++ ./man/po4a/po4a.cfg 2010-07-28 22:09:54.000000000 -0400 @@ -0,0 +1,23 @@ +[po_directory] man/po4a/po/ + +[po4a_alias:man] man opt:"-M UTF-8 -L UTF-8" + +[type: man] man/schroot.1.in $lang:man/translated/$lang/schroot.1.in \ + add_$lang:?man/po4a/add_$lang/$lang.add +[type: man] man/schroot-setup.5.in $lang:man/translated/$lang/schroot-setup.5.in \ + add_$lang:?man/po4a/add_$lang/$lang.add +[type: man] man/schroot.conf.5.in lang:man/translated/$lang/schroot.conf.5.in \ + add_$lang:?man/po4a/add_$lang/$lang.add +[type: man] man/schroot-script-config.5.in $lang:man/translated/$lang/schroot-script-config.5.in \ + add_$lang:?man/po4a/add_$lang/$lang.add +[type: man] man/schroot-faq.7.in $lang:man/translated/$lang/schroot-faq.in \ + add_$lang:?man/po4a/add_$lang/$lang.add + +# The following files could also be offered for translation, maybe separately +#[type: man] man/dchroot.1.in $lang:man/translated/$lang/dchroot.1.in \ +# add_$lang:?man/po4a/add_$lang/$lang.add +#[type: man] man/dchroot-dsa.1.in $lang:man/translated/$lang/dchroot-dsa.1.in \ +# add_$lang:?man/po4a/add_$lang/$lang.add +#[type: man] man/csbuild.1.in $lang:man/translated/$lang/csbuild.1.in \ +# add_$lang:?man/po4a/add_$lang/$lang.add + diff -urN /mnt/donnees/1/debian/schroot//man/schroot.1.in ./man/schroot.1.in --- /mnt/donnees/1/debian/schroot//man/schroot.1.in 2010-07-25 17:58:44.000000000 -0400 +++ ./man/schroot.1.in 2010-07-28 22:09:54.000000000 -0400 @@ -283,90 +283,74 @@ to use the full name including the namespace, even when not strictly required. .SH EXAMPLES .SS List available chroots -\f[CR]%\ \f[CB]schroot \-l\fP\fP\[CR] -.br -\f[CR]chroot:default\fP -.br -\f[CR]chroot:etch\fP -.br -\f[CR]chroot:sid\fP -.br -\f[CR]chroot:testing\fP -.br -\f[CR]chroot:unstable\fP +.EX +.\" Translators: This is the result of "schroot -l" +.\" Run this command within your environment to +.\" have consistent translations +% \f[CB]schroot \-l\fP\[CR] +chroot:default +chroot:etch +chroot:sid +chroot:testing +chroot:unstable +.EE .SS Get information about a chroot -\f[CR]%\ \f[CB]schroot\ \-i\ \-c\ sid\fP\fP\[CR] -.br -\f[CR]\ \ \[em]\[em]\[em]\ Chroot\ \[em]\[em]\[em]\fP -.br -\f[CR]\ \ Name\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sid\fP -.br -\f[CR]\ \ Description\ \ \ \ \ \ \ \ \ \ \ \ Debian sid (unstable)\fP -.br -\f[CR]\ \ Type\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ plain\fP -.br -\f[CR]\ \ Priority\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 3\fP -.br -\f[CR]\ \ Users\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rleigh\fP -.br -\f[CR]\ \ Groups\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sbuild\fP -.br -\f[CR]\ \ Root\ Users\fP -.br -\f[CR]\ \ Root\ Groups\ \ \ \ \ \ \ \ \ \ \ \ sbuild\fP -.br -\f[CR]\ \ Aliases\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ unstable\ unstable\-sbuild\ unstable\-p\fP -.br -\f[CR]owerpc\-sbuild\fP -.br -\f[CR]\ \ Environment\ Filter\ \ \ \ \ ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\fP -.br -\f[CR]FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\fP -.br -\f[CR]IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\fP -.br -\f[CR]RMPATH)$\fP -.br -\f[CR]\ \ Run\ Setup\ Scripts\ \ \ \ \ \ true\fP -.br -\f[CR]\ \ Script\ Configuration\ \ \ script\-defaults\fP -.br -\f[CR]\ \ Session\ Managed\ \ \ \ \ \ \ \ true\fP -.br -\f[CR]\ \ Personality\ \ \ \ \ \ \ \ \ \ \ \ linux32\fP -.br -\f[CR]\ \ Location\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ /srv/chroot/sid\fP +.EX +.\" Translators: This is the result of "schroot -i -c sid" +.\" Run this command within your environment to +.\" have consistent translations. It is likely +.\" that only left columns have to be translated. +% \f[CB]schroot \-i \-c sid\fP\[CR] + \[em]\[em]\[em] Chroot \[em]\[em]\[em] + Name sid + Description Debian sid (unstable) + Type plain + Priority 3 + Users rleigh + Groups sbuild + Root Users + Root Groups sbuild + Aliases unstable unstable\-sbuild unstable\-p + owerpc\-sbuild + Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I +FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA +IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE +RMPATH)$ + Run Setup Scripts true + Script Configuration script\-defaults + Session Managed true + Personality linux32 + Location /srv/chroot/sid +.EE .LP Use \fI\-\-all\fP or \fI\-c\fP multiple times to use all or multiple chroots, respectively. .SS Running commands in a chroot -\f[CR]%\ \f[CB]schroot \-c sid /bin/ls\fP\fP\[CR] -.br -\f[CR][sid chroot] Running command: \[lq]/bin/ls\[rq]\fP -.br -\f[CR]CVS sbuild\-chroot.c sbuild\-session.h schroot.conf.5\fP -.br -\f[CR]Makefile sbuild\-chroot.h schroot.1 schroot.conf.5.in\fP -.br -\f[CR]Makefile.am sbuild\-config.c schroot.1.in\fP -.br -\f[CR]Makefile.in sbuild\-config.h schroot.c\fP -.br -\f[CR]pam sbuild\-session.c schroot.conf\fP -.PP -\f[CR]%\ \f[CB]schroot \-c sid \-\- ls \-1 | head \-n 5\fP\fP\[CR] -.br -\f[CR][sid chroot] Running command: \[lq]ls \-1\[rq]\fP -.br -\f[CR]ABOUT\-NLS\fP -.br -\f[CR]AUTHORS\fP -.br -\f[CR]COPYING\fP -.br -\f[CR]ChangeLog\fP -.br -\f[CR]INSTALL\fP +.EX +.\" Translators: This is the result of "schroot -c sid /bin/ls" +.\" Run this command within your environment to +.\" have consistent translations +% \f[CB]schroot \-c sid /bin/ls\fP\[CR] +[sid chroot] Running command: \[lq]/bin/ls\[rq] +CVS sbuild\-chroot.c sbuild\-session.h schroot.conf.5 +Makefile sbuild\-chroot.h schroot.1 schroot.conf.5.in +Makefile.am sbuild\-config.c schroot.1.in +Makefile.in sbuild\-config.h schroot.c +pam sbuild\-session.c schroot.conf +.EE +.PP +.EX +.\" Translators: This is the result of "schroot -c sid -- ls -1 | head -n 5" +.\" Run this command within your environment to +.\" have consistent translations +% \f[CB]schroot \-c sid \-\- ls \-1 | head \-n 5\fP\[CR] +[sid chroot] Running command: \[lq]ls \-1\[rq] +ABOUT\-NLS +AUTHORS +COPYING +ChangeLog +INSTALL +.EE .LP Use \fI\-\-\fP to allow options beginning with \[oq]\-\[cq] or \[oq]\-\-\[cq] in the command to run in the chroot. This prevents them being interpreted as @@ -376,16 +360,19 @@ as required; the data will be the same as if the command was run directly on the host system. .SS Switching users -\f[CR]%\ \f[CB]schroot \-c sid \-u root\fP\fP\[CR] -.br -\f[CR]Password:\fP -.br -\f[CR][sid chroot] (rleigh\[->]root) Running login shell: \[lq]/bin/bash\[rq]\fP -.br -\f[CR]# \fP +.EX +.\" Translators: This is the result of "schroot -c sid -u root" +.\" Run this command within your environment to +.\" have consistent translations +% \f[CB]schroot \-c sid \-u root\fP\[CR] +Password: +[sid chroot] (rleigh\[->]root) Running login shell: \[lq]/bin/bash\[rq] +# +.EE .LP -If the user \[oq]rleigh\[cq] was in \f[CI]root\-users\fP in -...@schroot_conf@\fP, or one of the groups he belonged to was in +If the user \[oq]rleigh\[cq] was in +\f[CI]root\-users\fP +in \...@schroot_conf@\fP, or one of the groups he belonged to was in \f[CI]root\-groups\fP, they would be granted root access without authentication, but the PAM authorisation step is still applied. .SS Sessions @@ -398,175 +385,138 @@ .PP Let's start by looking at a session-capable chroot: .PP -\f[CR]%\ \f[CB]schroot\ \-i\ \-c\ sid\-snap\fP\fP\[CR] -.br -\f[CR]\ \ \[em]\[em]\[em]\ Chroot\ \[em]\[em]\[em]\fP -.br -\f[CR]\ \ Name\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sid\-snap\fP -.br -\f[CR]\ \ Description\ \ \ \ \ \ \ \ \ \ \ \ Debian sid snapshot\fP -.br -\f[CR]\ \ Type\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ lvm\-snapshot\fP -.br -\f[CR]\ \ Priority\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 3\fP -.br -\f[CR]\ \ Users\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ maks rleigh\fP -.br -\f[CR]\ \ Groups\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sbuild\fP -.br -\f[CR]\ \ Root\ Users\fP -.br -\f[CR]\ \ Root\ Groups\ \ \ \ \ \ \ \ \ \ \ \ root sbuild\fP -.br -\f[CR]\ \ Aliases\fP -.br -\f[CR]\ \ Environment\ Filter\ \ \ \ \ ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\fP -.br -\f[CR]FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\fP -.br -\f[CR]IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\fP -.br -\f[CR]RMPATH)$\fP -.br -\f[CR]\ \ Run\ Setup\ Scripts\ \ \ \ \ \ true\fP -.br -\f[CR]\ \ Script\ Configuration\ \ \ script\-defaults\fP -.br -\f[CR]\ \ Session\ Managed\ \ \ \ \ \ \ \ true\fP -.br -\f[CR]\ \ Personality\ \ \ \ \ \ \ \ \ \ \ \ linux\fP -.br -\f[CR]\ \ Device\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ /dev/hda_vg/sid_chroot\fP -.br -\f[CR]\ \ Mount\ Options\ \ \ \ \ \ \ \ \ \ \-o atime,async,user_xattr\fP -.br -\f[CR]\ \ Source\ Users\fP -.br -\f[CR]\ \ Source\ Groups\ \ \ \ \ \ \ \ \ \ root rleigh\fP -.br -\f[CR]\ \ Source\ Root\ Users\fP -.br -\f[CR]\ \ Source\ Root\ Groups\ \ \ \ \ root rleigh\fP -.br -\f[CR]\ \ LVM\ Snapshot\ Options\ \ \ \-\-size 2G \-c 128\fP +.EX +.\" Translators: This is the result of "schroot -i -c sid-snap" +.\" Run this command within your environment to +.\" have consistent translations. It is likely +.\" that only left columns have to be translated. +% \f[CB]schroot \-i \-c sid\-snap\fP\[CR] + \[em]\[em]\[em] Chroot \[em]\[em]\[em] + Name sid\-snap + Description Debian sid snapshot + Type lvm\-snapshot + Priority 3 + Users maks rleigh + Groups sbuild + Root Users + Root Groups root sbuild + Aliases + Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I +FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA +IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE +RMPATH)$ + Run Setup Scripts true + Script Configuration script\-defaults + Session Managed true + Personality linux + Device /dev/hda_vg/sid_chroot + Mount Options \-o atime,async,user_xattr + Source Users + Source Groups root rleigh + Source Root Users + Source Root Groups root rleigh + LVM Snapshot Options \-\-size 2G \-c 128 +.EE .PP Note that the \fISession Managed\fP option is set to \[oq]true\[cq]. This is a requirement in order to use session management, and is supported by most chroot types. Next, we will create a new session: .PP -\f[CR]%\ \f[CB]schroot \-b \-c sid\-snap\fP\fP\[CR] -.br -\f[CR]sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP +.EX +.\" Translators: This is the result of "schroot -b -c sid-snap" +.\" Run this command within your environment to +.\" have consistent translations +% \f[CB]schroot \-b \-c sid\-snap\fP\[CR] +sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f +.EE .PP The session ID of the newly-created session is returned on standard output. It is common to store it like this: .PP -\f[CR]%\ \f[CB]SESSION=$(schroot \-b \-c sid\-snap)\fP\fP\[CR] -.br -\f[CR]%\ \f[CB]echo $SESSION\fP\fP\[CR] -.br -\f[CR]sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP +.EX +.\" Translators: Do not translate this string +% \f[CB]SESSION=$(schroot \-b \-c sid\-snap)\fP\[CR] +% \f[CB]echo $SESSION\fP\[CR] +sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f +.EE .PP The session may be used just like any normal chroot. This is what the session looks like: .PP -\f[CR]%\ \f[CB]schroot\ \-i\ \-c\ sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP\fP\[CR] -.br -\f[CR]\ \ \[em]\[em]\[em]\ Session\ \[em]\[em]\[em]\fP -.br -\f[CR]\ \ Name\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d\fP -.br -\f[CR]4ccc899f0f\fP -.br -\f[CR]\ \ Description\ \ \ \ \ \ \ \ \ \ \ \ Debian sid snapshot\fP -.br -\f[CR]\ \ Type\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ lvm\-snapshot\fP -.br -\f[CR]\ \ Priority\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 3\fP -.br -\f[CR]\ \ Users\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ maks rleigh\fP -.br -\f[CR]\ \ Groups\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ sbuild\fP -.br -\f[CR]\ \ Root\ Users\fP -.br -\f[CR]\ \ Root\ Groups\ \ \ \ \ \ \ \ \ \ \ \ root sbuild\fP -.br -\f[CR]\ \ Aliases\fP -.br -\f[CR]\ \ Environment\ Filter\ \ \ \ \ ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\fP -.br -\f[CR]FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\fP -.br -\f[CR]IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\fP -.br -\f[CR]RMPATH)$\fP -.br -\f[CR]\ \ Run\ Setup\ Scripts\ \ \ \ \ \ true\fP -.br -\f[CR]\ \ Script\ Configuration\ \ \ script\-defaults\fP -.br -\f[CR]\ \ Session\ Managed\ \ \ \ \ \ \ \ true\fP -.br -\f[CR]\ \ Personality\ \ \ \ \ \ \ \ \ \ \ \ linux\fP -.br -\f[CR]\ \ Mount\ Location\ \ \ \ \ \ \ \ \ /var/lib/schroot/mount/sid\-snap\-461\fP -.br -\f[CR]95b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP -.br -\f[CR]\ \ Path\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ /var/lib/schroot/mount/sid\-snap\-461\fP -.br -\f[CR]95b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP -.br -\f[CR]\ \ Mount\ Device\ \ \ \ \ \ \ \ \ \ \ /dev/hda_vg/sid\-snap\-46195b04\-0893\-\fP -.br -\f[CR]49bf\-beb8\-0d4ccc899f0f\fP -.br -\f[CR]\ \ Device\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ /dev/hda_vg/sid_chroot\fP -.br -\f[CR]\ \ Mount\ Options\ \ \ \ \ \ \ \ \ \ \-o\ atime,async,user_xattr\fP -.br -\f[CR]\ \ Source\ Users\fP -.br -\f[CR]\ \ Source\ Groups\ \ \ \ \ \ \ \ \ \ root\ rleigh\fP -.br -\f[CR]\ \ Source\ Root\ Users\fP -.br -\f[CR]\ \ Source\ Root\ Groups\ \ \ \ \ root\ rleigh\fP -.br -\f[CR]\ \ LVM\ Snapshot\ Device\ \ \ \ /dev/hda_vg/sid\-snap\-46195b04\-0893\-\fP -.br -\f[CR]49bf\-beb8\-0d4ccc899f0f\fP -.br -\f[CR]\ \ LVM\ Snapshot\ Options\ \ \ \-\-size\ 2G\ \-c\ 128\fP +.EX +.\" Translators: This is the result of "schroot -i -c sid-snap-$(schroot -b -c sid-snap)" +.\" Run this command within your environment to +.\" have consistent translations. It is likely +.\" that only left columns have to be translated. +% \f[CB]schroot \-i \-c sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP\[CR] + \[em]\[em]\[em] Session \[em]\[em]\[em] + Name sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d +4ccc899f0f + Description Debian sid snapshot + Type lvm\-snapshot + Priority 3 + Users maks rleigh + Groups sbuild + Root Users + Root Groups root sbuild + Aliases + Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I +FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA +IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE +RMPATH)$ + Run Setup Scripts true + Script Configuration script\-defaults + Session Managed true + Personality linux + Mount Location /var/lib/schroot/mount/sid\-snap\-461 +95b04\-0893\-49bf\-beb8\-0d4ccc899f0f + Path /var/lib/schroot/mount/sid\-snap\-461 +95b04\-0893\-49bf\-beb8\-0d4ccc899f0f + Mount Device /dev/hda_vg/sid\-snap\-46195b04\-0893\- +49bf\-beb8\-0d4ccc899f0f + Device /dev/hda_vg/sid_chroot + Mount Options \-o atime,async,user_xattr + Source Users + Source Groups root rleigh + Source Root Users + Source Root Groups root rleigh + LVM Snapshot Device /dev/hda_vg/sid\-snap\-46195b04\-0893\- +49bf\-beb8\-0d4ccc899f0f + LVM Snapshot Options \-\-size 2G \-c 128 +.EE .PP Now the session has been created, commands may be run in it: .PP -\f[CR]%\ \f[CB]schroot \-r \-c sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f \-\- uname \-sr\fP\fP\[CR] -.br -\f[CR]I: [sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f chroot] Running command: \[lq]uname \-sr\[rq]\fP -.br -\f[CR]Linux 2.6.18\-3\-powerpc\fP -.br -\f[CR]%\ \f[CB]schroot \-r \-c $SESSION \-\- uname \-sr\fP\fP\[CR] -.br -\f[CR]I: [sid\-snap\-fe170af9\-d9be\-4800\-b1bd\-de275858b938 chroot] Running command: \[lq]uname \-sr\[rq]\fP -.br -\f[CR]Linux 2.6.18\-3\-powerpc\fP +.EX +.\" Translators: This is the result of "schroot -r -c sid-snap-$(schroot -b -c sid-snap)" +.\" Run this command within your environment to +.\" have consistent translations. +% \f[CB]schroot \-r \-c sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f + \-\- uname \-sr\fP\[CR] +I: [sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f chroot] Running + command: \[lq]uname \-sr\[rq] +Linux 2.6.18\-3\-powerpc +% \f[CB]schroot \-r \-c $SESSION \-\- uname \-sr\fP\[CR] +I: [sid\-snap\-fe170af9\-d9be\-4800\-b1bd\-de275858b938 chroot] Running + command: \[lq]uname \-sr\[rq] +Linux 2.6.18\-3\-powerpc +.EE .PP When all the commands to run in the session have been performed, the session may be ended: .PP -\f[CR]%\ \f[CB]schroot \-e \-c sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP\fP\[CR] -.br -\f[CR]%\ \f[CB]schroot \-e \-c $SESSION\fP\fP\[CR] +.EX +% \f[CB]schroot \-e \-c sid\-snap\-46195b04\-0893\-49bf\-beb8\-0d4ccc899f0f\fP\[CR] +% \f[CB]schroot \-e \-c $SESSION\fP\[CR] +.EE .PP Finally, the session names can be long and unwieldy. A name may be specified instead of using the automatically generated session ID: .PP -\f[CR]%\ \f[CB]schroot \-b \-c sid\-snap \-n my\-session\-name\fP\fP\[CR] -.br -\f[CR]my\-session\-name\fP +.EX +% \f[CB]schroot \-b \-c sid\-snap \-n my\-session\-name\fP\[CR] +my\-session\-name +.EE .SH TROUBLESHOOTING If something is not working, and it's not clear from the error messages what is wrong, try using the \fB\-\-debug=\fP\fIlevel\fP option to turn on debugging diff -urN /mnt/donnees/1/debian/schroot//README ./README --- /mnt/donnees/1/debian/schroot//README 2010-07-25 17:58:44.000000000 -0400 +++ ./README 2010-07-28 22:09:54.000000000 -0400 @@ -31,6 +31,7 @@ If building from GIT, you will also need: gettext (0.16) doxygen +po4a (>=0.40) Translation @@ -38,6 +39,8 @@ If you would like to see the schroot messages output in your own language, please consider translating the pot file (po/schroot.pot). +If you would like to see the schroot man pages in your own language, +please consider translating the pot file (man/po4a/po/schroot-man.pot). Building and installation
signature.asc
Description: OpenPGP digital signature
