[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-system.xml

[Sven Vermeulen (swift)]

swift       14/06/01 13:37:36

  Modified:             hb-install-system.xml
  Log:
  Fix bug #498968 - Add warning about non-installation media having different /dev/shm structure, as well as an in-document comment for future reference

Revision  Changes    Path
1.146                xml/htdocs/doc/en/handbook/hb-install-system.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.146&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.146&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?r1=1.145&r2=1.146

Index: hb-install-system.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v
retrieving revision 1.145
retrieving revision 1.146
diff -u -r1.145 -r1.146
--- hb-install-system.xml	13 Apr 2014 11:58:00 -0000	1.145
+++ hb-install-system.xml	1 Jun 2014 13:37:36 -0000	1.146
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.145 2014/04/13 11:58:00 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.146 2014/06/01 13:37:36 swift Exp $ -->
 
 <sections>
 
@@ -14,8 +14,8 @@
 to progress to that state.
 </abstract>
 
-<version>37</version>
-<date>2014-04-13</date>
+<version>38</version>
+<date>2014-06-01</date>
 
 <section>
 <title>Chrooting</title>
@@ -109,6 +109,21 @@
 # <i>mount --rbind /dev /mnt/gentoo/dev</i>
 </pre>
 
+<!--
+Only warning for non-Gentoo installation media. The more other installation
+media diverge from ours, the more difficult it will be to create proper
+documentation. If this becomes a larger issue, we will need to include a
+single warning up front, and perhaps have a wiki page where users can put the
+differences, so that the installation instructions can focus on Gentoo-only
+media.
+-->
+<warn>
+When using non-Gentoo installation media, this might not be sufficient.
+Some distributions make <path>/dev/shm</path> a symbolic link to
+<path>/run/shm</path> which, after the chroot, becomes invalid. Making
+<path>/dev/shm</path> a proper tmpfs-mount up front can fix this.
+</warn>
+
 </body>
 </subsection>
 <subsection>