/srv/irclogs.ubuntu.com/2009/05/05/#ubuntu-doc.txt

Rocket2DMnhey, where is the serverguide in the hardy branch?00:39
Rocket2DMnnvm found it00:44
Rocket2DMnping nhandler01:42
Rocket2DMnnhandler, you there?01:47
Shane_FaganIs anyone looking after Bug #187133 ?01:49
ubot4`Launchpad bug 187133 in ubuntu-docs "The section Listen to online audio streams is out-of-date and requires rework." [Medium,Confirmed] https://launchpad.net/bugs/18713301:49
Rocket2DMngo for it Shane_Fagan01:55
Shane_FaganSure im just about done now01:55
Shane_FaganIm updating the section on internet radio streams should I include info about vlc?02:11
Shane_FaganAh ill just mention that other media players support internet radio streams02:14
Shane_FaganIts quite annoying that rhythmbox's future in ubuntu is so uncertain. I added banshee just in case. Can someone review my patch and see if its ok? http://launchpadlibrarian.net/26334390/AudioStreams.diff02:24
nhandlerIf I am giving an example command that should be entered in the terminal, how should I denote text that the user needs to input. For example, 'sudo apt-get install <package>'. Should I put the item the user needs to change in <>'s, make it italicized, or something else?04:05
persiaI always liked the use of monospace sans-serif for that, personally, but I don't know the relevant standards applied within the group.04:14
Shane_Faganmdke: *ping15:57
=== jjesse_ is now known as jjesse
Rocket2DMnhey guys, did i move bug 371927 into the right package?22:42
ubot4`Launchpad bug 371927 in gnome-user-docs "documentation Section 2.4.2 -  Adding Workspaces" [Medium,Confirmed] https://launchpad.net/bugs/37192722:42
Rocket2DMnit was in ubuntu-docs, but after much frustration not finding what the user was talking about, i downloading the lp:gnome-user-docs and found it there22:42
Shane_FaganDougieRichardson: I put up another diff for you :)22:50
Shane_FaganBug #18713322:52
ubot4`Launchpad bug 187133 in ubuntu-docs "The section Listen to online audio streams is out-of-date and requires rework." [Medium,Confirmed] https://launchpad.net/bugs/18713322:52
DougieRichardsonShane_fagan: hi, I'll take a look in a mo - in ubuntu-learning meeting22:56
Shane_FaganNo bother take your time22:57
nhandlerWhat is the proper way to denote a placeholder in a command that the user needs to replace? For example, 'sudo apt-get install <package>'22:57
DougieRichardsongood question22:59
DougieRichardsonThere isn't an example I can think of off the top of my head, is there anything in the command line section of the advanced topics?23:01
nhandlerI'll look in a little bit. I have a MOTU Meeting followed by a BT meeting followed by a Wiki FG meeting ;)23:01
dsas_Rocket2DMn: Assuming that link is correct then the bug is likely in the workspace-switcher manual itself, that's probably a part of the gnome-panel package iirc23:01
dsas_DougieRichardson: Think it can get away with using $USER etc23:02
DougieRichardsonI'll have a look too but from memory I'm inclined to think we don't use placeholders23:02
DougieRichardsondsas_: hi mate, I dunno - people might feel the need to include the $ literal23:03
dsas_DougieRichardson: For the command line section that's ok23:03
dsas_echo $USER gives your username23:03
dsas_Re-reading that, my first line wasn't very clear. sorry23:04
DougieRichardsonagreed but if you did a sudo apt-get install $package-name it would bomb, wouldn't it?23:05
dsas_yes23:05
dsas_Sorry, wasn't suggesting it was a good idea to do that. Was just explaining what basic commands did23:05
DougieRichardsonoh sorry dude, long day23:05
dsas_Rocket2DMn: content being able to crash yelp is also a bug23:06
DougieRichardsonwhich bug23:09
dsas_DougieRichardson: 37192723:11
dsas_DougieRichardson: bug 37192723:11
ubot4`Launchpad bug 371927 in gnome-user-docs "documentation Section 2.4.2 -  Adding Workspaces" [Medium,Confirmed] https://launchpad.net/bugs/37192723:11
dsas_http://bugzilla.gnome.org/show_bug.cgi?id=549302 looks related23:11
ubot4`Gnome bug 549302 in docs "Window List and Workspace Switch applet help title "Problem Showing Document"" [Minor,Unconfirmed]23:11
DougieRichardsonIs this not a yelp problem?23:14
DougieRichardsonAlthough, it might be worth double checking the relevant source, I've crashed yelp before with my text23:14
Rocket2DMndsas_, thanks for the response. there were a couple of packages i looked into for that23:18
dsas_Hmm, actually the source validates23:19
dsas_/usr/share/gnome/help/workspace-switcher/C/workspace-switcher.xml23:19
DougieRichardsonHave you cat it - its deprecated23:21
Rocket2DMndsas_, that file is not where the content is23:21
Rocket2DMndsas_, in the gnome2-user-guide source, the content is in gosoverview.xml23:22
Rocket2DMnwhen i run "dpkg -S gosoverview.xml" i see gnome-user-guide23:22
dsas_heh, was just reading it, after validating it. Sorry you're right23:22
Rocket2DMnbut i saw more bugs filed against gnome-user-docs23:22
Rocket2DMnalthough there isnt a gnome-user-docs package in ubuntu23:23
Rocket2DMni guess gnome-user-guide is the right package?23:23
dsas_Rocket2DMn: gnome-user-docs is the source package iirc.23:24
Rocket2DMni am horrible about finding my way through documents, i cnat seem to find a logical connection between how stuff appears in yelp and how the docs are laid out23:24
DougieRichardsonThat file does crash yelp23:24
Rocket2DMnit always takes me forever to find what im looking for when somebody files a bug23:24
dsas_Rocket2DMn: It is often tricky. Specially as the search isn't great either.23:25
Rocket2DMnso we're sure it's gnome-user-guide?23:25
dsas_yep23:26
DougieRichardsonlooks like it23:26
Rocket2DMnlol gnome-user-guide isnt a valid option on lp23:26
dsas_gah23:27
dsas_it's gnome-user-docs23:27
Rocket2DMnhow do we know23:27
dsas_gnome-user-docs is the source package of gnome2-user-guide, the problem is either with that or with yelp23:28
Rocket2DMnhow did you find that out?23:28
Rocket2DMngnome2-user-guide isnt installed by default23:28
Rocket2DMnonly gnome-user-guide23:29
Rocket2DMnman after 2 years i have yet to figure this packaging stuff out...23:29
dsas_https://edge.launchpad.net/ubuntu/hardy/i386/gnome-user-guide23:30
dsas_at the bottom it says the source package.23:30
dsas_I think they renamed it from gnome2-user-guide to gnome-user-guide at some stage.23:30
Rocket2DMnhow did you navigate to that page exactly?23:32
Rocket2DMnlooks liek they replaced it after gutsy btw23:33
dsas_I searched for gnome-user-guide23:33
dsas_or something23:34
Rocket2DMnok, thanks23:34
dsas_I tend to search or hack the URLs, browsing LP is a pita23:34
dsas_dean@flik:/usr/share/gnome/help$ xmllint --noout --xinclude --noent --postvalid user-guide/C/gospanel.xml23:35
dsas_validity error : no DTD found!23:35
dsas_Document user-guide/C/gospanel.xml does not validate23:35
dsas_that is the correct file right2?23:35
Rocket2DMngosoverview.xml23:36
Shane_FaganDougieRichardson:  So have you reviewed my patch?23:37
dsas_oh gah, I get validation errors all over that directory, user-guide.xml is the root of it23:37
dsas_doesn't seem right, as I can view most of it in yelp23:38
* dsas_ is confused23:38
DougieRichardsonIts in one of the files it links to - one sec I think I see it23:40
Rocket2DMnok thanks dsas_ , i'll backtrace yelp later for that23:41
Rocket2DMngotta get food right now though23:41
DougieRichardsondsas_:there's an anchor and title tag transposed - just looking for them23:45
dsas_hmm, just noticed my name is listed as an author of user-guide/C/user-guide.xml I don't remember adding that23:55
DougieRichardsonlol23:59

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