Kurtis Rader

Another example is the `whence` builtin. Typing `whence --help` says it supports a `-q` flag which works as expected. But the man page makes no mention of that flag. I'm...

@siteshwar and I discussed this issue in the ksh93/users Gitter room today. What follows are the comments I made. Doxygen is a really awful tool for writing user documentation. The...

It is possible to store the documentation external to the binary. The [fish shell](https://github.com/fish-shell/fish-shell/) shows how to do it. It supports `help a_cmd` to open the local HTML version of...

@dannyweldon mentioned the ability to embed documentation inside scripts/functions that can be used by builtin `getopts`. This is similar to [DocOpt](https://github.com/docopt/docopt) but far uglier due to the support for Troff...

When I say "builtin getopts command is undocumented" I mean in the output of "man ksh" which is all that most people will read. Few people are going to think...

FWIW, I noticed that the clang documentation is generated using Sphinx. For example, see the bottom of this page: https://clang.llvm.org/docs/ClangFormat.html

Did you know the `sleep` builtin has a `-s` flag? I didn't because the ksh man page doesn't document it. I noticed it because I was reviewing [code coverage](https://www.skepticism.us/ast/coveragereport/src/cmd/ksh93/bltins/sleep.c.gcov.html) stats...

I've started working on moving the documentation out of the source code. That revealed several problems. The main one being the "[docopt](http://docopt.org/)" text format that is recognized by `optget()` is...

I've moved almost all of the builtin command "docopt" style documentation and flag definition text used by the AST `optget()` function into external files in the *src/cmd/ksh93/docs* directory. The next...

I just noticed, while refactoring the *src/cmd/ksh93/bltins/bg_fg_disown.c* module, this bogosity: ``` KSH PROMPT:1: disown --help Usage: disown [ options ] [job ...] KSH PROMPT:2: fg --help Usage: fg [ options...