Mailund on the Internet

Gordon Brown apologizes for the treatment of Alan Turing:

2009 has been a year of deep reflection – a chance for Britain, as a nation, to commemorate the profound debts we owe to those who came before. A unique combination of anniversaries and events have stirred in us that sense of pride and gratitude which characterise the British experience. Earlier this year I stood with Presidents Sarkozy and Obama to honour the service and the sacrifice of the heroes who stormed the beaches of Normandy 65 years ago. And just last week, we marked the 70 years which have passed since the British government declared its willingness to take up arms against Fascism and declared the outbreak of World War Two. So I am both pleased and proud that, thanks to a coalition of computer scientists, historians and LGBT activists, we have this year a chance to mark and celebrate another contribution to Britain’s fight against the darkness of dictatorship; that of code-breaker Alan Turing.

Turing was a quite brilliant mathematician, most famous for his work on breaking the German Enigma codes. It is no exaggeration to say that, without his outstanding contribution, the history of World War Two could well have been very different. He truly was one of those individuals we can point to whose unique contribution helped to turn the tide of war. The debt of gratitude he is owed makes it all the more horrifying, therefore, that he was treated so inhumanely. In 1952, he was convicted of ‘gross indecency’ – in effect, tried for being gay. His sentence – and he was faced with the miserable choice of this or prison – was chemical castration by a series of injections of female hormones. He took his own life just two years later.

–

254-279=-25

Ok, I figured out how to build the docsets now.  Wasn’t really that hard.  Doxygen really does all the work, if you only tell it to.

You have to enable the docset generation and tell Doxygen the name of the documentation and the name of the bundle:

Something like this in the Doxygen file:

GENERATE_DOCSET        = YES
DOCSET_FEEDNAME        = "Bio++ NumCalc"
DOCSET_BUNDLE_ID       = bpp.NumCalc

Then when you run Doxygen it will generate a makefile in the html directory, and if you run make install there it will create the bundle and install it.

To  automate this in Xcode you can pick the apidoc target and add a Run Script.

Rename it to something sensible if you want

Just add “cd html && make install” as the script

and when you build the target the docset bundle gets installed.

I had to restart Xcode before they showed up in the Developer Documentation, though, but now they are there:

It is only the NumCalc library that really has a nice title there, but that is because it is the only one with a long project name in the Bio++ doxygen files, so not really a failing of this docset build.

I don’t know how to change the Unknown Publisher heading, though.  I have no idea where to put a publisher.

Now I just have one problem left.  The documentation doesn’t show up in the Quick Help dialogue which I had hoped it would.  It doesn’t seem like Xcode links the documentation bundle with the code at all, which is a bit disappointing.

It does find the relevant information if I highlight a symbol and ask the Help menu for the documentation, so that at least is something.

–

254-279=-25

Hattip Evolving Thoughts.

–

254-278=-24