diff --git a/tldr/audacious b/tldr/audacious index 7e1d728d..df615c97 100755 --- a/tldr/audacious +++ b/tldr/audacious @@ -5,13 +5,17 @@ source: https://github.com/tldr-pages/tldr.git --- # audacious -> An open-source audio player. +> An open-source audio player. Indirectly based on XMMS. > More information: . -- Launch the program: +- Launch the GUI: `audacious` +- Start a new instance and play an audio: + +`audacious --new-instance {{path/to/audio}}` + - Enqueue a specific directory of audio files: `audacious --enqueue {{path/to/directory}}` @@ -20,7 +24,7 @@ source: https://github.com/tldr-pages/tldr.git `audacious --play-pause` -- Skip forwards or backwards in the playlist: +- Skip forwards ([fwd]) or backwards ([rew]) in the playlist: `audacious --{{fwd|rew}}` @@ -28,7 +32,7 @@ source: https://github.com/tldr-pages/tldr.git `audacious --stop` -- Start a headless version: +- Start in CLI mode (headless): `audacious --headless` diff --git a/tldr/go-tool b/tldr/go-tool index f28293e8..f7c13f9a 100644 --- a/tldr/go-tool +++ b/tldr/go-tool @@ -24,3 +24,7 @@ source: https://github.com/tldr-pages/tldr.git - View documentation for a specified tool: `go tool {{command}} --help` + +- List all available cross-compilation targets: + +`go tool dist list` diff --git a/tldr/kdeconnect-cli b/tldr/kdeconnect-cli index 62bd5af2..3e42d0f0 100644 --- a/tldr/kdeconnect-cli +++ b/tldr/kdeconnect-cli @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # kdeconnect-cli -> KDE's Connect CLI. +> Use KDE Connect for sharing files or text to a device, ringing it, unlocking it, and much more. > More information: . - List all devices: diff --git a/tldr/linux/aplay b/tldr/linux/aplay index 9b0a82ed..6e6c0448 100644 --- a/tldr/linux/aplay +++ b/tldr/linux/aplay @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # aplay -> Command-line sound player for ALSA soundcard driver. +> Sound player for ALSA soundcard driver. > More information: . - Play a specific file (sampling rate, bit depth, etc. will be automatically determined for the file format): diff --git a/tldr/linux/virt-manager b/tldr/linux/virt-manager index 7db95db4..b0094f9f 100644 --- a/tldr/linux/virt-manager +++ b/tldr/linux/virt-manager @@ -5,10 +5,10 @@ source: https://github.com/tldr-pages/tldr.git --- # virt-manager -> CLI launcher for virt-manager, a desktop user interface for managing KVM and Xen virtual machines and LXC containers. +> A desktop user interface for managing KVM and Xen virtual machines and LXC containers. > More information: . -- Launch virt-manager: +- Launch the GUI: `virt-manager` @@ -28,11 +28,11 @@ source: https://github.com/tldr-pages/tldr.git `virt-manager --show-domain-creator` -- Show domain details window: +- Show domain details window for a specific virtual machine/container: `virt-manager --show-domain-editor {{name|id|uuid}}` -- Show domain performance window: +- Show domain performance window for a specific virtual machine/container: `virt-manager --show-domain-performance {{name|id|uuid}}` diff --git a/tldr/ncmpcpp b/tldr/ncmpcpp index c600c7cf..e3cede6e 100644 --- a/tldr/ncmpcpp +++ b/tldr/ncmpcpp @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # ncmpcpp -> A command-line music player client for the Music Player Daemon. +> A music player client for the Music Player Daemon. > More information: . - Connect to a music player daemon on a given host and port: diff --git a/tldr/osx/diskutil b/tldr/osx/diskutil index 1cda650f..d8375708 100644 --- a/tldr/osx/diskutil +++ b/tldr/osx/diskutil @@ -6,6 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # diskutil > Utility to manage local disks and volumes. +> Some subcommands such as `diskutil partitiondisk` have their own usage documentation. > More information: . - List all currently available disks, partitions and mounted volumes: diff --git a/tldr/osx/diskutil-partitiondisk b/tldr/osx/diskutil-partitiondisk new file mode 100644 index 00000000..318eabcf --- /dev/null +++ b/tldr/osx/diskutil-partitiondisk @@ -0,0 +1,31 @@ +--- +syntax: markdown +tags: [tldr, osx] +source: https://github.com/tldr-pages/tldr.git +--- +# diskutil partitionDisk + +> Utility to manage partitions inside disks and volumes. +> Part of `diskutil`. +> APM is only supported for macOS, MBR is optimized for DOS, while GPT is compatible for most modern systems. +> More information: . + +- Reformat a volume using APM/MBR/GPT partitioning scheme, leaving no partitions inside (this will erase all data on the volume): + +`diskutil partitionDisk {{/dev/disk_device}} 0 {{APM|MBR|GPT}}` + +- Reformat a volume, then create a single partition using a specific filesystem filling up all free space: + +`diskutil partitionDisk {{/dev/disk_device}} 1 {{APM|MBR|GPT}} {{partition_filesystem}} {{partition_name}}` + +- Reformat a volume, then create a single partition using a specific filesystem under specific size (e.g. `16G` for 16GB or `50%` to fill half of total volume size): + +`diskutil partitionDisk {{/dev/disk_device}} 1 {{APM|MBR|GPT}} {{partition_filesystem}} {{partition_name}} {{partition_size}}` + +- Reformat a volume, then create multiple partitions: + +`diskutil partitionDisk {{/dev/disk_device}} {{number_of_partitions}} {{APM|MBR|GPT}} {{partition_filesystem1}} {{partition_name1}} {{partition_size1}} {{partition_filesystem2}} {{partition_name2}} {{partition_size2}} ...` + +- List all supported file systems for partitioning: + +`diskutil listFilesystems` diff --git a/tldr/windows/reg b/tldr/windows/reg index 30454b28..5099112d 100644 --- a/tldr/windows/reg +++ b/tldr/windows/reg @@ -13,7 +13,27 @@ source: https://github.com/tldr-pages/tldr.git `reg {{command}}` -- Display general information and list all available commands: +- View documentation for adding and copying subkeys: + +`tldr reg {{add|copy}}` + +- View documentation for deleting keys and subkeys: + +`tldr reg {{delete|unload}}` + +- View documentation for searching, viewing, and comparing keys: + +`tldr reg {{compare|flags|query}}` + +- View documentation for exporting and importing registry keys not preserving the key ownerships and ACLs: + +`tldr reg {{export|import}}` + +- View documentation for saving, restoring registry and unloading keys preserving the key ownerships and ACLs: + +`tldr reg {{save|restore|load|unload}}` + +- Display help: `reg /?` diff --git a/tldr/windows/reg-add b/tldr/windows/reg-add index fb347646..983c5ab6 100644 --- a/tldr/windows/reg-add +++ b/tldr/windows/reg-add @@ -12,18 +12,18 @@ source: https://github.com/tldr-pages/tldr.git `reg add {{key_name}}` -- Add a new value under a specific key: +- Add a new [v]alue under a specific key: `reg add {{key_name}} /v {{value}}` -- Add a new value with specific data: +- Add a new value with specific [d]ata: `reg add {{key_name}} /d {{data}}` -- Add a new value to a key with a specific data type: +- Add a new value to a key with a specific data [t]ype: -`reg add {{key_name}} /t {{type}}` +`reg add {{key_name}} /t REG_{{SZ|MULTI_SZ|DWORD_BIG_ENDIAN|DWORD|BINARY|DWORD_LITTLE_ENDIAN|LINK|FULL_RESOURCE_DESCRIPTOR|EXPAND_SZ}}` -- Forcefully overwrite the existing registry value without a prompt: +- [f]orcefully (without a prompt) overwrite the existing registry value: `reg add {{key_name}} /f` diff --git a/tldr/windows/reg-compare b/tldr/windows/reg-compare index 477bcd57..7c555456 100644 --- a/tldr/windows/reg-compare +++ b/tldr/windows/reg-compare @@ -8,22 +8,26 @@ source: https://github.com/tldr-pages/tldr.git > Compare keys and their values in the registry. > More information: . -- Compare all values under a specific key with a second key: +- Compare all values under a specific key with another key: -`reg compare {{first_key_name}} {{second_key_name}}` +`reg compare {{key_name1}} {{key_name2}}` -- Compare a specific value under two keys: +- Compare a specific [v]alue under two keys: -`reg compare {{first_key_name}} {{second_key_name}} /v {{value}}` +`reg compare {{key_name1}} {{key_name2}} /v {{value}}` -- Compare all sub keys and values for two keys: +- Compare all [s]ubkeys and values for two keys: -`reg compare {{first_key_name}} {{second_key_name}} /s` +`reg compare {{key_name1}} {{key_name2}} /s` -- Only output the matches between the specified keys: +- Only [o]utput the matches ([s]ame) between the specified keys: -`reg compare {{first_key_name}} {{second_key_name}} /os` +`reg compare {{key_name1}} {{key_name2}} /os` -- Output the differences and matches between the specified keys: +- [o]utput the differences and matches ([a]ll) between the specified keys: -`reg compare {{first_key_name}} {{second_key_name}} /oa` +`reg compare {{key_name1}} {{key_name2}} /oa` + +- Compare two keys, [o]utputting [n]othing: + +`reg compare {{key_name1}} {{key_name2}} /on` diff --git a/tldr/windows/reg-copy b/tldr/windows/reg-copy index 6d3898df..ecaf28e2 100644 --- a/tldr/windows/reg-copy +++ b/tldr/windows/reg-copy @@ -12,10 +12,10 @@ source: https://github.com/tldr-pages/tldr.git `reg copy {{old_key_name}} {{new_key_name}}` -- Copy a registry key recursively to a new registry location: +- Copy a registry key recursively (with all [s]ubkeys) to a new registry location: `reg copy {{old_key_name}} {{new_key_name}} /s` -- Forcefully copy a registry key without a prompt: +- [f]orcefully (without a prompt) copy a registry key: `reg copy {{old_key_name}} {{new_key_name}} /f` diff --git a/tldr/windows/reg-delete b/tldr/windows/reg-delete index 41db2836..7b6b1b0d 100644 --- a/tldr/windows/reg-delete +++ b/tldr/windows/reg-delete @@ -12,14 +12,14 @@ source: https://github.com/tldr-pages/tldr.git `reg delete {{key_name}}` -- Delete a value under a specific key: +- Delete a [v]alue under a specific key: `reg delete {{key_name}} /v {{value}}` -- Delete all values recursively under the specified key: +- Delete [a]ll [v]alues recursively under the specified key: `reg delete {{key_name}} /va` -- Forcefully delete all values recursively under a key without a prompt: +- [f]orcefully (without a prompt) delete [a]ll [v]alues recursively under a key: `reg delete {{key_name}} /f /va` diff --git a/tldr/windows/reg-export b/tldr/windows/reg-export index b1420379..fac5ff36 100644 --- a/tldr/windows/reg-export +++ b/tldr/windows/reg-export @@ -5,13 +5,13 @@ source: https://github.com/tldr-pages/tldr.git --- # reg export -> Export the specified sub keys and values into a file. +> Export the specified subkeys and values to a `.reg` file. > More information: . -- Export all sub keys and values of a specific key: +- Export all subkeys and values of a specific key: `reg export {{key_name}} {{path o ile.reg}}` -- Force overwriting of an existing file without prompt: +- Forcefully (assuming [y]es) overwrite of an existing file: `reg export {{key_name}} {{path o ile.reg}} /y` diff --git a/tldr/windows/reg-flags b/tldr/windows/reg-flags index 3f520fb3..cb1049aa 100644 --- a/tldr/windows/reg-flags +++ b/tldr/windows/reg-flags @@ -16,6 +16,6 @@ source: https://github.com/tldr-pages/tldr.git `reg flags {{key_name}} set {{flag_name1 flag_name2 ...}}` -- Set one or more flags for a specific key and its [s]ub keys: +- Set one or more flags for a specific key and its [s]ubkeys: `reg flags {{key_name}} set {{flag_name1 flag_name2 ...}} /s` diff --git a/tldr/windows/reg-import b/tldr/windows/reg-import index 58d9b431..48fabd84 100644 --- a/tldr/windows/reg-import +++ b/tldr/windows/reg-import @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # reg import -> Import all available keys, subkeys, and values from a file. +> Import all available keys, subkeys, and values from a `.reg` file. > More information: . - Import all keys, subkeys and values from a file: diff --git a/tldr/windows/reg-load b/tldr/windows/reg-load index b97e9009..c72ec0b3 100644 --- a/tldr/windows/reg-load +++ b/tldr/windows/reg-load @@ -5,10 +5,10 @@ source: https://github.com/tldr-pages/tldr.git --- # reg load -> Load saved sub keys into a different sub key in the registry. -> This is intended for troubleshooting and temporary keys. +> Load saved subkeys into a different subkey in the registry. +> Note: this is intended for troubleshooting and temporary keys. > More information: . - Load a backup file into the specified key: -`reg load {{key_name}} {{path o ile}}` +`reg load {{key_name}} {{path o ile.hiv}}` diff --git a/tldr/windows/reg-query b/tldr/windows/reg-query index fd9e3403..932503fe 100644 --- a/tldr/windows/reg-query +++ b/tldr/windows/reg-query @@ -5,25 +5,37 @@ source: https://github.com/tldr-pages/tldr.git --- # reg query -> Display the values of keys and sub keys in the registry. +> Display the values of keys and subkeys in the registry. > More information: . - Display all values of a key: `reg query {{key_name}}` -- Display a specific value of a key: +- Display a specific [v]alue of a key: `reg query {{key_name}} /v {{value}}` -- Display all values of a key and its sub keys: +- Display all values of a key and its [s]ubkeys: `reg query {{key_name}} /s` -- Search for keys and values matching a specific pattern: +- Search [f]or keys and values matching a specific pattern: `reg query {{key_name}} /f "{{query_pattern}}"` -- Display a value of a key matching a specified data type: +- Display a value of a key matching a specified data [t]ype: -`reg query {{key_name}} /t {{type}}` +`reg query {{key_name}} /t REG_{{SZ|MULTI_SZ|EXPAND_SZ|DWORD|BINARY|NONE}}` + +- Only search in [d]ata: + +`reg query {{key_name}} /d` + +- Only search in [k]ey names: + +`reg query {{key_name}} /f /k` + +- [c]ase-sensitively search for an [e]xact match: + +`reg query {{key_name}} /c /e` diff --git a/tldr/windows/reg-restore b/tldr/windows/reg-restore index 133bd58a..34cb01f4 100644 --- a/tldr/windows/reg-restore +++ b/tldr/windows/reg-restore @@ -5,10 +5,10 @@ source: https://github.com/tldr-pages/tldr.git --- # reg restore -> Restore a key and its values from a backup file. +> Restore a key and its values from a native `.hiv` file. > See `reg-save` for more information. > More information: . - Overwrite a specified key with data from a backup file: -`reg restore {{key_name}} {{path o ile}}` +`reg restore {{key_name}} {{path o ile.hiv}}` diff --git a/tldr/windows/reg-save b/tldr/windows/reg-save index 2e8c0a28..654c7047 100644 --- a/tldr/windows/reg-save +++ b/tldr/windows/reg-save @@ -5,13 +5,13 @@ source: https://github.com/tldr-pages/tldr.git --- # reg save -> Save a registry key, its sub keys and values to a file. +> Save a registry key, its subkeys and values to a native `.hiv` file. > More information: . -- Save a registry key, its sub keys and values to a specific file: +- Save a registry key, its subkeys and values to a specific file: -`reg save {{key_name}} {{path o ile}}` +`reg save {{key_name}} {{path o ile.hiv}}` -- Forcefully overwrite an existing file without a prompt: +- Forcefully (assuming [y]es) overwrite an existing file: -`reg save {{key_name}} {{path o ile}} /y` +`reg save {{key_name}} {{path o ile.hiv}} /y` diff --git a/tldr/youtube-viewer b/tldr/youtube-viewer index 8fd6dd8e..2c60b33a 100644 --- a/tldr/youtube-viewer +++ b/tldr/youtube-viewer @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # youtube-viewer -> Command-line application for searching and playing videos from YouTube. +> Search and play videos from YouTube. > More information: . - Search for a video: