r13530 - in /www/src: 10.status.en.page 20.status.en.page 20.svn.en.page 30.packaging.en.page 30.svn.en.page 40.committing.en.page 40.packaging.en.page 50.committing.en.page 50.releasing.en.page 60.info.en.page 60.releasing.en.page default.css
brad-guest at users.alioth.debian.org
brad-guest at users.alioth.debian.org
Thu Nov 22 17:46:47 UTC 2007
Author: brad-guest
Date: Thu Nov 22 17:46:47 2007
New Revision: 13530
URL: http://svn.debian.org/wsvn/pkg-gnome/?sc=1&rev=13530
Log:
Adds more content to website
Added:
www/src/10.status.en.page
www/src/20.svn.en.page
www/src/30.packaging.en.page
www/src/40.committing.en.page
www/src/50.releasing.en.page
www/src/60.info.en.page
Removed:
www/src/20.status.en.page
www/src/30.svn.en.page
www/src/40.packaging.en.page
www/src/50.committing.en.page
www/src/60.releasing.en.page
Modified:
www/src/default.css
Added: www/src/10.status.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/10.status.en.page?rev=13530&op=file
==============================================================================
--- www/src/10.status.en.page (added)
+++ www/src/10.status.en.page Thu Nov 22 17:46:47 2007
@@ -1,0 +1,17 @@
+---
+title: Package Status
+inMenu: true
+---
+
+h2. Package Status
+
+http://jhdebuild.0d.be/packages.html lists (or used to list) upstream
+GNOME packages, along with their Debian maintainer, whether they are
+maintained by pkg-gnome, etc.
+
+http://www.0d.be/debian/debian-gnome-2.20-status.html lists all of pkg-gnome's
+packages of GNOME 2.20, indicates whether they have been supersceded by new
+upstream releases, etc.
+
+http://www.0d.be/debian/debian-gnome-2.18-status.html does the same for GNOME
+2.18, and http://www.0d.be/debian/debian-gnome-2.16-status.html for GNOME 2.16.
Added: www/src/20.svn.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/20.svn.en.page?rev=13530&op=file
==============================================================================
--- www/src/20.svn.en.page (added)
+++ www/src/20.svn.en.page Thu Nov 22 17:46:47 2007
@@ -1,0 +1,72 @@
+---
+title: Using Subversion
+inMenu: true
+---
+h2. Using the SVN repository
+
+The source for pkg-gnome's packages is managed with the
+"Subversion":http://subversion.tigris.org/ version control system.
+
+If you need general help with Subversion, check out the online book
+"Version control with Subversion":http://svnbook.red-bean.com/.
+
+h3. The pkg-gnome repository
+
+The pkg-gnome repository is accessible via:
+<pre><code>Read-only:
+ svn://svn.debian.org/svn/pkg-gnome/
+Read-Write: (You must be a member of the pkg-gnome team on alioth)
+ svn+ssh://svn.debian.org/svn/pkg-gnome/</code></pre>
+
+The repository can be browsed with a web browser at http://svn.debian.org/wsvn/pkg-gnome/
+
+h4. Structure of the repository
+
+<pre><code>pkg-gnome
++-- desktop
+ +-- unstable
+ +-- gnome-foo
+ +-- gnome-bar
+ +-- experimental
+ +-- gnome-foo
+ +-- gnome-bar
++-- packages
+ +-- unstable
+ +-- gnome-baz
+ +-- gnome-qux
+ +-- experimental
+ +-- gnome-baz
+ +-- gnome-qux
++-- www
+ +-- ...</code></pre>
+
+Officially-blessed modules (desktop, platform, bindings and the admin tools)
+live in @/desktop at . Packages that are not part of an official GNOME release
+live in @/packages at .
+
+**Currently a new structure is being discussed, so this may change soon!**
+
+h3. Checking out
+
+Here we are using
+"epiphany-browser":http://packages.debian.org/epiphany-browser/ as an example
+of a package that we want to make changes to.
+
+First of all, create an area for you to do your work in:
+
+ mkdir -p ~/src/pkg-gnome
+ cd ~/src/pkg-gnome
+
+If you are not going to commit to the repository yourself, but instead send a
+patch to the pkg-gnome team:
+
+ svn checkout svn://svn.debian.org/svn/pkg-gnome/desktop/unstable/epiphany-browser
+
+If you have been granted commit access to the repostory:
+
+ svn checkout svn+ssh://svn.debian.org/svn/pkg-gnome/desktop/unstable/epiphany-browser
+
+You will now have an @epiphany-browser@ directory that is empty except for a
+single @debian@ directory. This is normal!
+
+p>. "Next: Packaging >>":./packaging.html
Added: www/src/30.packaging.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/30.packaging.en.page?rev=13530&op=file
==============================================================================
--- www/src/30.packaging.en.page (added)
+++ www/src/30.packaging.en.page Thu Nov 22 17:46:47 2007
@@ -1,0 +1,85 @@
+---
+title: Packaging
+inMenu: true
+---
+h2. Packaging
+
+Now that we have our package checked out we can start make changes to it.
+
+Say epiphany-browser had been orphaned and we were adopting it, then we
+would add ourselves as the maintainer in the debian/control.in file, (The
+debian/control file is automatically generated from this in the clean rule)
+
+<pre><code>Source: epiphany-browser
+Section: gnome
+Priority: optional
+Maintainer: Your Name <your at email.address>
+Uploaders: @GNOME_TEAM@
+...</code></pre>
+
+Now that you have done this you may want to make sure the debian/control
+file is regenerated, you can do this by running:
+
+<pre><code>fakeroot debian/rules clean</code></pre>
+
+Then you will want to add an entry to the changelog.
+If you have not used @debchange@ (@dch@) before, put the following in your
+@~/.devscripts@ config file:
+
+<pre><code>DEBCHANGE_RELEASE_HEURISTIC=changelog</code></pre>
+
+You can change the editor it uses by setting the @EDITOR@ environment
+variable. There are several different circumstances in which you'll want to
+change the changelog:
+
+<pre><code># Increase the Debian release number, adding a new changelog entry
+ dch -i
+# Append a new entry to the current changelog
+ dch -a
+# Don't change version number or add a new changelog entry,
+# just update the changelog's stamp and open up an editor
+ dch -e</pre></code>
+
+So say we wanted to increase the debian release version, we would do the following inside the epiphany-browser directory we had just checked out:
+
+<pre><code>dch -i</code></pre>
+
+We would then be given the following:
+
+<pre><code>epiphany-browser (2.20.1-4) UNRELEASED; urgency=low
+
+ *
+
+ -- Your Name <your at email.address> Thu, 22 Nov 2007 17:01:00 +0000
+
++-- 7 lines: epiphany-browser (2.20.1-3) unstable; urgency=low -- Other Person
++--...</code></pre>
+
+We can then add an entry saying that the package has a new maintainer:
+
+<pre><code>epiphany-browser (2.20.1-4) UNRELEASED; urgency=low
+
+ * New Maintainer. Closes: #NNNNNN
+
+ -- Your Name <your at email.address> Thu, 22 Nov 2007 17:01:00 +0000
+
++-- 7 lines: epiphany-browser (2.20.1-3) unstable; urgency=low -- Other Person
++--...</code></pre>
+
+You will probably also want to check that the package still builds,
+and that you haven't broken anything. Firstly you need to obtain the
+original tarball and put it in the ../tarballs directory.
+
+<pre><code>cd ..
+mkdir tarballs
+cd tarballs
+wget http://http://ftp.de.debian.org/debian/pool/main/e/epiphany-browser/epiphany-browser_2.20.1.orig.tar.gz
+cd ../epiphany-browser</code></pre>
+
+Once you have done this you can build the package using:
+
+<pre><code>svn-buildpackage --svn-lintian --svn-ignore-new</code></pre>
+
+The resulting package with then be located in ../build-area/
+
+p>. "Next: Committing >>":./committing.html
Added: www/src/40.committing.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/40.committing.en.page?rev=13530&op=file
==============================================================================
--- www/src/40.committing.en.page (added)
+++ www/src/40.committing.en.page Thu Nov 22 17:46:47 2007
@@ -1,0 +1,29 @@
+---
+title: Committing your work
+inMenu: true
+---
+
+h2. Committing
+
+After you have finished your changes, it is time to save your work back to
+pkg-gnome's Subversion repository.
+
+h3. If you have commit access
+
+It is time to commit! For this we use the @debcommit@ command from the
+"@devscripts@":http://packages.debian.org/devscripts package. It will
+generate a commit message based on the entries you just added to
+ at debian/changelog@, and then commit your changes.
+
+If you are on the IRC channel, you will notice that the CIA bot blurts out a
+summary of your commit. The full changes will also be mailed to the
+"pkg-gnome-commits":http://lists.alioth.debian.org/mailman/listinfo/pkg-gnome-commits
+mailing list.
+
+h3. If you don't have commit access
+
+Not a problem! Run @svn diff@ to have subversion output your changes in
+patch format. Please mail the output to the bug tracking system so that it
+can be reviewed and incorporated.
+
+p>. "Next: Releasing >>":./releasing.html
Added: www/src/50.releasing.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/50.releasing.en.page?rev=13530&op=file
==============================================================================
--- www/src/50.releasing.en.page (added)
+++ www/src/50.releasing.en.page Thu Nov 22 17:46:47 2007
@@ -1,0 +1,15 @@
+---
+title: Releasing
+inMenu: true
+---
+
+h2. Releasing
+
+To release use the following:
+
+<pre><code>dch -r # Changes the distribution from UNRELEASED to unstable
+debcommit -r # Releases the package and creates a tag</pre></code>
+
+**<i>Can someone please comfirm this is right?</i>**
+
+p>. "Next: General Info >>":./info.html
Added: www/src/60.info.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/60.info.en.page?rev=13530&op=file
==============================================================================
--- www/src/60.info.en.page (added)
+++ www/src/60.info.en.page Thu Nov 22 17:46:47 2007
@@ -1,0 +1,22 @@
+---
+title: General Info
+inMenu: true
+---
+h2. General Info
+
+Tools used for building packages:
+
+ * svn-buildpackage
+ * quilt
+ * cdbs
+ * gnome-pkg-tools
+
+Packaging guides and policies:
+
+ * "Debian New Maintainers' Guide":www.debian.org/doc/maint-guide/
+ * "Debian Policy Manual":www.debian.org/doc/debian-policy/
+ * "Debian Developer's Reference":www.debian.org/doc/developers-reference/
+ * GNOME policy
+
+For general info about how to use @svn-buildpackage@, see its manual page
+and the contents of @/usr/share/doc/svn-buildpackage/@.
Modified: www/src/default.css
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/default.css?rev=13530&op=diff
==============================================================================
--- www/src/default.css (original)
+++ www/src/default.css Thu Nov 22 17:46:47 2007
@@ -229,3 +229,15 @@
line-height:1.3em;
margin:0;
}
+
+pre {
+ border-top:1px solid #d8d8d8;
+ border-right:1px solid #d8d8d8;
+ border-bottom:1px solid #d8d8d8;
+ border-left:4px solid #cccccc;
+ margin:16px;
+ padding:7px 7px 7px 11px;
+ background:#f4f4f4 url(images/menubg.gif) bottom left repeat-x;
+ color:#505050;
+ overflow: auto;
+}
More information about the pkg-gnome-commits
mailing list