ManDrake
ManDrake is a native man page editor for macOS with features such as syntax highlighting, live mandoc syntax validation and a live-updating rendered preview of the man page during editing. It can also export man pages as PDF or HTML.
Long story short, many years ago I was sick of writing man pages in an endless cycle of edit-view, edit-view so I decided to do something about it and created this editor. It's a bit rough around the edges, but it works really well for me. Perhaps it will also be of some use to you.
- ⇩ Download ManDrake 3.3 (~1.9 MB, Intel 64-bit, 10.8 or later)
To learn more about the mandoc man page format:
man mdocor read this page.
For a recent web-based alternative to ManDrake, check out Grapse.
ManDrake is free, open source software distributed under a BSD license. If you find it useful, feel free to make a donation.
Screenshots
License
Copyright (c) 2004-2022, Sveinbjorn Thordarson <[email protected]>
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
-
Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Building ManDrake
Requirements
If you want to build ManDrake yourself, you need the following components/tools:
- Apple's Xcode
- macOS SDK (10.8 or later)
- Git
- CocoaPods
You may also need to install Xcode’s command line tools with the following command, if you want to re-build the included cat2html and mandoc binaries
xcode-select --install
Environment Setup
After cloning the repository, run the following commands inside the repository root (i.e. the directory containing this README.md file):
pod install
This installs all the dependencies required. ManDrake can then be built via the xcworkspace.
Captain Mandrake
Do I look all rancid and clotted? You look at me, Jack. Eh? Look, eh? And I drink a lot of water, you know. I'm what you might call a water man, Jack - that's what I am. And I can swear to you, my boy, swear to you, that there's nothing wrong with my bodily fluids. Not a thing, Jackie.
Here's Group Captain Lionel Mandrake from Kubrick's wonderful Dr. Strangelove or: How I Learned to Stop Worrying and Love the Bomb in the intimidating company of Brigadier General Jack D. Ripper.
