dtb trinity
trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

"in an alternate, human-readable format" would be better; the 'H' stands for Human.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

"If the output is a stream, nul bytes are printed." Input is irrelevant here (this may be my own error).

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

"and the"?..

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

Specifically prints information related to invocation.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

I think this would be more appropriate in a BUGS or CAVEATS section, perhaps with a "See BUGS" in the "-o" option.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

What is "it"?

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

Better: "Do nothing, unsuccessfully."

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

This infinitive present tense for descriptions feels off and I think this is a good example of why. "Compare integers" - who, what, when, where, why, how? It's easy to reference but more difficult to puzzle out for the casual reader.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

Every comparison only compares with the integers next to it.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

Is this replacement portable?

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

cat(1p) and tee(1p) don't provide equivalent functionality; cat(1p) doesn't specify a way to ignore SIGINT and tee(1p) doesn't specify a way to ensure output is unbuffered.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

s/subsequent//. I realize options are only supported prior to positional arguments.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

Use standard error as an output.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

This is inconsistent with the changes made to the dj(1) man page, possibly to my original man pages but I haven't checked.

trinity commented on pull request bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

These were single quoted to indicate, following C conventions, specifically that they are ASCII bytes and not strings.

trinity suggested changes for bonsai/harakit#86 2024-03-26 22:53:17 -06:00
docs: fixed formatting of many manpages

Upon review I realize my man pages had a lot of errors and wrinkles. Your changes are in sum an improvement but I find some of them to be questionable.

trinity commented on issue bonsai/harakit#8 2024-03-26 17:08:01 -06:00
qi(1): The qi shell

What should we use for subshells? My initial thought was to use curly braces ({}) but if we do that it will conflict with our plans for [format(1)](https://git.tebibyte.media/bonsai/coreutils

trinity commented on issue bonsai/harakit#8 2024-03-26 16:23:14 -06:00
qi(1): The qi shell

does time have to be a shell built in? how about a simple coreutil for bench-marking instead?

time isn't a [built-in in dash](https://git.kernel.org/pub/scm/utils/dash/dash.git/tree/src/bl

trinity commented on issue bonsai/harakit#8 2024-03-26 16:10:19 -06:00
qi(1): The qi shell

Both Emma and I plan to have math be in a separate utility or utilities and not built into the shell at all.

how different is it going to be from expr

This was implemented as…

trinity commented on issue bonsai/harakit#70 2024-03-26 16:05:33 -06:00
Harakit by Example

It may be better to just have a Bonsai system wiki.

how about a coreutil that does this? a general purpose tool to make wikis, documentations and even man pages. suckless does this i…