/srv/irclogs.ubuntu.com/2005/12/10/#ubuntu-doc.txt

=== LaserJock [n=LaserJoc@ppp-69-227-157-8.dsl.renocs.pacbell.net] has joined #ubuntu-doc
=== theCore [n=ubuntu@Toronto-HSE-ppp3714657.sympatico.ca] has joined #ubuntu-doc
theCoreLaserJock: ping01:25
LaserJocktheCore: hi01:28
theCoreLaserJock: i build my first package !01:28
LaserJocktheCore: nice01:28
theCoreLaserJock: it was quite easy dh_make01:29
theCoreLaserJock: how i know how to make the guide01:29
theCoreLaserJock: first we will need to introduce the reader howto build packages from source01:31
theCoreLaserJock: just a quick review01:31
theCoreLaserJock: after we put a basic tutorial, that walkthrough the reader01:32
LaserJocktheCore: I've been thinking. Maybe we should start from scratch.01:32
theCoreLaserJock: maybe ... 01:32
theCoreLaserJock: but I think we need catch the reader with something concret01:33
LaserJocktheCore: I'm going to throw a quick outline together of what I'm thinking and put it on a wiki page01:33
theCoreLaserJock: ok01:33
LaserJocktheCore: check out https://wiki.ubuntu.com/UbuntuPackagingGuide/Outline01:41
theCoreLaserJock: "Scope of guide" is quite the same of "Target Audience", isn't it ?01:45
LaserJocktheCore: yeah pretty much01:46
LaserJocktheCore: but its' a pretty rough outline ;-)01:47
theCoreLaserJock: i know ;)01:47
theCoreLaserJock: does Ubuntu has a list of orphaned packages ?01:54
LaserJocktheCore: I don't really think there is any such thing in Ubuntu. At least for Universe packages the team as a whole is the maintainer01:55
=== bshumate [n=bshumate@adsl-210-97-250.clt.bellsouth.net] has joined #ubuntu-doc
theCoreLaserJock: i made somes changes02:27
LaserJockok, I will be away for a bit. I'll be back a little later though.02:28
theCoreme too, cya later02:28
LaserJocktheCore: well, hmmm. I think we need to work through these. I don't want to seem critical but I was trying to get away from the DNMG but the changes you made kinda seem like it turns it into that.02:32
=== poningru [n=poningru@n128-227-82-53.xlate.ufl.edu] has joined #ubuntu-doc
=== poningru [n=poningru@n128-227-82-53.xlate.ufl.edu] has joined #ubuntu-doc
=== jsgotangco [n=jsg@ubuntu/member/jsgotangco] has joined #ubuntu-doc
theCoreLaserJock: im back03:36
LaserJocktheCore: now II'm back :-)03:57
theCorenice03:57
theCoreLaserJock, i think we try to make the Packaging guide both a introduction and a refrence guide04:00
theCore*reference04:01
theCoreLaserJock, in what way you want to get away from DNMG ?04:03
LaserJocktheCore: well, I would like to start getting into examples earlier04:07
theCoreLaserJock, i think so too04:07
theCoreLaserJock, but before getting to the examples, the reader must configure his system propely04:08
LaserJocktheCore: my thought would be that we would only require build-essentials and devscripts to start with. Then as the examples progress will start each example with the programs needed. 04:10
theCoreLaserJock, hmm, then we need to put the require programs as an annexes04:11
theCoreLaserJock, all right then04:11
LaserJocktheCore: no just say at the beginning of each section, "Required programs : ..."04:12
theCoreLaserJock, i see ... 04:12
theCoreLaserJock, good lets make like that04:12
LaserJockthat way the reader doesn't get overwhelmed in figuring out the packages they need to install and what they do before we have even started an example04:13
theCoreLaserJock, good idea04:14
theCoreLaserJock, edit the wiki then04:15
LaserJocktheCore: the other thing is I would like to put most of the stuff you have in "Files under /debian" into the Packaging scenarios. I invision that most of the material will be in that section04:15
theCoreLaserJock, i wanted this section as a reference of all the options of those file04:16
theCoreLaserJock, maybe, we should divide the guide in 2 parts: a tutorial and a reference part04:18
LaserJocktheCore: I was thinking more basic part and advanced part but yeah something like that04:19
theCoreLaserJock, we could divide the tutorial in 2 parts too: basic and adv. ...04:20
LaserJocktheCore: ok, let me edit the wiki a bit and we can go through it again. Thanks for doing this with me. It really helps to have somebody to talk things over with.04:20
theCoreLaserJock, no prob.04:20
theCoreLaserJock, however, there is something with which I stand firmly for:  the user must get no errors04:24
LaserJocktheCore: of course ;-)04:25
theCoreLaserJock, so we need to adapt properly the commands 04:26
LaserJocktheCore: yes and I hope to get lots of proofreading from the MOTU and the core devs.04:26
theCoreLaserJock, me too04:26
theCoreLaserJock, today when i was reading DNMG, I got a gnupg error with dh_make and it's only at the end they shown how to configure it so it works 04:28
LaserJocktheCore: yeah, stuff like that would be good to avoid, although it is an easy mistake to make sometimes04:31
theCoreLaserJock, we need to get to the user a real package to make04:32
theCoreLaserJock, like that we can tweak the guide so the reader go get an obscur error 04:33
theCoreLaserJock, but we will need a set of good packages, so we can show all the typical error and problem to get over with04:34
theCoreLaserJock, so how is it going with the wiki?04:36
LaserJocktheCore: sorry, still working on it. I was trying to help my wife decorate a Christmas tree for a minute.04:37
theCoreLaserJock, lol04:38
LaserJocktheCore: yes, minghua suggested the hello packages. That is what they are designed for04:38
theCoreLaserJock, ok lets go with the hello pkg04:38
theCoreLaserJock, maybe it would be cooler for the reader using a real package04:40
theCoreLaserJock, so at the end he didn't read the guide for nothing04:41
=== Wrightplace2305 [n=Wrightpl@216-15-55-41.c3-0.slvr-ubr2.lnh-slvr.md.cable.rcn.com] has joined #ubuntu-doc
=== Wrightplace2305 [n=Wrightpl@216-15-55-41.c3-0.slvr-ubr2.lnh-slvr.md.cable.rcn.com] has left #ubuntu-doc []
LaserJocktheCore: ok, check it out04:58
LaserJocktheCore: it still needs some work04:58
theCoreLaserJock, okay04:58
theCoreLaserJock, not bad ...05:00
LaserJocktheCore: the thing is that most of the material should be done in the packaging scenarios because that is where the examples will mainly be05:02
theCoreLaserJock, true05:03
LaserJocktheCore: but at this point it is hard to show that on an outline05:03
theCoreLaserJock, why did you put  Binary & Source packages before the walkthrough ?05:03
LaserJocktheCore: because the reader should understand the difference between them I think before they really start getting into it, then you say " This is how you create the source packages"05:04
LaserJockif you say that before they know the difference I think there might be confusion05:05
LaserJockin fact maybe "Tools needed for development" should be after the overview05:06
theCoreLaserJock, okay, can you explain to me what do you consider a source pkg ( are talking about the .tar.{gz,bz2} package ? )05:06
theCoreLaserJock, nah , i don't think so05:07
LaserJocktheCore: the source pkg is the .orig.tar.gz, .dsc, and an optional .diff.gz file05:07
theCoreLaserJock, okay 05:07
LaserJocktheCore: that is what the packager deals with almost exclusively, not the binary packages05:08
theCoreLaserJock, we should add a quick tutorial on how building a package just with the source05:10
LaserJocktheCore: what do you mean exactly?05:10
theCoreLaserJock, building form a tarball05:10
theCorefrom*05:10
LaserJocktheCore: I think that should be covered in the "Packages from scratch" scenario05:11
theCoreLaserJock, or maybe we should put that into the prerequisites05:11
theCoreah okay, i see05:11
LaserJocktheCore: I think the point should be to get the reader to the scenarios as quickly as possible05:12
theCoretrue05:12
LaserJocktheCore: the getting started section should just get everybody on the same page05:13
theCoreLaserJock, i just figured out what you wanna do05:13
theCoreLaserJock, i think so, too05:14
theCoreLaserJock, the scenario idea is nice05:14
=== zenrox [n=zenrox@71.115.198.118] has joined #ubuntu-doc
LaserJocktheCore: I think that is the distinction I'm trying to make with the DNMG 05:15
theCoreLaserJock, and i think it's great way to do it05:15
LaserJocktheCore: well, I hope it will work05:16
=== bhuvan [n=bhuvan@b14.gw.maa.collab.net] has joined #ubuntu-doc
theCoreLaserJock, i think we will need to rebuild the whole DocBook XML file, because the current one is quite crapy05:17
LaserJocktheCore: how so? you mean content or the actual XML?05:17
theCoreLaserJock, both05:18
LaserJocktheCore: I agree. Although I did try to get the first couple of sections tidied up a bit05:18
theCoreLaserJock, i think we will need to rebuild the whole DocBook XML file, because the current one is quite crapy05:18
theCoreoups05:19
theCorewrong key ... :(05:19
theCoreLaserJock, for now, it's just a DocBook convertion of DNMG05:20
LaserJocktheCore: with some wiki thrown in05:20
theCoreand a diagram05:20
LaserJockyep, I mean the original author did quite a bit of work, but I think we need to go with this other approach05:21
theCorei agree05:22
theCoreLaserJock, do we start ?05:25
LaserJocktheCore: yes. I think the first step would be to flesh out that outline a little bit more and get the Getting Started section done. That shouldn't take too long.05:26
theCoreLaserJock, i think we should use the wiki as a development area, and then when we finish a section we could do the DocBook conversion05:28
LaserJocktheCore: yeah, at least until I get commit access to the repo ;-)05:30
theCoreLaserJock, lol05:30
LaserJockHopefully that will be right after Tuesday's CC meeting05:31
theCoreyou are lucky, i would like to get a access too ... but anyway ...05:33
LaserJockkeep on working and you will.05:33
theCoreLaserJock, hmm dh-make as an advance tool ?05:33
theCoreLaserJock, i'm sure about that05:33
LaserJocktheCore: well we will have to see. I just stuck them there for now until we know what we will put in the scenarios05:35
theCorehttp://www.us.debian.org/doc/manuals/maint-guide/ap-pkg-eg.en.html <<<< that was, for me, the most useful part of the DNMG05:36
LaserJocktheCore: right, those kinds of things are what we should be focused on. I was really dissapointed when I read through all the material and then all the good stuff was at the end05:38
theCoreLaserJock, lol, me too05:38
theCoreLaserJock, but me i started reading the guide from the end ;)05:39
theCoreLaserJock, what are the packages we use for the examples ?05:41
theCoreLaserJock, i think we need some concrete examples with real packages05:42
LaserJockhello, hello-dbs, and hello-debhelper are already in Ubuntu05:43
LaserJockwe may need to add others if we need to do more05:43
theCorehello packages are not what i call concrete example ... but they will do the jobs ...05:45
theCoreare they in tar.gz format ?05:45
LaserJocktheCore: why not? they were designed for showing how to package05:46
LaserJocktheCore: they are just like any other package05:46
theCoreLaserJock, i dunno, i wouldn't feel proud building an hello package, i would, more likely, feel dumb05:47
theCorebut that my point of view05:47
MadpilotIsn't "Hello World" the standard first step in programming? why shouldn't it be the first step in package-building? ;)05:47
LaserJocktheCore: take a look at hello05:48
theCoreMadpilot, maybe ... :-/05:48
LaserJockthe worst thing we can do is pick a package that either will change enough that the example will need to get updated often or it won't work anymore, or something that will need a bunch of dependecies05:49
LaserJockthe other thing is that a lot of packages aren't exactly the best examples of packaging05:49
theCoreLaserJock, okay ... i'm conviced ... but i still have some doubts05:51
LaserJocktheCore: well, I admit that the outcome isn't terribly exciting but I think it is better than having readers chase down dependencies05:52
theCoreLaserJock, i really the LinuxFromScratch book and they show tough example05:54
LaserJockI mean it's got postinst and prerm scripts, autotools05:54
theCoreLaserJock, for me, LFS is the best book out on the web to learn linux05:55
theCoreLaserJock, the whole book is one big example05:56
theCoreLaserJock, so maybe we should use their way ...05:58
theCore... mixed with your05:58
LaserJocktheCore: hmm, how would it be different?05:59
theCoretheCore, it's wouldn't have dumb examples06:00
theCoreLaserJock, *06:01
LaserJocktheCore: really though, how dumb is it? Packagers often don't care about what they are packaging they just need to do it06:01
theCoreLaserJock, yea .. maybe 06:02
LaserJocktheCore: well, it might be the easiest starting point, unless you have something better06:03
theCoreLaserJock, ok, lets do it like this then06:04
theCoreLaserJock, now, we really need to concentrate on the Packaging Scenarios, i think it's really a good idea06:05
theCoreLaserJock, those will be existing for the readers06:06
theCoreLaserJock, and enriching too06:07
LaserJockI hope so06:07
=== Liz [n=Liz@static-203-87-81-158.nsw.chariot.net.au] has joined #ubuntu-doc
theCoreLaserJock, so what are you doing right now ?06:29
LaserJocktheCore: looking at your changes ;-)06:30
=== poningru [n=poningru@n128-227-82-53.xlate.ufl.edu] has joined #ubuntu-doc
theCoreLaserJock, so?06:32
LaserJocktheCore: couple of changes, check it now06:36
theCoreLaserJock, cdbs ?06:37
LaserJockyep06:37
theCoreLaserJock, what is it exactly ?06:37
LaserJockhttp://perso.duckcorp.org/duck/cdbs-doc/cdbs-doc.xhtml06:39
theCorehttp://ubuntuforums.org/showthread.php?t=51003 <<< could be useful06:45
LaserJockyes, I've seen that before06:47
=== highvoltage [n=Jono@196.36.161.235] has joined #ubuntu-doc
theCorehttp://women.alioth.debian.org/wiki/index.php/English/BuildingWithoutHelper <<< could be useful too07:00
LaserJockyes07:07
=== robitaille [n=robitail@ubuntu/member/robitaille] has joined #ubuntu-doc
theCoreI gotta go sleep, cya later07:08
=== bshumate [n=bshumate@adsl-210-97-250.clt.bellsouth.net] has joined #ubuntu-doc
=== LaserJock [n=LaserJoc@ppp-69-227-157-8.dsl.renocs.pacbell.net] has left #ubuntu-doc []
=== manicka [n=grant@203-158-39-222.dyn.iinet.net.au] has joined #ubuntu-doc
=== jsgotangco [n=jsg@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== ssam [n=ssam@88-104-132-192.dynamic.dsl.as9105.com] has joined #ubuntu-doc
=== highvoltage [n=Jono@196.36.161.235] has joined #ubuntu-doc
=== jsgotangco [n=jsg@ubuntu/member/jsgotangco] has joined #ubuntu-doc
=== wjb [n=warren@c220-237-178-175.lowrp1.vic.optusnet.com.au] has joined #ubuntu-doc
=== wjb [n=warren@c220-237-178-175.lowrp1.vic.optusnet.com.au] has joined #ubuntu-doc
=== enrico_ [n=enrico@debian/developer/enrico] has joined #ubuntu-doc
=== WaterSevenUb [n=WaterSev@azevedo.astro.up.pt] has joined #ubuntu-doc
=== mpt [n=mpt@200-171-140-32.dsl.telesp.net.br] has joined #ubuntu-doc
=== Belutz [n=Belutz@ubuntu/member/belutz] has joined #ubuntu-doc
=== zenrox [n=zenrox@71.115.198.118] has joined #ubuntu-doc
=== WaterSevenUb [n=WaterSev@azevedo.astro.up.pt] has joined #ubuntu-doc
=== ssam [n=ssam@88-104-132-192.dynamic.dsl.as9105.com] has joined #ubuntu-doc
=== uniq [n=frode@213.184.199.55] has joined #ubuntu-doc
=== MichaleR [n=mikeraz@eye.patch.com] has joined #ubuntu-doc
=== Kinnison [n=dsilvers@haddenham.pepperfish.net] has joined #ubuntu-doc
=== bhuvan [n=bhuvan@b14.gw.maa.collab.net] has left #ubuntu-doc []
=== jjesse [n=jjesse@mail.ftpb.com] has joined #ubuntu-doc
=== jsgotangco [n=jsg@ubuntu/member/jsgotangco] has joined #ubuntu-doc
jsgotangcohey guys02:31
Kamping_Kaiserhi02:32
jsgotangcohey Kamping_Kaiser what's up?02:32
Kamping_Kaiserabout to try and work out why pam fails for *one* username on a server :(02:32
Kamping_Kaiserit's going to be impossible02:32
Kamping_Kaisersame user, added removed 3 times, still on joy. 02:33
jjesseis there a sync time for PAM?02:46
jjessei know in Active Directory there is a delay when you remove a username and it syncs across the domain controllers02:46
Kamping_Kaiseri thought it was imidate.02:46
Kamping_Kaiser*shrug*. 02:46
jjesseKamping_Kaiser: i don't know PAM at all just a thought02:47
Kamping_Kaiserworth looking at if i cant get it02:47
Kamping_Kaiserso thaniks :)02:47
=== WaterSevenUb [n=WaterSev@azevedo.astro.up.pt] has joined #ubuntu-doc
=== ssam [n=ssam@88-104-132-192.dynamic.dsl.as9105.com] has joined #ubuntu-doc
=== uniq [n=frode@213.184.199.55] has joined #ubuntu-doc
=== MichaleR [n=mikeraz@eye.patch.com] has joined #ubuntu-doc
=== Kinnison [n=dsilvers@haddenham.pepperfish.net] has joined #ubuntu-doc
=== jjesse [n=jjesse@mail.ftpb.com] has joined #ubuntu-doc
=== mgalvin [n=mgalvin@host-66-202-95-170.spr.choiceone.net] has joined #ubuntu-doc
=== Kamping_Kaiser [n=Kaiser@ppp207-221.lns1.adl2.internode.on.net] has joined #ubuntu-doc
=== ssam [n=ssam@88-104-132-192.dynamic.dsl.as9105.com] has joined #ubuntu-doc
=== WaterSevenUb [n=WaterSev@azevedo.astro.up.pt] has joined #ubuntu-doc
=== MichaleR [n=mikeraz@eye.patch.com] has joined #ubuntu-doc
=== uniq [n=frode@213.184.199.55] has joined #ubuntu-doc
=== Kinnison [n=dsilvers@haddenham.pepperfish.net] has joined #ubuntu-doc
=== Belutz [n=Belutz@ubuntu/member/belutz] has joined #ubuntu-doc
=== theCore [n=corrupte@Toronto-HSE-ppp3714657.sympatico.ca] has joined #ubuntu-doc
theCorehello there04:58
jjessehello theCore 05:10
theCorejjesse: do you work on some doc ?05:11
jjesseyes i do, mostly kubuntu docs :)05:11
theCoreah, nice05:11
theCoreon my side, i work on the PackagingGuide05:12
=== mdke_ [n=matt@ubuntu/member/mdke] has joined #ubuntu-doc
jjesseoh how is that going?05:13
=== mgalvin [n=mgalvin@ubuntu/member/mgalvin] has joined #ubuntu-doc
=== bshumate [n=bshumate@adsl-210-97-250.clt.bellsouth.net] has joined #ubuntu-doc
=== mdke_ [n=matt@ubuntu/member/mdke] has joined #ubuntu-doc
=== LaserJock [n=LaserJoc@lambda.chem.unr.edu] has joined #ubuntu-doc
=== mpt [n=mpt@200-171-140-32.dsl.telesp.net.br] has joined #ubuntu-doc
=== Belutz [n=Belutz@ubuntu/member/belutz] has joined #ubuntu-doc
=== bshumate [n=bshumate@adsl-210-97-250.clt.bellsouth.net] has joined #ubuntu-doc
LaserJockmdke_: ping?07:36
=== mpt [n=mpt@200-171-140-32.dsl.telesp.net.br] has left #ubuntu-doc ["http://mpt.net.nz/"]
=== mpt [n=mpt@200-171-140-32.dsl.telesp.net.br] has joined #ubuntu-doc
=== enrico [n=enrico@debian/developer/enrico] has joined #ubuntu-doc
=== ssam_ [n=ssam@88-104-132-192.dynamic.dsl.as9105.com] has joined #ubuntu-doc
mdke_LaserJock, pong08:40
LaserJockmdke_: I had a long discussion last night with theCore about the packaging guide08:42
mdke_cool08:42
jjessetheCore was on here earlier today08:42
LaserJockwe kinda were thinking that maybe it would be best to start from scratch on the Packaging Guide08:43
mdke_ok08:43
LaserJockit would help to eleviate the license issues but we also wanted to do it in a different way that will, I think, be much easier on the reader08:44
mdke_did you contact Diziet about the developer documentation spec?08:44
mdke_dude, seriously don't worry about the licence issues. but if you want to rework it, that's fine08:44
LaserJockmdke_: yes, I talked to Diziet a while back and he thought that there wasn't any problem for us to do the Packaging Guide. He thought that there wouldn't be much overlap08:45
mdke_oh right08:45
LaserJockmdke_: well the license thing wasn't a big deal. I just think that right now it is too similar to the Debian New Maintainer Guide and theCore and I saw that there might be a better way to do it08:46
mdke_ok08:46
mdke_LaserJock, will you continue working in our repo?08:47
LaserJockwe made an outline at https://wiki.ubuntu.com/UbuntuPackagingGuide/Outline08:47
LaserJockmdke_: oh, for sure. I am commited to getting a Packaging Guide in the doc-team repo by the time Dapper is released08:48
mdke_awesome08:48
LaserJocktomorrow hopefully I will become a Ubuntu member so then it will be a little easier08:49
jjesseLaserJock: did i say i would speak up for you? i don't remember if i did or not08:49
LaserJockjjesse: you did, but if you can't make it or something that's ok08:49
mdke_i'll leave a message with someone08:50
jjessenope still planing on being there08:50
LaserJockwell, hopefully it won't be to bad. I have a couple of MOTUs to speak for me also.08:51
mdke_you'll be fine08:51
LaserJockmdke_: anyway, I just wanted talk to you about the Packaging Guide and what thCore and I were thinking08:52
mdke_LaserJock, i don't know squat about packaging, but I'll certainly support anything you want to do with the guide08:53
LaserJockmdke_: thanks08:54
=== wjb [n=warren@c220-237-178-175.lowrp1.vic.optusnet.com.au] has joined #ubuntu-doc
=== jjesse [n=jjesse@mail.ftpb.com] has joined #ubuntu-doc
=== judax [n=judax@69.150.58.218] has joined #ubuntu-doc
=== macgyver2 [n=eric@pdpc/supporter/student/macgyver2] has joined #ubuntu-doc
=== HrdwrBoB [n=matt@bob.is.teh.admin.at.vicnet.net.au] has joined #ubuntu-doc
=== mpt [n=mpt@200-158-80-35.dsl.telesp.net.br] has joined #ubuntu-doc
=== bshumate [n=bshumate@adsl-210-97-250.clt.bellsouth.net] has left #ubuntu-doc []
=== HrdwrBoB_ [n=matt@bob.is.teh.admin.at.vicnet.net.au] has joined #ubuntu-doc

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