[12:07] it would work just as well in the kde Makefile [12:08] it's more practical than logical [12:09] is there no common makefile? [12:10] not at the moment [12:11] ok i've updated the wiki page [12:12] hmm... the samples aren't perfect yet... [12:12] jeff@cloud:~/ubuntu-doc/styleguide $ make sg [12:13] whoops sorry [12:13] will do [12:14] and maybe webbrowser should be two words [12:15] pah === mdke slaps jeffsch [12:15] done [12:15] i waited just the right amount of time, eh? [12:15] now there's one more change... [12:16] oops, never mind [12:17] mdke: did you do make sg on your system? [12:17] yes [12:17] looks great [12:18] i was thinking we should have the stylesheets in the repo [12:18] i build em nicely on this system (Ubuntu) but not on systems with different addresses for the stylesheets [12:18] it is: gnome/default.css [12:19] i mean the xml->html stylesheets [12:20] the customization stylesheets are, but the rest are standard location [12:20] if you have docbook installed, then you have the stylesheets installed [12:21] customization layer stylesheets are in gnome/libs [12:21] jeffsch, but for example on my gentoo system the stylesheets are in a different location, so the builds don't work [12:21] i smell an XML_CATALOG issue... [12:22] [10:46] jeffsch: you may want to update the ubuntu XML_CATALOG for ubuntu stuff [12:22] its just because the stylesheets are referred to by location, so when the location changes the build doesn't work [12:22] i don't know much about it tho [12:22] i don't think it is because of that [12:22] its the same for froud's stuff iirc [12:23] so the fault is yours for using gentoo then. :) [12:23] yes [12:23] but the same applies to suse and other stuff [12:23] actually what am I saying [12:23] everyone here uses Ubuntu [12:23] we don't need the stylesheets in our repo [12:24] i suppose if you want to build ubuntu docs on non ubuntu machines, you gotta deal with stuff [12:24] yup [12:24] so why did you ask if I'd done make sg earlier? [12:25] to see it the stylesheet customization works on other machines [12:25] it wasn't working until the other day [12:25] ah [12:25] the css is the same as for froud's stuff with a pale draft thing on the background [12:26] i got it working on mine, updated the repos, and etc etc [12:26] we should get some ubuntu bling in [12:26] maybe henrik will do it [12:26] yeah, i just copied the default.css from the kde folders [12:26] yeah ubuntu bling is the next step [12:26] hey guess what... take a look at gnome/Makefile [12:27] it looks like froud added stuff so stylesheets are found on SUSE machines [12:27] maybe you could do the same for gentoo [12:27] good plan [12:28] so jeffsch you have learnt how to convert html and such? [12:28] /html/to html [12:28] you mean xslt? [12:29] i dunno [12:29] but you think you might be able to take care of producing make targets for the gnome stuff? [12:29] you mean like make ug for user guide, etc? [12:29] that sort of thing [12:30] already done. [12:30] try it [12:30] sure, but in future too [12:30] yeah. hopefully there won't be much to change in the future [12:30] hope so [12:30] just sort the css i guess [12:31] yeah. a new css with ubuntu bling would be nice [12:31] we can ask henrik [12:32] yeah. that stuff prolly already exists [12:32] oh yeah [12:32] just need to merge it with the current css you and froud are using right? [12:33] hopefull, just have to replace default.css [12:33] cool [12:34] for draft we could use the theme from the wiki css draft page [12:37] mdke: did you apply njal's patch? [12:39] jeffsch, yep [12:39] he wrote and said he appreciated the feedback and would work on it [12:41] ok. his writing style is pretty cool. but, alas, we are writing tech docs... [12:42] yep === robitaille robitaille is finally here, 60 mins after starting his IRC client; hi mdke! [12:42] i referred him to the styleguide but also said that the styleguide didn't have a lot of stuff on grammar/style yet so to use the links provided [12:43] hey robitaille :) === jeffsch thinks robitaille needs to upgrade his 486 [12:43] hello again. I started irrsi in a window, then totally forgot about it while doing other stuff [12:44] ;) [12:47] hmm [12:48] looks like mediawiki isn't packaged for sarge [12:48] oh, or ubuntu [01:09] ok i've found the gnome ug jeffsch [01:10] its big and v complicated [01:10] is it split across a bunch of files? [01:10] yeah looks like it [01:11] i'm still checking out the enormous cvs right now [01:11] all the languages have their own screenshots [01:11] if we use the gnome ug we should figure out a way to use the translations... [01:11] ;) [01:13] will it be compatible with rosetta? [01:13] boh [01:13] i have no idea how they organise their translations [01:14] gnome don't like rosetta because it provides no means of pushing translations upstream that by rights should be done originally in rosetta [01:15] hmmm... it's getting more and more complicated [01:15] don't worry [01:15] most of the translations are probably years old [01:15] the italian ones were committed 2 years ago [01:16] ditto fr [01:17] yikes! it must make life a little difficult for new user trying to learn gnome desktop [01:17] yep [01:18] so what do you think we should do with this gnome ug [01:18] jeffsch, ^^ [01:18] add in the complication that ubuntu desktop is slightly different than gnome desktop [01:19] i think i need to read it more before knowing for sure what to do [01:19] in the end, we should do whatever is best for ubuntu users [01:19] yeah [01:20] jeffsch, i might put it in svn and we can look at it and then discuss at next meeting [01:20] what do you think? [01:20] sounds good [01:20] just the en ;) [01:20] i'll put it in teamstuff [01:20] yeah. and gnome calls en C for some reason [01:20] yes [01:22] i think we should worry less about what we can push upstream, and more about the ubuntu user experience [01:23] agreed [01:26] jeffsch, should I include the screenshots in my commit? might make a quite large [01:27] i would include them. people need to see that they are not ubuntu [01:28] ouch ok here goes [01:29] gnome docs try to avoid screenshots anyway, so it shouldn't be too large [01:29] at least in theory :) [01:29] ok here it comes [01:37] phew === mdke strokes his upload connection [01:38] hmm... not too bad... only 5M [01:38] heh [01:38] takes a while on 128 upload [01:39] changelog says last update was 2004-08-27 [01:40] but nothing substantial since 2004-04-20 [01:41] last cvs commit was 3 months ago [01:41] i think all he did was probably to put his name on the top and change it to gnome 2.10 ;) [01:41] that's WRONG man [01:43] hey... there's two pdf files in there for a total of 2.8M [01:45] sorry [01:45] i'll remove em shall I? [01:45] one is gnome 2.2 and the other gnome 2.4 [01:45] not your fault! [01:45] yeah, remove em [01:46] cuts the download in half [01:46] done [01:47] thanks for pointing that out [01:57] jeffsch, there is a lot of good stuff in there [02:04] yeah, there is. [02:05] how much work you think it would take to make it suitable for ubuntu (before integrating the stuff we already have in the current ug)? [02:05] i have no idea [02:06] i'm thinking quite a bit [02:06] but your method would inspire a better structure for the finished document, our userguide is not well structured right now [02:06] it might be a good learning experience to go through line by line, making sure the menus all point to the right place, and so on [02:07] people would learn the docbook tags [02:07] it depends really on whether anyone is willing to put the work in [02:07] it would be tedious, that's for sure [02:07] btw did you ever incorporate the tags from gtaylor into the styleguide? [02:07] not yet [02:16] i gotta run. cya [02:16] bye mate === jsgotangco [~jsg@202.57.71.235] has joined #ubuntu-doc === rob^ [~rob@rob-ubuntu.student.supporter.pdpc] has joined #ubuntu-doc === jsgotangco [~user@202.57.71.235] has joined #ubuntu-doc === jsgotangco wonders what's with the huge update on svn this weekend [03:49] hmm its all kde [03:49] the beginnings of a vendor drop... [03:57] hi jsgotangco [03:57] good weekend? [03:58] aye we just arrived last night [03:58] so i wasn't able to check out the happenings over in ubuntu land [03:58] seems the natives have been quiet lately [03:58] arrived where? [03:59] oh we went home to my folks' old farm we haven't been going there lately [04:00] nice [04:00] how does one do an xinclude? [04:00] to include part of another document [04:01] hmm [04:02] maybe it isn't possible with another document that isn't in our repo lol [04:03] i think you have to declare it first in the DTD [04:04] i wanted to include the update-manager in the userguide [04:04] ahhh you've been busy [04:05] BTW [04:05] how was edubuntu [04:06] (i almost forgot about it) [04:06] it was really cool [04:06] i met some cool people [04:06] and learnt some interesting things [04:06] who was there? [04:07] mdz, mark, henrik, ogra from ubuntu [04:07] colin applegate and paul flint [04:07] ah so colin was there [04:07] (don't know paul flint) [04:07] he's an incredibly loud american [04:08] aren't they all [04:08] some people from guadalinex, skolelinux and some uk folk in education [04:08] *grin* [04:08] heh colin was the opposite [04:08] guadalinex..hrmmm... [04:08] let me guess [04:08] it is an incredible project [04:08] javier carranza? [04:08] they have 200,000 installs on school computers [04:08] that wasn't the guy i think [04:09] did you get to talk to mdz [04:09] a little [04:09] ahh [04:09] i was really blown away by him [04:09] and mark too [04:09] is ogra leading the project [04:09] i believe so [04:09] he was also real nice [04:10] ah also Jane was there [04:10] JaneW! [04:10] err so what happened? [04:10] i only went on the first day [04:11] it was a lot of brainstorming and people talking about their experiences with school based projects [04:11] pretty interesting [04:11] you'll find stuff on the wiki, i believe Jane was putting it up as she took notes [04:12] hmm ok [04:12] did elkner come? [04:13] nope he didn't make it [04:14] oh too bad he's a really niceguy [04:15] anyway i was really impressed by the Ubuntu guys [04:15] they are very smart and also friendly [04:15] the actual conference was a little disorganised but in general it was probably quite useful to all concerned, at least on day 1 [04:18] oh edubuntu was incredibly specific [04:18] we were a riot in sydney [04:18] im getting lost in our svn [04:18] hrrmm [04:19] whereabouts? [04:19] or i forgot [04:20] jordi was there [04:20] i think that is everyone [04:21] jordi! [04:21] well i haven't been doing any useful svn stuff lately [04:22] that's why i guess i am lost [04:22] i have been looking into scrollkeeper [04:22] oh awesome [04:22] how is it going? [04:22] oh its like a jungle out there [04:23] its basically similar to comparing two tables [04:23] except the other table is incredibly overflowing with stuff [04:25] btw I emailed the -devel and -users lists reporting on the meeting, just to try and keep the ubuntu world up to date on our group [04:25] hopefully we can attract more contributors [04:25] i should have done that before, but that thanks [04:25] np [04:26] hmmm great hoary doesn't detect my old hp printer [04:26] i guess it doesnt like usb printers yet === mpt [~mpt@203-167-186-120.dsl.clear.net.nz] has joined #ubuntu-doc [04:39] hmm [04:43] its strange everytime you send to the list, it requires authorization [04:45] me? [04:45] that is because I am thick and keep sending from the wrong address [04:46] i keep cancelling the posts though as soon as I realise [04:46] so you shouldn't have to moderate them [04:47] yeah well it still informs me anyway [04:47] it won't happen again, i've subscribed both addresses now [04:47] oh [04:47] i don't set that for ubuntu-it [04:50] hey we've made no 1 on distrowatch for last 12 months now too [04:50] awesome [04:50] not bad for a distro that is yet to reach 1 year old [04:51] quite [04:52] ok bed time [04:52] 4 am [04:54] hmmm an underwater volcano is erupting near iwo jima [04:54] nice [04:54] must be Godzilla === Trace [~Trace@61.149.156.41] has joined #ubuntu-doc [07:21] Hello, I am very intrested in hardware detection of Ubuntu, can someone tell me where i can find such doc? === ealden [~ealden@219.90.92.176] has joined #ubuntu-doc === judax [~judax@ppp-69-148-18-161.dsl.austtx.swbell.net] has joined #ubuntu-doc === jsgotangco [~jsg@202.57.71.235] has joined #ubuntu-doc === froud [~sean@ndn-165-142-120.telkomadsl.co.za] has joined #ubuntu-doc [08:45] African Greetings [08:47] froud, hi [08:47] waz up jsgotangco [08:47] nothing much, sorry i'm not doing that much svn work lately, i'm currently lost at it, but i'm doing stuff on scrollkeeper [08:48] scrollkeeper, why? [08:49] i'm digging at the stuff not being used at all or disorganized [08:49] ok whatever tickles your fancy [08:50] have you seen the new kde system settings [08:50] replaces kcontrol in kubuntu [08:50] yeah [08:50] im totally lost at it [08:50] atm [08:51] http://lnix.net/~froud/kquickguide/C/ch03s07.html [08:52] why lost? [08:52] what KDE is this? [08:52] KDE 3.5? [08:53] Kubuntu Breezy [08:53] KControl is dropped for kde-systemsettings [08:53] it is not part of standard kde [08:54] hmm probably because i haven't been using kubuntu lately, reason why i am lost [08:55] no I had to compile it and install it, Kubuntu breezy is not ready yet. [08:55] Riddell did a good job with it, I think [08:56] hmmm isn't it too early to do the compiling thing and breezy-fying the doc [08:57] yes and no. Things like this need to start early or we will not have enough time later [08:57] as much as i'd like to do more stuff (which i believe im capable of), im so limited with hardware atm [08:58] I use removable hard drives on some of the lab machines [08:58] well school run c u laters === froud [~froud@ndn-165-142-120.telkomadsl.co.za] has joined #ubuntu-doc [09:24] welcome back [09:25] yep [09:25] canged hosts [09:25] changed === Seveas [~seveas@seveas.demon.nl] has joined #ubuntu-doc [09:28] ahh i thought you were in a school run [09:28] yes it was [09:29] then I leave my laptop and the louge and move to my home office [09:33] thats nice === _froud_ [~froud@ndn-165-142-120.telkomadsl.co.za] has joined #ubuntu-doc === FLeiXiuS [~fleixius@pcp0010487351pcs.essex01.md.comcast.net] has joined #ubuntu-doc === rob^ [~guest1@rob-ubuntu.student.supporter.pdpc] has joined #ubuntu-doc === sigurdga [~sigurd@45.80-203-115.nextgentel.com] has left #ubuntu-doc [] === rob^ [~guest1@rob-ubuntu.student.supporter.pdpc] has joined #ubuntu-doc [12:52] _froud_, thanks for the email [12:52] which of the two solutions would you consider to be more desirable? [12:52] sounds like vendor drop is probably more satisfactory [12:53] <_froud_> vendor drop in vendpr/gnome/ [12:53] vendor/gnome/ [12:54] yeah [12:54] froud, what did you do with njal's patch? i had already applied it yesterday [12:55] did he send another? [12:55] Hmm yes there was another [12:55] I applied it [12:55] it's all deletes [12:56] no [12:56] http://lists.ubuntu.com/archives/ubuntu-doc-commits/2005-July/000882.html [12:56] --- userguide.xml(revision 1341) [12:56] +++ userguide.xml(working copy) [12:56] @@ -1980,6 +1980,15 @@ [12:56] directorys (see above), folder newfolder should be [12:56] in the list. [12:56] [12:56] + [12:56] + [12:56] + Change Directorys: - cd (/directory/location) [12:56] + This is a simple enough command cd (Change Directory) typing cd on it's own will take you to your home (/home/yourusername) directory, sometimes known as ~. To get to the new folder you created type cd ~/newfolder (remember that ~ is a shortcut, nothing wrong with shortcuts). [12:57] + [12:57] + [12:57] + Remove Directorys: - rm -rf (directoryname) [12:57] no need to do massive paste's like that! [12:57] + Again the command is simple, to remove the newfolder type cd ~ (just to get you outside of the directory before you delete it) now type rm -rf newfolder, how do you know it is gone? Simple, type your prefered command for viewing directorys, is newfolder there? It shouldnt be. Congratulations you have used the basic file management functions in the terminal. [12:57] + [12:57] [12:57] [12:57] [12:57] I'm talking about a totally different revision [12:57] revision 1347 [12:57] all that section above is deleted now [12:58] check the link i posted above, it shows the revision [12:59] i think what has happened is that you applied the patch that i had already applied [01:01] Argh! when you patch send mail to list otherwise we will collide [01:01] i did [01:01] just role back my version [01:01] i'm pretty sure [01:01] I did not get message [01:01] perhaps I sent it accidentally only to njal [01:02] hmm [01:02] how does on roll back? [01:02] on/one [01:04] froud, still here? [01:06] mdke: read http://svnbook.red-bean.com/en/1.1/svn-book.html#svn-ch-4 [01:06] search for "Undoing Changes" [01:06] bit busy just now [01:07] working on deadlines [01:07] cool thanks [01:12] froud, ok I've rolled back [01:12] sorry about that [01:12] cheer now you know how :-) [01:12] no my fault I should have checked [01:12] both our faults [01:12] if you have time later you have to teach me vendor drops [01:12] Ok I won't argue ;-) [01:13] but good if you know about merging and branching [01:13] helps if other learn this stuff [01:13] yes I've bookmarked that document === jiyuu0 [~jiyuu0@219.95.63.70] has joined #ubuntu-doc [01:32] http://cvs.gnome.org/viewcvs/update-manager/help/C/ <-- froud is that the right one? [01:32] yep [01:33] has last patch from jeffsch [01:34] wicked am adding to svn now [01:36] oh no i'm not [01:36] vendor is outside trunk? [01:36] yes [01:36] you will find vendor/gnome [01:36] bugger [01:37] i only have trunk right now [01:37] checkout vendor relative to your trunk [01:37] svn co https://docteam.ubuntu.com/repos/vendor vendor [01:37] from where do i type that? [01:38] home? [01:38] where is you ubuntu-docs/ [01:38] in home [01:38] so cd ubuntu-docs [01:39] when you ls you should see trunk/ [01:39] then do svn co https://docteam.ubuntu.com/repos/vendor vendor [01:39] no when I ls I see the contents of trunk [01:39] btw when you bringin the doc dont bring in any .cvs folders [01:39] i won't [01:39] and use svn import not svn commit [01:39] ok [01:39] oh dear [01:40] you have trunk in ubuntu-docs [01:40] yes [01:40] Hmm [01:40] because that is what it says on the StepbyStepRepositories page [01:40] yes [01:40] i just followed that [01:40] svn for dummies [01:40] not that you are a dummy [01:40] fair enough [01:41] how come vendor isn't in trunk? [01:41] make a new folder for your docs [01:41] then [01:41] ok done [01:41] svn co https://docteam.ubuntu.com/repos {thatfolder} [01:42] that will give you branches/ trunk/ tags/ and vendor/ [01:42] its big [01:42] i bet [01:42] ok will do that [01:42] but that is everything to do with the project [01:42] how come vendor isn't in trunk tho? [01:43] that's the way svn repos's are structured [01:43] you should read more from svn book :-) [01:43] does it mean that people who don't have vendor checked out can't build html documents that use vendor? [01:44] yes [01:44] that is a shame [01:44] that is one of the downsides [01:44] can't we put vendor inside trunk? [01:44] of a v drop [01:44] you can, but [01:44] best keep a v drop in vendor and then if you want copy it to trunk/gnome [01:45] how come? [01:45] you see you will have to have a checkout of the upstream outside your svn wc [01:45] so you can update that copy and diff changes into the svn wc vendor drop [01:46] i don't get it :/ [01:46] for example I have all kde svn in seperate workspace [01:46] and I have a copy of kde docs in our my copy of ubuntu-doc svn [01:46] I merge changes upstream to the ubuntu copy and commit them [01:47] yes i see [01:47] but why can't that be done to trunk/vendor? [01:47] this is why baz is a better system :-) [01:47] You want vendor to remain as printine to upstream as possible [01:47] pristine [01:47] can't changes be merged to trunk/vendor and committed? that way it still remains identical to upstream [01:48] yes, but trunk is where the whole world hacks [01:48] strange stuff happens in trunk [01:48] i haven't noticed that ;) [01:48] in trunk you will lose control of the vendor drop [01:49] better keep it out of site and mae people know that they do not change that unless it is gnome (upstream) specific [01:49] and if they do change in vendor/ then that patch must be moved upstream [01:50] hmm [01:50] so before you patch a vendor you must also merge changes in upstream into the drop [01:50] but now that you have a v drop [01:50] but it also means that most people don't see the xinclude material when they view the document [01:50] you can XInclude or XPointer to those docs [01:50] yes [01:50] only when they have the vendor/ [01:50] that is really bad :/ [01:51] that is why you can then make an svn copy from vendor/gnome to trunk/gnome/upstream [01:51] froud, don't the xinclude and xpointer links have to be changed then? [01:51] that way they will not need vendor/ and you can maintain the pristine quality of the vendor/ [01:52] yes instead of refing the ../../../../vendor/ [01:52] they refer to the copy in trunk/gnome/upstream/ [01:53] When I start using the kde drop I will make a copy of the kde v drop in trunk/kde/upstream [01:53] I dont want people hacking the vendor/ [01:53] and the links you make in the documents will be to trunk/kde/upstream? [01:53] or to vendor? [01:53] the trunk [01:53] ok i see, that has reassured me [01:54] Also I want canges in the trunk/kde/upstream to be selectively merged into /vendor/kde/ [01:54] then and only then will I patch and move the changes upstream [01:54] yes i see that [01:54] capish [01:54] si [01:55] thanks froud [01:55] now to check out repos [01:55] so you must hold a string hand on what people do to your trunk/copy of the upstream [01:55] s/string/strong [01:55] remember no ubuntu stuff in there [01:56] if they do, shoot them [01:56] yes [01:56] only upstream specific stuff [01:56] but if they do stuff, it is not hard to delete it and revert back to the upstream from vendor/ [01:56] and remember that at gnome you must talk to the maintainer [01:56] correct [01:56] talk to the maintainer? [01:56] y? [01:56] but you dont want to be working at reverting their changes [01:57] true [01:57] yes maintainer for update manager is me [01:57] so go for it [01:57] but why is it necessary to talk to the maintainer? [01:57] but for gug you cant just make changes [01:57] gnome policy [01:57] no changes without mainter [01:58] kde is diff, everyone can change a kde doc [01:58] changes to upstream you mean? [01:58] or changes in our docs? [01:58] but in gnome, you speak to the maintainer, upstream [01:58] i don't intend to make any changes upstream, for a start I don't have access to their cvs [01:59] speaking to the gnome doc mainter is good idea. if they say yes, then you know that the patch will be accepted. if they say no, not a good idea, then you wont waste time working on a patch that wont be acepted [01:59] oh if we do patches, naturally I will speak to them [01:59] but right now it is just a question of using them [02:00] I have access, but must first speak to mainaters [02:00] rules, geeze they suck [02:01] now if mainters dont respond [02:01] just contact gnome-docs mailing list [02:01] yes but as I say, i don't intend to do patches right now [02:01] if no response, I will patch as silence will be considered consent :-) [02:02] sure, just so you know [02:02] yep [02:02] the silence is consent thing [02:02] that is the worst concept ever [02:02] you will find it it the only way to move forward in some cases [02:02] well it works in FOSS [02:03] not for me [02:03] well then you will find progress slow going :-) [02:03] see what I have done in 1 week with kubuntu [02:03] I speak to our list and if people have no comment I go for it [02:04] I give enough time for the timezones to read and respond [02:04] if no response, proceed [02:04] otherwise you will get stuck === mdke doesn't respond [02:05] know it does not sound nice, but sometimes it must be the way [02:05] if you want to make progress you must do [02:05] well everyone works differently [02:05] if people don't contribute comments you must just do [02:05] it depends what it is [02:05] you will get much more done that way [02:06] you know my views on this [02:06] well it's up to you :-) [02:06] yes [02:06] ok thanks for your help with the repos [02:06] but as you can see, the progress I make is substantial [02:06] enough of this please [02:06] Oh no === froud goes back to dealines === plovs [~plovs@195.13.248.82] has joined #ubuntu-doc [02:28] mdke: ping [02:28] hi mpt [02:29] I'd like to actually start doing some writing [02:29] cool [02:29] of Ubuntu Help [02:29] anything in mind? [02:29] aha [02:29] I've chatted with shaunm of gnome-docs fame [02:29] so yelp will default to opening a particular book [02:30] rather than defaulting to a hierarchy of software [02:30] for vanilla Gnome, that will be the Gnome User Guide [02:30] Does the GUG have any relationship to any of the docs listed on https://wiki.ubuntu.com/DocteamProjects ? [02:30] the gnome user guide was last updated about a year ago [02:31] sure, so a lot of changes will need to go upstream as well [02:31] you will find a copy of it in teamstuff/ [02:31] I'm under no illusions about the amount of stuff that will need rewriting, no matter what the starting point is [02:31] mpt, perhaps you can contribute to the thread on the mailing list about it? [02:32] as far as yelp opening a particular book, IMO that decision should be one that the team should take together [02:33] we have been thinking about how to use the gnome user guide, if at all. there is a thread on the mailing list and jeffsch has some ideas about it too [02:33] ok [02:33] that's why I put it in our repo so we can look at it and talk about it [02:33] ah, that's why it's not in my local tree [02:34] which I last updated, um, a month or so ago :-) [02:34] i put it in yesterday [02:34] ok, so if maybe 80~90% of my changes would be suitable for upstream [02:34] who would be in charge of merging such changes into the Ubuntu version? [02:35] anyone who put their hand up? [02:35] well it will come into Ubuntu in the normal way, through debian I suppose [02:36] As for the decision, I think it's being made upstream [02:36] if we decide to use the GUG in our docs, then it will depend on how we do it [02:36] well the decision on what yelp displays is one that is taken at a distro level is it not? [02:37] especially if our documentation is going to be in a different format (html), yelp will have to be instructed accordingly [02:38] mdke: dude -> [02:38] http://cia.navi.cx/stats/project/gnome/gnome-user-docs [02:38] gnome2-user-docs package will be done by seb for ubuntu, most likely [02:39] jdub, what is that link? [02:39] mdke: cvs commits for the user guide [02:40] jdub, is it different to http://cvs.gnome.org/viewcvs/gnome-user-docs/gnome2-user-guide/C/ ? [02:41] why ask me when you could read the page? [02:41] jdub, it looks different to me, so that's why I asked [02:41] you're looking at a different directory of the same cvs module [02:41] okay [02:42] jdub, but I assume your reason for posting me the link was to show that the userguide is not out of date? [02:42] mostly that it has been touched more recently than a year [02:42] 3 months is a particularly telling period, too === mpt subscribes to YAML, gnome-doc-list [02:43] jdub, yes, the changelog shows that a couple of minor changes have been made since a year ago, but essentially what has happened is that the document is a 2.6 guide, with a 2.10 label [02:43] ask seb what he thinks of it [02:44] it refers to applications:// and menu editing via right click [02:45] but I agree, that page shows a lot more edits than appear in the changelog that I'd previously looked at [02:45] (check the diffs, they're not that minor_ [02:46] am looking now [02:46] (the final one is the only one not in ubuntu) [02:46] anyway, it's definitely less than a year, and on par with release dates [02:47] ok whatever, if you're happy with it, then that is fine by me [02:47] if its being actively developed, then I will file bugs for the stuff that I consider to be out of date [02:49] arg, it's GFDL [02:51] mdke: it's not without flaws, but it has had recent attention [02:52] okay well the thread on the mailing list is there if you guys have ideas about how we should use the GUG [02:53] mpt, it may be that your idea is similar to jeffsch 's === mpt wonders how that thread ended up in his Trash unread [03:00] mdke, I don't see any messages from jeffsch in that thread [03:01] mpt, no he hasn't sent any [03:01] he expressed his idea yesterday in irc [03:01] mdke: jeffsch wants to for the code [03:01] erm [03:01] pardon? [03:02] jeffsch: wanted to for GDP code for the gug [03:02] to for? [03:02] but if jdub has an ubuntu version of gug then better to use that === mdke rubs his eyes [03:03] ubuntu version? [03:03] jeffsch: idea was to take the gug and rework it to uug [03:03] yes... [03:03] i was here === plovs [~plovs@195.13.248.82] has joined #ubuntu-doc [03:04] ah you mean fork [03:04] gotcha [03:04] is that new version ubuntu specific? [03:04] that is not a new version [03:04] ak more recent version [03:04] no its the same version [03:04] is it gnome or ubuntu [03:05] hmm we're not understanding each other [03:05] froud, what on earth are you talking about? [03:05] damn [03:05] i mucked up the vendor drop === mdke tries again [03:05] http://cia.navi.cx/stats/project/gnome/gnome-user-docs [03:05] is this a more recent version of the gnome doc? [03:05] no [03:06] it is cvs stats [03:06] click on it and you'll see [03:06] yes, but the patches show a more recent version that what you see in cvs [03:06] i asked jdub and he said it was the same [03:07] OK [03:07] I see [03:07] well so longas you can maintain the v drop [03:07] you will be ok [03:07] and I would not count on the gdp being dead [03:07] i'm not doing a v drop of that, i'm doing one of update-manager [03:08] it's been through this type of dead patch before === mpt reads http://developer.gnome.org/tools/cvs.html and cries [03:08] OK but you put it in teamstuff [03:08] not good [03:08] the gug [03:08] How do I set an environment variable? [03:08] I used to know that sort of thing, eight years ago [03:08] should not be in teamstuff [03:08] set [03:09] set constant=string [03:09] ? [03:09] the GUG is in teamstuff so that people can read it and look at it [03:09] it SHOULD be there [03:09] ouch [03:10] is that a good idea they can read it upstream [03:10] its not there for use or dropping, it is just for jeffsch and others to play aroudn [03:10] froud: Yes, but I forget where the $ is supposed to go, and what file I put that command in if I want it to be set whenever I log in [03:10] better to vendor it or jeffsch can make a branch [03:10] mpt: what you doing you want to export to your path [03:11] setting the CVSROOT variable [03:12] export CVSROOT=:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome [03:12] brilliant, thanks === mpt installs cvs [03:16] but the gnome2-user-guide cvs checkout is in teamstuff/ on our repository if you want to look at it [03:17] I don't want to look at it, I want to make a trial patch to see how easy the process is [03:17] okay [03:17] hmm, cvs login tells me I entered the wrong password [03:17] even though I'm anonymous [03:18] what command did you use? [03:18] mdke: much better :-) r1351 - in vendor/gnome/update-manager [03:18] mdke: cvs login [03:18] froud, second time lucky ;) [03:18] now if the gug could be the same it would be nice [03:18] froud, we haven't decided whether to vendor drop that or not yet [03:18] mpt, cvs -z3 co gnome-user-docs/gnome2-user-guide/C should be enough [03:19] aha, now it's working [03:19] yes, the instructions were badly written [03:19] suggesting that login was necessary even if you were anonymous [03:19] mpt, you were using the GDP guide? [03:20] I didn't know there was one [03:20] I'm using http://developer.gnome.org/tools/cvs.html [03:20] mpt, you're using the right one [03:21] froud, my svn up isn't working now i did that import [03:21] ok fixed it [03:22] nooooo, I don't want the Gnome User Guide for Gnome 1.4 in Spanish [03:23] mdke: hmm [03:23] works here [03:23] mpt, you're checking out the whole tree? [03:24] hardcore ;) [03:24] mpt, cvs -z3 co gnome-user-docs/gnome2-user-guide/C [03:24] mdke: you must now delete the folder and then do svn up [03:24] froud, yeah that's what I did :) [03:24] remembe ryou use dimport [03:24] its working now [03:24] ok cool [03:24] mdke: Yes, I wasn't following your instructions closely enough [03:25] right now I have it too :-) [03:25] mpt, otherwise you get all the screenshots for each language ;) === rob^ [~rob@rob-ubuntu.student.supporter.pdpc] has joined #ubuntu-doc [03:32] help shouldn't have screenshots in it anyway [03:32] but yeah, I have just the C-ish version now [03:32] mdke: see trunk/kde for example if vendor drp copy [03:33] trunk/kde/upstream/kde [03:33] svn up [03:33] cool! [03:33] nice one [03:33] mpt: (the guide-like documents and help infrastructure as they currently stand benefit from including screenshots; when we get to context/topic oriented help, i'll totally agree.) [03:33] if you can follow the same convention, then it will be easy for users to follow [03:34] jdub: yes agreed, books have screenshots help does not :-) [03:34] convention? [03:34] unless absolutely needed [03:34] can i just svn cp to trunk/gnome/upstream/gnome? [03:35] bingo [03:35] froud: that's not the most useful way of describing it at the moment. [03:35] I suggest making the extra gnome folder since you may have other upstreams [03:35] ok [03:35] jdub: ok [03:35] jdub: however you want to describe it [03:36] jdub: but as general convention making limited use of screeshots in help is good practice [03:36] jdub: for manuals it is different [03:37] my comment answers that (there is no distinction at the moment) [03:37] correct at present there is not [03:39] froud, ok i just did the svn copy, did i do it right? [03:40] yes [03:40] yay [03:41] shit I hav eto install XP on a box and I have lost my license keys [03:41] anyone know where I can get a key? [03:42] erm [03:42] XP is ebil [03:43] work sometime customers give me requirements to doc on windoze [03:44] i guess you can ring em up and ask for your licence key [03:45] and how do they know what key came with the box? [03:45] i don't know [03:45] shit and I dont have another widoze xp from which to copy it [03:45] maybe your vendor is the best bet if its an oem [03:46] he he this is africa dude [03:47] http://www.seriall.com/mostpopular.html [03:47] the internet you gotta love it === rob^ [~rob@rob-ubuntu.student.supporter.pdpc] has joined #ubuntu-doc === mpt wonders how to float an image in DocBook :-) [04:20] only works for xsl:fo and then you need an xslfo processor that supports floats [04:20] xep or xsl formatter will do it [04:20] but not fop [04:21] [04:21] [04:21] [04:21] [04:21] [04:21] I've already removed and from that, which were silly [04:21] It's just a little icon, it should be floated to the side [04:21] not really silly [04:22] depends on the case [04:22] I'm talking about this particular case [04:22] the text object is good [04:22] For perhaps 10% of illustrations, would be useful for blind users etc [04:22] when no image is found the text object value is displayed [04:22] yes [04:22] and for users using lynx === enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc [04:23] But in this case, if the illustration is not available, the best possible replacement is nothing at all [04:23] ok [04:23] The doc is much more pleasant+sensible without any replacement text than it would be with any replacement text you or I might think of [04:23] is the image inline to the text or in a block [04:23] It's on a line by itself [04:24] That's what I'm trying to change [04:24] block then [04:24] yes [04:24] what are the parents [04:24] I pasted them all [04:24] (now that I've removed ) [04:24] parents of the mediaobject === melodie [~melodie@dyn-213-36-22-40.ppp.tiscali.fr] has joined #ubuntu-doc [04:24] what are they now [04:25] [04:25] and above that, [04:27] mpt: http://www.sagehill.net/docbookxsl/FigureFloats.html [04:27] but as I said it only works for xslfo [04:28] perhaps the new stylesheets for html have fixed that [04:28] but last I used our stylesheets it did not [04:29] mdke: if you remember the burning problem and doc question I came for about one week ago [04:29] ? [04:29] I wanted to tell you I solved it :) [04:30] mpt: oh and as far as I know you should have a figure parent [04:30] I love how yelp crashes on any XML error [04:30]
[04:31] Draconian error handling at its most extreme :-) [04:31] [04:31] [04:31] [04:31] [04:31] [04:31] [04:31] [04:31]
[04:31] [04:31] [04:31] [04:31] [04:31] [04:31] [04:31] [04:31] [04:31] hope that helps [04:31] mpt but you sure yelp supports the floats [04:32] I see no support for it in the yelp xsls [04:32] woohoo [04:32] I definitely did have real XML errors there anyway [04:32] well my version is a bit behond === mpt wonders at the difference between , , and === mpt growls at Gaim for swallowing SGML tags [04:37] informalfigure, eh === plovs [~plovs@195.13.248.82] has joined #ubuntu-doc [04:40] thanks froud [04:48] mpt: http://www.docbook.org/tdg/en/html/docbook.html [04:49] difference between , , and [04:50] O. [04:50] ta [04:52] ah, is what inserts the arrows === jiyuu0 [~jiyuu0@219.95.63.70] has joined #ubuntu-doc === jdub_ [~jdub@home.waugh.id.au] has joined #ubuntu-doc [05:03] behind every quirky help file explanation is a usability bug [05:04] For ten points, what is the bug here? "1. Choose Actions Lock Screen. If that doesnt work, you dont have a screensaver set up. To set up a screensaver, open System Preferences Screensaver, and choose an item from the Mode: menu." [05:09] mdke: "cvs diff -u -p user-guide.xml" produces zero output. What might I be doing wrong? [05:11] oh, wait === FLeiXiuS [~fleixius@pcp0010487351pcs.essex01.md.comcast.net] has joined #ubuntu-doc [05:45] I figured it out [05:45] I was diffing the wrong file [05:45] Well, that was fun === karlheg [~karlheg@host-250-237.resnet.pdx.edu] has joined #ubuntu-doc === froud [~sean@ndn-165-142-120.telkomadsl.co.za] has joined #ubuntu-doc === karlheg [~karlheg@host-250-237.resnet.pdx.edu] has joined #ubuntu-doc