bonsai/harakit
5
4
Fork 3
Code Issues 43 Pull Requests 3 Projects 1 Releases 36 Activity

swab.1: Clarify wording in Line 23 #177

New Issue
Open
opened 2026-02-09 00:27:29 -07:00 by emma · 4 comments
emma commented 2026-02-09 00:27:29 -07:00
Owner
Copy Link
Copy Source

harakit/docs/swab.1 Line 23 in d3c59ede0d
Configures the word size; that is, the size in bytes of the block size on which

https://git.tebibyte.media/bonsai/harakit/src/commit/d3c59ede0d236634045c965a4a623d0327d877bc/docs/swab.1#L23
trinity commented 2026-02-09 11:42:05 -07:00
Owner
Copy Link
Copy Source

What about this is unclear?

The wording could be better. I would write it now as

Configures the word size; that is, the size in bytes of the block on which...
What about this is unclear? The wording could be better. I would write it now as ``` Configures the word size; that is, the size in bytes of the block on which... ```
emma commented 2026-02-11 23:57:24 -07:00
Author
Owner
Copy Link
Copy Source

“The size in bytes [...] block size” is redundant, “The block size, in bytes,
on which to operate” suffices.

“The size in bytes [...] block size” is redundant, “The block size, in bytes, on which to operate” suffices.
trinity commented 2026-02-12 08:28:52 -07:00
Owner
Copy Link
Copy Source

Do you have an opinion on my corrected wording?

Do you have an opinion on my corrected wording?
emma commented 2026-02-12 09:30:17 -07:00
Author
Owner
Copy Link
Copy Source

I think I like it better than mine on second pass.

I think I like it better than mine on second pass.
emma added the bugenhancement labels 2026-02-12 12:20:06 -07:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
Something is not working
 duplicate
This issue or pull request already exists
 enhancement
New feature
 help wanted
Need some help
 invalid
Something is wrong
 joke
you are silly!
 question
More information is needed
 wontfix
This won't be fixed
No labels bug enhancement
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
emma (Emma Tebibyte) nitori silt (silt!) soup (Soup For My Family) trinity (dtb)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: bonsai/harakit#177