Daily Shaarli
June 30, 2022
Halibut: yet another free document preparation system
Halibut is a documentation production system, with elements similar to TeX, debiandoc-sgml, TeXinfo, and others. It is primarily targeted at people producing software manuals.
What does it do?
Halibut reads documentation source in a single input format, and produces multiple output formats containing the same text. The supported output formats are:
- Plain ASCII text
- HTML
- PostScript
- Unix man pages
- Unix info, generated directly as .info files rather than .texi sources
- Windows HTML Help (.CHM files), generated directly without needing a separate help compiler.
- Windows WinHelp (old-style .HLP files), also generated directly.
- Other notable features include:
- Hypertext cross-references are ubiquitous where possible. In particular, the HTML and PDF output both have hyperlinks in every reference between sections, and throughout the index and contents sections. (It seems daft to me that so many PDF documents fail to have this; it's one of the most useful features of PDF.)
- Support for international characters via Unicode, with the ability to fall back to an alternative representation. For example, you can write \u00F6{oe}, and in output formats that support it you will see ‘ö’ whereas in those that don't you will see ‘oe’.
- Comprehensive indexing support. Indexing is easy in the simple case: as you write the manual, you just wrap a word or two in \i{this wrapper}, and those words will appear in the index.
- More complex indexing is also supported, such as
adding references to things you never explicitly said
rewriting the appearance of index entries for a consistent style
duplicating index entries to several places because you don't know which concept they'll be looked up under
merging references to several things into one combined list. - Portability. The Halibut source code is portable ANSI C (apart from a dependency on having at least a 32-bit platform), so it should run without change on Unix, Windows, BeOS, MacOS, VMS, or whatever other (non-16-bit) OS you fancy. (Well, you might have trouble outputting PDF under VMS, due to file typing issues. I dunno.)
- Configurability. Each output format supplies configuration directives, so it is easy to tailor the HTML output (say) to contain a standard header with links to other parts of a site, or to use a style sheet, or whatever.
Quickly generate your favicon from text by selecting the text, fonts, and colors. Download your favicon in the most up to date formats.
Farewell of a hero
Last living World War II Medal of Honor recipient dies at 98
The last living Medal of Honor recipient from World War II — a hero who fought enemy forces with a flamethrower in Iwo Jima — died Wednesday morning in West Virginia. He was 98.
Hershel “Woody” Williams, a former Marine corporal who earned the military’s highest decoration for his bravery in the Battle of Iwo Jima, died peacefully at a veterans medical center, according to The Woody Williams Foundation.
a few things were obvious about Trump as a candidate and president.
First, he didn’t have strong political beliefs. Many, including one former writer here a RedState, used to get what seemed to be sexual gratification from calling Trump a “New York liberal.” But, as a salesman, he knew what was important to those who voted for them. To this day, I’m not terribly sure what Trump believes, but I’m also sure that it doesn’t matter.
Second, he didn’t hold Americans in “fly over country” in contempt. I think Trump connected with conservative Americans in a way that no candidate since Ronald Reagan has managed to do because he wasn’t laughing at us to his rich liberal buddies at cocktail parties.
Third, in the words of my Old Man, “ya dance with them what brung ya.” When Trump was sworn in, he had a choice to make. He could stay true to the people who voted for him or yield to the siren call of Washington’s social life. In a singular act of political courage, he chose loyalty to his supporters.
One of those signs of loyalty was Trump’s overt embrace of the Pro-Life Movement. I’m not sure that Trump had ever spent ten consecutive seconds thinking about the issue of abortion. From his life and lifestyle, I’d not be surprised to find that he didn’t have a personal problem with this horrific practice. Unlike President George W. Bush, whom I admired, Trump was not ashamed of us. President Trump became the first president to personally appear at the March for Life rally since its inception in 1974. Neither Reagan nor Bush, all of whom talked big talk about being pro-life, ever made an appearance, but a New York City playboy cared enough to show up. When it came time to appoint justices, Trump delivered three whose records indicated they were pro-life and conservative.
Unsurprisingly, people who made a career out of being “Never Trump” are trying to rewrite history to take credit for something that happened despite their best efforts. //
A pause here for a brief fact check. The famous lists of possible Supreme Court nominees were developed inside the Trump White House by a team led by Don McGahn. The Federalist Society executive vice president Leonard Leo was an adviser. The selections were not by any stretch of the imagination “delegated.” In fact, it was Conservative, Inc. insiders who howled as loudly as the Washington Post editorial board about how the proposed justices would scare moderate voters. //
Sure, George W. Bush gave us Samuel Alito. But, do you know who else he gave us? John Roberts. Roberts is the guy whose concurrence in Dobbs tells the majority that included all three Trump-appointed justices that they were completely wrong in their decision. In a weird way, we are lucky to have John Roberts. We were saved from much worse because Bush couldn’t find enough inbred senators willing to foist Harriet Miers off on us. I agree that Clarence Thomas is a treasure. But do you know who else George H. W. Bush put on the bench? David Souter. Souter wrote the opinion in Casey that sought to forever lock in abortion as a Constitutional right. He voted with the majority in the Lawrence vs. Texas decision that changed or placid “slouching towards Gomorrah” posture into the Usain Bolt-style sprint that put us on the glide path to codifying a cheap simulacrum of actual marriage as the law of the land. //
The Gospel Matthew (21:28-32) contains the Parable of the Two Sons. The story is that a father asks his two sons to go work in the vineyard. One tells his father “no,” but then relents and goes off to work. The other tells his father, “yes,’ and doesn’t go. The question is, who actually did their father’s will? I’m not trying to make a theological argument defending Trump; I am merely using this well-known (at least I hope) Bible reading as a point of departure for a comparison. Trump spent his entire life never giving much thought to governance. Yet once he was president, he governed more conservatively than any president in the past 20 years. Not only on Life but the economy, neutering Iran, the Abraham Accords, and, I’d contend, bullying the freeloaders in NATO into starting to meet their obligations. In essence, he said “no” at first but ended up doing the hard work in the vineyard.
On the other hand, we had “conservatives” who were elected, pledging to defend life. When it came down to nut-cutting time, they still agreed to fund Planned Parenthood, ignore the Pro-Life Movement outside of election year photo-ops, and appointed judges who, to this day, continue to support abortion and anything else the administrative state desires. They are the ones who said “yes,” and decided they liked being invited to the cool parties and maybe moving out of the conservative punditry ghetto more than fighting for causes. So who was actually the more conservative?
Donald Trump won in 2016. He won because he likes to win and because he knows if you aren’t a winner, you are the other thing…that would be a loser. //
There is a place inside the conservative tent for thinkers as well as for doers. What there isn’t a place for are people who fought tooth and nail to keep abortion legal by supporting Hillary Clinton…and Joe Biden…and then claim the Dobbs victory for themselves and their fellow travelers because they had wonderful thoughts and wrote erudite articles.
“I am afraid that there is a certain class of race-problem solvers who don't want the patient to get well, because as long as the disease holds out they have not only an easy means of making a living, but also an easy medium through which to make themselves prominent before the public.”
Booker T. Washington (1856-1915)
“The bitterness and hate ... would have long since been obliterated in this state, were it not for some unprincipled men who would keep alive the bitterness of the past, and inculcate a hatred between the races, in order that they may aggrandize themselves by office, and its emoluments, to control my people, the effect of which is to degrade them.”
Senator Hiram Revels (1827-1901)