tag:blogger.com,1999:blog-8198584Sat, 23 Mar 2024 17:59:50 +0000Things Phil Finds InterestingShameless plugs for cool stuff the KDE documentation team is doing.noreply@blogger.com (Philip Rodrigues)Blogger38125tag:blogger.com,1999:blog-8198584.post-117131016732321709Mon, 12 Feb 2007 19:44:00 +00002007-02-12T19:56:07.336+00:00POSTIn the true spirit of the lazy web, I'll put this out and see if anyone wants to take it up:<br /><br />I'd like to improve kbugbuster to help with KDE bug triage. One of the main limitations at the moment is that it can only use the email interface to make changes, so that limits the app to closing bugs as FIXED, and very little else. So, what I want is a way to make any type of changes allowed by bugzilla. The only way I could find was to "fake" being a web browser by sending HTTP POSTs. But try as I might, I can't get it to work. Making comments or changes to bugs in the KDE bugzilla just POSTs the form data to the process_bug.cgi script, but whatever I try, I get strange errors from the server.<br /><br />So, does anyone out there think they can do a better job of this? Ideally, I'd like to have C++ code using the KDE libraries to do this, but any kind of code would be fine - I can probably convert it to C++ if I can see exactly what's needed.2007/02/post.htmlnoreply@blogger.com (Philip Rodrigues)2tag:blogger.com,1999:blog-8198584.post-117066801930748561Mon, 05 Feb 2007 09:23:00 +00002007-02-05T09:33:39.323+00:00Guest blog!<p>So I'm playing at being a real blog writer, and having a guest blogger for this post. I guess Kurt Pfeifle needs no introduction, but here's some relevant info:</p><br /><br /><p><i>Kurt is a long-time KDE contributor, and living proof that you don't have to be a coder to have a real effect in improving KDE. He does a lot of work on the KDE Print system (just take a look at all the whatsthis help in the printing dialog), and has recently done a lot of work triaging kdeprint bug reports. He's currently working on the notorious problems with producing PDFs from KDE applications.</i></p><br /><br /><br /><p>I need a bit of help from some Qt or KDE developer guru. </p><br /><br /><p>Here is the problem: an unknown-to-me (and escaping-my-tracing-attempts) process keeps writing into my <i>qtrc</i> setting file(s) one specific key value that I want to remain unchanged. I want it to remain <i>"embedFonts=false"</i> as long as <b>*I*</b> tell it so; but some alien thing reverts it to <i>"embedFonts=true"</i> after each and every time I printed something.</p><br /><br /><p>Here some more details about my qtrc problem.</p><br /><br /><p>I know of 2 GUI applications that write this specific setting, when a certain checkbox is enabled:</p><br /><ul><br /> <li><i>"kaddprinterwizard --kdeconfig"</i>; select <i>"Fonts"</i>; enable <i>"Embed fonts in PostScript data when printing"</i></li><br /> <li><i>"qtconfig"</i>; select the <i>"Printer"</i> tab; activate <i>"Enable Font Embedding"</i></li><br /></ul><br /><p>The button <i>"System Options"</i> in kprinter does also start this same dialog (<i>"kaddprinterwizard --kdeconfig".)</i></p><br /><br /><p>Here is what I do:</p><br /><ul><br /> <li>open a KWord document</li><br /> <li>start the print dialog</li><br /> <li>click button <i>"System Options"</i> (i.o.w.: <i>"kaddprinterwizard --kdeconfig"</i>)</li><br /> <li>make sure fonts are *not* embedded; confirm</li><br /> <li>select the <i>"Print to file (PDF)"</i> printer</li><br /> <li>print it</li><br /></ul><br /><br /><p>Here is what happens:</p><br /><br /><ul><br /><li>Next time I want to print...</li><br /> <li>...I start the print dialog...</li><br /> <li>...I click button <i>"System Options"</i> (i.o.w.: <i>"kaddprinterwizard --kdeconfig"</i>)...</li> <br /> <li>...and annoyingly, I find that in the meantime, font embedding has magically been re-enabled!</li><br /></ul><br /><br /><p>The file qtrc comes in different incarnations: </p><br /><br /><ul><br /> <li><i>/etc/X11/qtrc</i> (for system-level settings). This one is used, when root runs <i>"qtconfig"</i>.</li><br /> <li><i>$HOME/.qt/qtrc</i> (for user-level settings). This one is used, when user runs <i>"qtconfig"</i> or <i>"kaddprinterwizard --kdeconfig"</i>.</li><br /></ul><br /><p>I assume, the settings in <i>$HOME/.qt/qtrc</i> should override settings of the <i>/etc/X11/qtrc</i> file for a user.</p><br /><br /><p>I verified that my clicking/confirming the change in the KDEPrint GUI does indeed write into the qtrc file momentarily. But as I said, this gets again reverted by another process. I also manually edited the system-wide <i>/etc/X11/qtrc</i> file and made sure it had <i>"embedFonts=false"</i> when I saved it. The above described behavior still remained unchanged, and even that system wide <i>/etc/X11/qtrc</i> file got reset!</p><br /><br /><p>I don't know who or what does mess with my qtrc file(s) and who or what resets my configuration to something I do not want for now. </p><br /><br /><p>For now, as a temporary workaround, I have changed permissions to all qtrc files found on my system to "0444" (read-only for user, group and others). This now ensures that my darn <i>"embedFonts=false"</i> entry remains stable; but this hack obviously is not exactly what the doctor ordered, and may lead to other problems on other corners of the system which I currently am not aware of....</p><br /><br /><p>So here are my questions to you:</p><br /><ul><br /> <li>Does this happen on your system too? (Mine is a SUSE-10.0 with qt3-3.3.7-9.3 and KDE 3.5.5, <b>*and*</b> libqt4-4.2.2-2.1 <b>*and*</b> libqt4-qt3support-4.2.2-2.1... but in any case, Qt4 doesn't seem to use a qtrc file any more.)</li><br /> <li>How can I find out who/what is re-setting the qtrc file behind my back?</li><br /> <li>How do I get rid of that behavior???</li><br /></ul>2007/02/guest-blog.htmlnoreply@blogger.com (Philip Rodrigues)1tag:blogger.com,1999:blog-8198584.post-116833447043766159Tue, 09 Jan 2007 08:47:00 +00002007-01-09T09:21:10.463+00:00Result!Just a quick post to say that the <a href=" bug triage weekend</a> was a huge success. Some highlights:<br /><ul><br /><li>Getting the <a href=" of unconfirmed konqueror bugs</a> (excluding wishes) down from over 950 to below 800.</li><br /><li>Making konqueror <a href=" (ie, more bugs closed than opened)</a> for the last 6 months. Of course, this builds on the great amount of hard work done over the longer term by the konqueror developers and other triagers, but as Adriaan would tell us, it's a nice metric.</li><br /><li>mafitzpatrick's incredible testcase work. I don't know how he does it...</li><br /><li>Kurt Pfeifle getting through all the khtml printing bugs</li><br /></ul><br />Of course, they weren't the only people working hard over the weekend - illogic-al, bram85 and logixoul did some great work co-ordinating the whole thing, and many more people checked, confirmed and otherwise triaged a lot of bugs. Thanks to all of them!<br /><br />And some thoughts I had that we can try out next time:<br /><ul><br /><li>Triage newer bugs instead of/as well as older bugs, since they're quite a different kettle of fish - easier in some ways, so nicer for people who haven't done triage before.</li><br /><li>Make lists of bugs in one particular component, to aid in finding duplicates</li><br /><li>Someone suggested we do KOffice next. Perhaps putting it here will help us remember :-)</li><br /></ul><br /><br />The main bug weekend is over now, but if you want to get involved and help out with bug triage, just drop by in #kde-bugs on irc.freenode.net sometime.2007/01/result.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-116794137939888121Thu, 04 Jan 2007 20:04:00 +00002007-01-04T20:09:39.463+00:00More bug triage!We've got another bug triage extravaganza planned for this weekend, the 6th-7th. So if you're free and you feel like helping KDE, drop by #kde-bugs on irc.freenode.net for a bit - it's really easy, and all you need is a recent KDE installation. Some tips on bug triage can be found <a href=" /><br />Looking forward to seeing you there!2007/01/more-bug-triage.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-115770416553227336Fri, 08 Sep 2006 08:24:00 +00002006-09-08T09:29:25.543+01:00Grand!They said it couldn't be done[1], but we've got the number of unconfirmed Konqueror bugs (excluding wishlists) below 1000, from 1305 a couple of weeks ago:<br /><a href=" konq bugs</a>.<br />There are also a huge bunch waiting for feedback ("Works for me. Does the bug still occur for you in KDE 3.5?") of which many, I suspect, will be closed in about a month.<br /><br />1. OK, so no one actually said this, but it does look a daunting task...2006/09/grand.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-115680327643171301Mon, 28 Aug 2006 22:05:00 +00002006-08-28T23:14:36.443+01:00Bugs!<p>Following a post on kde-devel about the number of UNCONFIRMED konqueror bugs, a few of us are going to try having a "konqueror bug triage day" this Wednesday, 30th Aug. We'll meet at 3pm UTC (10am CST, 5pm CET) in #konq-bugs on irc.freenode.net, and go on until whenever we like.</p><p>The aim is to sort through the bugs that have been reported, removing duplicates and bugs that are obsolete, so that the developers can spend their time fixing bugs instead of trawling through bugs.kde.org</p><p>We'd love to have more people to help, so whether or not you've done any bug triage before, please feel free to join us. All you'll need is a recent version of KDE (at least 3.5, but the newer the better), and a big of perseverance.</p><p>If you haven't done any bug triage before, you might like to<br />read these two pages to get an idea of what it involves:<ul><li><a href=" /></li><li><a href="2006/03/ive-got-little-bit-of-free-time-so.html">2006/03/ive-got-little-bit-of-free-time-so.html</a><br /></li><br /></ul><br /></p>2006/08/bugs.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-114676629557558316Thu, 04 May 2006 18:09:00 +00002006-05-04T19:11:35.590+01:00Let's go away for a whileExams are looming, so it's time for my annual disappearance from all things KDE. If you need to get hold of me, I'll be checking my email (philip-rodrigues-at-chch-ox-ac-uk).2006/05/lets-go-away-for-while.htmlnoreply@blogger.com (Philip Rodrigues)1tag:blogger.com,1999:blog-8198584.post-114479283005990562Tue, 11 Apr 2006 21:33:00 +00002006-04-11T23:00:30.160+01:00ChangelogCarsten suggests that <a href=" changelog should be in XML</a>. So, in the spirit of avoiding the work I have to do to pass my degree, I hacked up a little XML changelog, with some XSL to turn it into HTML. The tarball is <a href=";. Untar it, and then run either<br /><pre>xsltproc changelog.xsl changelog.xml > changelog.html</pre><br />for changes by app, or<br /><pre>xsltproc changelog-by-type.xsl changelog.xml > changelog.html</pre><br />for changes by type.<br /><br />It's just a proof-of-concept, so there are no doubt plenty of ways to improve it, but it's quite an elegant solution, and in purely technical terms, is probably the Right Way(TM) to do it (ie, XML changelog with XSL to convert it to HTML). However, the amaroK guys (I'm told) have a ruby script that produces HTML from a simpler, <i>ad hoc</i> changelog file format. Though lacking the technical elegance of the XML solution (he says, without having seen said ruby script), it might turn out to be the better option, since a simpler file format might mean more people adding to the file, and therefore a better changelog. Plus, I don't know ruby, so no one can ask me to maintain it :-).<br /><br />Oh, and since I mentioned XSL, does anyone know of some kind of "templating" system for it, so I could write (say)<br /><pre>if <i>condition</i> {<br /> ...<br /> }<br /></pre><br />instead of the fairly unpleasant<br /><pre><xsl:if test="<i>condition</i>"> <br /> ...<br /> </xsl:if><br /></pre><br />or the far, far worse way of sending parameters (arguments) to templates (functions). The basic ideas of XSL (templates, applying them with apply-templates) are really nice, but why oh why did they have to make it an XML variant? It's just nasty to look at, and seems like a particularly egregious case of "when all you have is a hammer...". OK, rant is over; we now return to your scheduled programming (and lots of comments telling me that I misused "egregious").2006/04/changelog.htmlnoreply@blogger.com (Philip Rodrigues)3tag:blogger.com,1999:blog-8198584.post-114435848917745520Thu, 06 Apr 2006 20:05:00 +00002006-04-06T22:21:29.236+01:00We're all coders now!Or at least, <a href=" am (kinda)</a>. It's great to get a code patch into KDE (even if it is only about three lines long), having committed lots of docs over the years. And I can't resist saying that it proves that there's lots of <a href=" fruit</a> in the bugs database, which can be fixed, or--in the case of wishlists--implemented with very little effort and knowledge. They're great ways to get involved in KDE!2006/04/were-all-coders-now.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-114422706675933464Wed, 05 Apr 2006 08:16:00 +00002006-04-05T09:51:06.860+01:00WhatsThis?If you read kde-core-devel or kde-devel, you'll have already heard about the proposal which the HCI team has produced for KDE 4. With input from usability, accessibility and documentation folks, they've produced a <a href=" design document</a> for an improved way of linking tooltips, whatsthis and documentation. The document is quite long, so here's a mini summary of some of the main points:<br /><br />At the moment, tooltips, whatsthis help and documentation are generally produced and presented to the user quite separately. In the HCI team proposal, they're brought together in a sort of natural progression of increasing detail: single-word or -phrase tooltips -> single paragraph whatsthis -> detailed docs. So, tooltips will present a way of progressing to whatsthis, which will present a way of progressing to the full documentation. This is one element of the proposal...<br /><br />...The second element is to improve the usability of the whatsthis windows themselves. At the moment, the whatsthis help appears in "bubbles" which disappear as soon as you click anywhere. That's obviously not ideal, so in the HCI team design, they're "upgraded" to full windows, so you can keep them open while following the instructions in them, have multiple whatsthis windows open, move the windows around, and so on.<br /><br />So far, it's just a design - what we need next is an implementation, so it can be tested, refined, and most importantly, so we can start putting content into the tooltips and whatsthis once KDE 4 applications are ready for it. So, if you're comfortable coding with C++/Qt/KDE, and you're looking for a way to get involved with KDE 4, please do <a href="mailto:phil at kde dot org">contact me</a>, and I can put you in touch with the HCI team, who will work closely with you to help get an implementation off the ground.2006/04/whatsthis.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-114304935212095877Wed, 22 Mar 2006 17:40:00 +00002006-03-22T17:42:32.136+00:00I've got a little bit of free time, so here's the first in what will<br />hopefully become a series of hints and tips about getting involved in<br />KDE without having to learn C++.<br /><br />Today's topic is bug triage. Around 80 new bugs and wishlist items are<br />filed in <a href=" bug tracking system</a><br />every day, and, while application and library maintainers try to look<br />at all of the ones reported for their application, their job is a lot<br />easier if someone else has already gone through and removed the<br />duplicates, asked the reporter for any additional information that's<br />useful, and noted which bugs can be reproduced.<br /><br />The really nice thing about bug triage is that it comes in very small,<br />bite-sized chunks: each bug report probably takes a few minutes to<br />look through, so you can spend ten minutes a day on bug triage (on<br />your coffee break!), and be able to do something useful - something<br />that isn't so practical with some other ways of helping KDE.<br /><br />The main reference for bug triaging, which I'd thoroughly recommend,<br />is the <a href=" />bugs howto</a>. That'll give you some pointers for getting started,<br />and tell you a little about how the bug tracking system works, what<br />the different bug statuses mean, and so on.<br /><br />So, once you've got an account on bugs.kde.org and read the<br />quality.kde.org howto, what do you do next? The first thing to do is<br />decide which bugs to concentrate on: do you want to look just the bugs<br />for one or two applications, or take an overview of al bugs that are<br />reported? If you're a long term KDE user, and are a little bit<br />familiar with the internals, then taking an overview might be for you:<br />you'll be able to see when bugs are filed against the wrong KDE<br />component, and suggest what other parts of KDE could be relevant to<br />the bug. If you're not familiar with the internals of KDE, you can<br />still do bug triage! Just pick an application you use a lot, or<br />particularly like, and concentrate on the bugs that are reported for<br />that application.<br /><br />Let's say you decide to concentrate on bugs in one particular app. You<br />can use the <a href=" page</a> to<br />display all the open bugs for that application, or just the bugs that<br />have been opened in the last few days. Take a look at each bug, with<br />the aim of determining whether or not the behaviour that the reporter<br />described is really a bug, and if so, making it easier for the<br />developer to fix it. Put yourself in the shoes of the developer - what extra information will they need to be able to<br />start fixing the bug?<br /><br />Some things to do: <br /><br /><ul> <br /><br /><li>First, try to reproduce the behaviour that the reporter has<br />described. Add a comment to say whether you could reproduce the bug,<br />noting your KDE version and distribution. If you don't understand the<br />description, ask for clarification - if you can't understand what the<br />reporter means, the developer probably won't be able to either.</li><br /><br /><li>If you can reproduce the behaviour, think of ways to narrow down<br />the cause: Imagine that an app crashes when you save a document. What<br />about selecting Save from the File menu? What about pressing Ctrl+S?<br />Does it happen for any document, or just certain documents (perhaps<br />certain file formats)? What about local vs remote files? This is where<br />you get to use your imagination a little bit, since every bug report is<br />different.</li><br /><br /><li>Try to find out whether the bug is related to a problem with<br />config files: trying to reproduce the bug with a newly created user<br />(and asking the reporter to do the same) is a good way to test<br />this.</li><br /><br /></ul><br /><br />Those are some common, simple things that I can think of. As you get<br />more experienced, you'll find other tips n' tricks that are useful,<br />especially if you choose to concentrate on just one application.<br /><br />So, in 20-second summary:<br /><h2>Bug triage</h2><br /><b>Why's it useful?</b> It makes bug hunting and fixing easier for<br />developers, so more bugs get fixed.<br /><br /><b>Why choose bug triage instead of ...?</b> It doesn't take much time<br />to look over a bug, so it comes in nice small chunks<br /><br /><b>What skills do I need to do it?</b> Not much, just a bit of<br />patience and sometimes some perseverance.2006/03/ive-got-little-bit-of-free-time-so.htmlnoreply@blogger.com (Philip Rodrigues)2tag:blogger.com,1999:blog-8198584.post-114211751137679110Sat, 11 Mar 2006 22:45:00 +00002006-03-11T22:51:51.386+00:00Serendipity<p>So I said I'd write some mini-howtos on non-coding ways to get involved with KDE. <a href=" Krammer has beaten me to it</a>, and he has some good information and insights. </p><br /><p>I don't have time to write a full mini howto, but I have a neat story about bug triage, and how the contributions of non-coders and coders can all come together quite nicely.</p><br /><p>It began (for me at least) with flicking through the bug reports, looking for anything I could usefully comment on. I noticed that <a href=" 122218</a> and <a href=" 122158</a> looked quite similar, so I added a comment to each bug to say so. Lubos fixed the second bug, and added a comment to the first to note how he'd done it. Enter Ismail Onur Filiz, who, on finding Lubos' explanation of the fix, codes up a patch. It's reviewed and applied, and there's one less bug in KMail :-).</p><br /><p>I'm quite pleased with that story, since it shows how non-coding contributions can help things happen, even if they're not directly producing the end result, and it makes me feel that my occasional bug triage attempts are useful.</p>2006/03/serendipity.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-114081151642761506Fri, 24 Feb 2006 20:01:00 +00002006-02-24T20:05:16.440+00:00<p>If I'd had a pound for every time some KDE user has said something<br />along the lines of "If I could code, I'd contribute to KDE," I<br />wouldn't be writing this on a laptop that was bottom-of-the-line when<br />I bought it three years ago.</p><br /><p>So, if you're a KDE user who has at some time or another thought or<br />said exactly that, what can you do? Well, there are two options:</p><br /><ul><li><p>Learn to code! I get the impression that some people think that the<br /> KDE coders entered the world with innate knowledge of C++ and Qt,<br /> and wrote their first KDE application just before saying their<br /> first word. They had to learn it just like the rest of us. It's not impossible to learn C++/Qt/KDE. Granted, it's not as easy as some other programming languages, but many<br /> contributors have proved that it can be done: just ask annma.</p></li><br /><li><p>Get involved with one of the very valuable non-coding tasks that<br /> help make KDE better. They range from writing docs and doing<br /> translations, through artwork and usability studies, to maintaining<br /> websites or doing bug triage. While these might not have the same<br /> "wow" factor as coding that killer feature, or fixing that<br /> long-standing bug, they're still extremely important to KDE, and<br /> can be just as satisfying.</li></p><br /></ul><br /><p>For example, take bug triage: KMail alone receives about 30<br />comments to bugs every day. The majority of these are users<br />either reporting new bugs/wishes or adding a comment to existing<br />ones. The small team of developers working on KMail can keep up<br />with these bugs a lot more easily if someone has already looked<br />through them and removed duplicates, confirmed those bugs which are<br />reproducible, and added any other useful information.</p><br /><p>It won't make you the next Linus, but it's one way to get to know more<br />about KDE, and in the end it helps make KDE better.</p><br /><p>I think I'll write a few blog entries over the next few weeks going<br />into more detail about specific ways to get involved. Maybe I'll even<br />polish them up enough to become dot articles. Which reminds me, I have<br />some notes of Aaron's "10 ways to get involved in open source" talk<br />which I should turn into full sentences so they can be article-ized.</p>2006/02/if-id-had-pound-for-every-time-some.htmlnoreply@blogger.com (Philip Rodrigues)6tag:blogger.com,1999:blog-8198584.post-113875224005016291Tue, 31 Jan 2006 23:39:00 +00002006-02-01T00:04:00.150+00:00"Kafkaesque, isn't it?"An amusing bit of randomness that makes life more interesting: it turns out that some teenager in Québec goes by the MSN user name of accengrave at hotmail.com, whereas I'm accentgrave at hotmail.com. So of course, he tells his friends his username, and they add me instead (serves 'em right for not pronouncing all those letters, I suppose ;-). I think I now have most of this guy's friends in my contact list, and I've spent plenty of time trying to decode "MSN French" (evidently the Académie Française hasn't managed to extend its influence as far as IM-using teenagers).<br /><br />In KDE land, not a lot's happened. I want to have some time to work on ways to turn the hype about KDE 4 into well-directed effort. People turn up in #kde asking when KDE 4 will be out, trying to build trunk, etc, and it would be great to be able to tell them of good places to direct their energy (seeing as building trunk isn't exciting at the moment unless you're hacking kdelibs, AIUI). Aaron's <a href="; on "10 ways to get involved in KDE" has some nice ideas. Perhaps a dot article on "10 ways to help make KDE 4 the best ever" would be useful. Alas, time doesn't permit at the moment, with university life taking it all up.<br /><br />I did have some fun(?) chasing down a bug in the audiocd:/ slave on FreeBSD a few weeks ago, which is a lot of fun if you don't know C++ and are just randomly adding kdDebug()s and messing around with gdb. With some help from people with clue, I tracked down the problem in the end - [ade] probably blogged about it already, so I'll skip the details.<br /><br />And I have a memory dump lying around from a FreeBSD kernel crash too. Perhaps looking at that would be setting my sights a little too high...2006/01/kafkaesque-isnt-it.htmlnoreply@blogger.com (Philip Rodrigues)1tag:blogger.com,1999:blog-8198584.post-113449099277123919Tue, 13 Dec 2005 16:06:00 +00002005-12-13T16:23:12.826+00:00Mini-tipFor want of anything more interesting to write about, here's a little tip I came up with in response to a user's question on #kde.<br /><br />The situation was this: The user has a konsole open with four tabs, each one showing the output of some "tail -f" command (with a different file for each tab). The question: how to have this setting saved and restored at login?<br /><br />Well, my solution is a bit of a hack, and probably isn't the simplest way to do it, but it shows how a little knowledge of KDE internals can do almost anything you want :-). Here goes:<br /><br />We create a new "Session Type" for each tail command we want to run. I couldn't see a GUI-based way to do it, but the commandline way isn't very hard: Just put a tail<i>n</i>.desktop file in ~/.kde/share/apps/konsole/ with the following content:<br /><pre><br />[Desktop Entry]<br />Encoding=UTF-8<br />Type=KonsoleApplication<br />Name=Tail command <i>n</i><br />Exec=tail -f /path/to/somefile<br />Cwd=<br />Tips=false<br /></pre><br />Repeat that for each command you want to run in a tab. Now (after running kbuildsycoca, or restarting KDE), you can use konsole's session menu to start tabs for all of these commands. The command will run in its own tab, and on logout/login, the tabs (and commands) will be restored :-).2005/12/mini-tip.htmlnoreply@blogger.com (Philip Rodrigues)1tag:blogger.com,1999:blog-8198584.post-112786123181289321Tue, 27 Sep 2005 22:45:00 +00002005-09-27T23:48:34.233+01:00Need a titleI'm tempted to try to beat Rainer in the "most delayed report about<br />akademy" post, but I'll let it suffice to say that akademy was great<br />fun: Málaga's a great place, and the organising team did a brilliant<br />job of keeping everything running smoothly. The workstations in the<br />hacking rooms were particularly useful for running tests on the whole<br />of the KDE documentation, which I didn't have the hard disk space to<br />check out on my own machine (on which more later).<br /><br />As well as being fun, it was a really productive week for the docs<br />team. I promised not to turn this post into an akademy report, so I'll<br />just link to <a href=" />one I wrote up for kde-doc-english</a>. Despite getting plenty done,<br />there's no shortage of tasks left to do: if you have any proficiency<br />with writing, LaTeX, XSL, PHP or C++, we could use your help. Get in<br />touch with kde-doc-english@kde.org or with me directly (phil AT kde<br />dot org), and we'll suggest ways that you can help us improve KDE.<br /><br />If you're a writer or maintainer of a document in KDE (or even the doc<br />writer for a 3rd party app), you'll find Frerich Raabe's <br /><a href=" docs<br />sanitizer</a> useful. Give it a KDE docbook document, either by upload<br />or by giving the URL, and it will point out any mistakes in either the<br />DocBook markup, or in the little quirks that we require for KDE<br />documentation. <br /><br /><b>Quick tip</b>: In the URL box, put a link to the document in<br />websvn, then bookmark the page. By going to the bookmark, you can<br />quickly recheck the document in SVN.<br /><br />Some other miscellaneous fallout from akademy: I've joined the eV,<br />written some promo stuff (ok, so it wasn't much, but it feels like a<br />big step), offered my limited skills to a usability mini-project<br />(improving whatsthis help), and been invited to a RL KDE meetup. I<br />even did some actual <i>writing</i> of docs! At least life's not boring...2005/09/need-title.htmlnoreply@blogger.com (Philip Rodrigues)1tag:blogger.com,1999:blog-8198584.post-112540035725320415Tue, 30 Aug 2005 10:50:00 +00002005-08-30T12:12:37.260+01:00aKademy: Me three! (or, "Argh!")Apologies to those reading on Planet KDE for the blank post - either the blogger editor or my checkout of Konqueror managed to eat my whole post. Let me see if I can remember it...<br /><br />My fourth day at aKademy, and it's shaping up to be a good one. Aaron and Waldo were definitely worth getting up for, giving a useful and entertaining (of course!) presentation on "Marketing for Geeks." Their ideas were fairly simple, but important. I think we can take a lot of it on board in the docs team, or more specifically, the projects that go on "around" the docs team - for example, the Features Guide.<br /><br />Next up, Rainer presented his work on creating multimedia presentations from desktop captures. This has great potential for documentation - descriptions of actions that go "click on this, then on that, then enable the other, then ..." can be wearing both to write and to read (see, for example, <a href=" section of the userguide</a> which I wrote). Showing a direct demonstration is a much better option for the user. When the technical issues are ironed out (and most of them are, as Rainer demonstrated), this technology should certainly be able to find a place in KDE docs.<br /><br />The "aKademy appreciation awards," a new idea from Brad Hards, were presented straight afterwards, in a well-attended lecture theatre. It was great to see recognition for the docs team, with Lauri taking away (in spirit, at least - she hasn't yet got here) the award for non-coding contribution. Certainly well deserved: Lauri's knowledge of both the community and technology of KDE, and all the work she puts in, much of it in backstage jobs that are invisible to most people, are invaluable both to the KDE project in general and the docs team in particular.<br /><br />With all that already done, there's plenty left to do for the rest of the day - Lauri arrives sometime soon, so docs work will probably start in earnest. There's PDF generation work to do, along with, I expect, an "invitation" (arm-twisting :-) to write another <a href=" day report</a>. I want to chase up a few people, and try out some of the tools Rainer demonstrated. Should keep me busy.2005/08/akademy-me-three-or-argh.htmlnoreply@blogger.com (Philip Rodrigues)2tag:blogger.com,1999:blog-8198584.post-112539894802693497Tue, 30 Aug 2005 10:09:00 +00002005-08-30T11:49:08.060+01:00aKademy: Me too!2005/08/akademy-me-too.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-112144321519812097Fri, 15 Jul 2005 15:48:00 +00002005-07-15T17:00:15.206+01:00End in sightThe hours I've sunk into the second take at PDF generation are beginning to pay off. I've got most applications' docs in kdebase, kdepim and kdenetwork to produce some sort of PDF output, even if it's not completely correct. Since the last time I played around with this, we've got a new system for the DocBook -> LaTeX -> PDF conversion, namely <a href=";. It has the enormous advantage of being actively maintained, and the maintainers have been really excellent in responding to the bugs, problems and quirks that I've found.<br /><br />So, I'm now at the stage where it's worthwhile working on the formatting of the generated documents. I think there could be some improvements to the default formatting of the PDFs that dblatex produces, and it might be nice to have a little bit of branding - a few 'K' logos here and there, etc. Here's <a href=" short example (Klipper)</a> of the PDFs we're generating, and <a href=" longer example (Userguide)</a>.<br /><br />If you have the XSL, LaTeX or artistic skills to help, please get in touch with kde-doc-english@kde.org or with me directly (phil at kde dot org).2005/07/end-in-sight.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-112007650481694087Wed, 29 Jun 2005 19:39:00 +00002005-06-29T21:21:44.850+01:00It's been so long since I last blogged that I don't know what to include and what to leave out. In case anyone noticed my absence from IRC or mailing lists, I should say that my disappearance was, like so many others', due to exams. Not having a computer in my room <i>really</i> makes revision go a lot better :-).<br /><br />I bought my plane tickets for akademy a couple of days ago. I had to resort to phone booking, since bmibaby's website seems to be so broken that it didn't even work in IE. Still, it's done now, so I'll be there in Malaga for the duration of the conference. It should be a lot of fun, and with the experience I gained from last year's conference, I should be able to get a lot done too.<br /><br />Among the people I hope to meet at akademy is Evangelia Berdou, who, <a href=" Thomas Zander wrote</a>, is doing research into aspects of co-operation in open-source, with KDE and GNOME as case studies. I had a telephone interview with Evangelia on Monday, which I was slightly hesitant about, since it was intended to deal mainly with the Quality Teams, and I haven't really been that deeply involved with the Quality Teams. (I follow the mailing list, and try to help where I can, but I haven't done much of the wider co-ordination work). As it turned out, I babbled on for an hour and enjoyed myself a lot more than I was expecting. I think I drifted off the topic a little at times, but I hope some of what I said will be useful for Evangelia's work, and, in the long run, KDE too.<br /><br />In the world of documentation, I'm trying to make some inroads into our todo list. Rainer Endres' excellent new docs.kde.org front- and back-end for docs.kde.org will help with one item (linking between docs), and I've just started discussions with the author of dblatex, a tool which we plan to use for the creation of PDFs of the documentation. Using an actively maintained system should mean we avoid hitting the brick wall that was eventually going to come our way with db2latex, the system I was experimenting with <a href="2005/04/pdf-generation.html">a few months ago</a>.<br /><br />And of course, I haven't gone the last few months without a little frisbee: I managed to get onto the university first team, thanks to the loss of a few key players, and played the annual Oxford vs Cambridge varsity match, this year held in Cambridge. In sweltering temperatures, we managed to take the match 14-7, and I even made some nice defensive blocks. I also found out that Sander Koning, of kde.nl fame, is a fellow ultimate frisbee player, so much throwing of discs should take place at akademy :-)2005/06/its-been-so-long-since-i-last-blogged.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-111766270457736671Wed, 01 Jun 2005 21:47:00 +00002005-06-01T22:51:44.590+01:00De gustibus non est disputandumSo it doesn't really have much to do with anything, but I completed the Times crossword yesterday - first time I've finished one of the daily ones. Worth a blog entry, I think.<br /><br />And exams will be over in 2 and a half weeks, after which time I won't feel guilty about spending several hours doing crosswords instead of learning...2005/06/de-gustibus-non-est-disputandum.htmlnoreply@blogger.com (Philip Rodrigues)0tag:blogger.com,1999:blog-8198584.post-111574618385126556Tue, 10 May 2005 16:42:00 +00002005-05-10T18:29:43.890+01:00TW3Well, this really was the week that was. Last weekend, I managed to juggle two separate visitors to Oxford, despite them turning up at more-or-less the same time, and the later one coming on about 12 hours' notice (hi George!).<br /><br />Wednesday saw me in a state of nervous tension all day, looking forward to the final of the Oxford colleges ultimate frisbee spring league. We were quite chuffed to get that far, and the opposition were looking good. To keep things interesting, I had a tutorial immediately before the match, which ended up being relocated about five times that afternoon, and then resulted in my finding out how little I know about atomic physics (with exams in six weeks. Argh!). Still, it was a good way to get fired up for a match in which we knew we needed to play hard to have any chance of winning.<br /><br />Losing a player to a sprained ankle in the warm-up probably isn't the best way to start when your team has about 10 people on the squad and theirs has nearer 20, but that's the inauspicious way we began our bid for victory. It could only get better :-).<br /><br />So, to the game. This must have been the closest and most hard-fought game of Oxford college ultimate that I've ever seen. For every point we scored, they responded. We had all the clichés, straight from a Hollywood sports film: neck-and-neck in points all the way, big catches, big defence plays saving us from conceding points, celebrations, and to top it off, the match went to sudden death. One point to determine the champion<br /><br />And I scored it!! Woohoo! It's such a weird feeling watching an incoming disc, and thinking "If I catch this, we have <a href=";, and if I drop it, everyone comes over and kicks me." So <a href=" caught it</a>, and I've been on a high since. :-).<br /><br /> The <a href=" of the photos</a> are online too, if you're interested in that sort of thing.)<br /><br /><br />To top it off, it wasn't just a great game in terms of competitiveness: it had great 'spirit' too. Playing in such a close game that's self-referreed, and having almost zero arguments can only make one feel good about the world. And of course, after the match, we had the requisite silly games (known as "calls") and went out with our opponents, and most of the sizeable crowd who had cheered us on, for a drink.<br /><br />Ah, good days. And that's to say nothing about my birthday yesterday...2005/05/tw3.htmlnoreply@blogger.com (Philip Rodrigues)1tag:blogger.com,1999:blog-8198584.post-111429354261265868Sat, 23 Apr 2005 21:29:00 +00002005-04-23T22:59:21.963+01:00This post Certified 100% PDF-Free(TM)So, after a small diversion to watch a slightly amusing troll ply his trade in #kde, I got to work on reviewing the tips database for ktips. Unfortunately, it seems not to have received much love lately, and there are stacks of cool features of KDE that aren't advertised there. I also want to plug the docs a bit with relevant links in the tips. Seems logical too.<br /><br />First step was to go through the existing tips, and check them for accuracy and usefulness. I was pleasantly surprised to find that, modulo some changes in GUI texts, even the tips dating back to 2.0 days are still relevant. I guess that shows that the KDE framework was useful when KDE was started, and still is now, or something. I'm sure one of the more astute bloggers on planet KDE could come up with an analogy involving trees to illustrate the point more elegantly :-).<br /><br />Next step was to think of what's missing. Fortunately, I had Fabrice Mous and Lauri on my side, so I didn't really have to think of very many myself. 45 minutes later, and I've got about 30 more neat features to write little tips for.<br /><br />And, wow - I use KDE every day, yet there are all these features that I never knew about, like:<br /><ul><br /><li>Hold Ctrl and scroll the mouse wheel in Konq to change font size</li><br /><li>Hold Shift and scroll the mouse wheel for fast scrolling in any app</li><br /><li>Middle mouse button on desktop for a window list</li><br /></ul><br />Plus a few that I knew about previously, but which still rock:<br /><ul><br /><li>Web shortcuts in Konq</li><br /><li>Konq's image gallery handling - the photobook plugin, and the image gallery creator.</li><br /><li>Ability to use 'servicemenus' to modify various context menus</li><br /></ul><br />So now I have a big list of features to write little tips for, and the need to find some time to do it in. Hrm. There are a few more issues to look at: Most of the tips relate to apps included in kdebase. I guess there's no reason they shouldn't also include apps from all official KDE modules, but I guess I should check with core-devel.<br /><br />And now Lauri has me reading the Epic of Gilgamesh (or "Gigglemesh" for any 5-year-old readers)...2005/04/this-post-certified-100-pdf-freetm.htmlnoreply@blogger.com (Philip Rodrigues)3tag:blogger.com,1999:blog-8198584.post-111376069603833116Sun, 17 Apr 2005 17:24:00 +00002005-04-17T18:58:16.040+01:00More PDF...Apologies to anyone who downloaded the PDF generation tarball yesterday and found that it didn't work. My fault :-}. The <a href=" version</a> should work better. It does a couple more things - centres images, gives them a little padding, and gets rid of all the blank pages. For examples, see the <a href=" docs</a> or <a href=" User Guide</a> as PDF. As before, more testers are especially welcomed - thanks to mikmak on #kde-devel for pointing out some problems. If you're familiar with XSL or LaTeX (especially if you're a LaTeXpert), I'd love to have your help; get in touch at "phil at kde dot org" or on #kde-docs on irc.freenode.net .<br /><br />And, for those interested in such things, I'm back at Uni again. So 8 weeks of revision and frisbee coming up. At least it won't snow this term when I'm out playing :-).2005/04/more-pdf.htmlnoreply@blogger.com (Philip Rodrigues)2tag:blogger.com,1999:blog-8198584.post-111359305154970212Fri, 15 Apr 2005 18:47:00 +00002005-04-15T20:24:11.550+01:00PDF GenerationPDF generation of the KDE docs is something we get asked for every so often, and it turns out to be less easy than you might suppose. There are quite a few tools around that will do the conversion in one way or another, all with their own problems. In the end, we've settled on the db2latex XSL stylesheets to get LaTeX output, and then pdflatex for the PDF. It took some tweaking of the XSL and a Perl script to wrap around it all to fix some of the problems, but we seem to have fairly good-looking output.<br /><br />And of course, just as I write that, Lauri shows me the output that her version of libxslt produces, which is, erm, less nice: the table of contents has made its way into the title. Great. I guess I'll have to update my libxslt at some point to test.<br /><br />So, the next step is some more data points, and some testing. To that end, I've put the tools up <a href=";. Download it, unpack, and follow the instructions in the README. Hopefully it should work, giving you a nice PDF file of some KDE document. (The Perl code is really not excellent; feel free to send me improvements :-)<br /><br />In other news, I've joined the legions of text-message obsessed adolescents by (reluctantly) getting myself a mobile phone. So if u c me usng txt slng, KILL ME IMMEDIATELY!2005/04/pdf-generation.htmlnoreply@blogger.com (Philip Rodrigues)0