r62468 - in /website/docs/pkg-perl-for-users: ./ Makefile debian-swirl.png pkg-perl-for-users.tex
diocles at users.alioth.debian.org
diocles at users.alioth.debian.org
Sat Sep 11 10:45:19 UTC 2010
Author: diocles
Date: Sat Sep 11 10:44:55 2010
New Revision: 62468
URL: http://svn.debian.org/wsvn/?sc=1&rev=62468
Log:
Add pkg-perl-for-users slides
Added:
website/docs/pkg-perl-for-users/
website/docs/pkg-perl-for-users/Makefile
website/docs/pkg-perl-for-users/debian-swirl.png (with props)
website/docs/pkg-perl-for-users/pkg-perl-for-users.tex
Added: website/docs/pkg-perl-for-users/Makefile
URL: http://svn.debian.org/wsvn/website/docs/pkg-perl-for-users/Makefile?rev=62468&op=file
==============================================================================
--- website/docs/pkg-perl-for-users/Makefile (added)
+++ website/docs/pkg-perl-for-users/Makefile Sat Sep 11 10:44:55 2010
@@ -1,0 +1,19 @@
+BASENAME = pkg-perl-for-users
+READER = evince
+
+all: show
+
+clean:
+ rm -f $(BASENAME).{aux,log,nav,out,pdf,snm,toc,vrb}
+
+build: clean
+ # Run it twice, as otherwise the .nav file won't be there, and no
+ # index will be made
+ pdflatex $(BASENAME).tex
+ pdflatex $(BASENAME).tex
+
+show: build justshow
+
+justshow:
+ $(READER) $(BASENAME).pdf
+
Added: website/docs/pkg-perl-for-users/debian-swirl.png
URL: http://svn.debian.org/wsvn/website/docs/pkg-perl-for-users/debian-swirl.png?rev=62468&op=file
==============================================================================
Binary file - no diff available.
Propchange: website/docs/pkg-perl-for-users/debian-swirl.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: website/docs/pkg-perl-for-users/pkg-perl-for-users.tex
URL: http://svn.debian.org/wsvn/website/docs/pkg-perl-for-users/pkg-perl-for-users.tex?rev=62468&op=file
==============================================================================
--- website/docs/pkg-perl-for-users/pkg-perl-for-users.tex (added)
+++ website/docs/pkg-perl-for-users/pkg-perl-for-users.tex Sat Sep 11 10:44:55 2010
@@ -1,0 +1,205 @@
+\documentclass{beamer}
+
+\usepackage{hyperref}
+
+\newcommand{\email}[1]
+{$<$\href{mailto:#1}{\nolinkurl{#1}}$>$}
+
+\title[pkg-perl for users]{Getting Perl modules into Debian}
+\subtitle{Debian's Perl team from an end-user perspective}
+\author{Tim Retout}
+\date{11th September 2010\\HantsLUG @ IBM Hursley}
+
+\pgfdeclareimage[height=2cm]{debian-logo}{debian-swirl}
+\logo{\pgfuseimage{debian-logo}}
+
+\usetheme{Warsaw}
+%\usecolortheme{crane}
+
+\begin{document}
+
+\frame{\titlepage}
+
+\frame
+{
+ \frametitle{What is the Debian Perl team?}
+
+ \begin{itemize}
+ \item Maintain almost 1700 perl packages within Debian
+ \item Both official Debian Developers and sponsees
+ \item Around 70-80 committers,\footnote{\url{http://www.ohloh.net/p/pkg-perl}} but most activity from a small core team
+ \item Also indirectly contributes most of the Perl packages in
+ Debian's derivatives (e.g. Ubuntu).
+ \end{itemize}
+
+
+}
+
+\frame
+{
+ \frametitle{Using Perl on Debian}
+
+ How do you install Perl modules?
+
+ \begin{itemize}
+ \item ``apt-get install libfoo-perl''
+ \item Backports for older releases
+ \item cpan for unpackaged modules
+ \end{itemize}
+
+ CPAN (the tool) is configured to play nicely with Debian packages,
+ but does not install packages when satisfying dependencies.
+}
+
+\frame
+{
+ \frametitle{When a module isn't packaged}
+
+ If the Perl module you need is not available, you have several options:
+
+ \begin{enumerate}
+ \item Install it with CPAN, and handle future upgrades yourself.
+ \item File an RFP (Request for package) bug in Debian.\footnote{\url{http://pkg-perl.alioth.debian.org/howto/RFP.html}}
+ \item Get involved and package it yourself!
+ \end{enumerate}
+
+ Getting involved is easier than you think.
+}
+
+\frame
+{
+ \frametitle{Getting involved - tools}
+
+ The Perl team uses tools to speed up packaging.
+
+ \begin{itemize}
+ \item alioth.debian.org for team management
+ \item SVN for most packages, but a few are stored in git
+ \item \url{http://bugs.debian.org/}
+ \item Package Entropy Tracker (PET)
+ \item IRC (\#debian-perl on OFTC)
+ \item Two mailing lists - one for discussion, one to receive
+ automated messages
+ \end{itemize}
+
+ \url{http://pkg-perl.alioth.debian.org/} links to all of these.
+}
+
+\frame
+{
+ \frametitle{Getting involved - joining the team}
+
+ \begin{itemize}
+ \item Create an alioth account
+ \item Apply to join the pkg-perl group on alioth
+ \item Introduce yourself on the debian-perl mailing list
+ \item Use IRC for realtime communication
+ \end{itemize}
+
+ \url{http://wiki.debian.org/Teams/DebianPerlGroup}
+}
+
+\frame
+{
+ \frametitle{Creating a package - dh-make-perl}
+
+ dh-make-perl can jump-start creating a new Perl package.
+
+ \begin{itemize}
+ \item {\tt apt-get install dh-make-perl} and read the man page.
+ \item Download the CPAN tarball you wish to work on.
+ \item Unpack it, and run {\tt dh-make-perl --pkg-perl}.
+ \item Then run {\tt debuild} and hack until it builds.
+ \end{itemize}
+
+ If you don't want to contribute it to Debian, you could stop here.
+}
+
+\frame
+{
+ \frametitle{Creating a package - svn-buildpackage}
+
+ Once you have an initial package, you can upload to SVN. pkg-perl
+ uses a fairly complex SVN layout.\footnote{\url{http://pkg-perl.alioth.debian.org/subversion.html}}
+
+ \begin{itemize}
+ \item Use {\tt svn-inject} to inject new packages
+ \item {\tt svn-buildpackage} for building
+ \item {\tt svn-upgrade} for upstream upgrades
+ \end{itemize}
+
+ Set the suite to `UNRELEASED' in debian/changelog for now.
+
+ Commits are logged to IRC.
+}
+
+\frame
+{
+ \frametitle{Creating a package - cowbuilder}
+
+ One of the more tricky parts of packaging is getting the build
+ dependencies correct. cowbuilder is a tool for building packages in
+ a clean chroot:
+
+ \begin{itemize}
+ \item {\tt sudo apt-get install cowbuilder}
+ \item {\tt sudo cowbuilder --create}
+ \item {\tt sudo cowbuilder --build libfoo-perl\_1.0-1.dsc}
+ \item Can also integrate it into svn-buildpackage.
+ \end{itemize}
+
+ Check the test suite gets run!
+}
+
+\frame
+{
+ \frametitle{Creating a package - lintian}
+
+ We want Debian packages to be of high quality. lintian is a tool
+ that can check for common problems.
+
+ \begin{itemize}
+ \item {\tt sudo apt-get install lintian}
+ \item {\tt lintian -iI --pedantic libfoo-perl\_1.0-1\_amd64.changes}
+ \item Can also integrate it with debuild/cowbuilder
+ \end{itemize}
+}
+
+\frame
+{
+ \frametitle{Creating a package - getting feedback}
+
+ Once you think your package is ready for review, mark it as such:
+
+ \begin{itemize}
+ \item dch -r
+ \item (or `s/UNRELEASED/unstable/' in debian/changelog)
+ \item svn commit -m `dch -r; ready for review'
+ \end{itemize}
+
+ The package status will be changed automatically in PET.
+}
+
+\frame
+{
+ \frametitle{Creating a package - what next?}
+
+ \begin{itemize}
+ \item You are likely to get feedback on IRC.
+ \item Sometimes TODO lists are left for you in debian/changelog by the
+ reviewer, with the suite set back to UNRELEASED.
+ \item Once the reviewer is happy, they will upload the package and
+ tag the release in SVN.
+ \end{itemize}
+}
+
+\frame
+{
+ \frametitle{Questions?}
+
+ \begin{center}
+ \email{diocles at debian.org}
+ \end{center}
+}
+
+\end{document}
More information about the Pkg-perl-cvs-commits
mailing list