The oldest bug
Off the Beat: Bruce Byfield's Blog
Last week, I did something that I had meant to do for over a decade: I filed a bug against LibreOffice's Bibliography Database. As I tweeted immediately afterwards, somebody had to do it.
Part of the delay was due to the fact that I haven't been an academic for some years now. In the last decade, I've written exactly one scholarly paper, so defects in the Bibliography Database were less than a pressing concern of mine.
Another part was that the bug -- or most of it -- was so simple that I was sure somebody else would get around to correcting it.
But apparently I under-estimated the degree to which the Bibliography Database was being avoided. Although I was aware that many LibreOffice users were using external tools instead, I only recently became convinced that they were doing so because very few understood how to use the database. Even tutorials and the online help avoided so much as mentioning the difficulties, which makes strongly suspect that very few actually had hands-on experience with the database.
Last week, I decided suddenly that nobody else was likely to fix the problems. Hating to see a problem persist, especially one so easily fixed, I finally gave in and filed the bug myself.
That's right -- really
What does the Bibliography Database need to be functional? I suggested several large scale changes, including being organized by citation style, and allowing separate instances for each document. Thinking just now, I would add that the dialog for inserting citations into the text would benefit from displaying the entire database when necessary.
However, none of these improvements is needed to restore basic functionality. What is really need is so basic that's it ludicrous. It all comes down to some simple changes in a single field:
First, the Identifier column in the database and the Short Name in the input tool need to be given the same name, because they are the same field. Neither name adequately explains what the field contains, which is the form in which a citation is given in the text of the document -- for example, in the APA style, (Miller: 2005). If you go to Insert ->Index and Tables -> Bibliography Entry, this purpose is obvious immediately. Both should be renamed something like Citation.
Second, once you realize the purpose of the field, it becomes obvious that the samples in the database were added by people who had no idea how the database worked. Instead of giving the citation format, the examples give nonsense contents such as MIL00 that would never be used in any known system of citation. If these meaningless citations were replaced by examples that might be actually used, then users would have a fighting chance to understand how the database worked.
And that's it -- maybe twenty minutes' coding of the most routine kind to make the database functional. The biggest challenge would be avoiding boredom.
Yet these problems not only go back to OpenOffice.org, but to the proprietary StarOffice whose code release created OpenOffice.org in 2000. Depending on exactly when the Bibliography Database was added to the office suite, I could be talking about a bug that has persisted for two decades or more. By any measure, it's a candidate for the longest unreported and unfixed bug.
The senile bug
The fact that this bug was overlooked for so long probably reflects the history of the code. Sun Microsystems was always more interested in adding features to OpenOffice.org than in correcting longstanding problems, and LibreOffice and Apache OpenOffice, its successors, have no shortage of other -- often more urgent -- cleanup to do.
Perhaps, too, the Bibliography Database has always lacked an audience. The majority of users have no need of it, while professional academic are likely to find it too simple in comparison to third party tools. Under these circumstances, perhaps nobody has cared enough to notice the problems, much less fix them.
All these things may be true. Yet the Bibliography Database has continued to be shipped, release after release and year and after year, apparently without anyone noticing any problems or bothering to correct them if they did.
The experience is enough to make me doubt the old free software truism that, "with enough eyes, all bugs are shallow." After all, dozens of people have modified the code in question without noticing this particular bug. You might say that, given the size of the code, that there has never been enough eyes, but I suspect that the oversight is also due a lack of eyes with the necessary training or interest.
It is definitely enough to make me resolve to report bugs more often for all the software that I use. When I realize that, had I reported the problem when I first noticed in back in 2000, it would have been fixed thirteen years ago, I feel irresponsible.
I'm also left wondering what other easily fixed bugs may be lingering unnoticed in other obscure corners of the code that runs my hardware.
comments powered by DisqusSubscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.
News
-
Juno Computers Launches Another Linux Laptop
If you're looking for a powerhouse laptop that runs Ubuntu, the Juno Computers Neptune 17 v6 should be on your radar.
-
ZorinOS 17.1 Released, Includes Improved Windows App Support
If you need or desire to run Windows applications on Linux, there's one distribution intent on making that easier for you and its new release further improves that feature.
-
Linux Market Share Surpasses 4% for the First Time
Look out Windows and macOS, Linux is on the rise and has even topped ChromeOS to become the fourth most widely used OS around the globe.
-
KDE’s Plasma 6 Officially Available
KDE’s Plasma 6.0 "Megarelease" has happened, and it's brimming with new features, polish, and performance.
-
Latest Version of Tails Unleashed
Tails 6.0 is based on Debian 12 and includes GNOME 43.
-
KDE Announces New Slimbook V with Plenty of Power and KDE’s Plasma 6
If you're a fan of KDE Plasma, you'll be thrilled to hear they've announced a new Slimbook with an AMD CPU and the latest version of KDE Plasma desktop.
-
Monthly Sponsorship Includes Early Access to elementary OS 8
If you want to get a glimpse of what's in the pipeline for elementary OS 8, just set up a monthly sponsorship to help fund its continued existence.
-
DebConf24 to be Held in South Korea
Busan will be the location of the latest DebConf running July 28 through August 4
-
Fedora Unleashes Atomic Desktops
Fedora has combined its solid distribution with rpm-ostree system to make it possible to deliver a new family of Fedora spins, called Fedora Atomic Desktops.
-
Bootloader Vulnerability Affects Nearly All Linux Distributions
The developers of shim have released a version to fix numerous security flaws, including one that could enable remote control execution of malicious code under certain circumstances.