Skip to content

Commit 3bcd391

Browse files
SimonSchubertSimonSchubert
committed
Add commands
Document twurl-authorize from tldr-pages discovery.
1 parent 7c5e857 commit 3bcd391

43 files changed

Lines changed: 1132 additions & 328 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎assets/basics/terminalgames.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,16 @@ Play Go against the GNU Go engine.
212212
3 . . . . . . .
213213
```
214214

215+
## go-fish
216+
Collect books of four matching cards before the computer does.
217+
```[go-fish](/man/go-fish)```
218+
```
219+
Your hand: 3 3 7 9 K
220+
Got any 7s? y
221+
I had a 7? Here!
222+
Books won: 1
223+
```
224+
215225
## gomoku
216226
Get five stones in a row before the computer does.
217227
```[gomoku](/man/gomoku)```

‎assets/commands/go-fish.md‎

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,57 @@
11
# TAGLINE
22

3-
fish shell completion generator for Go programs
3+
play the classic Go Fish card game against the computer
44

55
# TLDR
66

7-
**Generate fish completions**
7+
**Start a game**
88

99
```go-fish```
1010

11-
**Specific package completions**
11+
**Play in "professional" mode** (randomly decide who asks first)
1212

13-
```go-fish [package]```
13+
```go-fish -p```
1414

1515
# SYNOPSIS
1616

17-
**go-fish** [_package_]
17+
**go-fish** [**-p**]
1818

1919
# PARAMETERS
2020

21-
_PACKAGE_
22-
> Package to generate completions for.
21+
**-p**
22+
> Professional mode: randomly determine who asks first, instead of always letting the player start.
2323
24-
**--help**
25-
> Display help information.
24+
# PREVIEW
25+
26+
```
27+
Your hand: 3 3 7 9 K
28+
Got any 7s? y
29+
I had a 7? Here!
30+
Books won: 1
31+
```
2632

2733
# DESCRIPTION
2834

29-
**go-fish** generates fish shell completions for Go programs. It analyzes Go command-line flag definitions and creates fish completion scripts.
35+
**go-fish** is a text-interface version of the traditional children's card game, part of the **bsd-games** collection. The player and the computer are each dealt seven cards, and take turns asking each other for cards of a given rank in order to collect "books" (all four cards of that rank).
3036

31-
The tool automates completion script generation from Go source code. It uses Go's flag package conventions to identify commands and options.
37+
You may only ask for a rank you already hold at least one card of. If the opponent has none, you're told to "Go Fish!" and must draw from the remaining deck; drawing the requested rank lets you go again. Completed books are set aside and that rank becomes unavailable. The game ends when either player is out of cards, and whoever has collected the most books wins.
3238

3339
# CAVEATS
3440

35-
Requires Go flags package usage. Fish shell specific. May need customization.
41+
Part of the bsd-games package, so availability depends on your distribution installing it. The computer opponent rarely bluffs and mostly plays honestly.
3642

3743
# HISTORY
3844

39-
go-fish was created to automate fish shell completion generation for Go command-line applications.
45+
**go-fish** originates from the **BSD Games** collection first assembled in the 1980s-90s and later packaged for Linux distributions as **bsd-games**/**bsdgames**.
4046

4147
# SEE ALSO
4248

43-
[go](/man/go)(1), [fish](/man/fish)(1)
49+
[hangman](/man/hangman)(6), [cribbage](/man/cribbage)(6)
50+
51+
# RESOURCES
52+
53+
```[Source code](https://github.com/jsm28/bsd-games)```
54+
55+
```[Documentation](https://packages.debian.org/stable/bsdgames)```
56+
57+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-bios-setup.md‎

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,24 +16,40 @@ Install GRUB in a **specific directory**
1616

1717
```grub-bios-setup -d /boot/grub /dev/sdX```
1818

19+
Also make the drive **bootable as a floppy**
20+
21+
```grub-bios-setup -a /dev/sdX```
22+
1923
# SYNOPSIS
2024

2125
**grub-bios-setup** [_options_] _device_
2226

2327
# PARAMETERS
2428

29+
**-b**, **--boot-image** _FILE_
30+
> Use _FILE_ as the boot image instead of boot.img
31+
32+
**-c**, **--core-image** _FILE_
33+
> Use _FILE_ as the core image instead of core.img
34+
2535
**-d**, **--directory** _DIR_
2636
> Use GRUB files from _DIR_ instead of default
2737
38+
**-m**, **--device-map** _FILE_
39+
> Use device map from _FILE_
40+
2841
**-f**, **--force**
2942
> Install even if problems are detected
3043
31-
**-m**, **--device-map** _FILE_
32-
> Use device map from _FILE_
44+
**-a**, **--allow-floppy**
45+
> Make the drive also bootable as a floppy (may break on some BIOSes)
3346
3447
**-s**, **--skip-fs-probe**
3548
> Skip filesystem probing
3649
50+
**--no-rs-codes**
51+
> Do not add Reed-Solomon error-correcting codes (x86 BIOS targets only)
52+
3753
**-v**, **--verbose**
3854
> Enable verbose output
3955
@@ -54,3 +70,13 @@ grub-bios-setup is part of GRUB 2, providing the low-level MBR installation that
5470
# SEE ALSO
5571

5672
[grub-install](/man/grub-install)(8), [grub-mkconfig](/man/grub-mkconfig)(8)
73+
74+
# RESOURCES
75+
76+
```[Homepage](https://www.gnu.org/software/grub/)```
77+
78+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
79+
80+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
81+
82+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-editenv.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,9 @@ Display all GRUB **environment variables**
3434
**create**
3535
> Create a new empty environment file
3636
37+
**-v**, **--verbose**
38+
> Print verbose messages
39+
3740
# DESCRIPTION
3841

3942
**grub-editenv** manages GRUB's environment block (grubenv), which stores persistent variables across boots. The environment file is typically located at /boot/grub/grubenv or /boot/grub2/grubenv.
@@ -61,3 +64,13 @@ grub-editenv is part of GRUB 2's saved default mechanism, allowing boot preferen
6164
# SEE ALSO
6265

6366
[grub-set-default](/man/grub-set-default)(8), [grub-reboot](/man/grub-reboot)(8), [grub-mkconfig](/man/grub-mkconfig)(8)
67+
68+
# RESOURCES
69+
70+
```[Homepage](https://www.gnu.org/software/grub/)```
71+
72+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
73+
74+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
75+
76+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-file.md‎

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,14 @@ Check if a file is an **ARM Linux** kernel
2020

2121
```grub-file --is-arm-linux [path/to/file]```
2222

23-
Check if a file is an **x86 Linux** kernel
23+
Check if a file is an **x86 Linux** kernel (32 or 64-bit)
2424

2525
```grub-file --is-x86-linux [path/to/file]```
2626

27+
Check if a file is an **x86 Multiboot2** kernel
28+
29+
```grub-file --is-x86-multiboot2 [path/to/file]```
30+
2731
Check if a file is an **x86_64 XNU** (macOS) kernel
2832

2933
```grub-file --is-x86_64-xnu [path/to/file]```
@@ -49,18 +53,24 @@ Check if a file is an **x86_64 XNU** (macOS) kernel
4953
**--is-arm-linux**
5054
> Check for ARM Linux kernel
5155
56+
**--is-arm64-linux**
57+
> Check for ARM64 Linux kernel
58+
5259
**--is-x86-linux**
53-
> Check for x86 Linux kernel
60+
> Check for x86 Linux kernel (covers both 32 and 64-bit)
5461
55-
**--is-x86_64-linux**
56-
> Check for x86_64 Linux kernel
62+
**--is-x86-linux32**
63+
> Check for x86 Linux kernel using the 32-bit-only boot protocol
5764
5865
**--is-x86_64-xnu**
59-
> Check for macOS XNU kernel
66+
> Check for macOS (XNU) x86_64 kernel
6067
61-
**--is-multiboot**
68+
**--is-x86-multiboot**
6269
> Check for Multiboot image
6370
71+
**--is-x86-multiboot2**
72+
> Check for Multiboot2 image
73+
6474
# DESCRIPTION
6575

6676
**grub-file** checks whether a file is a bootable image of a specific type. It examines file headers and signatures to identify kernel images, EFI applications, and other bootable formats.
@@ -78,3 +88,13 @@ grub-file is part of GRUB 2, providing a utility for image type detection. This
7888
# SEE ALSO
7989

8090
[grub-install](/man/grub-install)(8), [grub-probe](/man/grub-probe)(8), [file](/man/file)(1)
91+
92+
# RESOURCES
93+
94+
```[Homepage](https://www.gnu.org/software/grub/)```
95+
96+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
97+
98+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
99+
100+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-install.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,3 +77,13 @@ GRUB 2 grub-install replaced the older GRUB Legacy installation method around **
7777
# SEE ALSO
7878

7979
[grub-mkconfig](/man/grub-mkconfig)(8), [grub-set-default](/man/grub-set-default)(8), [efibootmgr](/man/efibootmgr)(8)
80+
81+
# RESOURCES
82+
83+
```[Homepage](https://www.gnu.org/software/grub/)```
84+
85+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
86+
87+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
88+
89+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-mkdevicemap.md‎

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,15 +23,18 @@ create GRUB device mapping file
2323
# PARAMETERS
2424

2525
**-m**, **--device-map** _FILE_
26-
> Output device map file.
26+
> Output device map file (default: /boot/grub/device.map).
2727
2828
**-n**, **--no-floppy**
2929
> Skip floppy detection.
3030
31+
**-s**, **--probe-second-floppy**
32+
> Also probe the second floppy drive.
33+
3134
**-v**, **--verbose**
3235
> Verbose mode.
3336
34-
**--help**
37+
**-h**, **--help**
3538
> Display help information.
3639
3740
# DESCRIPTION
@@ -42,7 +45,7 @@ The map is automatically generated but can be customized for special configurati
4245

4346
# CAVEATS
4447

45-
Deprecated in GRUB 2. May be needed for legacy setups. Disk order detection may vary.
48+
Mostly unnecessary today since GRUB generates a device map on the fly and identifies disks by UUID or label in grub.cfg. Still useful to override detection, such as when a partition or logical volume is used as a virtual machine's disk.
4649

4750
# HISTORY
4851

@@ -51,3 +54,13 @@ grub-mkdevicemap was developed as part of **GNU GRUB** for device mapping betwee
5154
# SEE ALSO
5255

5356
[grub-install](/man/grub-install)(8), [grub-mkconfig](/man/grub-mkconfig)(8), [grub](/man/grub)(8)
57+
58+
# RESOURCES
59+
60+
```[Homepage](https://www.gnu.org/software/grub/)```
61+
62+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
63+
64+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
65+
66+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-mkfont.md‎

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,14 @@ _FONT-FILE_
3838
**-i**, **--index** _N_
3939
> Face index for TTC.
4040
41-
**--range** _RANGE_
42-
> Unicode range to include.
41+
**-n**, **--name** _NAME_
42+
> Set font family name.
43+
44+
**-b**, **--bold**
45+
> Convert to a bold font.
46+
47+
**-r**, **--range** _FROM-TO_
48+
> Unicode range(s) to include (comma-separated).
4349
4450
**-v**, **--verbose**
4551
> Verbose output.
@@ -64,3 +70,13 @@ grub-mkfont was developed as part of **GNU GRUB 2** to support graphical boot me
6470
# SEE ALSO
6571

6672
[grub](/man/grub)(8), [grub-mkconfig](/man/grub-mkconfig)(8), [fc-list](/man/fc-list)(1)
73+
74+
# RESOURCES
75+
76+
```[Homepage](https://www.gnu.org/software/grub/)```
77+
78+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
79+
80+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
81+
82+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-script-check.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,3 +52,13 @@ grub-script-check is part of GRUB 2, providing validation for GRUB's configurati
5252
# SEE ALSO
5353

5454
[grub-mkconfig](/man/grub-mkconfig)(8), [grub-install](/man/grub-install)(8), [update-grub](/man/update-grub)(8)
55+
56+
# RESOURCES
57+
58+
```[Homepage](https://www.gnu.org/software/grub/)```
59+
60+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
61+
62+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
63+
64+
<!-- verified: 2026-07-17 -->

‎assets/commands/grub-set-default.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,3 +46,13 @@ grub-set-default is part of GRUB 2's saved default functionality. It provides a
4646
# SEE ALSO
4747

4848
[grub-reboot](/man/grub-reboot)(8), [grub-mkconfig](/man/grub-mkconfig)(8), [grub-editenv](/man/grub-editenv)(1)
49+
50+
# RESOURCES
51+
52+
```[Homepage](https://www.gnu.org/software/grub/)```
53+
54+
```[Source code](https://git.savannah.gnu.org/cgit/grub.git)```
55+
56+
```[Documentation](https://www.gnu.org/software/grub/manual/grub/grub.html)```
57+
58+
<!-- verified: 2026-07-17 -->

0 commit comments

Comments
 (0)