/srv/irclogs.ubuntu.com/2010/11/24/#ubuntu-classroom.txt

=== ChanServ changed the topic of #ubuntu-classroom to: Welcome to the Ubuntu Classroom - https://wiki.ubuntu.com/Classroom || Support in #ubuntu || Upcoming Schedule: http://is.gd/8rtIi || Questions in #ubuntu-classroom-chat || Event: Packaging Training Session - Current Session: Packaging Alley-oop -- Getting your package into Ubuntu through Debian - Instructors: paultag
paultagWell, it's 7:00 on the spot over here. Radical.00:01
ClassBotLogs for this session will be available at http://irclogs.ubuntu.com/2010/11/24/%23ubuntu-classroom.html following the conclusion of the session.00:01
paultagFirst of all, I'd really like to say that I'm sorry to everyone that showed up to the last two times I've missed this session00:01
paultagthe first time I was just plain confused, and the second time I was asleep. Anywho, that's all behind us now :)00:02
paultagI'd like for this to be Q-A styled, so please butt in at any point, I should get back to questions quickly. I'm going to start going over the basics, and depending on where people want "more", I'll change it up on the fly. No script here, so I'm pretty flexible with that stuff00:03
paultagif my Internet goes down, I'll find a way to get back online. It's been a bit sketchy all day, so sorry in advance if I lag out ( not that I'm expecting to )00:03
paultagNo questions so far, I trust?00:03
paultagbueller... bueller... Good.00:04
paultagSo, my session today is about how to get a package into Ubuntu through Debian ( how most packages should be included in Ubuntu )00:04
paultagYes, you can add packages directly to Ubuntu via REVU, but this only makes sense if Debian has no use at all for the package. If you've packaged up something nice, why not share!00:05
paultagSince we pull from Debian anyway, it only makes sense to push stuff to Debian, and not have Debian pull from us ( it will get messy if that starts )00:05
paultagExceptions are branding and settings packages, but even that can be included in Debian, with only a few minor changes to the build scripts, the source file can produce a totally different binary depending on what distro did the build00:06
paultagI've done this for Fluxbox -- the Default theme should be the Ubuntu theme for Ubuntu and the Debian theme for Debian, so it checks the vendor, and changes that flag depending :)00:07
paultagin short, most packages should be going through Debian00:07
paultagSo, let's go through the processes. The first think you need to do is be a moderate to heavy user of some bit of software that is not in the repos00:08
paultagif you don't care about the software, it gets hard to maintain. Bug reports no longer matter to you, and there is no investment00:08
paultagI'm taking about it's a real pain if it's not on the system type of user00:08
paultagNext, you need to identify why it's not in the repos. If the software has license issues, or something funny with releases, chances are it's not included for a reason00:09
paultagif it's because no one has ever attempted it before, you'00:09
paultagyou're in luck!*00:09
paultagThe first step is to file something called an ITP ( Intent to Package )00:10
paultagThe first step is to install the tool 'reportbug`00:10
paultagreportbug will allow you to do everything you need to, without having to think twice.00:10
paultagYou can find more on this process here -- http://www.debian.org/devel/wnpp/00:11
paultagFiling an ITP is a critical part of this process, and is really the first think you need to do00:11
paultagBecause, after all, if someone else decides to package the software into Debian, you can't both upload the same package ( so it only makes sense to track it via the bug tracker )00:12
paultagIt also follows that you should always check the BTS ( Bug Tracking System ) for an ITP on the bit of software you're working on before you start work00:12
paultagHere's an example ITP bug. I filed this for the last package I got into Debian -- http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=60094400:13
ubot2Debian bug 600944 in wnpp "ITP: fbautostart - XDG compliant autostarting app for Fluxbox" [Normal,Fixed]00:13
paultagthanks, ubot2 :)00:13
paultagYou give a close directive in the changelog on the first upload ( lintian will ensure this ) that will close out the bug you've created00:14
paultagNow, what do you do in the event that an ITP exists already?00:14
paultagWell, this is actually pretty common. People tend to be super-motivated and file the bug, but never actually follow through with the processes. Really a shame.00:15
paultagIf you find an ITP, check the date. If it's been a "while" ( a while can mean a few different things, depending on the package ), send mail to the ITP and query it's status00:15
paultag( don't forget to offer up support )00:15
paultagJust a simple "Hey, how is this going? Anything I can help with, i see it's been a while" sort of email will do wonders.00:16
paultagIf you get an email saying that they're actively working on it, it might be time to find other software. If they note that they are no longer working on it, you're in luck!00:16
paultagYou should change the owner of the bug and start work right-off. I've seen ITPs go through a few hands before they've been processed all the way through00:17
paultagIf you do not get an email back, wait a "while" ( again, use your best judgment here ), then take over work on the bug ( by re-assigning it, and noting that on the report )00:18
paultaga few weeks is usually best00:18
paultagQuestions before I move on?00:18
paultagRighto, I'll be moving on00:21
paultagNow comes the fun stuff. You need to actually package up the application00:21
paultagThis *must* be done to the most strict standards that are in place00:21
paultagmake sure everything is as neat and minimal as you can, and check all .dsc and .deb files with 'lintian --pedantic -iIE`00:22
paultag-i will give you super-verbose error messages00:22
paultag-I will give you Informational messages, they can be quite helpful00:23
paultag-E will give you experimental messages, these are usually not tested well and can be quite buggy00:23
paultagthere is no reason not to see them, though, and you should fix these errors00:23
paultag--pedantic tags are the most picky errors00:24
paultagPedantic literally means "Of or like a pedant"00:24
paultagit's a way of saying that they're formal and minute, but suited for teaching00:24
paultagI could not think of a better word for these messages myself. You should really fix any pedantic issues with your package, after all, you are learning best practice!00:25
paultagit's really good to get all these errors, it would be a shame if a package was denied based on errors that you did not even see, so please use these arguments! :)00:26
paultagQuestions on why you should be using uber strict Lintian messages?00:26
paultagWell OK then, moving on! :)00:27
paultagNext, you should be sure to fix any and all known issues with the software the can make it unfit for release.00:28
paultagAny bugs that cause crashes of the system, or of it's self are serious problems, and should be resolved. If you know about these, please fix it before you consider asking for an upload00:28
paultagBuggy code is no good to anyone!00:29
paultagYou should do this according to DEP3, debsrc 3, and quilt00:29
paultagDEP3 ensures that there is lots of meta-data on the patch. This makes it easy to digest patches in the ecosystem in a computer-full way00:30
paultagand as well all know, fewer man-hours is always better :)00:30
paultag( more computer-hours is great, on the other hand )00:30
paultagusing deb source format 3 and quilt is less critical, but still something that should be done00:31
paultagsource 3 is a big improvement, and quilt allows patch management to make sense again00:31
paultagNew packages should really adhear to this. Another standard ( abet not for patches ) is DEP5. DEP5 relates to the copyright, and you might as well fix it while you're in there00:32
paultagNext, after your package is in perfect shape ( all files are correct, you have DEP3'd patches, DEP5'd copyright, quilt, debsrc3 and no lintian errors ), you should upload your package to mentors.debian.org00:34
paultagsorry! .net!00:35
paultagHere's the URL -- http://mentors.debian.net/cgi-bin/welcome00:35
paultagPutting your package here allows you to upload your source to a common network, where it makes sense to have mentors pull from00:36
paultagthis also allows a note-type system, where mentors may leave feedback on the state of the package00:36
paultagIf you have a mentor you're working with already, you should get him or her to review the package, and consider it for upload ( or at the least, get comments and feedback on the state of the package )00:37
paultagAfter all, lintian is no replacement for a real debian developer :)00:37
paultagIf you don't have a mentor who'd consider uploading the new package, it's time to send out an RFS00:38
paultagHere's an example: http://lists.debian.org/debian-mentors/2010/11/msg00012.html00:39
paultagThe template for this mail will be shown to you on mentors.debian.net, and should not be too hard to follow00:39
paultagdebian-mentors can be quite harsh, so please, keep your head down00:39
paultagdo what they say, and listen to feedback. They have no CoC in Debian, and only a handful of @debian.org folks hang out there ( *@debian.org tend to be very nice, actually, it's the new package hackers and the old users that take pride in being tough to work with )00:40
paultagOh --- and don't say something's lintian clean if it's not ;)00:41
paultagthat will only anger the collective ;)00:41
paultagQuestions on this?00:42
paultagRighto. So, now that your package is uploaded and life can move on, it's time to prepare for the next phase :)00:43
paultagThis is where it gets fun -- you're now going to be the one who has to deal with bug reports and build failures00:44
paultagYou should subscribe to your own package ( just for kicks, via the PTS ), and check in with bugs.debian often ( http://bugs.debian.org/cgi-bin/pkgreport.cgi?package=my-package-name )00:44
paultagYou should also watch out for build failures on arches that are not your own ( such as SPARC, PPC, x86-64 ( or just x86 ), and so on )00:45
paultagDebian is the universal operating system, so be ready for that. There are lots of exotic failures that cause a FTBFS ( Failure to build from source )00:46
paultagsometimes, it's your fault ( patches, build system ), and other times it's not ( if the upstream code is not your own )00:46
paultagif the problem is not yours, please forward the bug rather then let it sit00:47
paultagWell, now that you know all this, it's been about 6 months and the next Ubuntu release is gearing up for a release00:47
paultagUbuntu runs a sync with Debian for a bit under 1/2 of the cycle ( 2.5 months ), and this will catch your new package. Congrats! You've just contributed to Ubuntu while you were watching that *illlarious* movie on the couch, afk. It's a wonder!00:48
paultagSince the package is now in Ubuntu, you should watch out for apport bugs, and launchpad bugs. It's not your duty, but it'd be lame if you did not help out at all00:48
paultagRemember to also keep an eye upstream, and always package new releases for Debian ( and Ubuntu! )00:49
paultagbeing an active maintainer comes with the turf, so be sure you have the time to care for your new baby :)00:49
paultag<UndiFineD> QUESTION: how is going to coƶperate with the future of USC (11.04+) where almost everything is from PPA00:50
paultagPPAs are almost totally unofficial. PPAs are very informal, and inherently not part of Ubuntu. They are "addons", "third party"00:50
ClassBotThere are 10 minutes remaining in the current session.00:51
paultagYou are able to migrate builds from a PPA to Ubuntu Main, no problem, but again this is a lot of work, and can cause issues ( such as maintaining it in two distros ( debian and ubuntu ) )00:51
paultagPPAs are also never going to be included in the default install, so users may select this software, but it's by no means part of the Ubuntu software collective ( or Debian )00:51
paultagUndiFineD, does that answer the question to your satisfaction?00:52
paultagDebian also has lots of great tools for when you manage more then one package, it'd be a shame to miss out on that ;)00:52
paultagI'd also consider work in Debian to be work with Ubuntu -- don't think that work with Debian will hurt your progress with the MOTU, it can only help00:53
paultagDebian ( counting all of it's spin-offs as well ) has the biggest share of the GNU/Linux market, and contributions in Debian are hard-hitting in the F/OSS world00:54
paultagso it's great karma in general00:54
paultagOK, well that's about all I thought about talking with :)00:55
paultagI'd be happy to take questions in the last 6 minutes or so00:55
ClassBotThere are 5 minutes remaining in the current session.00:56
paultagAlrighty, calling that a wrap00:59
paultagOne love, ya'll, thanks so much00:59
ClassBotLogs for this session will be available at http://irclogs.ubuntu.com/2010/11/24/%23ubuntu-classroom.html01:01
=== ChanServ changed the topic of #ubuntu-classroom to: Welcome to the Ubuntu Classroom - https://wiki.ubuntu.com/Classroom || Support in #ubuntu || Upcoming Schedule: http://is.gd/8rtIi || Questions in #ubuntu-classroom-chat ||
c2tarunthere was a training session at 5:30 is it over??02:05
UndiFineD<ClassBot> Logs for this session will be available at http://irclogs.ubuntu.com/2010/11/24/%23ubuntu-classroom.html02:27
=== zkriesse is now known as Commander_Picard
=== Commander_Picard is now known as zkriesse
=== apachelogger is now known as releaselogger
=== marrusl is now known as marrusl_afk
=== ikonia_ is now known as ikonia
=== releaselogger is now known as apachelogger
=== apachelogger is now known as bloglogger
=== SuperHark is now known as MichealH
=== bloglogger is now known as apachelogger
erjet_Hey, hello everybody !! :) whats up ?21:48
erjet_how are you doing??, am new here i just installed this aplication, i dont know how it works this thingi.. is there any help some one can give? :)21:48
nhandlererjet_: You might want to try #ubuntu for support21:49
zkriesseerjet: what is "Thingi"21:51
erjet_means : "thing" just a verbal extantion :D :)21:52
erjet_by the way is there a way i can install utorrent and internet download manager on ubuntu? can u help :)21:53
AlanBellerjet_: what country are you in erjet_ ?21:53
AlanBellok, Albania21:53
AlanBell!al21:54
ubot2Factoid 'al' not found21:54
AlanBellhmm one sec I will go find it21:54
AlanBellhttp://loco.ubuntu.com/teams/albania21:54
AlanBellhmm, no IRC channel specified21:54
AlanBellhttps://launchpad.net/~albania21:55
AlanBellerjet: seems that your team are mostly forum users http://ubuntuforums.org/forumdisplay.php?f=37221:56

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!