[12:38] enrico : I'm here [12:40] Ok. Please paste the question here :) [12:40] what is the structure, and what files I need to put into an upstream source tree to make it debable [12:40] or "how to learn debian packaging in 21 hours" [12:40] :) [12:41] you need 3 main files, all in the directory debian/ in the source tree [12:41] One is debian/control: it contains package metadata such as package name, description, dependencies [12:41] One is debian/changelog: it contains the version history and the latest version of the package [12:42] One is debian/rules ( :) ) and it is a makefile that contains commands that build the package [12:42] If you see people with a t-shirt saying "debian/rules" it's the name of this control file, as well as saying "Debian Rules!" [12:43] So, you can take any package (take for example my guessnet package) and see what's in debian/* You'll always find at least these files [12:43] Then you can have various other accessory files [12:44] debian/rules often makes use of debhelper, which is a suite of scripts that make creating packages easy, by automating most operations [12:44] Other (optional) files that can be there are scripts like preinst and postinst, that are executed by dpkg at various stages of the package installation/deinstallation/upgrade... [12:45] I suggest you take guessnet as an example and build from there [12:45] It's fine to just copy a debian/* directory over and replace the package name :) [12:46] guessnet's packaging however exploits the fact that upstream is very cool and uses automake/autoconf :) [12:47] hehe [12:47] I know why :) [12:48] it's not that hard to only use makefile, though [12:48] /usr/share/doc/cdbs/examples lists some examples and one of those only uses makefiles [12:48] There are links to documentations for cdbs. I'll tell you them now: [12:49] See debian bug 220756 for some links to cdbs documentation === enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc === enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc [01:05] laptop crashed [01:05] again and again [01:05] sivang: still there? [01:32] enrico : yes, headed to bed , just grabbed something to drink [01:32] Heading to bed too [01:32] See you tomorrow, then, continuing the debian packaging crash course [01:33] yes, it was great, crash courses are nice :) === silbs [~sbsm0084@host217-37-231-28.in-addr.btopenworld.com] has joined #ubuntu-doc === sm is now known as sm-zzz === lulu [~lu@host217-37-231-28.in-addr.btopenworld.com] has joined #ubuntu-doc === sivang [~sivang@80.179.93.130.forward.012.net.il] has joined #ubuntu-doc [11:08] hi all === lulu [~lu@host217-37-231-28.in-addr.btopenworld.com] has joined #ubuntu-doc [11:18] sivang: hiya :o) [11:19] hey there lulu ;-) === plovs [~plovs@195.13.248.82] has joined #ubuntu-doc [11:41] hi plovs [11:41] hi! [11:41] how's the laptop [11:42] hmm, bit better :) I will try make even some more fine tuning today [11:43] thanks, and what about yours? is he all well? (talking about them like children:) [11:45] the one for spain i haven't seen yet, osx is getting better, but it is not linux :-( [11:45] \ [11:49] plovs : didn't you tell me yesterday you have one for spain? [11:49] yes, i have one, just not at home atm [11:50] ah [11:52] how is your writing getting along? i haven't done much, just made an outline, too much work atm [11:56] plovs : slow but steady...:) [11:56] plovs : you meant on your part of the book? [11:57] yes, well on everything atm, i hope to do something wednesday and in the weekend === enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc === sivang sivangAFK [12:28] sivang: Hello,tell me something when you come back [12:45] Hey, gals... ;) [12:46] hi enrico [12:47] Hi [12:47] ChrisH: hei! [12:47] hi ! [12:48] sivang: feel like resuming the packaging business? [12:48] enrico : ah yes [12:48] enrico : let me see if I can update the from svn again, I was unable last night [12:49] Once week to go... :) [12:49] s/Once/One/ [12:49] Yup! [12:50] Does anyone know yet how far the hotel is from the Mataro train station? [12:51] I don't know [12:51] I'll need some instructions in that sense, actually [12:51] But I can try to dig that information later [12:51] lulu didn't know either [12:52] ChrisH : me neither, but silbs has noted to me that once first people get there, it would be more clear :) [12:52] we have the advantage of coming after the conf starts :) [12:53] I tried to understand things from the map that was linked from the wiki - no go :) [12:53] sivang: Cool, you are doing the "Welcome to Python" workshop? Great. Then I can finally ask the tricky questions. [12:53] it's all spanish and cluttered === enrico knows spanish [12:53] Linked from which page of the wiki? [12:53] ChrisH : hmm, that's interesting, where did you see it? [12:54] sivang: http://www.ubuntulinux.org/wiki/ConfAgenda [12:54] sivang: Friday, 17:30 - 19:00 [12:54] [12:54] Welcome to Python [12:54] [12:54] SivanGreen [12:54] [12:54] Salon Mataro/Iluro [12:54] enrico : here : http://www.renfe.es/cercanias/barcelona/img/zonal_barcelona_grande.gif [12:55] Looks like there are less interesting meetings than I thought during my stay. Well... it's a draft. ;) [12:56] hmm, I might ask some of the more python expers to help me :) and still this is the draft for the agenda, I didn't realie me suggesting a BOF makes me responsible for it :) [12:56] sivang: that map tells you which cercanias line to get (which is line 1, dircetion Maanet) [12:56] enrico : Macanet? [12:56] BTW, line 1 is nice as it goes all along the coastline and you can stare at the mediterranean [12:56] sivang: that's the end destination of the line, but you get out at Matar [12:56] enrico: Cool, I'll have my Ixus ready. :) [12:56] Now we need a map of matar, with a cross on the hotel [12:57] enrico: Indeed. [12:57] enrico : is it a bus ride? [12:57] sivang: no, train ride [12:57] enrico : I understood there is going to be a train [12:57] enrico: I don't like to take a taxi to the hotel with the baby on my lap. The taxi drivers must have learned to drive during the Vietnam war. [12:57] Cool thing is that line 1 also goes to the airport, so it's a single train ride, with no changes [12:57] Oh, if you take a taxi, always ask for the receipt [12:58] And if you feel like they asked too much, the receipt should have informations about the driver or taxi number on it [12:58] enrico : ok, please explain again: I arrive at the barcelona airport and from there take a train straight to mataro? [12:58] It happened that the taxi driver asked for some amount, then you asked for the receipt and they said "OH! I made an error..." [12:58] sivang: That part is easy. Take the blue line to mataro. Done. [12:58] sivang: yes: cercanias line 1 [12:58] sivang: This information has already been there. [12:59] sivang: But there is no information about the area around the hotel. [12:59] enrico : hmmm, where do I find the train station on the airport? [01:00] sivang: I bet it's well marked, but I'm sure you can ask to any airport information desk and they'll all speak english [01:01] enrico : do you think the train is far from the airport? [01:01] sivang: No. [01:01] the train station should be in the airport [01:01] sivang: http://www.ubuntulinux.org/wiki/Conference/ => Flying In [01:03] ok, it is more clear now [01:03] thanks ChrisH for pointing it [01:03] sivang: yw [01:11] ChrisH: and the Mataro train station is an easy 10 min walk from the hotel apparently. But, they have taxis for about 4 euros or so, apparently. [01:11] lulu: hi! [01:11] lulu: Very good. I don't mind the costs. I just fear for my life and that of my son. [01:12] lulu: is there a map of matar with the location of the hotel (or the hotel website) [01:13] ChrisH: the hotel website is on the wiki - Hotel NH Ciutat de Matar, located near the city center. [01:13] lulu: ok. Later on I can pull all the information and try to post some map [01:13] ChrisH: a link anyway. === enrico goes having lunch [01:15] ChrisH: mmm - I googled for others - with more info on the hotel. - I'll replace the link with another. [01:15] lulu: did you find anything useful on the hotel web site? :) [01:16] ChrisH: ^.....I'll see what I can find..... [01:16] ChrisH : you make it sound like spain is a dangerous place :) please say it's not.. [01:17] sivang: It's not. But my boss told me that the taxi drivers are mad in spain. [01:17] sivang: They don't have baby seats or belts on the back seats. [01:17] sivang: And they drive like hell. [01:17] sivang: So if - as lulu said - it's just a 10 minute walk, I'm more than happy. [01:18] ChrisH : You mean to walk it ? (sounds reasonanbe to me also) [01:18] sivang: Yup. We have a mini-buggy for Marco, a suitcase on rollers and a backpack. [01:19] sweat! [01:19] sivang: I don't sweat! :) [01:19] sivang: That reminds me... I need to get the mentoring docs ready. [01:20] ChrisH : mentoring docs? nice..anything specific in mind? [01:20] lulu: btw... what about it? The mentoring ideas. [01:20] sivang: Mark had a few thoughts. And I also have. Just need to write a document and draw a sketch or two. [01:21] ChrisH : did you get how a BOF is supposed to be managed? [01:21] sivang: It's how we make the project easier for contributers. [01:21] sivang: In real life? :) [01:21] like yes [01:22] sivang: Well... I assume we will just gather and talk about the topic. Nothing serious. No real speech. Perhaps an introduction so everybody knows what they will talk about. [01:23] ChrisH : ok, this sounds nice, I am just trying to figure if I am able to do a "W2P BOF" ..:) [01:25] sivang: Windows-to-Perl? [01:25] hahah [01:25] ChrisH : Welcome 2 Pytohn [01:26] hmm,. the hotel website gives much info [01:26] :) [01:26] sivang: I've just started with Python. May be useful to have someone there who is using Python more than for just a day. [01:27] ChrisH : yes, I will talk to keybuk about it [01:27] lulu: Besides the NM workshop that I don't see. You "promised" the Soyus will be introduced. As I'm not there in the second week... is there a chance this is done twice? I know I'm asking for much. [01:27] sivang: The style is very different from Perl and although I got a few lines running I'm often laughed about in #python. ;) [01:29] ChrisH: I can't promise there will be a second BOF but the Soyuz team will be working there for 2 weeks so you will be able to speak to them directly. Kiko, Daniel, Celso and Guilherme....but there will be talk about it. [01:30] lulu: k [01:33] ChrisH : what's Soyus? [01:33] http://www.bookings.org/hotel/es/nhciutatdemataro.html?checkin=;checkout= [01:33] there's a map [01:34] http://www.bookings.org/hotel/es/nhciutatdemataro.html?checkin=;checkout=#Hotel%20Photos [01:36] sivang: Niiice. :) Just my styile. [01:36] sivang: However I wonder where on the map is the train station. [01:37] yes [01:37] sivang: soyus is (from what I know from lulu) a python framework that will handle the package repository in ubuntu [01:37] what I was actually trying to figure [01:37] wowowo [01:37] we must have them give a talk on the first week also [01:37] :) [01:39] I second that. Pretty important IMHO and I really can't stay for two weeks. During such a long conf I'd expect to have such important issues being displayed more than once. [01:39] From looking through the attendees list I see that hardly anyone attends more than for a few days. [01:40] guys - we will see what we can do ok! :o) [01:40] lulu: Hey, no offense intended! [01:42] ChrisH : you see her very nice clownish smiley? [01:42] (using the 'o' as a nose) [01:42] ChrisH: none taken :o) I think we can fit in an intro in one of the group sessions in the first week... [01:42] lulu : we are all thirsty to know more and more about ubuntnu, that's the reason of the demands :) [01:44] lulu: At least I didn't ask to hold the soyus workshop it in my hotel room so I wouldn't need to get up. ;) [01:44] hhahaha [01:44] sivang: I know and it's great :o) but I do know that information will be released at exactly the right time ;) [01:44] Although... [01:44] is there anything publically available already about Soyus? [01:49] sivang: if they told you before, they'd have to kill you :) [01:49] ahmm, I guess so :) [01:50] so, how many of the docteam-related BOFs [01:50] I've seen 2 [01:50] one by Mako, [01:50] and the other by jdub on hoary documentation goals [01:50] how many of them before the 9th ? [01:51] lemm echeck [01:52] oh no the conf page is in rest :) [01:52] I wanted to add the new photo links and map of the hotel === sid77 [~sid77@host98-44.pool8020.interbusiness.it] has joined #ubuntu-doc [01:54] Map_ of Barcelona Light Rail. [01:54] System Message: WARNING/2 (, line 136); backlink [01:54] Duplicate explicit target name: "map". === sid77 hi! [02:00] sid77: hi! [02:05] a question: which are the guidelines for translating stuff? I mean: some times ago I asked for a "style" problem translating the faq, and I was answered to follow the original style found in the wiki. I've seen that now the Italian Translation page is deeply restructured, is it all ok? [02:08] sid77: I'd imagine that every translation team has its own guidelines. However, I (together with lulu and daf) just yesterday posted a message to try to clarify the relationships between the docteam and the translation team, so we may get more clues soon [02:10] ok [02:14] sid77: in the meantime, you can ask to the other members of the italian team [02:16] enrico : could you give me again the command to make procmail reprocess my mail into folders? [02:16] formail -s procmail < mailbox [02:17] enrico : ah thank you! [03:12] btw, can I still use the hornbeck repo? [03:12] to add content to UB ? [03:12] (ubuntu book) [03:13] I'd think so [03:13] ok === sivang downaloding the package === plovs [~plovs@195.13.248.82] has joined #ubuntu-doc [03:14] About packaging the FAQs, I told Sivan that he can find a simple package in http://lento.uncasino.it/enrico/store/openoffice.org-thesaurus-it_0+20041114.orig.tar.gz [03:15] (that's going to reach unstable after ftpmaster's approval: it'll take like 2 weeks if everything goes well [03:15] sid77: btw, that's the Italian Thesaurus for OpenOffice!! [03:15] sid77: and with a supercool history behind it! [03:16] what? [03:16] ok I have the pkg [03:16] enrico? [03:17] oh, k. read. lol [03:18] sivang: yes [03:19] ok, I'm ready with the package [03:19] sid77: it's been made by a 3rd grade liceo scientifico high school and their italian teacher [03:19] sid77: then, other schools and volunteers joined [03:19] yeah [03:20] sid77: I asked them to work with the class and the english teacher to write some history of what happened, and to hype themselves a bit, and then include it in the package [03:20] sivang: have a look at the debian/ directory: it should be minimal [03:21] ahahahha [03:21] sivang: if you forget about unpacking the zipfiles, you can see how to install files where you want [03:21] sivang: of course the FAQs also have a makefile [03:22] sivang: you also see an example of a simple debian/control, and a postinst file in which you can add commands in case you need to invoke scrollkeeper after the installation [03:22] sivang: do you have enough to start making a debian/directory now? [03:22] then we can work from that [03:23] enrico : I think so, lemme look [03:24] tar xvf openoffice.org-thesaurus-it_0+20041114.orig.tar.gz [03:24] tar: This does not look like a tar archive [03:24] tar: Skipping to next header [03:24] tar: Archive contains obsolescent base-64 headers [03:24] tar: Read 811 bytes from openoffice.org-thesaurus-it_0+20041114.orig.tar.gz [03:24] tar: Error exit delayed from previous errors [03:25] sivang: tar zxvf... [03:25] You forgot the 'z' [03:25] :) [03:25] shit [03:25] :) [03:26] People... anyone minds if I convert DocumentationTeamCurrentWork to MoinMoin? [03:26] It's reSt [03:26] go ahead! [03:26] :) [03:26] I got pinched by rest another time today, [03:26] :) [03:26] when trying to add a SIMPLE link for the hotel pictures and map [03:27] why can't it "just work?" :) [03:27] enrico : looking at the debian folder, it looks good [03:28] I see I should probably use postinst to call scrollkeeper-update [03:29] bleh... Moin tables aren't that nice to edit either [03:29] well they are not, [03:30] but a simple link should not require to lean another lang right [03:30] ? [03:31] I tried so silently to immitate the already resisding link there, and walked slowly away from the interpreter so it won't notice me , and then " BEEEEEEEP!!! YOU'RE BUSTED, WRONG MARKUP DUDE" [03:31] :0 [03:31] :) [03:33] I left it in reSt, as in that specific case it's easier to update than MoinMoin [03:38] sivang: how are you doing? [03:39] enrico : I have the dir, having trobule syncing the versino from hornbeck's repo, lemme try again. [03:42] sivang: I did an svn update here and it works [03:42] what trouble did you have? [03:43] working now [03:43] :) [03:45] it's updated [03:45] I'll new create /debian under the source trre of the faq, [03:45] this is the right way right? [03:46] yes [03:46] (and copy the skeleton files into there) [03:46] done [03:47] oh and this is now the new "book" not just plain faq anymore, if I recall right, [03:47] ChrisH ? [03:49] enrico : first let us start with debian/rules :) [03:49] sivang: no: first is debian/control [03:49] yes [03:49] sorry [03:49] ok, control [03:49] sivang: there you decide the package name, if it's arch-indep or arch-dependent, and which are your build-dependencies [03:49] ok I want to call the pkg ubuntu_handbook [03:49] that is, first state what you're about to do, then do it :) [03:50] no underscores [03:50] ubuntu-handbook is better [03:50] why no underscores? [03:50] ubuntu convention? [03:50] underscore separate the package name from the version in the .deb file name [03:51] after debian/control, create the initial debian/changelog, so that you have a communication channel with your users and a place ot annonate what you do [03:52] ok, fields in /control: [03:52] Source: === falco [~falco@a81-84-137-51.netcabo.pt] has joined #Ubuntu-doc [03:52] ubuntu-handbook? [03:53] why is the meaning of a source/bin pkg when dealing with docs? [03:53] Because you always have a source package that creates a binary package. In this case the terms source and binary are a bit abused; however, you have a source package that generates the packages that get installed [03:54] the source packages is what you download with "apt-get source". The "binary" packages is what you download with apt-get install [03:54] For example, in the source package you don't have the generated .pdf and .html files [03:55] You generate them when you build the package and then you include them in the 'binary' package [03:56] sivang: You want to create a package from the book? Yes, then it's /debian. But why would anyone need a package from source files for a book? [03:57] ChrisH: the intention is to package the book itself [03:57] enrico: Uh huh. For yelp/scrollkeeper I assume. [03:58] ChrisH : when creating a package for such documentation, the package holds the source and calls make on it, after it will register it with scrollkeepr and it would be brwoseable from yelp. [03:58] sivang: k. Now I get it. [03:59] enrico : I have edited my control, would you like to take a look at it? [03:59] sivang: sure: did you commit it? [04:00] enrico : commit? I just edited the file [04:00] sivang: if you want me to see it, commit it :) [04:00] the I can fix it and commit it again [04:00] else, what are we using this subversion server for? [04:02] ok I'll commit now [04:02] I just realized [04:02] I did svn commit and got this: [04:03] --This line, and those below, will be ignored-- [04:03] M parts/about/main.xml [04:03] M parts/about/chap-ubuntu.xml [04:03] what does it want from me? [04:03] You probably modified them [04:03] I did [04:03] If you don't remember doint it, you can abort the commit, checkout a fresh version, and work on that one [04:03] The diff those 2 files and see the modifications [04:04] If instead you modified those files, it wants to commit them [04:04] If you only want to commit debian/*, do svn commit debian [04:04] I want to commit it, [04:04] I just wq from vi? [04:05] it new part I added to the book [04:05] under about ofcourse [04:05] :q! from vi, then svn will notice it's unchanged and prompt you to abort [04:06] Authentication realm: Documentation Team Repository [04:06] Password for 'pooh': [04:07] sivang: I imagine you have a password for the repo? [04:07] yes, but not under the user of pooh [04:07] so try using --username [04:07] I should have done something to tell svn sivang is the username? [04:08] svn help commit [04:08] k [04:12] errgh [04:12] my password doesn not let me in [04:13] commited [04:13] finally === enrico gets it [04:14] sivang: do an svn status [04:14] I see your modifications in those 2 files, but not the new debian/* files [04:14] you probably forgot to do svn add on the new files [04:14] svn status shows you what's the status of the various files in your local copy [04:18] ok [04:19] sivang: did you manage to commit the debian/ directory? [04:20] svn status [04:20] ? debian [04:20] ? parts/about/chap-background.xml [04:21] the ? means that svn doesn't know anything about them [04:21] if you want them in the repository, you need to svn add them [04:21] svn add debian parts/about/chap-background.xml [04:21] then you'll see them with 'A' instead of '?' [04:21] and you can commit their addition [04:22] . [04:24] recommited [04:24] check now [04:25] got it! [04:26] great [04:26] do you get the chap-ubuntu changes? [04:26] (ubuntu background) [04:28] sivang: yes, also chap-ubunut [04:28] about control: "Maintainer:" should be you [04:29] I'll fix it and commit it [04:29] k, thanks [04:29] :) [04:29] it's fun working that way [04:29] then you can do svn diff and see what changed [04:30] yes [04:32] you can fix the copyright file, before we forget about it :) [04:33] right [04:33] how do I svn diff? [04:33] In the description, you say that it can be converted, implying that the package only distributes the docbook sources [04:33] sivang: svn help diff [04:33] But the makefile actually builds the HTML version of it [04:34] We can make a multi-binary package, that is a source package that generates various binary packages: one with the docbook sources for yelp, one with the PDF and the HTML [04:35] Or we can package everything in a single package [04:35] I suggest we package everything in a single package, then split it if needed [04:35] enrico : ok [04:35] enrico : agreed [04:37] sivang: committed === skyrider [~skyrider@kid.stu.cn.ua] has joined #ubuntu-doc [04:40] enrico : ${shlibs:Depends}, <==? [04:40] Well, we don't need it, so you can delete it. It would be replaced by library dependencies by a debhelper script that calls 'ldd' on every binary you generate and checks which libraries they depend on [04:41] what does it mean? [04:43] sivang: try this. Do a ldd `which ls`, you'll see which shared libraries 'ls' depends on. If you call dpkg -S on the full path of all of these libraries, then you get a list of debian package names [04:43] This is an automated way of knowing which debian library packages are used by ls, and so they should be on 'ls' dependency list [04:43] wow nice! [04:44] Since we don't have any binary executable file, we don't need that. [04:44] I bet somekind of debhelper does it automagically [04:44] dh_shlibdeps [04:44] right :) [04:44] librt.so.1 => /lib/tls/i686/cmov/librt.so.1 (0x40027000) [04:44] libacl.so.1 => /lib/libacl.so.1 (0x4002e000) [04:44] libc.so.6 => /lib/tls/i686/cmov/libc.so.6 (0x40035000) [04:44] libpthread.so.0 => /lib/tls/i686/cmov/libpthread.so.0 (0x40170000) [04:44] /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) [04:44] libattr.so.1 => /lib/libattr.so.1 (0x40180000) [04:44] coooooooool! [04:45] commited === wartylog [~warthylog@port49.ds1-van.adsl.cybercity.dk] has joined #ubuntu-doc === Topic for #ubuntu-doc: Ubuntu Doc Team - general discussion - backlog at http://irclog.workaround.org | This channel tries to follow the tradition of the #gnome-love channel on irc.gimp.net, all new comers and questions are welcomed, as long as you follow the Ubuntu community code of conduct @ http://www.ubuntulinux.org/community/conduct first. === Topic (#ubuntu-doc): set by sivang at Sat Nov 20 20:50:09 2004 === warthylog [~warthylog@port49.ds1-van.adsl.cybercity.dk] has joined #ubuntu-doc === Topic for #ubuntu-doc: Ubuntu Doc Team - general discussion - backlog at http://irclog.workaround.org | This channel tries to follow the tradition of the #gnome-love channel on irc.gimp.net, all new comers and questions are welcomed, as long as you follow the Ubuntu community code of conduct @ http://www.ubuntulinux.org/community/conduct first. === Topic (#ubuntu-doc): set by sivang at Sat Nov 20 20:50:09 2004 [04:57] (enrico/#ubuntu-doc) ubuntulog probably scared it [04:58] (sivang/#ubuntu-doc) heheh [04:58] (enrico/#ubuntu-doc) warthylog: hello. have you met ubuntulog? Maybe you can become friends [04:58] (sivang/#ubuntu-doc) haha [04:58] (sivang/#ubuntu-doc) they can mate and then have decsendents :) [05:00] (enrico/#ubuntu-doc) sivang: committed the new changelog. If you want to edit it, you can use the 'dch' script: very very handy [05:00] (sivang/#ubuntu-doc) commited copyright [05:00] (enrico/#ubuntu-doc) also, I don't know if the distribution (on the 1st line of the changelog) shuold be changed for ubuntu. I think so, but I should ask how [05:00] (enrico/#ubuntu-doc) It doesn't matter for now [05:01] (enrico/#ubuntu-doc) sivang: the copyright file is perfect! [05:01] (sivang/#ubuntu-doc) it is? [05:01] (enrico/#ubuntu-doc) it is [05:01] (enrico/#ubuntu-doc) now, debian/rules. [05:02] (enrico/#ubuntu-doc) you have to add "include /usr/share/cdbs/1/class/makefile.mk [05:02] (enrico/#ubuntu-doc) after the include for debhelper [05:02] (enrico/#ubuntu-doc) You can remove 'tarball' and its stuff, like the DEB_TAR_SRCDIR and THES_BASE lines [05:03] (enrico/#ubuntu-doc) And the UNZIP=-n and export UNZIP lines === wartylog [~warthylog@port49.ds1-van.adsl.cybercity.dk] has left #ubuntu-doc [] === wartylog [~warthylog@port49.ds1-van.adsl.cybercity.dk] has joined #ubuntu-doc === Topic for #ubuntu-doc: Ubuntu Doc Team - general discussion - backlog at http://irclog.workaround.org | This channel tries to follow the tradition of the #gnome-love channel on irc.gimp.net, all new comers and questions are welcomed, as long as you follow the Ubuntu community code of conduct @ http://www.ubuntulinux.org/community/conduct first. === Topic (#ubuntu-doc): set by sivang at Sat Nov 20 20:50:09 2004 [05:05] then, you can test building the package with "fakeroot debian/rules build" [05:05] That should perform all steps until invoking the makefile and letting it build [05:06] You can actually checkout also http://69.155.172.150/docutils and see the packaging there [05:07] I still have to understand how to register it in the scrollkeeper, the docs are bit blurry [05:07] (for scrollkeeper) [05:07] It was 2 hours that I was thinking "but I just did the same work a few days ago..." :) [05:07] and also I want to make a new front page for the first yelp invocation [05:07] what? [05:07] One thing at a time: first get a debian package to build, then let it do what you want :) [05:07] ok :) [05:07] sivan: You can actually checkout also http://69.155.172.150/docutils and see the packaging there [05:08] I noticed that :) [05:10] checking out docutils [05:10] takes long,strange [05:13] hi guys [05:18] enrico : error in docutils, look at the control file . in the description section [05:21] Oh :) Polygen [05:22] Or Proxysperm, Polpybel, Polsybel, Polpiflex [05:22] (polygen is able to generate its name randomly) [05:23] fixing it [05:24] committed [05:25] sivang: how are you doing with debian/rules? Does it compile? [05:26] enrico : finishing to modify it [05:26] DEB_TAR_SRCDIR=. [05:26] THES_BASE=build-tree/ [05:26] this is required? [05:26] sivang: 17:00 < enrico> You can remove 'tarball' and its stuff, like the DEB_TAR_SRCDIR and THES_BASE lines [05:26] 17:00 < enrico> And the UNZIP=-n and export UNZIP lines === enrico loves backscroll: it's easier than retype :) [05:27] sorry [05:27] woops [05:27] :) [05:28] enrico : will you take a look at my rules? [05:28] (commited) [05:29] sivang: remove the 'tarball' line, as you don't need to ship a tarball inside your source package to be unpacked at build time [05:30] /usr/share/cdbs/1/rules/tarball.mk:47: *** You must specify DEB_TAR_SRCDIR. Stop. [05:30] plovs:ping [05:30] oh [05:30] :) [05:30] then try 'fakeroot debian/rules build' to see if ti works [05:30] lulu: hi [05:31] enrico : it created lots of html files on the parent dir [05:31] that's all [05:31] sivang: it went so far as to call the makefile, then. it doesn't need to do much more [05:32] we're ok so far [05:32] Now, we probably have to fix upstream's makefile :) === enrico hates when he's ALSO upstream [05:32] sivang: Did you work with makefiles in the past? [05:32] yes :) [05:33] enrico : yes, but on low end uni projects, not ones of big projects etc. [05:33] sivang: good! So, we probably want to generate the HTML in a subdirectory and a PDF file [05:34] appearently, xsltproc ignores the target file and just generates tons of html files [05:34] it probably wants a directory and not a file name, and the directory must exist according to xsltproc manpage [05:35] enrico : I don't understand how cdbs calls our make file :) [05:35] It just calls "make" :) [05:35] If you want to have more parameters passed to it, you can add something like: DEB_MAKE_BUILD_TARGET+="further make options" [05:36] I'll fix the makefile for you. moment... [05:37] tnx [05:41] sivang: committed [05:42] ok, let me check out [05:43] enrico : do you know if ubuntu devs are also using cdbs? [05:43] fakeroot debian/rules [05:43] test -x debian/rules [05:44] sivang: I think it depends on their preference [05:44] does not using cdbs allows finer grain control over pkg? [05:45] in theory not, but since cdbs is not that documented yet, one may feel like it because they don't know how to perform changes [05:45] However, I see two cases: [05:45] enrico, i have been looking at the man-pages, tomorrow i want to work on the apt apt-pages, where do i put them? do we have something in svn for it? [05:45] 1) changes over the common practices are small, then use cdbs [05:46] 2) changes over the common practices are huge, then just do things the old way [05:46] ok, I get it now [05:47] plovs: good question [05:47] plovs: I suggest you just put the changes as patches attached to bug reports in the Debian BTS or the Ubuntu bugzilla [05:47] That way, the maintainers can pick them up and include them in their packages [05:48] Oh, wait. I'm talking about the manpages... what do you mean apt apt-pages? [05:52] enrico : why does debian rules only does test -x debian/rules ? [05:52] nothing happens [05:52] Uhm... it appears that Lupin uses KDE: http://www.blogmatic.net/mie/lupin_linux.avi :) [05:55] who is Lupin? [05:55] hehe he recieved a spam [05:55] :) [05:56] sivang: really, you don't know who's Lupin? [05:56] no : [05:56] :( [05:57] One of the best Japanese animation thingies: stories of a cool thief [05:57] In Italy, it's a supercult [06:01] sivang: got the new makefile? [06:01] works for you? [06:01] sec [06:02] XSLTPROC = /usr/bin/xsltproc --xinclude [06:02] XSL = ubuntu.xsl [06:02] .PHONY: all [06:02] all: html/index.html [06:02] html/index.html: usersguide.xml $(XSL) $(shell find parts -name '*.xml') [06:02] mkdir -p html [06:02] $(XSLTPROC) -o html/ $(XSL) $< [06:02] clean: [06:02] rm -rf html/ [06:02] ? [06:02] Sounds like what I committed, yes [06:02] ok, [06:02] when I do fakroot debian/rules [06:02] i get "test -x debian/rules" and nothing more. [06:04] it may be because you already built the HTML [06:05] try make clean and build the package again [06:05] make doesn't do things that don't need to be done :) [06:06] the same [06:06] I did make clean and redid rules, [06:06] same result [06:10] show me the output of 'make' [06:12] make alone does it right, [06:12] axcluding [06:13] excluding: [06:13] warning: failed to load external entity "parts/gnome/main.xml" [06:13] usersguide.xml:86: element include: XInclude error : could not load parts/gnome/main.xml, and no fallback was found [06:13] but when I do fakroot debian/rules it just gives: [06:13] test -x debian/rules [06:19] sivang: let's see [06:20] what's in your debian/rules [06:20] ? [06:21] here, it all works for me, with only 2 lines in debian/rules (namely, including debhelper.mk and makefile.mk) [06:27] sivang: around? === sm-zzz is now known as sn === sn is now known as sm === enrico plays dopewars waiting for sivan === enrico is worried for sivan [06:50] enrico: Perhaps he ran out of batteries again. :) [06:51] he seems to be still connected: I didn't see its connection time out === enrico would like to find hornbeck online [06:54] At the conference every Ubuntu maintainer gets an RFID tag implanted. Then we always know where sivang is. [06:54] I'll start wearing a lead suite :) [06:54] ChrisH: cool! and then we all go shopping together, peep peep [06:55] plovs: Better. You don't need to pay. Everything you steal will be automatically charged to your credit card. === enrico will be a RFID fortune teller [06:56] In the glass ball, a monitor with the RFID info read from the customer's RFID-enabled passport [06:56] I see... you're American! [06:56] Hardly. :) [06:56] is there some way to see what has changed in svn (RecentChanges) [06:56] And you leave in... Alabama! [06:57] plovs: svn diff [06:57] svn -r diff [06:57] or svn log [06:57] enrico: thanks [07:03] enrico: i'm ok with putting man-page updates in bugzilla, but svn would give others a chance to look at it as well, i would like to get second opinions [07:06] plovs: in that case, it's a bit hard to track things right, as the upstream manpage could change in the meantime [07:08] enrico: then i'll just put it there and others will have to get from there then [07:09] I'd think so. I think the likeliness of someone wanting to correct a correction is so low that it doesn't justify optimizing for review (in this case) [07:09] Remember to post patches, though [07:10] do we have a page now on naming Ubuntu or UbUntuGnuLinux etc? [07:12] plovs: I started an ubuntu-doc-tools with XML entities definitions for these ones [07:12] link coming [07:12] enrico: are there any plans to make sym-links in the repositories from hoary to stable etc? [07:12] plovs: svn co http://69.155.172.150/docutils [07:12] plovs: I don't know about that: I can ask the devels if you want [07:13] I mean, I can ask #ubuntu-devel [07:13] enrico: what do you think, i was reading the apt-page and it would simplify things, off course only if we use pinning as well [07:14] what do you mean with apt-page? [07:15] the apt man-page [07:15] ah, ok [07:15] I'll ask #ubuntu-debvel [07:16] in bugzilla it was asked to be updated, basically thet is s/Debian/Ubuntu/g and then stable/hoary etc [07:17] enrico: thanks [07:20] I report the answer here for the logs: no stable->warty kinds of links, although they do existin the CDs just in case d-i would break without them [07:23] enrico: ok === maskie [~maskie@196-30-111-136.uudial.uunet.co.za] has joined #ubuntu-doc [07:42] enrico : here! [07:42] Hey, sivang found his batteries. :) === enrico is back [07:56] night all :o) === lulu [~lu@host217-37-231-28.in-addr.btopenworld.com] has left #ubuntu-doc [] [07:59] ChrisH : what's RFID tag? :) [07:59] sivang: Ah, sorry, I didn't think of your 3rd world country. ;) [08:00] yes, you have to explain everything 3 times before we understadn :) [08:00] sivang: That are little transponders that are activated by a electromagnetic field and emit information that is stored. [08:00] sivang: They are introduced in some larger companies to "tag" goods. We at work are using it for more expensive things to track them until they reach the customer. [08:00] ChrisH: strange that an israelian doesn't know about RFID though [08:00] I know Israel is quite advanced on surveillance things [08:01] sivang: But it's dangerous. In the US companies are already tagging employees in first tests. Some customers service cards already contain RFIDs without telling the people. So they can track the customer everywhere where they have an antenna installed. [08:01] ChrisH : oh, I know about this :) just didn't know the acronym [08:01] enrico: Nah, I'm just joking with Sivan because he has some drainage and power problems. ;) [08:01] OMG [08:02] enrico : we do, the electric corporation is still in it's beta stage :) [08:03] otoh, someone is working on a cheap rfid reader detection device, that would beep whenever it's in range of and RFID reader [08:03] enrico : I am not really interested in this technologies, actually they are big disgrace to freedom of speech IMHO [08:04] and a faraday-cage passport holder [08:04] sivang: very sure === ChrisH wants an RFID tag that destroys all reader in range ;) [08:04] haha [08:04] my order first! [08:04] when you open the company, ChrisH [08:05] Okay... :) === ChrisH registeres finaltag.com [08:05] ;-) [08:05] enrico : ok, let's get back to the package, ok? [08:05] That reminds me... I need to get the mentors t-shirt done. Oops. Mataro is close. [08:05] sivang: ok. last thing I said was: show me your debian/rules [08:05] yes, too close :) === silbs [~sbsm0084@host217-37-231-28.in-addr.btopenworld.com] has left #ubuntu-doc [] [08:06] enrico : cat rules [08:06] #!/usr/bin/make -f [08:06] include /usr/share/cdbs/1/rules/debhelper.mk [08:06] include /usr/share/cdbs/1/class/makefile.mk [08:06] sivang: it should work, then [08:06] show me the output of fakeroot debian/rules clean; fakeroot debian/rules build [08:06] if it's long, mail it [08:10] mailed [08:14] sivang: sounds like it works to me [08:16] now you can add "html/" in debian/docs to have the HTML documentation installed correctly in /usr/share/doc [08:17] (that is handled by dh_installdocs, called by cdbs. If you want to know about the format of the docs file, read dh_installdocs manpage) [08:21] so everything under debian/doc --> {system_root$}/usr/share/doc ? [08:23] no... you list files inside the debian/docs file, and then dh_installdocs will make sure that they'll be installed in /usr/share/doc/package/... [08:30] enrico : ok [08:33] but I didn't make "fakeroot debian/rules" run [08:34] Sorry, I didn't understand: say it again? [08:36] enrico : I could not execute "fakeroot debian/rules" and have an html dir ready [08:37] That should be "fakeroot debian/rules build" [08:38] ah oops [08:38] When I do it, then I can "ls -la html" and see the generated files. You should be able, too [08:38] I can [08:38] it works here the same [08:38] ok, [08:38] let's go on and finish this package :) [08:39] Now you can do the debian/docs file and try your luck with "fakeroot debian/rules binary" [08:39] "fakeroot debian/rules binary" creates the .deb file. It'll put it in the directory ABOVE the one you run the command [08:39] To see if a .deb has what you need, you can dive into it using "mc" [08:40] Or, you can see what went inside it by having a look in debian/ubuntu-handbook [08:49] sivang: how is it going? [09:00] sivang: I'll have to leave in 30 minutes or so, but I'll also have to make a phone call [09:00] however, you're almost there. The package name mismatches between debian/control and debian/changelog, and that's probably the only showstopper you have to having a .deb file built. Then, it's just small fixes. [09:00] I'm here [09:00] sorry [09:00] About scrollkeeper, read /usr/share/doc/scrollkeeper/README.Debian [09:00] ok, I see [09:00] I will thakns, [09:00] sounds like I'm really almost there. [09:00] you can also apt-get source some package which installs scrollkeeper-enabled documentation and see what they do [09:00] Yes, you're almost there. [09:00] Use mc to navigate inside .deb files [09:00] Quit mc and restart it if you suspect it's caching the contents of an old .deb file (sometimes it does it) [09:00] When you think it could work, try dpkg -i .deb and see what happens: it might even work :) [09:00] If it doesn't work, you can always "dpkg --purge ubuntu-handbook" and try again [09:01] ok, thanks alot enrico! [09:02] sivang: if tonight you have some time, I'd really like you to put down a small technical story on how you packaged this, which could be useful for people learning how to make .deb packages [09:03] afaik, there are not many beginner's documents about it (although ChrisH may know of some that I don't) [09:03] I know of none :) [09:08] ok, I will talk with him also [09:08] about it [09:08] anywya, I'm off to the shower and then finish the package, [09:09] I will not do anything more today bedies finishing the package and writing the newbie howto to the packaging [09:14] Uh... what's that? http://www.ubuntulinux.org/support/documentation/howto/starterguide [09:15] Shouldn't parts of that rather to into the user guide? [09:15] what is that? [09:16] anyway, after shower.. [09:16] Just found it on the page. === skyrider [~skyrider@kid.stu.cn.ua] has joined #ubuntu-doc [10:29] I just heard that KDE is about to be packaged for ubuntu. Looks like we need to do our screenshots twice. :) [10:32] Forget that... the information is still classified. Sorry, but I need to blank your memories. === sivang [~sivang@80.179.93.130.forward.012.net.il] has joined #ubuntu-doc [10:51] ChrisH : ok, what is that link used for? [10:52] sivang: Just saw it on the front page. Haven't heard from it before. [10:53] ah ok, what nm docs are you working on for the bof? [10:54] sivang: The new maintainers/mentoring stuff Mark asked for. However I don't see a meeting for that yet. I hope it's not for the bin. === netjoined: irc.freenode.net -> saberhagen.freenode.net === sivang [~sivang@80.179.93.130.forward.012.net.il] has joined #ubuntu-doc === skyrider [~skyrider@kid.stu.cn.ua] has joined #ubuntu-doc === falco [~falco@a81-84-137-51.netcabo.pt] has joined #ubuntu-doc === sm [~simon@lsanca1.ar5-4.15.64.42.lsanca1.dsl-verizon.net] has joined #ubuntu-doc === boglot [~logbot@mentors.workaround.org] has joined #ubuntu-doc === asw [~Alexander@node-423a728a.bos.onnet.us.uu.net] has joined #ubuntu-doc === ChrisH [~chaas@212.12.58.114] has joined #ubuntu-doc