This is going to be a somewhat terse post given the ambitiousness of the project I'm going to lay out. I'm just interested in getting it out there to get some useful feedback.
Last year I wrote a simple literate programming system in perl, which accepted files in an extended docbook format, and had tangle and weave utilities to create source code (tangle) and well formatted xhtml articles (weave). It was actually a pretty successful project, as it was target language agnostic. The system didn't care whether the language to tangle was c, lisp, forth, or haskell, as long as the programmer knew the order required by the language.
At about the same time I conducted a podcast interview with Donald Knuth which inspired me to take the project very seriously.
Since then I've done nothing with the perl version of the project, and have shifted my income generating attention to php.
So here's a gonzo version of an SRS for the PHP version of my utility.
The utility presents a web interface which accepts one or more files in an extended docbook format (with added tags appropriate to literate programming), either imported or entered via a web based docbook editor. The main interface gives three basic options, edit (create a source file in the extended docbook format), tangle (create a compilable or interpretable file of source code), or weave (create an awesome human readable article explaining how the code works, with the complete source code imbedded ... see any of Donald Knuth's writings on literate programming to see how this works).
What I need from you PHP geeks is advice about the most efficient way to build a really good online Docbook editor. I can probably figure out the backend tangle and weave routines quickly (it'll look a whole lot like the perl code I've already written.
Friday, March 4, 2011
PHP literate programming project
Sunday, February 27, 2011
Matcha and my own tea ritual
I've never had a background in chemistry, so armed with a copy of Chemistry: Concepts and Problems: A Self-Teaching Guide (Wiley Self-Teaching Guides)
As a consequence of this, I've developed by own little morning tea ritual, involving matcha
The potential health benefits of green tea are well known. It contains numerous phytochemicals, vitamins, and minerals, but of particular interest is a polyphenol known as Epigallocatechin gallate (EGCG). EGCG has received interest as a potential preventative for cancer and some autoimmune diseases.
But like any other chemical substance there are circumstances under which EGCG can be harmful. The wikipedia article on EGCG mentions some of those circumstances. They include pregnancy (high intake of polyphenols during pregnancy can increase the risk of neonatal leukemia), and when using the anti-cancer drug Velcade (EGCG can reduce the bioavailability of the drug).
Since I'm neither pregnant, nor on anti-cancer medication, I've devised my own tea ritual in the morning, which diverges substantially from the Japanese method of preparing the tea, but which works for me.
I sift a teaspoon of matcha powder into a mug, then pour about 1/8 cup fresh squeezed lemon juice onto the powder, and rapidly stir it with a fork (since I've yet to acquire one of the little wooden wisks). This forms a rather thick sludge.
I pour a cup of hot (not boiling) water from a tea kettle into the mug. The resulting beverage is both sour and somewhat bitter, but I've grown to love the concoction. I often exacerbate the bitterness by eating a tablespoon of cocoa nibs along with the tea. I wouldn't advise adding the cocoa nibs unless your taste buds really thrive on bitterness, but it works for me. The Japanese ritual includes eating small sweets to mellow out the strong bite of the matcha.
Whether any of my dietary eccentricities will actually have an appreciable impact on my longevity is unknowable. But I have fun with it, learn a bit about a couple of branches of science, and on balance my diet is much better than the average diet in our American Fast Food Nation.
Monday, February 7, 2011
Professor Irwin Corey
OK, I realize that the modern definition of the word "technology" in the popular lexicon is narrowed to the point of only including digital technology which sprang from the recent resurgence of the Internet.
But I'm on a mission from God, in the Blues Brothers sense of the phrase. My mission is to get proper recognition for Professor Irwin Corey before that 96 year old gentleman dies.
To learn a bit about him go here: http://en.wikipedia.org/wiki/Irwin_Corey
To see him in action in his prime just watch this video
Saturday, January 15, 2011
Trend Micro CEO advocates "security through obscurity"
Here's a link to some commentary by Ricky at Digitizor regarding Steve Chang's statement that closed source software is inherently more secure than free or open source software. FUD just never seems to die, but I'd hope that Mr. Chang, the CEO of a security firm, would think this sort of issue through a bit more thoroughly.
Monday, September 20, 2010
Isambard Kingdom Brunel
Unless you're a student of the history of technology and engineering, you probably haven't heard of Isambard Kingdom Brunel. Brunel is well known in the rapidly diminishing engineering circles in the UK. He also has contemporary following among fans of the science fiction genre known as "steampunk", because of the cutting edge nature of his activities within his century.
Brunel was perhaps the greatest civil engineer of the 19th century. He planned many bridges and dockyards which are still in use, supervised the building of the first major British railway, and most importantly in my opinion, designed the first propeller driven ship.
Since Brunel's time the UK reputation for engineering has been degraded to the point of Lucas jokes, and the United States has become the world's capital of consuming everything, producing a great deal less.
Here's the link to the wikipedia article on Brunel. As the UK attempts to redesign itself as the place where physical things are designed and built, and the United States seeks to establish itself as a place built on something besides financial vaporware, it might be good to reflect on Brunel's accomplishments.
Thursday, August 19, 2010
A cultural interlude -- Lydia the tattooed Lady
I'm taking a break from writing about Oracle America v Google, or Minix 3 today, and doing something a bit more whimsical. I've always lived my life surrounded by music, and have written here about the Free Music movement.
In addition to enabling free music the internet has made available an amazing array of resources for those of us who love music and film in all its forms. When I was a teen if I wanted to see, say, a Marx Brotherss film my one option was waiting for it to come on television. A decade later (in the 1970s) a few small "art" theaters had opened, which might occasionally show a Marx Brothers movie. A decade after that (in the 1980s) videotape had entered the mass market, and if I wanted to buy a Marx Brothers film I could do so.
Now that the web is ubiquitous and nearly every artist committed to record, tape, or film has at least some presence on the web if I want to see one particular notable Marx Brothers clip I can probably find it.
So on that happy note I present one of the best musical numbers ever to come out of an otherwise terrible movie (At the Circus). The lyrics to Lydia the Tatooed Lady were penned by Yip Harburg, one of the great songwriters of the 20th Century (who also wrote Brother Can You Spare a Dime, Paper Moon, and all the songs in the movie the Wizard of Oz.
After a string of wonderful but chaotic movies at Paramount, and the two wonderful Irving Thalberg Marx Brothers movies at MGM, A Night at the Opera and A Day at the Races, their movies went into sharp decline in quality. This clip is a gem in an otherwise awful movie.
Tuesday, August 17, 2010
Understanding Oracle America v Google: The patents at issue
Minix 3 and bochs configuration progress report
Understanding Oracle America v Google: The Oracle Corporation
The beginnings of the Oracle Corporation were in 1977 when Larry Ellison, Ed Oates, and Bob Miner formed the consulting group Software Development Laboratories. Oates had shown Ellison a 1970 paper in which IBM's Ted Codd had proposed the relational database model for data. IBM was very slow on the drawn in implementing the work of their own researcher, so SDL jumped in to fill the void.
By 1979 the company was successfully marketing their product, and in 1979 changed their name to Oracle Corporation after their flagship product.
By successful marketing and by acquisition of other companies Oracle grew to be the corporation that has the third largest revenue from software, behind only Microsoft and IBM.
Oracle's most significant acquisition in terms of their recent trajectory was in January of this year, when they completed their acquisition of Sun Microsystems. Sun was well known as a producer of enterprise servers and storage devices. They were also a powerhouse in Research and Development, had a great deal of trouble monetizing their research, and had been on an acquisition spree of their own before being acquired by Oracle. I'll write more on Sun and the properties Oracle got with the acquisition when I cover Oracle America, the name Oracle has given to the subsidiary comprising the former Sun.
Oracle is in some ways an old fashioned software company. While Oracle has dabbled in open source software and software which is free in the sense of "free beer", it's exhibited little understanding of the culture of the free software movement. The first evidence of this is the awkward and heavy handed manner in which it handled relations with the Open Solaris community (I've written brief posts on that relationship here and here).
Why is Oracle suing Google?
There isn't really an easy answer at the moment as to the motivation and timing of this lawsuit. It has the obvious effect of disrupting, and potentially damaging, future adoption of Java. So it's likely Oracle has some specific goal in mind beyond a one time settlement. I can't imagine Oracle deciding to compete with patent trolling firms like Acacia. In fact in 1994 Oracle went on record opposing software patents in principle (in agreement with a substantial portion of the IT world).This early in the game my best candidate for a quick guess is that Oracle is interested in getting a strong foothold in the mobile industry, either by forcing a licensing agreement with Google, or blowing Android out of the water and introducing a competing device. Oracle did something similar to the latter when they tried to compete with Red Hat Linux a few years back. That attempt was a complete and utter failure.
As the suit unfolds Oracle's specific strategy will probably become obvious. But I doubt that it's moral indignation over violation of their IP. After all, Oracle got its start implementing research that was carried out on IBM's dime.
Monday, August 16, 2010
An outline of Oracle America v Google
Since my goal is mostly to present the information necessary to follow this important lawsuit, I've written an outline of my future posts, which I present here. As I get each article finished and published I'll turn each article into a link to the published article. So if you find these article useful you might want to go back and bookmark this outline.
I won't necessarily finish the articles in the order in which they appear in the outline. The inflow of information will dictate the order.
Here are the things I view as important to understanding the lawsuit.
- The Players
- Oracle Corporation
- Oracle America
- The lawyers
- The Free Software community
- The Technology
- Android
- Java
- Dalvik
- The details of the filing
- The Law
- Patent Law
- How patent lawsuits are handled
- Copyright law
- The Ethics
- Possible impacts
- The patents at issue
If you think I'm missing some component to understanding this case post a comment here. If you think I'm in error in a particular article post a comment to that article.
Sunday, August 15, 2010
Oracle v Google -- getting started
The most important document for understanding the case (although if you're not a lawyer it may not be the first thing you'll want to read) is the complaint itself, which was filed in the United States District Court -- Northern District of California.
The law firms representing Oracle in the case are Morrison and Foerster LLP, and Boies, Schiller & Flexner LLP
Here is a link to Oracle's press release on the suit.
... and a link to a TechCrunch article quoting a response Google sent via email.
For basic info the the following articles are representative of what the press is carrying at the moment:
Epic smackdown looms in Google vs Oracle from CNNMoney.com
Lawsuit may signal era of Oracle, Google tensions from the Economic Times (India)
Oracle sues Google over Android from Mashable
Here's an interesting blog from Taylor Buley at Forbes, which raises a question I had pondered. Why didn't Oracle file the suit in the Eastern District of Texas, which is a patent troll's paradise? I'll have to mull over Buley's reasoning, but the reasons behind the chosen venue is a good point to ponder.
Groklaw, which has long been the best (though most partisan) site for following the various SCO lawsuits will be following Oracle v Google in depth.
Finally, here is Richard Stallman's call to arms Fighting Software Patents. It doesn't have any direct bearing on Oracle's chances of success, but it's a nice little manifesto to review when an important software patent case arises.
Saturday, August 14, 2010
Oracle versus Google -- Farewell to Sun's legacy
I'll be writing a tutorial series on the lawsuit after the dust settles a bit and after I've had time to research the issue properly, but I do want to make a somewhat personal statement about this case.
I worked as a solaris sysadmin for quite a few years. As annoying as Sun Microsystems could be to deal with, I came to respect them as a font of innovation. I'm not going to attempt to list all the contributions of Sun Microsystems to the computer science and technology world, but a few notable recent ones are Java, zfs, dtrace, and the Open Office suite.
When Oracle acquired Sun my first reaction was alarm, and nothing that has transpired since the takeover has softened my reaction. With Oracle in charge the likelihood of any remnant of Sun's culture surviving is miniscule.
Although I'm going to cover the lawsuit in as accurate and balanced a manner as I can under the circumstances, Oracle has unleashed the potential for significant damage to the innovative impulse in the computer technology world. Software patents are a bad idea, and provide fertile ground for those law firms best described as patent trolls. No matter what the outcome of the suit it's likely to damage Java as both a language and a platform.
Saturday, July 3, 2010
Minix 3 and bochs (or Virtual Machines Make My Head Hurt) -- Part 1

The subtitle Virtual Machines Make My Head Hurt is a reference to the difficulty I have in determining which layer is doing what at any given time when I'm operating in a virtual machine environment. If there is a failure somewhere I have to ask myself the questions: is the failure on the guest operating system? The host operating system? Some incomplete interoperability between the two? The hardware? The application I'm running?
Well, failure isn't really the theme of this post, since I'm at the beginning of this particular phase of my Minix 3 installation, although thinking through how the different layers in virtual environments are working together still makes my head hurt. So I'll slowly explain what I'm trying to do, and why. Then I'll followup at the end of this post with exactly where I am and what I intend to do to move this aspect of the project along.
As I stated in an earlier post my long term goal is to get Minix 3 working on my Dell Inspiron 1545 laptop in every reasonable respect (including the network, the wireless, and the USB ports). This is both a narrow and broad project. Narrow in the sense that I'm focused on one particular system. Broad in the sense that in order to do this I may have to learn about writing drivers for everything on the system.
How does this relate to virtual machinery? After a couple of weeks of burning anything I needed from the outside world to a CD on my Ubuntu Linux system and moving it to the laptop, I discovered that it might be nice to ftp things I need onto a networked Minix 3 work area, evaluate and configure it in that environment, then when I deem it ready make a CD and move it onto the laptop.
This is where bochs comes in. bochs is a free and open source x86 emulator. With it I should be able to run Minix 3 in a virtual environment, including access to the network of the host environment, do any configuration or development needed on the virtual Minix 3, then move it to my Dell laptop for further testing. If I'm reading the bochs documentation correctly I should also be able to do some of the necessary reverse engineering I'll need to do for my device drivers with the debug mode in bochs.
So a couple of days ago I installed bochs onto my Ubuntu Linux workstation, and attempted to use the document Running Minix 3 on Bochs from the Minix 3 website to configure and run Minix 3 on bochs. I followed the instructions, and the attempt to run my Minix 3 boot image failed on the following error:
========================================================================
Build from CVS snapshot on November 12, 2009
==============================
00000000000i[ ] LTDL_LIBRARY_PATH not set. using compile time default '/usr/lib/bochs/plugins'
00000000000i[ ] BXSHARE not set. using compile time default '/usr/share/bochs'
00000000000i[ ] reading configuration from bochsrc.txt
00000000000p[ ] >>PANIC<< bochsrc.txt:9: directive 'ips' not understood
00000000000e[CTRL ] notify called, but no bxevent_callback function is registered
00000000000i[CTRL ] quit_sim called with exit code 1
Wednesday, June 30, 2010
Minix 3 Installation Diary -- Part 3
I couldn't find anything, so I posted a description of the problem. Initially it was mysterious to the respondents, but it soon dawned on both me and a couple of the regulars on the list that grub was already installed in the Master Boot Record (MBR) from the previous host on that particular laptop, which happened to be Fedora Linux.
A member of the list suggested that I use installboot to overwrite the grub entry in the MBR. It took me a few tries, but the command
installboot -m /dev/c0d4 /usr/mdec/masterboot did the trick.
I rebooted, and this time came back up to the Minix 3 login prompt.
For more information on the Minix 3 boot process the article from the Minix 3 Wiki From power-on the the login prompt is very useful.
The manual page for installboot is also helpful.
Tuesday, June 29, 2010
Minix 3 Installation Diary -- Part 2
After burning it to a CD (from my ubuntu Linux workstation) I inserted the CD in the laptop and rebooted. I had one of the installation docs open in front of me, along with tabs for any other pages on the minix site which seemed relevant to troubleshooting.
I powered on ... and nothing useful happened. Luckily this one was easy enough to figure out with a quick browse through the docs. The error message (which I failed to write down) indicated that the CD was not found. Under my BIOS system configuration I needed to change a parameter from AHCI (Advanced Host Controller Interface -- Intel's API for addressing Serial ATA) which isn't yet supported by Minix, to ATA (the Minix doc called it "legacy", but it was easy enough to tell what was going on).
So now I had a bootable live CD. I booted up, ran the setup command, and began working through the steps. I'd already saved everything I needed off the Fedora Linux installation which was the previous host on the laptop, so I chose to delete the existing partitions and make the whole disk Minix 3. I accepted the default filesystem sizes (/, /home, and /usr had separate slices).
When the copying of files finished, I was instructed to shutdown and reboot. Then I was prompted to run packman, which is Minix's package manager system, in order to get X windows and a number of other programs, libraries, and utilities.
Using the command xdm I was treated to a window manager which resembled almost exactly the first X windows interface I was ever exposed to 16 years ago on a Sun workstation. As it happens, twm ("Tom's Window Manager") is the window manager ported to Minix. It's one of the original window managers, and is very minimalistic. I have to say that I don't object to that. Graphical eye candy can be soothing, mostly because I'm accustomed to it, but most of the time I'm working with text in terminal windows, which twm handles well.
I then attempted a reboot, and Oooops!!! I was faced with a very strange problem which I'll describe in a separate blog posting (so that this article doesn't run on forever).
Monday, June 28, 2010
My Minix 3 diary -- Introduction and initial installation
But part of me has missed the early days of broken and missing pieces, where I had to do detective work to get my setup behaving correctly.
More seriously, although I love Linux, I've always recognized that it is not the be-all and end-all of operating system technology. It's good, it's free (both in the "free beer" and "free as in freedom" sense, and the support community is wonderful.
But there are a number of other OSes out there, and one which in particular has beckoned me is Minix 3.
Those of you who know the history of Linux might remember that Linus Torvalds, the creator of Linux, was originally working in the first version of Minix when he began coding Linux. At that time Minix was an educational tool targeted at the 8088/8086 processors, and as such could not support modern production use (multiprogramming was not possible).
You may also remember the debates between Linus Torvalds and Andrew Tanenbaum regarding the merits of monolithic kernels versus microkernel architecture (I'm not going to bother to go into that now. Follow the preceding link if you are interested in exploring it).
Fast forwarding to the present, Minix has come a very long way. Minix 3 has been released, and an active community is working on transforming it into a serious production system.
The goals of Minix 3 are summarized as follows on the official Minix web page:
MINIX 3 is initially targeted at the following areas:
- Applications where very high reliability is required
- Single-chip, small-RAM, low-power, $100 laptops for Third-World children
- Embedded systems (e.g., cameras, DVD recorders, cell phones)
- Applications where the GPL is too restrictive (MINIX 3 uses a BSD-type license)
- Education (e.g., operating systems courses at universities)
I've been looking for a fun, interesting, and challenging project to keep myself young at heart in the UNIX/POSIX world. So I've taken a Dell Inspiron 1545 laptop and installed Minix 3.1.7 on it. My intent is to get every reasonable function of this laptop working with Minix in the modern sense of the word. Where possible I'll build on other people's work (and hope upon hope that someone writes a driver for the NIC before I'm forced to do it myself). But if no one else is working on a particular project relevant to my laptop list, I'll hunker down and do it myself. I have no time line, since this is a labor of love.
The top priority missing component as far as I'm concerned is a driver for the NIC. The ethernet card on this laptop is probably a Marvell 88E80XX 10/100 Ethernet Controller (based on looking over Dell's spec sheets).
But before I tackle device drivers I have to get the standalone Minix running and configured to my satisfaction first. My next post is going to be a description of the specific problems I ran into on the installation, and how I dealt with them.
Tuesday, June 1, 2010
87 year old former oil man explains the BP oil catastrophe in detail
This is one of the better attempts to explain the BP Gulf of Mexico oil catastrophe I've seen. It is an interview with Peter Davidson, 87 years old and "a veteran of many oil fields" explaining the drilling operation and leak to his daughter, who prompts him to keep it to a basic level that an interested layperson can understand.
Gulf Oil Spill: what happened? from Mary Mele on Vimeo.
Monday, May 31, 2010
Google sued over pedestrian accident
First, I support the right of individuals to sue corporations (or individuals) for irresponsible activity which leads to injury. This is where I diverge from much of the pop culture/AM Radio shock jock ridicule of lawsuits directed at corporations. There are times when a company releases dangerous goods which should have been tested better or publishes instructions which don't adequately disclose the risks of a product.
So the question is whether posting pedestian directions which include the stretch pictured the image above was irresponsible on Google's part.
My own opinion is that Google should win this lawsuit, and that if the woman who brought the suit wanted to really target those responsible she should really sue whatever governmental body is responsible for this roadway.
IANAL (I am not a lawyer) so I can't comment on an informed manner about the legal responsibility beyond stating that Google includes a disclaimer on their pedestrian routes
But my fear is that lawsuits like this help unleash the attitude that we as a people shouldn't walk anywhere, shouldn't encourage others to walk anywhere, and that our state and local governments shouldn't be held responsible for the lack of safe pedestrian accomodation on roadways.
The problem here isn't that Google provided the woman with a route from point A to point B. The problem is that those responsible for designing the highway didn't take into account the fact that walking is a reasonable use of a route funded, designed, and maintained by the government.
Friday, May 28, 2010
podcast interview with Donald Knuth
On Wednesday I recorded a podcast interview with Dr. Donald Knuth, a major figure in the history of computer science. He's the author of The Art of Computer Science
I interviewed him by phone. We focused on Literate Programming, but he also touched on TeX, Metafont
You can listen by using the control above, or visit my show page at BlogtalkRadio.
Missed deadline (but for an exciting reason)
Today was the day I intended to post the first results of my multi-language programming exercise. Instead events led me to work on my podcasts, including the interview with Donald Knuth which I'll post and announce in a short while. I'm resetting the clock, and my first results (written in PHP) will be posted two Fridays from now.











