add note about naming conventions, with formatting

[mirror/dsa-wiki.git] / input / howto / dchroot.creole

diff --git a/input/howto/dchroot.creole b/input/howto/dchroot.creole
index 2f6c783..f6733f1 100644 (file)
--- a/input/howto/dchroot.creole
+++ b/input/howto/dchroot.creole
@@ -1,6 +1,21 @@
 
 == HOWTO set up a porting dchroot on a debian.org machine ==
 
+The script 'upgrade-porter-chroots' has expectations about naming conventions
+for new porter chroots.  The current list it searches for are:
+
+{{{
+lenny squeeze wheezy sid \
+lenny_i386 squeeze_i386 wheezy_i386 sid_i386 \
+lenny_amd64 squeeze_amd64 wheezy_amd64 sid_amd64 \
+sid_s390x \
+}}}
+
+Please make sure that new chroots meet the expectations of the script, or update
+the script accordingly (it lives in the debian.org.git repo)
+
+
+
 This example is for setting up a $DIST dchroot on paer.debian.org,
 adjust accordingly.
 
@@ -39,6 +54,7 @@ EOF
 #*)
  echo 'Acquire::PDiffs "false";' > /etc/apt/apt.conf.d/local-pdiff
  echo 'APT::Install-Recommends 0;' > /etc/apt/apt.conf.d/local-recommends
+ echo 'Acquire::Languages "none";' > /etc/apt/apt.conf.d/local-no-lang
 # # not sure this one's a good idea, -- weasel 20080829
 # ##echo 'DPkg::Post-Invoke { "(sleep 1; apt-get clean) &"; };' > /etc/apt/apt.conf.d/local-cleanup
 #
@@ -72,7 +88,7 @@ EOF
 #   least "en_US.UTF-8 UTF-8" and "en_US ISO-8859-1".)
 #
 #*) setup nsswitch.conf to properly use the ldap stuff
-  # OBSOLETE: apt-get install libnss-db &&
+  # [dchroot]: apt-get install libnss-db &&
   # sed -i -e 's/^passwd:\[[:space:]]\+compat$/passwd:         compat db/;
   #            s/^group:\[[:space:]]\+compat$/group:          db compat/;
   #            s/^shadow:\[[:space:]]\+compat$/shadow:         compat db/' \
@@ -102,7 +118,7 @@ EOF
   exit
 }}}
 
-* OBSOLETE: edit /etc/fstab on the system root and add entries to mount /proc and /home
+* [dchroot only] edit /etc/fstab on the system root and add entries to mount /proc and /home
 in the chroot, there will be existing ones for the other chroots, just copy and
 adjust. Then mount them (from the system root).
 {{{
@@ -128,14 +144,12 @@ adjust. Then mount them (from the system root).
   :  tmp /srv/albeniz.debian.org/chroot/sid/tmp none bind,defaults
 }}}
 
-* set up /etc/schroot/chroot.d/ correctly.  OBSOLETE: edit /etc/dchroot.conf in the system root, add an entry for $DIST, and
-update the stable and testing pointers
+* [schroot] set up /etc/schroot/chroot.d/ correctly.
+  [dchroot]: edit /etc/dchroot.conf in the system root, add an entry for $DIST, and update the stable and testing pointers
 
-* OBSOLETE: run ud-replicate so the new chroot is setup (this would happen via cron eventually, this is just to speed things up)
+* [dchroot]: run ud-replicate so the new chroot is setup (this would happen via cron eventually, this is just to speed things up)
 {{{
   ud-replicate
 }}}
 
-* as a normal user, test that the new chroot works: "dchroot $DIST", test that the stable and testing pointers work.
-
--- taggart 2007,  slightly modified by weasel 2007, 2008, ported to wiki 2010.
+* as a normal user, test that the new chroot works: "dchroot $DIST" or "schroot $DIST", test that the stable and testing pointers work.