add a note about building official packages

diff --git a/doc/debocker.8 b/doc/debocker.8
index 707219d..072d5c2 100644 (file)
--- a/doc/debocker.8
+++ b/doc/debocker.8
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "DEBOCKER" "8" "July 2015" "Debian" "debocker"
+.TH "DEBOCKER" "8" "August 2015" "Debian" "debocker"
 .
 .SH "NAME"
 \fBdebocker\fR \- build Debian packages with docker
@@ -13,6 +13,9 @@
 \fBDebocker\fR builds Debian packages inside docker\. The build process is contained in docker images and (almost) no other tools are needed to develop Debian packages on the main system\. Moreover, docker\'s image cache reuses the same system state whenever possible\. In particular, when a package is built for the second time, its dependecies and buildchain are not downloaded nor installed again\.
 .
 .P
+\fBDo not use debocker to build packages that will will be uploaded to the Debian archive\fR, unless you use a trusted Debian base image (I mean it)\. Currently, \fBdebocker\fR uses Debian images from Docker registry which cannot be trusted for such use\.
+.
+.P
 \fBDebocker\fR is also able to create a self\-contained \fIbundle\fR with everything necessary to build a package with docker only\.
 .
 .P
@@ -22,7 +25,7 @@ You do not have to be root to run \fBdebocker\fR, but you have to be able to use
 The build process consists of 5 steps:
 .
 .IP "1." 4
-\fIuprade\fR \- the base image is updated to the most recent packages (with apt\-get)
+\fIupgrade\fR \- the base image is updated to the most recent packages (with apt\-get)
 .
 .IP "2." 4
 \fIinstall\-utils\fR \- the Debian toolchain is installed
@@ -187,7 +190,7 @@ Debocker does not clean after itself\. If you are not careful, docker images may
 And probably many more\.
 .
 .SH "AUTHOR"
-Initial idea and coding has been done by Tomasz Buchert \fItomasz@debian\.org\fR\.
+Initial idea and coding has been done by Tomasz Buchert\.
 .
 .P
 Initial packaging, many ideas and a lot of support by Dariusz Dwornikowski\.
@@ -196,4 +199,4 @@ Initial packaging, many ideas and a lot of support by Dariusz Dwornikowski\.
 The semi\-official homepage is \fIhttp://debocker\.debian\.net\fR\.
 .
 .SH "SEE ALSO"
-pbuiler(8), docker(1), devscripts(1), pristine\-tar(1)
+pbuilder(8), docker(1), devscripts(1), pristine\-tar(1)

diff --git a/doc/debocker.8.html b/doc/debocker.8.html
index 7c8bcc4..006e885 100644 (file)
--- a/doc/debocker.8.html
+++ b/doc/debocker.8.html
@@ -89,6 +89,11 @@ image cache reuses the same system state whenever possible. In
 particular, when a package is built for the second time, its
 dependecies and buildchain are not downloaded nor installed again.</p>
 
+<p><strong>Do not use debocker to build packages that will will be uploaded to
+the Debian archive</strong>, unless you use a trusted Debian base image (I
+mean it).  Currently, <strong>debocker</strong> uses Debian images from Docker
+registry which cannot be trusted for such use.</p>
+
 <p><strong>Debocker</strong> is also able to create a self-contained <em>bundle</em> with
 everything necessary to build a package with docker only.</p>
 
@@ -99,13 +104,13 @@ member of the <em>docker</em> group.</p>
 <p>The build process consists of 5 steps:</p>
 
 <ol>
-<li> <em>uprade</em> - the base image is updated to the most recent
+<li><em>upgrade</em> - the base image is updated to the most recent
  packages (with apt-get)</li>
-<li> <em>install-utils</em> - the Debian toolchain is installed</li>
-<li> <em>install-deps</em> - the build dependencies of the package are
+<li><em>install-utils</em> - the Debian toolchain is installed</li>
+<li><em>install-deps</em> - the build dependencies of the package are
  installed</li>
-<li> <em>extract-source</em> - the source package is extracted</li>
-<li> <em>build</em> - the proper build is executed</li>
+<li><em>extract-source</em> - the source package is extracted</li>
+<li><em>build</em> - the proper build is executed</li>
 </ol>
 
 
@@ -235,8 +240,7 @@ images may consume a lot of space.</p>
 
 <h2 id="AUTHOR">AUTHOR</h2>
 
-<p>Initial idea and coding has been done by Tomasz Buchert
-<a href="&#109;&#x61;&#x69;&#x6c;&#x74;&#111;&#x3a;&#116;&#111;&#109;&#x61;&#115;&#x7a;&#64;&#x64;&#x65;&#x62;&#x69;&#97;&#x6e;&#46;&#x6f;&#x72;&#103;" data-bare-link="true">&#116;&#x6f;&#109;&#97;&#x73;&#122;&#64;&#x64;&#x65;&#x62;&#105;&#97;&#110;&#46;&#x6f;&#114;&#103;</a>.</p>
+<p>Initial idea and coding has been done by Tomasz Buchert.</p>
 
 <p>Initial packaging, many ideas and a lot of support by Dariusz
 Dwornikowski.</p>
@@ -245,12 +249,12 @@ Dwornikowski.</p>
 
 <h2 id="SEE-ALSO">SEE ALSO</h2>
 
-<p><span class="man-ref">pbuiler<span class="s">(8)</span></span>, <span class="man-ref">docker<span class="s">(1)</span></span>, <span class="man-ref">devscripts<span class="s">(1)</span></span>, <span class="man-ref">pristine-tar<span class="s">(1)</span></span></p>
+<p><span class="man-ref">pbuilder<span class="s">(8)</span></span>, <span class="man-ref">docker<span class="s">(1)</span></span>, <span class="man-ref">devscripts<span class="s">(1)</span></span>, <span class="man-ref">pristine-tar<span class="s">(1)</span></span></p>
 
 
   <ol class='man-decor man-foot man foot'>
     <li class='tl'>Debian</li>
-    <li class='tc'>July 2015</li>
+    <li class='tc'>August 2015</li>
     <li class='tr'>debocker(8)</li>
   </ol>
 

diff --git a/doc/debocker.8.ronn b/doc/debocker.8.ronn
index 215bd05..8fdbae9 100644 (file)
--- a/doc/debocker.8.ronn
+++ b/doc/debocker.8.ronn
@@ -14,6 +14,11 @@ image cache reuses the same system state whenever possible. In
 particular, when a package is built for the second time, its
 dependecies and buildchain are not downloaded nor installed again.
 
+**Do not use debocker to build packages that will will be uploaded to
+the Debian archive**, unless you use a trusted Debian base image (I
+mean it).  Currently, **debocker** uses Debian images from Docker
+registry which cannot be trusted for such use.
+
 **Debocker** is also able to create a self-contained *bundle* with
 everything necessary to build a package with docker only.
 
@@ -23,7 +28,7 @@ member of the *docker* group.
 
 The build process consists of 5 steps:
 
-  1. *uprade* - the base image is updated to the most recent
+  1. *upgrade* - the base image is updated to the most recent
      packages (with apt-get)
   2. *install-utils* - the Debian toolchain is installed
   3. *install-deps* - the build dependencies of the package are
@@ -151,8 +156,7 @@ And probably many more.
 
 ## AUTHOR
 
-Initial idea and coding has been done by Tomasz Buchert
-<tomasz@debian.org>.
+Initial idea and coding has been done by Tomasz Buchert.
 
 Initial packaging, many ideas and a lot of support by Dariusz
 Dwornikowski.
@@ -161,4 +165,4 @@ The semi-official homepage is <http://debocker.debian.net>.
 
 ## SEE ALSO
 
-pbuiler(8), docker(1), devscripts(1), pristine-tar(1)
+pbuilder(8), docker(1), devscripts(1), pristine-tar(1)