[Pkg-xfce-commits] r3212 - scripts/pbuilder

Yves-Alexis Perez corsac at alioth.debian.org
Tue May 5 06:28:09 UTC 2009


Author: corsac
Date: 2009-05-05 06:28:09 +0000 (Tue, 05 May 2009)
New Revision: 3212

Added:
   scripts/pbuilder/README.html
Modified:
   scripts/pbuilder/README
Log:
update README, switch to asciidoc and commit html rendering too


Modified: scripts/pbuilder/README
===================================================================
--- scripts/pbuilder/README	2009-05-05 06:13:52 UTC (rev 3211)
+++ scripts/pbuilder/README	2009-05-05 06:28:09 UTC (rev 3212)
@@ -1,18 +1,46 @@
-0) Install pbuilder, debootstrap, fakeroot, svn-buildpackage, cdbs
+= Pbuilder scripts for pkg-xfce
+$Id$
 
-1) Set the correct $BASEDIR and $MIRROR (ideally an apt-proxy instance) in
-   pdebuild.conf
+== Quick setup
 
-2) Make sure you have already been in the parent directory and run:
-	./get-sources.pl desktop && ./get-sources.pl goodies
-   to grab both goodies and desktop original tarballs.
+. Install +pbuilder+, +debootstrap+, +fakeroot+, +svn-buildpackage+,
+  +cdbs+, +quilt+.
+. Set the correct variables in pdebuild.conf:
+  -  __$BASEDIR__ (repository root) ;
+  -  __$DESKTOPDIR__, __$GOODIESDIR__ (path to desktop and goodies packages,
+     useful when playing with branches) ;
+  - __$DISTRIBUTION__ and __$ARCH__ to match the target you want ;
+  -  __$MIRRORSITE__ to use your favorite mirror.
+. Make sure you have already been in the parent directory and run:
+	+./get-sources.pl desktop && ./get-sources.pl goodies+
+  to grab both goodies and desktop original tarballs.
+. Run +./pdebuild-sources.sh+ desktop and then 
+  +./pdebuild-sources.sh goodies+.
+. Cross your fingers.
 
-3) Run ./pdebuild-sources.sh desktop and then ./pdebuild-sources.sh goodies.
+== General maintainance
 
-4) Cross your fingers.
+.clean cache and built packages
+[shell]
+----
+./pdebuild-source.sh clean
+----
 
-If you want to wipe out everything and start from scratch, just rm -rf xfce/
-and run pdebuild-sources.sh again.
+.update pbuilder chroot
+[shell]
+----
+./pdebuild-source update
+----
 
-If you want to rebuild just one package remove xfce/build/<packagename> and
-run pdebuild-sources.sh again.
+.build only one package (or a set of packages)
+[shell]
+----
+./pdebuild-source.sh <desktop|goodies> <package> [<package>, <package>]
+----
+
+[NOTE]
+If the package already exist but you want to rebuild it, remove
++xfce/build/<name>\_<version>_<arch>.changes+ and run +pdebuild-sources.sh+
+again.
+
+// vim: filetype=asciidoc spelllang=en:


Property changes on: scripts/pbuilder/README
___________________________________________________________________
Added: svn:keywords
   + Id Rev Url Author Date

Added: scripts/pbuilder/README.html
===================================================================
--- scripts/pbuilder/README.html	                        (rev 0)
+++ scripts/pbuilder/README.html	2009-05-05 06:28:09 UTC (rev 3212)
@@ -0,0 +1,559 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+<meta name="generator" content="AsciiDoc 8.4.4" />
+<title>Pbuilder scripts for pkg-xfce</title>
+<style type="text/css">
+/* Debug borders */
+p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
+/*
+  border: 1px solid red;
+*/
+}
+
+body {
+  margin: 1em 5% 1em 5%;
+}
+
+a {
+  color: blue;
+  text-decoration: underline;
+}
+a:visited {
+  color: fuchsia;
+}
+
+em {
+  font-style: italic;
+  color: navy;
+}
+
+strong {
+  font-weight: bold;
+  color: #083194;
+}
+
+tt {
+  color: navy;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  color: #527bbd;
+  font-family: sans-serif;
+  margin-top: 1.2em;
+  margin-bottom: 0.5em;
+  line-height: 1.3;
+}
+
+h1, h2, h3 {
+  border-bottom: 2px solid silver;
+}
+h2 {
+  padding-top: 0.5em;
+}
+h3 {
+  float: left;
+}
+h3 + * {
+  clear: left;
+}
+
+div.sectionbody {
+  font-family: serif;
+  margin-left: 0;
+}
+
+hr {
+  border: 1px solid silver;
+}
+
+p {
+  margin-top: 0.5em;
+  margin-bottom: 0.5em;
+}
+
+ul, ol, li > p {
+  margin-top: 0;
+}
+
+pre {
+  padding: 0;
+  margin: 0;
+}
+
+span#author {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-weight: bold;
+  font-size: 1.1em;
+}
+span#email {
+}
+span#revision {
+  font-family: sans-serif;
+}
+
+div#footer {
+  font-family: sans-serif;
+  font-size: small;
+  border-top: 2px solid silver;
+  padding-top: 0.5em;
+  margin-top: 4.0em;
+}
+div#footer-text {
+  float: left;
+  padding-bottom: 0.5em;
+}
+div#footer-badges {
+  float: right;
+  padding-bottom: 0.5em;
+}
+
+div#preamble {
+  margin-top: 1.5em;
+  margin-bottom: 1.5em;
+}
+div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
+div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
+div.admonitionblock {
+  margin-top: 1.5em;
+  margin-bottom: 1.5em;
+}
+div.admonitionblock {
+  margin-top: 2.5em;
+  margin-bottom: 2.5em;
+}
+
+div.content { /* Block element content. */
+  padding: 0;
+}
+
+/* Block element titles. */
+div.title, caption.title {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-weight: bold;
+  text-align: left;
+  margin-top: 1.0em;
+  margin-bottom: 0.5em;
+}
+div.title + * {
+  margin-top: 0;
+}
+
+td div.title:first-child {
+  margin-top: 0.0em;
+}
+div.content div.title:first-child {
+  margin-top: 0.0em;
+}
+div.content + div.title {
+  margin-top: 0.0em;
+}
+
+div.sidebarblock > div.content {
+  background: #ffffee;
+  border: 1px solid silver;
+  padding: 0.5em;
+}
+
+div.listingblock > div.content {
+  border: 1px solid silver;
+  background: #f4f4f4;
+  padding: 0.5em;
+}
+
+div.quoteblock {
+  padding-left: 2.0em;
+  margin-right: 10%;
+}
+div.quoteblock > div.attribution {
+  padding-top: 0.5em;
+  text-align: right;
+}
+
+div.verseblock {
+  padding-left: 2.0em;
+  margin-right: 10%;
+}
+div.verseblock > div.content {
+  white-space: pre;
+}
+div.verseblock > div.attribution {
+  padding-top: 0.75em;
+  text-align: left;
+}
+/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
+div.verseblock + div.attribution {
+  text-align: left;
+}
+
+div.admonitionblock .icon {
+  vertical-align: top;
+  font-size: 1.1em;
+  font-weight: bold;
+  text-decoration: underline;
+  color: #527bbd;
+  padding-right: 0.5em;
+}
+div.admonitionblock td.content {
+  padding-left: 0.5em;
+  border-left: 2px solid silver;
+}
+
+div.exampleblock > div.content {
+  border-left: 2px solid silver;
+  padding: 0.5em;
+}
+
+div.imageblock div.content { padding-left: 0; }
+div.imageblock img { border: 1px solid silver; }
+span.image img { border-style: none; }
+
+dl {
+  margin-top: 0.8em;
+  margin-bottom: 0.8em;
+}
+dt {
+  margin-top: 0.5em;
+  margin-bottom: 0;
+  font-style: normal;
+  color: navy;
+}
+dd > *:first-child {
+  margin-top: 0.1em;
+}
+
+ul, ol {
+    list-style-position: outside;
+}
+ol.arabic {
+  list-style-type: decimal;
+}
+ol.loweralpha {
+  list-style-type: lower-alpha;
+}
+ol.upperalpha {
+  list-style-type: upper-alpha;
+}
+ol.lowerroman {
+  list-style-type: lower-roman;
+}
+ol.upperroman {
+  list-style-type: upper-roman;
+}
+
+div.compact ul, div.compact ol,
+div.compact p, div.compact p,
+div.compact div, div.compact div {
+  margin-top: 0.1em;
+  margin-bottom: 0.1em;
+}
+
+div.tableblock > table {
+  border: 3px solid #527bbd;
+}
+thead {
+  font-family: sans-serif;
+  font-weight: bold;
+}
+tfoot {
+  font-weight: bold;
+}
+td > div.verse {
+  white-space: pre;
+}
+p.table {
+  margin-top: 0;
+}
+/* Because the table frame attribute is overriden by CSS in most browsers. */
+div.tableblock > table[frame="void"] {
+  border-style: none;
+}
+div.tableblock > table[frame="hsides"] {
+  border-left-style: none;
+  border-right-style: none;
+}
+div.tableblock > table[frame="vsides"] {
+  border-top-style: none;
+  border-bottom-style: none;
+}
+
+
+div.hdlist {
+  margin-top: 0.8em;
+  margin-bottom: 0.8em;
+}
+div.hdlist tr {
+  padding-bottom: 15px;
+}
+dt.hdlist1.strong, td.hdlist1.strong {
+  font-weight: bold;
+}
+td.hdlist1 {
+  vertical-align: top;
+  font-style: normal;
+  padding-right: 0.8em;
+  color: navy;
+}
+td.hdlist2 {
+  vertical-align: top;
+}
+div.hdlist.compact tr {
+  margin: 0;
+  padding-bottom: 0;
+}
+
+.comment {
+  background: yellow;
+}
+
+ at media print {
+  div#footer-badges { display: none; }
+}
+
+div#toctitle {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-size: 1.1em;
+  font-weight: bold;
+  margin-top: 1.0em;
+  margin-bottom: 0.1em;
+}
+
+div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+div.toclevel2 {
+  margin-left: 2em;
+  font-size: 0.9em;
+}
+div.toclevel3 {
+  margin-left: 4em;
+  font-size: 0.9em;
+}
+div.toclevel4 {
+  margin-left: 6em;
+  font-size: 0.9em;
+}
+/* Workarounds for IE6's broken and incomplete CSS2. */
+
+div.sidebar-content {
+  background: #ffffee;
+  border: 1px solid silver;
+  padding: 0.5em;
+}
+div.sidebar-title, div.image-title {
+  color: #527bbd;
+  font-family: sans-serif;
+  font-weight: bold;
+  margin-top: 0.0em;
+  margin-bottom: 0.5em;
+}
+
+div.listingblock div.content {
+  border: 1px solid silver;
+  background: #f4f4f4;
+  padding: 0.5em;
+}
+
+div.quoteblock-attribution {
+  padding-top: 0.5em;
+  text-align: right;
+}
+
+div.verseblock-content {
+  white-space: pre;
+}
+div.verseblock-attribution {
+  padding-top: 0.75em;
+  text-align: left;
+}
+
+div.exampleblock-content {
+  border-left: 2px solid silver;
+  padding-left: 0.5em;
+}
+
+/* IE6 sets dynamically generated links as visited. */
+div#toc a:visited { color: blue; }
+</style>
+<script type="text/javascript">
+/*<![CDATA[*/
+window.onload = function(){generateToc(2)}
+/* Author: Mihai Bazon, September 2002
+ * http://students.infoiasi.ro/~mishoo
+ *
+ * Table Of Content generator
+ * Version: 0.4
+ *
+ * Feel free to use this script under the terms of the GNU General Public
+ * License, as long as you do not remove or alter this notice.
+ */
+
+ /* modified by Troy D. Hanson, September 2006. License: GPL */
+ /* modified by Stuart Rackham, October 2006. License: GPL */
+
+function getText(el) {
+  var text = "";
+  for (var i = el.firstChild; i != null; i = i.nextSibling) {
+    if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
+      text += i.data;
+    else if (i.firstChild != null)
+      text += getText(i);
+  }
+  return text;
+}
+
+function TocEntry(el, text, toclevel) {
+  this.element = el;
+  this.text = text;
+  this.toclevel = toclevel;
+}
+
+function tocEntries(el, toclevels) {
+  var result = new Array;
+  var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
+  // Function that scans the DOM tree for header elements (the DOM2
+  // nodeIterator API would be a better technique but not supported by all
+  // browsers).
+  var iterate = function (el) {
+    for (var i = el.firstChild; i != null; i = i.nextSibling) {
+      if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
+        var mo = re.exec(i.tagName)
+        if (mo)
+          result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
+        iterate(i);
+      }
+    }
+  }
+  iterate(el);
+  return result;
+}
+
+// This function does the work. toclevels = 1..4.
+function generateToc(toclevels) {
+  var toc = document.getElementById("toc");
+  var entries = tocEntries(document.getElementsByTagName("body")[0], toclevels);
+  for (var i = 0; i < entries.length; ++i) {
+    var entry = entries[i];
+    if (entry.element.id == "")
+      entry.element.id = "toc" + i;
+    var a = document.createElement("a");
+    a.href = "#" + entry.element.id;
+    a.appendChild(document.createTextNode(entry.text));
+    var div = document.createElement("div");
+    div.appendChild(a);
+    div.className = "toclevel" + entry.toclevel;
+    toc.appendChild(div);
+  }
+  if (entries.length == 0)
+    document.getElementById("header").removeChild(toc);
+}
+/*]]>*/
+</script>
+</head>
+<body>
+<div id="header">
+<h1>Pbuilder scripts for pkg-xfce</h1>
+<span id="author">$Id$</span><br />
+<div id="toc">
+  <div id="toctitle">Table of Contents</div>
+  <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
+</div>
+</div>
+<h2 id="_quick_setup">1. Quick setup</h2>
+<div class="sectionbody">
+<div class="olist arabic"><ol class="arabic">
+<li>
+<p>
+Install <tt>pbuilder</tt>, <tt>debootstrap</tt>, <tt>fakeroot</tt>, <tt>svn-buildpackage</tt>,
+  <tt>cdbs</tt>, <tt>quilt</tt>.
+</p>
+</li>
+<li>
+<p>
+Set the correct variables in pdebuild.conf:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+<em>$BASEDIR</em> (repository root) ;
+</p>
+</li>
+<li>
+<p>
+<em>$DESKTOPDIR</em>, <em>$GOODIESDIR</em> (path to desktop and goodies packages,
+     useful when playing with branches) ;
+</p>
+</li>
+<li>
+<p>
+<em>$DISTRIBUTION</em> and <em>$ARCH</em> to match the target you want ;
+</p>
+</li>
+<li>
+<p>
+<em>$MIRRORSITE</em> to use your favorite mirror.
+</p>
+</li>
+</ul></div>
+</li>
+<li>
+<p>
+Make sure you have already been in the parent directory and run:
+        <tt>./get-sources.pl desktop &amp;&amp; ./get-sources.pl goodies</tt>
+  to grab both goodies and desktop original tarballs.
+</p>
+</li>
+<li>
+<p>
+Run <tt>./pdebuild-sources.sh</tt> desktop and then
+  <tt>./pdebuild-sources.sh goodies</tt>.
+</p>
+</li>
+<li>
+<p>
+Cross your fingers.
+</p>
+</li>
+</ol></div>
+</div>
+<h2 id="_general_maintainance">2. General maintainance</h2>
+<div class="sectionbody">
+<div class="listingblock">
+<div class="title">clean cache and built packages</div>
+<div class="content">
+<pre><tt>./pdebuild-source.sh clean</tt></pre>
+</div></div>
+<div class="listingblock">
+<div class="title">update pbuilder chroot</div>
+<div class="content">
+<pre><tt>./pdebuild-source update</tt></pre>
+</div></div>
+<div class="listingblock">
+<div class="title">build only one package (or a set of packages)</div>
+<div class="content">
+<pre><tt>./pdebuild-source.sh &lt;desktop|goodies&gt; &lt;package&gt; [&lt;package&gt;, &lt;package&gt;]</tt></pre>
+</div></div>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">If the package already exist but you want to rebuild it, remove
+<tt>xfce/build/&lt;name&gt;_&lt;version&gt;_&lt;arch&gt;.changes</tt> and run <tt>pdebuild-sources.sh</tt>
+again.</td>
+</tr></table>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Last updated 2009-05-05 08:27:19 CEST
+</div>
+</div>
+</body>
+</html>


Property changes on: scripts/pbuilder/README.html
___________________________________________________________________
Added: svn:keywords
   + Id Rev Url Author Date




More information about the Pkg-xfce-commits mailing list