/srv/irclogs.ubuntu.com/2009/03/19/#ubuntu-doc.txt

j1mcmdke: are you around?01:17
j1mchi all17:20
j1mcmdke: are you around?17:20
j1mcwe have an issue with xubuntu docs, whereby basically the packaging of xubuntu docs results in a conflict with ubuntu docs.  i should have foreseen this, but i didn't.  we are considering packaging the documentation converted to html, and wanted to see if you thought that would be easier than modifying the build process to create yelp-compatible docs.17:22
j1mcbrb17:28
mdkej1mc: sounds tricky21:06
mdkej1mc: how does the conflict arise?21:06
j1mcmdke: the conflict arises in that the debian/build instructions basically tell the build process to build the docs in the same spot as the ubuntu docs.21:28
j1mcwhich, of course, makes sense21:28
j1mcmoreover, when yelp and ubuntu docs are installed, just opening yelp opens the ubuntu docs (i think... it at least opens gnome documentation).21:30
j1mci was thinking that just building out the html might be a better approach, but i'm not sure how difficult this would be, either.21:31
j1mcit would essentially involve creating a local copy of help.ubuntu.com, but the url's converted to be local file copies specific to xubuntu.21:32
mdkej1mc: that's a bit silly to install them in the same spot as the ubuntu-docs21:41
mdkej1mc: you should just install them somewhere else, in any event you'll need to patch yelp, right?21:42
j1mcmdke: understood.  i'm not really a build-file master, though.21:42
j1mcmdke: would patching yelp be difficult to do?21:42
mdkej1mc: i don't know, but haven't you been intending to do it since the beginning of this release cycle?21:44
j1mcto be honest, i didn't know that a patch would be necessary.  sorry i'm not the most advanced with these kinds of things.21:45
mdkeI thought that was the point of you having a new branch21:45
j1mcthe point of having the new branch was to use yelp, that's correct, but i didn't know that a patch on yelp would be necessary.21:45
mdkeargh.21:46
j1mcyeah.  :/21:47
mdkeok, I suppose if you had all the same documents as ubuntu-docs, then they could be installed in the same place and yelp would use them instead. I don't know if even that would work21:47
mdkebut it's truly ugly as a solution21:47
j1mcright - especially in that ubuntu docs and xubuntu docs would now conflict21:47
mdkethat's not really going to work, I don't think21:48
j1mcand both are part of the overall *-desktop metapackage for ubuntu and xubuntu21:48
mdkebecause the idea is that people can run different desktops at the same time21:48
j1mcyes21:48
mdkeI think what you'll need to do is to have a yelp-xubuntu package or similar and patch it to point at the xubuntu docs. Even that might be quite tricky21:49
mdkeat this stage in the release cycle I'd recommend doing whatever you did last release cycle...21:49
j1mcgoing back and updating the original package?21:49
j1mc... the original branch?  you really think that building out the html would be too difficult at this point?21:50
mdkewell, how did you ship the documents in the last release? as html?21:50
j1mcyes - do you recall the "docs that aren't valid docbook, but work together as a large meta-document"?21:51
mdkeyes21:51
mdkeso why don't you do the same again?21:51
mdkewith your new branch21:51
j1mchmm... the current branch has ghelp links in there.  would the fix-urls.sh script convert them into something that would work in the same way?  i don't think it would.21:52
j1mcthat script just converts the ghelp links for publishing help.ubuntu.com, right?21:52
mdkeyes, the idea of th fix-urls.sh script is to convert ghelp links into regular html links. But you would have to look at the script and ensure that it covers all of your links21:53
mdkeI'm sure you could adapt it21:53
j1mcright21:53
mdkeok, I have to go now21:54
mdkesee you21:54
j1mci would just have to modify my <xincludes...> links in my initial start page of the meta-document, i think.21:54
j1mcthanks, mdke.21:55
j1mci'll look into it.21:55
mdkegood luck!21:55
j1mcthanks :)21:55

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