doc : fix markdown rendering.

This commit is contained in:
Dmitry Voronin 2023-12-07 05:22:29 +03:00
parent 475dea095f
commit fc0c68db16
2 changed files with 143 additions and 143 deletions

View file

@ -45,7 +45,7 @@ function doc_bash() {
[[ "${usage}" = "" ]] && usage="${fun}" [[ "${usage}" = "" ]] && usage="${fun}"
# Write to file. # Write to file.
[[ "${desc}" != "" ]] && echo "${usage}|${desc}" >> "${file}" [[ "${desc}" != "" ]] && echo "\`${usage}\`|${desc}" >> "${file}"
done done
echo >> "${file}" echo >> "${file}"

View file

@ -14,356 +14,356 @@ $ h <COMMAND>
Command|Description Command|Description
---|--- ---|---
emulator [NAME]|Start an Android emulator. Default name is `default`. `emulator [NAME]`|Start an Android emulator. Default name is `default`.
## Archive. ## Archive.
Command|Description Command|Description
---|--- ---|---
archive [DIRS]|Archive directories. All directories by default. `archive [DIRS]`|Archive directories. All directories by default.
archive_fast [DIRS]|Archive directories with fast compression. All directories by default. `archive_fast [DIRS]`|Archive directories with fast compression. All directories by default.
archive_check [FILES]|Check archives integrity. Checks all archives by default. `archive_check [FILES]`|Check archives integrity. Checks all archives by default.
archive_prune [NAME]|Delete old versions of archives. All archives by default. `archive_prune [NAME]`|Delete old versions of archives. All archives by default.
unarchive [FILES]|Extract previously created archive with checksum validation. `unarchive [FILES]`|Extract previously created archive with checksum validation.
archive_name [ARCHIVE] [NAME]|Rename archives. If no name specified, it simplifies archive's name. If no archives specified, apply to all archives. `archive_name [ARCHIVE] [NAME]`|Rename archives. If no name specified, it simplifies archive's name. If no archives specified, apply to all archives.
archive_convert|Convert old archives to a new format. *TODO: remove me after some time when there won't be any old archives.* `archive_convert`|Convert old archives to a new format. *TODO: remove me after some time when there won't be any old archives.*
## Battery. ## Battery.
Command|Description Command|Description
---|--- ---|---
battery_level|Print current battery level. `battery_level`|Print current battery level.
## Bootstrap. ## Bootstrap.
Command|Description Command|Description
---|--- ---|---
bootstrap_rust|Install Cargo/Rust. `bootstrap_rust`|Install Cargo/Rust.
bootstrap_texlive|Install TeXLive. `bootstrap_texlive`|Install TeXLive.
bootstrap_grub|Install grub theme. `bootstrap_grub`|Install grub theme.
bootstrap_ffmpeg|Install ffmpeg. `bootstrap_ffmpeg`|Install ffmpeg.
## Cd. ## Cd.
Command|Description Command|Description
---|--- ---|---
cdd <DIR>|CD (back) to directory. Finds first directory that matches the input (case-insensitive). `cdd <DIR>`|CD (back) to directory. Finds first directory that matches the input (case-insensitive).
## Checksum. ## Checksum.
Command|Description Command|Description
---|--- ---|---
checksum_create [FILES]|Save file checksums. For file with a name `file` it will create a new file called `.file.sha1` with hash in it. All files by default. `checksum_create [FILES]`|Save file checksums. For file with a name `file` it will create a new file called `.file.sha1` with hash in it. All files by default.
checksum_check [FILES]|Check stored values against actual files. All files by default. `checksum_check [FILES]`|Check stored values against actual files. All files by default.
checksum|Calculate hashes for all files recursively and store in a file called `checksum.sha1`. `checksum`|Calculate hashes for all files recursively and store in a file called `checksum.sha1`.
## Chmod. ## Chmod.
Command|Description Command|Description
---|--- ---|---
x <FILES>|Add executable flag to file. `x <FILES>`|Add executable flag to file.
## Color. ## Color.
Command|Description Command|Description
---|--- ---|---
color_test|Print all available colors with their names colored in corresponding color. `color_test`|Print all available colors with their names colored in corresponding color.
## Copypaste. ## Copypaste.
Command|Description Command|Description
---|--- ---|---
copy|Copy stdin to system clipboard. *Example:* `echo hi \| copy`. `copy`|Copy stdin to system clipboard. *Example:* `echo hi \| copy`.
paste|Paste system clipboard to stdout. *Example:* `paste > file.txt`. `paste`|Paste system clipboard to stdout. *Example:* `paste > file.txt`.
## Cp. ## Cp.
Command|Description Command|Description
---|--- ---|---
cp <FROM> <TO>|Replaces default cp with rsync. `cp <FROM> <TO>`|Replaces default cp with rsync.
cp_merge <FROM> <TO>|Copy and also merge all changes (delete dst files that do not exist in src). `cp_merge <FROM> <TO>`|Copy and also merge all changes (delete dst files that do not exist in src).
cp_link <FROM> <TO>|Copy by creating hardlinks. Works for directories, too. `cp_link <FROM> <TO>`|Copy by creating hardlinks. Works for directories, too.
bcp|Default cp, a.k.a builtin cp. When you don't need rsync. `bcp`|Default cp, a.k.a builtin cp. When you don't need rsync.
cp_test <FROM> <TO>|Print output of cp_merge without writing anything. `cp_test <FROM> <TO>`|Print output of cp_merge without writing anything.
## Date. ## Date.
Command|Description Command|Description
---|--- ---|---
today|Print today date in yyyyMMdd format. `today`|Print today date in yyyyMMdd format.
dow|Current day of week number. `dow`|Current day of week number.
## Dconf. ## Dconf.
Command|Description Command|Description
---|--- ---|---
dconf_load|Load Gnome settings. `dconf_load`|Load Gnome settings.
dconf_save [FILE]|Dump Gnome settings into the file. Default name is `gnome.dconf`. Do this before changing settings and after, an then run `diff` to find out what to add to the main `gnome.dconf`. `dconf_save [FILE]`|Dump Gnome settings into the file. Default name is `gnome.dconf`. Do this before changing settings and after, an then run `diff` to find out what to add to the main `gnome.dconf`.
## Disk. ## Disk.
Command|Description Command|Description
---|--- ---|---
df|Show only physical drives info. `df`|Show only physical drives info.
du [DIRS]|Show combined size in SI. Current dir by default. `du [DIRS]`|Show combined size in SI. Current dir by default.
## Docker.
Command|Description
---|---
docker_volumes <CONTAINER>|Show container's volumes.
docker_health|Check if any container exited.
docker_ip <CONTAINER>|Find out container's IP address.
docker_update|Update all docker images.
docker_prune|Prune everything.
dc|Docker compose shortcut.
dcu [SERVICES]|Docker compose up.
dcd [SERVICES]|Docker compose down.
dcp [SERVICES]|Docker compose pull.
dcl [SERVICES]|Docker compose logs.
dcr [SERVICES]|Docker compose restart.
dcs [SERVICES]|Docker compose stop.
dcdu [SERVICES]|Docker compose down & up specified services.
dcpu [SERVICES]|Docker compose pull & up specified services.
dcul [SERVICES]|Docker compose up & attach to logs for specified services.
## Doc. ## Doc.
Command|Description Command|Description
---|--- ---|---
doc_bash|Generate a markdown file with all the help info. Outputs to `~/.doc/bash.md`. `doc_bash`|Generate a markdown file with all the help info. Outputs to `~/.doc/bash.md`.
## Docker.
Command|Description
---|---
`docker_volumes <CONTAINER>`|Show container's volumes.
`docker_health`|Check if any container exited.
`docker_ip <CONTAINER>`|Find out container's IP address.
`docker_update`|Update all docker images.
`docker_prune`|Prune everything.
`dc`|Docker compose shortcut.
`dcu [SERVICES]`|Docker compose up.
`dcd [SERVICES]`|Docker compose down.
`dcp [SERVICES]`|Docker compose pull.
`dcl [SERVICES]`|Docker compose logs.
`dcr [SERVICES]`|Docker compose restart.
`dcs [SERVICES]`|Docker compose stop.
`dcdu [SERVICES]`|Docker compose down & up specified services.
`dcpu [SERVICES]`|Docker compose pull & up specified services.
`dcul [SERVICES]`|Docker compose up & attach to logs for specified services.
## Ffmpeg. ## Ffmpeg.
Command|Description Command|Description
---|--- ---|---
ffmpeg_mux_audio <SOUND> <OUTPUT DIR>|Mux audio into containers. File names in sound and current dirrectories must match. `ffmpeg_mux_audio <SOUND> <OUTPUT DIR>`|Mux audio into containers. File names in sound and current dirrectories must match.
ffmpeg_mux_cover <FORMAT> <COVER>|Mux cover into music file. `ffmpeg_mux_cover <FORMAT> <COVER>`|Mux cover into music file.
ffmpeg_music_meta <FORMAT>|Generate music metadata from directory structure. Top dir is the Artist name like this: `The_Beatles`. Next are albums like this: `2010_My_love`. Inside are songs like this: `01_sample.flac`. `ffmpeg_music_meta <FORMAT>`|Generate music metadata from directory structure. Top dir is the Artist name like this: `The_Beatles`. Next are albums like this: `2010_My_love`. Inside are songs like this: `01_sample.flac`.
## File. ## File.
Command|Description Command|Description
---|--- ---|---
o <FILE>|Open file/dir in GUI. `o <FILE>`|Open file/dir in GUI.
## Find. ## Find.
Command|Description Command|Description
---|--- ---|---
find_ext|Find all file extensions. `find_ext`|Find all file extensions.
find_module|Find all modules. `find_module`|Find all modules.
find_function [MODULE]|Find all module functions. Functions from all modules by default. `find_function [MODULE]`|Find all module functions. Functions from all modules by default.
## Fix. ## Fix.
Command|Description Command|Description
---|--- ---|---
fix_ethernet_speed <DEVICE> <SPEED>|Fix when ethernet mistakenly detects 100 Mb instead of 1000 Mb. SPEED is one of 10/100/1000 etc. `fix_ethernet_speed <DEVICE> <SPEED>`|Fix when ethernet mistakenly detects 100 Mb instead of 1000 Mb. SPEED is one of 10/100/1000 etc.
fix_files_sftp|Fix nautilus after typing wrong sftp password. `fix_files_sftp`|Fix nautilus after typing wrong sftp password.
## Git. ## Git.
Command|Description Command|Description
---|--- ---|---
gps|Git push. `gps`|Git push.
gpsf|Git force push. `gpsf`|Git force push.
gpl|Git pull. `gpl`|Git pull.
gl|Git log. `gl`|Git log.
gs|Git status. `gs`|Git status.
gst|Git stash. `gst`|Git stash.
gd|Git diff. `gd`|Git diff.
gc|Git commit. `gc`|Git commit.
gch|Git checkout. `gch`|Git checkout.
gchb <BRANCH>|Git checkout branch. `gchb <BRANCH>`|Git checkout branch.
gb|Git branch. `gb`|Git branch.
gbd <BRANCH>|Git branch delete. `gbd <BRANCH>`|Git branch delete.
gbda|Git branch delete all except current. `gbda`|Git branch delete all except current.
gf|Git fetch all. `gf`|Git fetch all.
gt|Git tag. `gt`|Git tag.
gi|Git ignore files. `gi`|Git ignore files.
gpc <FILE>|Git patch create. `gpc <FILE>`|Git patch create.
gp <FILE>|Git patch (apply). `gp <FILE>`|Git patch (apply).
ggc|Run git garbage collection. `ggc`|Run git garbage collection.
ga [FILES]|Preview diff while adding. Adds current dir by default. `ga [FILES]`|Preview diff while adding. Adds current dir by default.
gr [COMMIT COUNT]|Rebase by X commits or from root. When COUNT is 0 - rebase from root. Default is 2. `gr [COMMIT COUNT]`|Rebase by X commits or from root. When COUNT is 0 - rebase from root. Default is 2.
gu [EMAIL]|Specify git user as Dmitry Voronin with provided email. `gu [EMAIL]`|Specify git user as Dmitry Voronin with provided email.
gg <REPO>|Get my git repo. `gg <REPO>`|Get my git repo.
gdc <COMMITHASH>|See diff for a specific commit. `gdc <COMMITHASH>`|See diff for a specific commit.
## Help. ## Help.
Command|Description Command|Description
---|--- ---|---
help <FUNCTION>|Get help about dotfiles bash function. `help <FUNCTION>`|Get help about dotfiles bash function.
h <FUNCTION>|Short for help. `h <FUNCTION>`|Short for help.
## Ls. ## Ls.
Command|Description Command|Description
---|--- ---|---
l [DIRS]|List files in dirs. Current dir by default. `l [DIRS]`|List files in dirs. Current dir by default.
ll [DIRS]|List last modified files first. Current dir by default. `ll [DIRS]`|List last modified files first. Current dir by default.
lll [DEPTH] [DIRS]|List files in tree structure. Current dir by default. Depth can be omitted by passing `-` (dash). `lll [DEPTH] [DIRS]`|List files in tree structure. Current dir by default. Depth can be omitted by passing `-` (dash).
llll [DIRS]|List files recursively. Current dir by default. `llll [DIRS]`|List files recursively. Current dir by default.
la [DIRS]|List all files in dirs, incl. hidden files. Current dir by default. `la [DIRS]`|List all files in dirs, incl. hidden files. Current dir by default.
lla [DIRS]|List all files in dirs, incl. hidden files, sorted by mtime. Current dir by default. `lla [DIRS]`|List all files in dirs, incl. hidden files, sorted by mtime. Current dir by default.
## Name. ## Name.
Command|Description Command|Description
---|--- ---|---
name [FILES]|Rename files to strip all special characters. All files by default. `name [FILES]`|Rename files to strip all special characters. All files by default.
name_hash [FILES]|Rename all files to their hashes while keeping extensions. All files by default. `name_hash [FILES]`|Rename all files to their hashes while keeping extensions. All files by default.
name_hash_check [FILES]|Check hashes for previously renamed files. All files by default. `name_hash_check [FILES]`|Check hashes for previously renamed files. All files by default.
name_series <SEASON> [FILES]|Rename files for Jellyfin series, i.e. `Episode S01E01.mkv` All files by default. `name_series <SEASON> [FILES]`|Rename files for Jellyfin series, i.e. `Episode S01E01.mkv` All files by default.
name_manga <SEASON> [FILES]|Rename files for Kavita manga format. All files by default. `name_manga <SEASON> [FILES]`|Rename files for Kavita manga format. All files by default.
name_ext <EXTENSION> [FILES]|Rename files with new extension. All files by default. `name_ext <EXTENSION> [FILES]`|Rename files with new extension. All files by default.
name_prefix <OLD> <NEW> [FILES]|Change file name prefix. All matching files by default. `name_prefix <OLD> <NEW> [FILES]`|Change file name prefix. All matching files by default.
name_postfix <OLD> <NEW> [FILES]|Change file name postfix. All matching files by default. `name_postfix <OLD> <NEW> [FILES]`|Change file name postfix. All matching files by default.
name_replace <OLD> <NEW> [FILES]|Replace part of the name. All matching files by default. `name_replace <OLD> <NEW> [FILES]`|Replace part of the name. All matching files by default.
## Ncdu. ## Ncdu.
Command|Description Command|Description
---|--- ---|---
ncdu [DIRS]|Search only on current filesystem. Current dir by default. `ncdu [DIRS]`|Search only on current filesystem. Current dir by default.
## Notify. ## Notify.
Command|Description Command|Description
---|--- ---|---
notify <MESSAGE>|Send Telegram notification. `notify <MESSAGE>`|Send Telegram notification.
notify_silent <MESSAGE>|Send silent Telegram notification. `notify_silent <MESSAGE>`|Send silent Telegram notification.
## Own. ## Own.
Command|Description Command|Description
---|--- ---|---
own [USER] [FILES]|Change file ownership to specified user id and restrict access to him. Root user by default. This directory recursively by default. `own [USER] [FILES]`|Change file ownership to specified user id and restrict access to him. Root user by default. This directory recursively by default.
## Pack. ## Pack.
Command|Description Command|Description
---|--- ---|---
pack <TARGET.ext> [FILES]|Pack files into desired format. All files and directories by default. `pack <TARGET.ext> [FILES]`|Pack files into desired format. All files and directories by default.
unpack [FILES]|Attempt to unpack. All supported formats by default. `unpack [FILES]`|Attempt to unpack. All supported formats by default.
## Parse. ## Parse.
Command|Description Command|Description
---|--- ---|---
parse_simplify <STRING>|Parse data and output simplified format. `parse_simplify <STRING>`|Parse data and output simplified format.
parse_camel <STRING>|Parse to CamelCase. `parse_camel <STRING>`|Parse to CamelCase.
parse_alnum <STRING>|Parse data keeping only alphanumeric characters. `parse_alnum <STRING>`|Parse data keeping only alphanumeric characters.
## Permissions. ## Permissions.
Command|Description Command|Description
---|--- ---|---
perm_share|Recursively change permissions to allow read sharing with group and others. `perm_share`|Recursively change permissions to allow read sharing with group and others.
perm|Recursively change permissions to restrict access for group and others. `perm`|Recursively change permissions to restrict access for group and others.
## Ps. ## Ps.
Command|Description Command|Description
---|--- ---|---
ps <PROCESS>|Find process and filter. `ps <PROCESS>`|Find process and filter.
## Recursive. ## Recursive.
Command|Description Command|Description
---|--- ---|---
recursive <COMMAND>|Run something recursively over all directories. `recursive <COMMAND>`|Run something recursively over all directories.
recursive1 <COMMAND>|Run something recursively over directories of 1 depth (excluding current dir). `recursive1 <COMMAND>`|Run something recursively over directories of 1 depth (excluding current dir).
## Rust. ## Rust.
Command|Description Command|Description
---|--- ---|---
rust_book|Open Rust book. `rust_book`|Open Rust book.
## Su. ## Su.
Command|Description Command|Description
---|--- ---|---
s [USER]|Su shortcut for lazy me. Root by default. `s [USER]`|Su shortcut for lazy me. Root by default.
## Terminal. ## Terminal.
Command|Description Command|Description
---|--- ---|---
tsize|Get terminal size. `tsize`|Get terminal size.
## Tmp. ## Tmp.
Command|Description Command|Description
---|--- ---|---
tmp|CD into host's primary tmp dir. `tmp`|CD into host's primary tmp dir.
## Tmux. ## Tmux.
Command|Description Command|Description
---|--- ---|---
ta [NAME]|Create/attach to named session. By default uses name `main`. `ta [NAME]`|Create/attach to named session. By default uses name `main`.
td|Detach from running session. `td`|Detach from running session.
tl|List running sessions. `tl`|List running sessions.
trn [NAME]|Rename current session. Uses current dir name by default. `trn [NAME]`|Rename current session. Uses current dir name by default.
tn [NAME]|Assign name to window. Uses current dir name by default. `tn [NAME]`|Assign name to window. Uses current dir name by default.
tk [NAME]|Kill specified session. By default it kills `main` session. `tk [NAME]`|Kill specified session. By default it kills `main` session.
tka|Kill all sessions. `tka`|Kill all sessions.
## Todo. ## Todo.
Command|Description Command|Description
---|--- ---|---
todo|Open `~/.todo.md` file. `todo`|Open `~/.todo.md` file.
## Toolbx. ## Toolbx.
Command|Description Command|Description
---|--- ---|---
tba [NAME]|Attach/create toolbx container with specified name. By default uses `main` name. `tba [NAME]`|Attach/create toolbx container with specified name. By default uses `main` name.
tbk [NAME]|Remove toolbx container with specified name. By default uses `main` name. `tbk [NAME]`|Remove toolbx container with specified name. By default uses `main` name.
tb_rpmfusion [NAME]|Install rpm-fusion repository into container with specified name. By default uses `main` name. `tb_rpmfusion [NAME]`|Install rpm-fusion repository into container with specified name. By default uses `main` name.
tbl|List all available containers. `tbl`|List all available containers.
## Transcode. ## Transcode.
Command|Description Command|Description
---|--- ---|---
transcode <FORMAT> [FILES]|Convert between different formats. By default tries to convert all files. `transcode <FORMAT> [FILES]`|Convert between different formats. By default tries to convert all files.
## Try. ## Try.
Command|Description Command|Description
---|--- ---|---
try <COMMAND>|Retry command every 2 sec until it completes successfully. `try <COMMAND>`|Retry command every 2 sec until it completes successfully.
## Vdl. ## Vdl.
Command|Description Command|Description
---|--- ---|---
vdl [LINK]|Download video from URL. When no [LINK] specified, it tries to update previously downloaded link. `vdl [LINK]`|Download video from URL. When no [LINK] specified, it tries to update previously downloaded link.
vdl_vk <LINK>|Temporary fix for vk downloads. `vdl_vk <LINK>`|Temporary fix for vk downloads.
vdl_file <FILE>|Download all videos from file with links. `vdl_file <FILE>`|Download all videos from file with links.
## Vi. ## Vi.
Command|Description Command|Description
---|--- ---|---
v|Neovim shortcut. `v`|Neovim shortcut.
## Wallpaper. ## Wallpaper.
Command|Description Command|Description
---|--- ---|---
wallpaper <FILE>|Set specified file as a wallpaper. `wallpaper <FILE>`|Set specified file as a wallpaper.
## Watch. ## Watch.
Command|Description Command|Description
---|--- ---|---
w <COMMAND>|Watch command output with 2 seconds interval. `w <COMMAND>`|Watch command output with 2 seconds interval.
ww <COMMAND>|Watch command output with minimal interval. `ww <COMMAND>`|Watch command output with minimal interval.