From 218768cb403abeee48212a2e577f2f0e9757acd9 Mon Sep 17 00:00:00 2001 From: Jacques Hogge <75214556+HOIg3r@users.noreply.github.com> Date: Wed, 29 Nov 2023 22:46:27 +0100 Subject: [PATCH 01/16] vboxmanage-*: add page (#11598) * VBoxManage-unregistervm : create & write markdown * VBoxManage-clonevm : create & write markdown * VBoxManage-createvm : create & write markdown * VBoxManage-export : create & write markdown * VBoxManage-import : create & write markdown * VBoxManage-registervm : create & write markdown * VBoxManage-registervm : add Title * VBoxManage-unregistervm : add Title * vboxmamange : correct typo * Update pages/common/vboxmanage-clonevm.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * vboxmamange-* : rewrite to infinitive tense + change name exemple * vboxmamange-* : change name exemple * vboxmamange-* : add colon + add empty line * Update pages/common/vboxmanage-import.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * Update pages/common/vboxmanage-import.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * Update pages/common/vboxmanage-import.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * Update pages/common/vboxmanage-import.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * Update pages/common/vboxmanage-import.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * vboxmanage-createvm : fix typo * vboxmanage-export/import/clonevm : fix typo * Update pages/common/vboxmanage-clonevm.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * vboxmanage-registervm/createVM/cloneVM : correct password option error + correct typo * VBoxManage-export : correct page * vboxmanage-createvm : correct typo ostype * vboxmanage-* : fix typo * Update vboxmanage-registervm.md --------- Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --- pages/common/vboxmanage-clonevm.md | 20 ++++++++++++++ pages/common/vboxmanage-createvm.md | 32 ++++++++++++++++++++++ pages/common/vboxmanage-export.md | 24 +++++++++++++++++ pages/common/vboxmanage-import.md | 36 +++++++++++++++++++++++++ pages/common/vboxmanage-registervm.md | 16 +++++++++++ pages/common/vboxmanage-unregistervm.md | 16 +++++++++++ 6 files changed, 144 insertions(+) create mode 100644 pages/common/vboxmanage-clonevm.md create mode 100644 pages/common/vboxmanage-createvm.md create mode 100644 pages/common/vboxmanage-export.md create mode 100644 pages/common/vboxmanage-import.md create mode 100644 pages/common/vboxmanage-registervm.md create mode 100644 pages/common/vboxmanage-unregistervm.md diff --git a/pages/common/vboxmanage-clonevm.md b/pages/common/vboxmanage-clonevm.md new file mode 100644 index 0000000000..7c1f609478 --- /dev/null +++ b/pages/common/vboxmanage-clonevm.md @@ -0,0 +1,20 @@ +# vboxmanage-clonevm + +> Creates a clone of an existing virtual machine (VM). +> More information: . + +- Clone the specified VM: + +`VBoxManage clonevm {{vm_name}}` + +- Specify a new name for the new VM: + +`VBoxManage clonevm {{vm_name}} --name {{new_vm_name}}` + +- Indicate the folder where the new VM configuration is saved: + +`VBoxManage clonevm {{vm_name}} --basefolder {{path/to/directory}}` + +- Store the cloned VM in VirtualBox: + +`VBoxManage clonevm {{vm_name}} --register` diff --git a/pages/common/vboxmanage-createvm.md b/pages/common/vboxmanage-createvm.md new file mode 100644 index 0000000000..d038ff6323 --- /dev/null +++ b/pages/common/vboxmanage-createvm.md @@ -0,0 +1,32 @@ +# vboxmanage-createvm + +> Create a new virtual machine. +> More information: . + +- Create a new VM with default settings: + +`VBoxManage createvm --name {{vm_name}}` + +- Set the base folder where the VM configuration will be stored: + +`VBoxManage createvm --name {{vm_name}} --basefolder {{path/to/directory}}` + +- Set the guest OS type (one of `VBoxManage list ostypes`) for the imported VM: + +`VBoxManage createvm --name {{vm_name}} --ostype {{ostype}}` + +- Register the created VM in VirtualBox: + +`VBoxManage createvm --name {{vm_name}} --register` + +- Set the VM to the specified groups: + +`VBoxManage createvm --name {{vm_name}} --group {{group1,group2,...}}` + +- Set the Universally Unique Identifier (UUID) of the VM: + +`VBoxManage createvm --name {{vm_name}} --uuid {{uuid}}` + +- Set the cipher to use for encryption: + +`VBoxManage createvm --name {{vm_name}} --cipher {{AES-128|AES-256}}` diff --git a/pages/common/vboxmanage-export.md b/pages/common/vboxmanage-export.md new file mode 100644 index 0000000000..a220a1d117 --- /dev/null +++ b/pages/common/vboxmanage-export.md @@ -0,0 +1,24 @@ +# vboxmanage-export + +> Export virtual machines to a virtual appliance (ISO) or a cloud service. +> More information: . + +- Specify the target OVF file: + +`VBoxManage export --output {{path/to/filename.ova}}` + +- Export in OVF 0.9 legacy mode: + +`VBoxManage export --legacy09` + +- Export in OVF (0.9|1.0|2.0) format: + +`VBoxManage export --{{ovf09|ovf10|ovf20}}` + +- Create manifest of the exported files: + +`VBoxManage export --manifest` + +- Specify description to the VM: + +`VBoxManage export --description "{{description-info}}"` diff --git a/pages/common/vboxmanage-import.md b/pages/common/vboxmanage-import.md new file mode 100644 index 0000000000..95baf9ce43 --- /dev/null +++ b/pages/common/vboxmanage-import.md @@ -0,0 +1,36 @@ +# vboxmanage-import + +> Imports a virtual machine (VM) previously exported or created. +> More information: . + +- Import a VM from an OVF or OVA file: + +`VBoxManage import {{path/to/file.ovf}}` + +- Set the name of the imported VM: + +`VBoxManage import {{path/to/file.ovf}} --name {{vm_name}}` + +- Indicate the folder where the configuration of the imported VM will be stored: + +`VBoxManage import {{path/to/file.ovf}} --basefolder {{path/to/directory}}` + +- Register the imported VM in VirtualBox: + +`VBoxManage import {{path/to/file.ovf}} --register` + +- Perform a dry run to check the import without actually importing: + +`VBoxManage import {{path/to/file.ovf}} --dry-run` + +- Set the guest OS type (one of `VBoxManage list ostypes`) for the imported VM: + +`VBoxManage import {{path/to/file.ovf}} --ostype={{ostype}}` + +- Set the memory (in megabytes) for the imported VM: + +`VBoxManage import {{path/to/file.ovf}} --memory={{1}}` + +- Set the number of CPUs for the imported VM: + +`VBoxManage import {{path/to/file.ovf}} --cpus={{1}}` diff --git a/pages/common/vboxmanage-registervm.md b/pages/common/vboxmanage-registervm.md new file mode 100644 index 0000000000..5ec2f3b093 --- /dev/null +++ b/pages/common/vboxmanage-registervm.md @@ -0,0 +1,16 @@ +# vboxmanage-registervm + +> Register a virtual machine (VM). +> More information: . + +- Register an existing VM: + +`VBoxManage registervm {{path/to/filename.vbox}}` + +- Supply the encryption password file of the VM: + +`VBoxManage registervm {{path/to/filename.vbox}} --password {{path/to/password_file}}` + +- Prompt for the encryption password on the command line: + +`VBoxManage registervm {{path/to/filename.vbox}} --password -` diff --git a/pages/common/vboxmanage-unregistervm.md b/pages/common/vboxmanage-unregistervm.md new file mode 100644 index 0000000000..d65287d796 --- /dev/null +++ b/pages/common/vboxmanage-unregistervm.md @@ -0,0 +1,16 @@ +# vboxmanage-unregistervm + +> Unregister a virtual machine (VM). +> More information: . + +- Unregister an existing VM: + +`VBoxManage unregistervm {{uuid|vm_name}}` + +- Delete hard disk image files, all saved state files, VM logs, XML VM machine files: + +`VBoxManage unregistervm {{uuid|vm_name}} --delete` + +- Delete all files from the VM: + +`VBoxManage unregistervm {{uuid|vm_name}} --delete-all` From e44fd29d4c215e650696f282331092925b12a4b2 Mon Sep 17 00:00:00 2001 From: Reinhart Previano Koentjoro Date: Thu, 30 Nov 2023 14:09:50 +0700 Subject: [PATCH 02/16] windows/*: add more PowerShell commands (#11612) * windows/*: add more PowerShell commands * get-commandL fix typo * Update install-module.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --------- Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --- pages/windows/get-command.md | 29 +++++++++++++++++++++++++ pages/windows/get-help.md | 24 ++++++++++----------- pages/windows/get-wuapiversion.md | 13 +++++++++++ pages/windows/get-wuhistory.md | 25 +++++++++++++++++++++ pages/windows/get-wusettings.md | 13 +++++++++++ pages/windows/install-module.md | 36 +++++++++++++++++++++++++++++++ pages/windows/pswindowsupdate.md | 13 +++++++++++ 7 files changed, 141 insertions(+), 12 deletions(-) create mode 100644 pages/windows/get-command.md create mode 100644 pages/windows/get-wuapiversion.md create mode 100644 pages/windows/get-wuhistory.md create mode 100644 pages/windows/get-wusettings.md create mode 100644 pages/windows/install-module.md create mode 100644 pages/windows/pswindowsupdate.md diff --git a/pages/windows/get-command.md b/pages/windows/get-command.md new file mode 100644 index 0000000000..0a45e0cadd --- /dev/null +++ b/pages/windows/get-command.md @@ -0,0 +1,29 @@ +# Get-Command + +> List and get available commands in the current PowerShell session. +> This command can only be run through PowerShell. +> More information: . + +- List all available PowerShell commands (aliases, cmdlets, functions) in the current computer: + +`Get-Command` + +- List all available PowerShell commands in the current session: + +`Get-Command -ListImported` + +- List only PowerShell aliases/cmdlets/functions available in the computer: + +`Get-Command -Type {{Alias|Cmdlet|Function}}` + +- List only programs or commands available on PATH in the current session: + +`Get-Command -Type Application` + +- List only PowerShell commands by the module name, e.g. `Microsoft.PowerShell.Utility` for utility-related commands: + +`Get-Command -Module {{module}}` + +- Get the command information (e.g. version number or module name) by its name: + +`Get-Command {{command}}` diff --git a/pages/windows/get-help.md b/pages/windows/get-help.md index 8ae34b4d9d..be31847b05 100644 --- a/pages/windows/get-help.md +++ b/pages/windows/get-help.md @@ -1,28 +1,28 @@ # Get-Help -> Display help information and documentation for PowerShell commands, aka. cmdlets. +> Display help information and documentation for PowerShell commands (aliases, cmdlets, and functions). > This command can only be run through PowerShell. > More information: . -- Display general help information for a specific cmdlet: +- Display general help information for a specific PowerShell command: -`Get-Help {{cmdlet}}` +`Get-Help {{command}}` -- Display a more detailed documentation for a specific cmdlet: +- Display a more detailed documentation for a specific PowerShell command: -`Get-Help {{cmdlet}} -Detailed` +`Get-Help {{command}} -Detailed` -- Display the full technical documentation for a specific cmdlet: +- Display the full technical documentation for a specific PowerShell command: -`Get-Help {{cmdlet}} -Full` +`Get-Help {{command}} -Full` -- Print only the documentation for a specific parameter of the cmdlet (use `*` to show all parameters), if available: +- Print only the documentation for a specific parameter of the PowerShell command (use `*` to show all parameters), if available: -`Get-Help {{cmdlet}} -Parameter {{parameter}}` +`Get-Help {{command}} -Parameter {{parameter}}` - Print only the examples of the cmdlet, if available: -`Get-Help {{cmdlet}} -Examples` +`Get-Help {{command}} -Examples` - List all available cmdlet help pages: @@ -32,6 +32,6 @@ `Update-Help` -- View an online version of cmdlet documentation in the default web browser: +- View an online version of PowerShell command documentation in the default web browser: -`Get-Help {{cmdlet}} -Online` +`Get-Help {{command}} -Online` diff --git a/pages/windows/get-wuapiversion.md b/pages/windows/get-wuapiversion.md new file mode 100644 index 0000000000..c03817e3b1 --- /dev/null +++ b/pages/windows/get-wuapiversion.md @@ -0,0 +1,13 @@ +# Get-WUApiVersion + +> Get the Windows Update Agent version. Part of external `PSWindowsUpdate` module. +> This command can only be run under PowerShell. +> More information: . + +- Get the currently-installed Windows Update Agent version: + +`Get-WUApiVersion` + +- Send the current configuration data via email (SMTP): + +`Get-WUApiVersion -SendReport -PSWUSettings @{SmtpServer="{{smtp_server}}"; Port={{smtp_port}} From="{{sender_email}}" To="{{receiver_email}}"}` diff --git a/pages/windows/get-wuhistory.md b/pages/windows/get-wuhistory.md new file mode 100644 index 0000000000..22ee5d49cb --- /dev/null +++ b/pages/windows/get-wuhistory.md @@ -0,0 +1,25 @@ +# Get-WUHistory + +> Get the history of installed updates from Windows Update. Part of external `PSWindowsUpdate` module. +> This command can only be run under PowerShell. +> More information: . + +- Get list of update history: + +`Get-WUHistory` + +- List the last 10 installed updates: + +`Get-WUHistory -Last {{10}}` + +- List all updates installed from a specific date to today: + +`Get-WUHistory -MaxDate {{date}}` + +- List all updates installed in the past 24 hours: + +`Get-WUHistory -MaxDate (Get-Date).AddDays(-1)` + +- Send the results via email (SMTP): + +`Get-WUHistory -SendReport -PSWUSettings @{SmtpServer="{{smtp_server}}"; Port={{smtp_port}} From="{{sender_email}}" To="{{receiver_email}}"}` diff --git a/pages/windows/get-wusettings.md b/pages/windows/get-wusettings.md new file mode 100644 index 0000000000..2c1c9c05aa --- /dev/null +++ b/pages/windows/get-wusettings.md @@ -0,0 +1,13 @@ +# Get-WUSettings + +> Get the current Windows Update Agent configuration. Part of external `PSWindowsUpdate` module. +> This command can only be run under PowerShell. +> More information: . + +- Get the current Windows Update Agent configuration: + +`Get-WUSettings` + +- Send the current configuration data via email (SMTP): + +`Get-WUSettings -SendReport -PSWUSettings @{SmtpServer="{{smtp_server}}"; Port={{smtp_port}} From="{{sender_email}}" To="{{receiver_email}}"}` diff --git a/pages/windows/install-module.md b/pages/windows/install-module.md new file mode 100644 index 0000000000..37a2e04068 --- /dev/null +++ b/pages/windows/install-module.md @@ -0,0 +1,36 @@ +# Install-Module + +> Install PowerShell modules from PowerShell Gallery, NuGet, and other repositories. +> More information: . + +- Install a module, or update it to the latest available version: + +`Install-Module {{module}}` + +- Install a module with a specific version: + +`Install-Module {{module}} -RequiredVersion {{version}}` + +- Install a module no earlier than a specific version: + +`Install-Module {{module}} -MinimumVersion {{version}}` + +- Specify a range of supported versions (inclusive) of the required module: + +`Install-Module {{module}} -MinimumVersion {{minimum_version}} -MaximumVersion {{maximum_version}}` + +- Install module from a specific repository: + +`Install-Module {{module}} -Repository {{repository}}` + +- Install module from specific repositories: + +`Install-Module {{module}} -Repository {{repository1 , repository2 , ...}}` + +- Install the module for all/current user: + +`Install-Module {{module}} -Scope {{AllUsers|CurrentUser}}` + +- Perform a dry run to determine which modules will be installed, upgraded, or removed through `Install-Module`: + +`Install-Module {{module}} -WhatIf` diff --git a/pages/windows/pswindowsupdate.md b/pages/windows/pswindowsupdate.md new file mode 100644 index 0000000000..da0dd27cb1 --- /dev/null +++ b/pages/windows/pswindowsupdate.md @@ -0,0 +1,13 @@ +# PSWindowsUpdate + +> A PowerShell external module to manage Windows Update. +> This tool provides multiple commands that all can only be run through PowerShell. +> More information: . + +- Install the module using `Install-Module`: + +`Install-Module PSWindowsUpdate` + +- List all commands available under the module: + +`Get-Command -Module PSWindowsUpdate` From 846fc674e69d465356f3f560f2da1c695f8129f6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dar=C3=ADo=20Here=C3=B1=C3=BA?= Date: Thu, 30 Nov 2023 05:19:39 -0300 Subject: [PATCH 03/16] assimp: update Spanish translation (#11611) Update assimp: verb mode --- pages.es/common/assimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.es/common/assimp.md b/pages.es/common/assimp.md index 63c179bcdc..ff209dae04 100644 --- a/pages.es/common/assimp.md +++ b/pages.es/common/assimp.md @@ -16,7 +16,7 @@ `assimp export {{archivo_entrada.stl}} {{archivo_salida.obj}}` -- Convertir un archivo utilizando parámetros personalizados (el archivo dox_cmd.h en el código fuente de assimp enumera los parámetros disponibles): +- Convierte un archivo utilizando parámetros personalizados (el archivo dox_cmd.h en el código fuente de assimp enumera los parámetros disponibles): `assimp export {{archivo_entrada.stl}} {{archivo_salida.obj}} {{parametros}}` From 36b754454068483eb7cfbecda4bc6ef96f5c1554 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dar=C3=ADo=20Here=C3=B1=C3=BA?= Date: Thu, 30 Nov 2023 05:20:07 -0300 Subject: [PATCH 04/16] dotnet-publish: fix typo (#11610) Update dotnet-publish: fix typo --- pages.es/common/dotnet-publish.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.es/common/dotnet-publish.md b/pages.es/common/dotnet-publish.md index b63e88fff0..952733e9a2 100644 --- a/pages.es/common/dotnet-publish.md +++ b/pages.es/common/dotnet-publish.md @@ -11,7 +11,7 @@ `dotnet publish --self-contained true --runtime {{identificador_del_entorno_en_tiempo_de_ejecución}} {{ruta/al/archivo_del_proyecto}}` -- Empaqueta la aplicación en un archivo ejecutable unico de una plataforma específica: +- Empaqueta la aplicación en un archivo ejecutable único de una plataforma específica: `dotnet publish --runtime {{identificador_del_entorno_en_tiempo_de_ejecucución}} -p:PublishSingleFile=true {{ruta/al/archivo_del_proyecto}}` From 908c9366c0e0b608003f9425e470d1684b23c44c Mon Sep 17 00:00:00 2001 From: Lena <126529524+acuteenvy@users.noreply.github.com> Date: Thu, 30 Nov 2023 09:27:59 +0100 Subject: [PATCH 05/16] vboxmanage-*, exiqgrep: update page (#11604) * exiqgrep: update page * vboxmanage-*: update page --- pages/common/vboxmanage-clonevm.md | 4 ++-- pages/common/vboxmanage-export.md | 6 +++--- pages/common/vboxmanage-import.md | 2 +- pages/common/vboxmanage-unregistervm.md | 2 +- pages/linux/exiqgrep.md | 4 ++-- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/pages/common/vboxmanage-clonevm.md b/pages/common/vboxmanage-clonevm.md index 7c1f609478..c797085142 100644 --- a/pages/common/vboxmanage-clonevm.md +++ b/pages/common/vboxmanage-clonevm.md @@ -1,6 +1,6 @@ # vboxmanage-clonevm -> Creates a clone of an existing virtual machine (VM). +> Create a clone of an existing virtual machine (VM). > More information: . - Clone the specified VM: @@ -15,6 +15,6 @@ `VBoxManage clonevm {{vm_name}} --basefolder {{path/to/directory}}` -- Store the cloned VM in VirtualBox: +- Register the cloned VM in VirtualBox: `VBoxManage clonevm {{vm_name}} --register` diff --git a/pages/common/vboxmanage-export.md b/pages/common/vboxmanage-export.md index a220a1d117..880b95a60a 100644 --- a/pages/common/vboxmanage-export.md +++ b/pages/common/vboxmanage-export.md @@ -3,7 +3,7 @@ > Export virtual machines to a virtual appliance (ISO) or a cloud service. > More information: . -- Specify the target OVF file: +- Specify the target OVA file: `VBoxManage export --output {{path/to/filename.ova}}` @@ -19,6 +19,6 @@ `VBoxManage export --manifest` -- Specify description to the VM: +- Specify a description of the VM: -`VBoxManage export --description "{{description-info}}"` +`VBoxManage export --description "{{vm_description}}"` diff --git a/pages/common/vboxmanage-import.md b/pages/common/vboxmanage-import.md index 95baf9ce43..091b9cdf09 100644 --- a/pages/common/vboxmanage-import.md +++ b/pages/common/vboxmanage-import.md @@ -1,6 +1,6 @@ # vboxmanage-import -> Imports a virtual machine (VM) previously exported or created. +> Import a previously exported virtual machine (VM). > More information: . - Import a VM from an OVF or OVA file: diff --git a/pages/common/vboxmanage-unregistervm.md b/pages/common/vboxmanage-unregistervm.md index d65287d796..a4cf29a8d8 100644 --- a/pages/common/vboxmanage-unregistervm.md +++ b/pages/common/vboxmanage-unregistervm.md @@ -7,7 +7,7 @@ `VBoxManage unregistervm {{uuid|vm_name}}` -- Delete hard disk image files, all saved state files, VM logs, XML VM machine files: +- Delete hard disk image files, all saved state files, VM logs, and XML VM machine files: `VBoxManage unregistervm {{uuid|vm_name}} --delete` diff --git a/pages/linux/exiqgrep.md b/pages/linux/exiqgrep.md index f44f776041..27b470a905 100644 --- a/pages/linux/exiqgrep.md +++ b/pages/linux/exiqgrep.md @@ -1,13 +1,13 @@ # exiqgrep -> The `exiqgrep` utility is a Perl script offering possibilities to `grep` in the Exim queue output. +> Perl script offering possibilities to `grep` in the Exim queue output. > More information: . - Match the sender address using a case-insensitive search: `exiqgrep -f '<{{email@somedomain.com}}>'` -- Match the sender address, and display message IDs only: +- Match the sender address and display message IDs only: `exiqgrep -i -f '<{{email@somedomain.com}}>'` From 385598fc66309af43adba8f390d4e4002d42b24a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dar=C3=ADo=20Here=C3=B1=C3=BA?= Date: Thu, 30 Nov 2023 08:52:12 -0300 Subject: [PATCH 06/16] dotnet-restore: fix typos in Spanish translation (#11609) --- pages.es/common/dotnet-restore.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages.es/common/dotnet-restore.md b/pages.es/common/dotnet-restore.md index 10573a42cb..0890b494e3 100644 --- a/pages.es/common/dotnet-restore.md +++ b/pages.es/common/dotnet-restore.md @@ -1,6 +1,6 @@ # dotnet restore -> Restarua las dependencias y herramientas de un proyecto .NET. +> Restaura las dependencias y herramientas de un proyecto .NET. > Más información: . - Restaura dependencias para un proyecto o solución .NET en el directorio actual: @@ -11,7 +11,7 @@ `dotnet restore {{ruta/al/proyecto_o_solución}}` -- Restaura depedencias sin almacenar las solicitudes HTTP en caché: +- Restaura dependencias sin almacenar las solicitudes HTTP en caché: `dotnet restore --no-cache` From f09e6ff87fa0f52bcd090c41f8e50b758e2eb9c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dar=C3=ADo=20Here=C3=B1=C3=BA?= Date: Thu, 30 Nov 2023 09:56:39 -0300 Subject: [PATCH 07/16] chatgpt: add Spanish translation (#11600) --- pages.es/linux/chatgpt.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 pages.es/linux/chatgpt.md diff --git a/pages.es/linux/chatgpt.md b/pages.es/linux/chatgpt.md new file mode 100644 index 0000000000..50bba07da8 --- /dev/null +++ b/pages.es/linux/chatgpt.md @@ -0,0 +1,28 @@ +# chatgpt + +> Shell script para usar ChatGPT de OpenAI y DALL-E desde la terminal. +> Más información: . + +- Comienza en modo chat: + +`chatgpt` + +- Dar un [p]rompt para responder: + +`chatgpt --prompt "{{¿Cuál es la expresión regular para emparejar una dirección de correo electrónico?}}"` + +- Inicia en modo chat utilizando un [m]odelo específico (por defecto es `gpt-3.5-turbo`): + +`chatgpt --model {{gpt-4}}` + +- Inicia en modo chat con un prompt [i]nicial: + +`chatgpt --init-prompt "{{Tú eres Rick, de Rick y Morty. Responde a las preguntas usando su amaneramiento e incluye chistes insultantes.}}"` + +- Envía el resultado de un comando a ChatGPT como un prompt: + +`echo "{{¿Cómo ver los procesos en ejecución en Ubuntu?}}" | chatgpt` + +- Genera una imagen utilizando DALL-E: + +`chatgpt --prompt "{{image: Un gato blanco}}"` From 0552f8f11a8c27ae2c6b4c935959192035e5d472 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dar=C3=ADo=20Here=C3=B1=C3=BA?= Date: Thu, 30 Nov 2023 12:03:27 -0300 Subject: [PATCH 08/16] 7z: update Spanish translation (#11606) --- pages.es/common/7z.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages.es/common/7z.md b/pages.es/common/7z.md index ae0258ef3c..047ae86b2b 100644 --- a/pages.es/common/7z.md +++ b/pages.es/common/7z.md @@ -7,15 +7,15 @@ `7z a {{archivo_comprimido.7z}} {{ruta/al/archivo_o_directorio_a_comprimir}}` -- Encriptar un archivo comprimido existente (incluyendo cabeceras): +- Encripta un archivo comprimido existente (incluyendo cabeceras): `7z a {{archivo_encriptado.7z}} -p{{contraseña}} -mhe=on {{archivo_comprimido.7z}}` -- Extraer un archivo comprimido en formato `.7z` con la estructura original que tenía antes de comprimir: +- Extrae un archivo comprimido en formato `.7z` con la estructura original que tenía antes de comprimir: `7z x {{archivo_comprimido.7z}}` -- Extraer un archivo comprimido en una ruta definida por el usuario: +- Extrae un archivo comprimido en una ruta definida por el usuario: `7z x {{archivo_comprimido.7z}} -o {{ruta/donde/extraer}}` From 6fa40aef1f00295455f5f40c568ad7e7465ecfdc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dar=C3=ADo=20Here=C3=B1=C3=BA?= Date: Thu, 30 Nov 2023 12:05:23 -0300 Subject: [PATCH 09/16] 7zr: fix typo in Spanish translation (#11608) --- pages.es/common/7zr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.es/common/7zr.md b/pages.es/common/7zr.md index c156d11336..301d57438f 100644 --- a/pages.es/common/7zr.md +++ b/pages.es/common/7zr.md @@ -18,7 +18,7 @@ - E[x]trae un archivo a un directorio específico: -`7zr x {{ruta/al/larchivo.7z}} -o{ruta/de/salida}}` +`7zr x {{ruta/al/archivo.7z}} -o{ruta/de/salida}}` - E[x]trae un archivo a `stdout`: From 9db3b97da5f79ad7b7e3ada3705e71406e923f77 Mon Sep 17 00:00:00 2001 From: Sharun <715417+sharunkumar@users.noreply.github.com> Date: Thu, 30 Nov 2023 10:07:02 -0500 Subject: [PATCH 10/16] pulumi-up: add page; pulumi: add subcommand mention (#11605) Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --- pages/common/pulumi-up.md | 16 ++++++++++++++++ pages/common/pulumi.md | 1 + 2 files changed, 17 insertions(+) create mode 100644 pages/common/pulumi-up.md diff --git a/pages/common/pulumi-up.md b/pages/common/pulumi-up.md new file mode 100644 index 0000000000..3160990c22 --- /dev/null +++ b/pages/common/pulumi-up.md @@ -0,0 +1,16 @@ +# pulumi up + +> Create or update the resources in a stack. +> More information: . + +- Preview and deploy changes to a program and/or infrastructure: + +`pulumi up` + +- Automatically approve and perform the update after previewing it: + +`pulumi up --yes` + +- Preview and deploy changes in a specific stack: + +`pulumi up --stack {{stack}}` diff --git a/pages/common/pulumi.md b/pages/common/pulumi.md index 260c50326a..005f53d81b 100644 --- a/pages/common/pulumi.md +++ b/pages/common/pulumi.md @@ -1,6 +1,7 @@ # pulumi > Define infrastructure on any cloud using familiar programming languages. +> Some subcommands such as `pulumi up` have their own usage documentation. > More information: . - Create a new project using a template: From 35376ee8a3d5cd0910b881416b8b3c7376ecf233 Mon Sep 17 00:00:00 2001 From: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> Date: Thu, 30 Nov 2023 17:14:49 +0100 Subject: [PATCH 11/16] pages.nl/*: update page (#11614) --- pages.nl/common/7z.md | 6 +++++- pages.nl/common/7za.md | 6 +++++- pages.nl/common/7zr.md | 6 +++++- pages.nl/linux/distrobox-export.md | 3 +-- 4 files changed, 16 insertions(+), 5 deletions(-) diff --git a/pages.nl/common/7z.md b/pages.nl/common/7z.md index 1e35101030..49ec8bbe2b 100644 --- a/pages.nl/common/7z.md +++ b/pages.nl/common/7z.md @@ -29,4 +29,8 @@ - Geef een [l]ijst met de inhoud van het archiefbestand: -`7z l {{archief.7z}}` +`7z l {{pad/naar/archief.7z}}` + +- Zet het niveau van compressie (hoger betekent meer compressie, maar langzamer): + +`7z a {{pad/naar/archief.7z}} -mx={{0|1|3|5|7|9}} {{pad/naar/bestand_of_map}}` diff --git a/pages.nl/common/7za.md b/pages.nl/common/7za.md index 1ef54387b2..b0466a9f57 100644 --- a/pages.nl/common/7za.md +++ b/pages.nl/common/7za.md @@ -28,6 +28,10 @@ `7za a -t{{7z|bzip2|gzip|lzip|tar|...}} {{pad/naar/archief.7z}} {{pad/naar/bestand_of_map}}` -- Lijst de inhoud van een archief op: +- Geef een [l]ijst met de inhoud van het archiefbestand: `7za l {{pad/naar/archief.7z}}` + +- Zet het niveau van compressie (hoger betekent meer compressie, maar langzamer): + +`7za a {{pad/naar/archief.7z}} -mx={{0|1|3|5|7|9}} {{pad/naar/bestand_of_map}}` diff --git a/pages.nl/common/7zr.md b/pages.nl/common/7zr.md index 511589c4e6..d2f6e715b2 100644 --- a/pages.nl/common/7zr.md +++ b/pages.nl/common/7zr.md @@ -24,6 +24,10 @@ `7zr x {{pad/naar/archief.7z}} -so` -- Lijst de inhoud van een archief op: +- Geef een [l]ijst met de inhoud van het archiefbestand: `7zr l {{pad/naar/archief.7z}}` + +- Zet het niveau van compressie (hoger betekent meer compressie, maar langzamer): + +`7zr a {{pad/naar/archief.7z}} -mx={{0|1|3|5|7|9}} {{pad/naar/bestand_of_map}}` diff --git a/pages.nl/linux/distrobox-export.md b/pages.nl/linux/distrobox-export.md index 2a08f7596a..471c2f7398 100644 --- a/pages.nl/linux/distrobox-export.md +++ b/pages.nl/linux/distrobox-export.md @@ -1,7 +1,6 @@ # distrobox-export -> Exporteer app/service/binary van container naar host-besturingssysteem. -> Subcommando van `distrobox`. Bekijk ook: `tldr distrobox`. +> Exporteer app/service/binary van container naar host-besturingssysteem. Bekijk ook: `tldr distrobox`. > Meer informatie: . - Exporteer een app van de container naar de host (het desktop pictogram verschijnt in de applicatielijst van uw hostsysteem): From 549107eee278450dc4dc7f29d7cf5f794cec77f6 Mon Sep 17 00:00:00 2001 From: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> Date: Thu, 30 Nov 2023 17:19:58 +0100 Subject: [PATCH 12/16] todo: add Dutch translation (#11617) Co-authored-by: Leon --- pages.nl/common/todo.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 pages.nl/common/todo.md diff --git a/pages.nl/common/todo.md b/pages.nl/common/todo.md new file mode 100644 index 0000000000..926ca9571f --- /dev/null +++ b/pages.nl/common/todo.md @@ -0,0 +1,32 @@ +# todo + +> Een eenvoudige, op standaarden gebaseerde, opdrachtregel todo manager. +> Meer informatie: . + +- Toon startbare taken: + +`todo list --startable` + +- Voeg een nieuwe taak toe aan de werklijst: + +`todo new {{ding_om_te_doen}} --list {{werk}}` + +- Voeg een locatie toe aan een taak met een gegeven ID: + +`todo edit --location {{locatie_naam}} {{taak_id}}` + +- Toon details over een taak: + +`todo show {{taak_id}}` + +- Markeer taken met de opgegeven IDs als voltooid: + +`todo done {{taak_id1 taak_id2 ...}}` + +- Verwijder een taak: + +`todo delete {{taak_id}}` + +- Verwijder voltooide taken en reset de IDs van de overgebleven taken: + +`todo flush` From 1e1cc4df3b3003a1e5d8421a61bfef93852a29b3 Mon Sep 17 00:00:00 2001 From: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> Date: Thu, 30 Nov 2023 17:20:25 +0100 Subject: [PATCH 13/16] ClamAV: add Dutch translation (#11615) Co-authored-by: Leon --- pages.nl/common/clamdscan.md | 36 ++++++++++++++++++++++++++++++++++++ pages.nl/common/clamscan.md | 36 ++++++++++++++++++++++++++++++++++++ pages.nl/common/freshclam.md | 8 ++++++++ 3 files changed, 80 insertions(+) create mode 100644 pages.nl/common/clamdscan.md create mode 100644 pages.nl/common/clamscan.md create mode 100644 pages.nl/common/freshclam.md diff --git a/pages.nl/common/clamdscan.md b/pages.nl/common/clamdscan.md new file mode 100644 index 0000000000..a45b44597f --- /dev/null +++ b/pages.nl/common/clamdscan.md @@ -0,0 +1,36 @@ +# clamdscan + +> Een command-line virus scanner die gebruik maakt van de ClamAV Daemon. +> Meer informatie: . + +- Scan een bestand of map op kwetsbaarheden: + +`clamdscan {{pad/naar/bestand_of_map}}` + +- Scan data van `stdin`: + +`{{commando}} | clamdscan -` + +- Scan de huidige map en toon alleen geïnfecteerde bestanden: + +`clamdscan --infected` + +- Sla het scan rapport op in een log bestand: + +`clamdscan --log {{pad/naar/log_bestand}}` + +- Verplaats geïnfecteerde bestanden naar een specifieke map: + +`clamdscan --move {{pad/naar/quarantaine_map}}` + +- Verwijder geïnfecteerde bestanden: + +`clamdscan --remove` + +- Gebruik meerdere threads voor het scannen van een map: + +`clamdscan --multiscan` + +- Geef de bestandsdescriptor door in plaats van het bestand naar de daemon: + +`clamdscan --fdpass` diff --git a/pages.nl/common/clamscan.md b/pages.nl/common/clamscan.md new file mode 100644 index 0000000000..cfe1a9a2c7 --- /dev/null +++ b/pages.nl/common/clamscan.md @@ -0,0 +1,36 @@ +# clamscan + +> Een command-line virus scanner. +> Meer informatie: . + +- Scan een bestand op kwetsbaarheden: + +`clamscan {{pad/naar/bestand}}` + +- Scan alle bestanden recursief in een specifieke map: + +`clamscan -r {{pad/naar/map}}` + +- Scan data van `stdin`: + +`{{commando}} | clamscan -` + +- Specificeer een virus database bestand of map van bestanden: + +`clamscan --database {{pad/naar/database_bestand_of_map}}` + +- Scan de huidige map en toon alleen geïnfecteerde bestanden: + +`clamscan --infected` + +- Sla het scan rapport op in een log bestand: + +`clamscan --log {{pad/naar/log_bestand}}` + +- Verplaats geïnfecteerde bestanden naar een specifieke map: + +`clamscan --move {{pad/naar/quarantine_map}}` + +- Verwijder geïnfecteerde bestanden: + +`clamscan --remove yes` diff --git a/pages.nl/common/freshclam.md b/pages.nl/common/freshclam.md new file mode 100644 index 0000000000..cc9fbfb1da --- /dev/null +++ b/pages.nl/common/freshclam.md @@ -0,0 +1,8 @@ +# freshclam + +> Update virus definities voor ClamAV antivirus programma. +> Meer informatie: . + +- Update virus definities: + +`freshclam` From 862f4c9fa06491eac86324c0ccef1258927270ae Mon Sep 17 00:00:00 2001 From: "K.B.Dharun Krishna" Date: Thu, 30 Nov 2023 23:31:27 +0530 Subject: [PATCH 14/16] CLIENT-SPECIFICATION: add automatic platform detection suggestion, fix Markdown syntax (#11523) * CLIENT-SPECIFICATION: add platform suggestion Signed-off-by: K.B.Dharun Krishna * CLIENT-SPECIFICATION: minor fixes Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com> * CLIENT-SPECIFICATION: fix typo * CLIENT-SPECIFICATION: minor fixes Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com> * CLIENT-SPECIFICATION: remove usage suggestion * CLIENT-SPECIFICATION: update page Co-authored-by: Starbeamrainbowlabs * CLIENT-SPECIFICATION: minor fixes Co-authored-by: Starbeamrainbowlabs * Update CLIENT-SPECIFICATION.md Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * CLIENT-SPECIFICATION: update changelog Signed-off-by: K.B.Dharun Krishna * CLIENT-SPECIFICATION: fix description in changelog Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com> --------- Signed-off-by: K.B.Dharun Krishna Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com> Co-authored-by: Starbeamrainbowlabs Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --- CLIENT-SPECIFICATION.md | 111 +++++++++++++++++++++------------------- 1 file changed, 57 insertions(+), 54 deletions(-) diff --git a/CLIENT-SPECIFICATION.md b/CLIENT-SPECIFICATION.md index d50b638eca..eba17aa62b 100644 --- a/CLIENT-SPECIFICATION.md +++ b/CLIENT-SPECIFICATION.md @@ -1,12 +1,11 @@ # tldr-pages client specification -**Current Specification Version:** 2.0 +**Current Specification Version:** 2.1 -This document contains the official specification for tldr-pages clients. It is _not_ a specification of the format of the pages themselves - only a specification of how a user should be able to interface with an official client. For a list of previous versions of the specification, see the [changelog section](#Changelog) below. +This document contains the official specification for tldr-pages clients. It is _not_ a specification of the format of the pages themselves - only a specification of how a user should be able to interface with an official client. For a list of previous versions of the specification, see the [changelog section](#changelog) below. The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC 2119](https://tools.ietf.org/html/rfc2119). - ## Terminology This section defines key terms that are relevant for understanding this specification document. @@ -24,7 +23,6 @@ If a page is common across multiple platforms, but slightly different on a given For example, if the command `foo` is common to `mac`, `windows`, and `linux` but functions differently on `windows`, then the main page will be stored in `common`, and a copy will be placed in `windows` that's altered to match the different functionality. - ## Command-line interface This section describes the standardised command-line interface (CLI) for clients implementing one. Clients that do not provide a CLI can ignore this section. @@ -78,12 +76,12 @@ This section documents the directory structure that contains the pages themselve The main version of every page is stored inside (but not directly) the `pages` directory. Inside this directory, there is a folder for each platform - for example `windows`, `linux`, and the special `common` platform: - - `pages/` - - `common/` - - `linux/` - - `windows/` - - `osx/` - - ...etc. +- `pages/` + - `common/` + - `linux/` + - `windows/` + - `osx/` + - ...etc. It is RECOMMENDED that clients support `macos` as an alias for `osx`. @@ -97,23 +95,21 @@ Command name | Mapped name | Filename `git checkout` | `git-checkout` | `git-checkout.md` `tar` | `tar` | `tar.md` - ### Translations Other directories sit alongside the main `pages` directory, and contain translations of the main versions of every page - though pages MAY NOT have a translation available for a given language yet. Furthermore, a given language MAY NOT have a folder yet either. The format of these directories is `pages.`, where `` is a [POSIX Locale Name](https://www.gnu.org/software/gettext/manual/html_node/Locale-Names.html#Locale-Names) in the form of `_`, where: - - `` is the shortest [ISO 639](https://en.wikipedia.org/wiki/ISO_639) language code for the chosen language (see [here](https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes) for a complete list). - - `` is the two-letter [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) country code for the chosen region (see [here](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) for a complete list). +- `` is the shortest [ISO 639](https://en.wikipedia.org/wiki/ISO_639) language code for the chosen language (see [here](https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes) for a complete list). +- `` is the two-letter [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) country code for the chosen region (see [here](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) for a complete list). Some examples: - - Chinese (Taiwan): `pages.zh_TW`. - - Portuguese (Brazil): `pages.pt_BR`. - - Italian: `pages.it`. +- Chinese (Taiwan): `pages.zh_TW`. +- Portuguese (Brazil): `pages.pt_BR`. +- Italian: `pages.it`. The structure inside these translation folders is identical to that of the main `pages` folder. - ## Page structure Although this specification is about the interface that clients must provide, it is also worth noting that pages are written in standard [CommonMark](https://commonmark.org/), with the exception of the non-standard `{{` and `}}` placeholder syntax, which surrounds values in an example that users may edit. Clients MAY highlight the placeholders and MUST remove the surrounding curly braces. Clients MUST NOT treat them as the placeholder syntax if they are escaped using `\` (i.e. `\{\{` and `\}\}`) and MUST instead display literal braces, without backslashes. Placeholder escaping applies only when both braces are escaped (e.g. in `\{` or `\{{`, backslashes MUST be displayed). Clients MUST NOT break if the page format is changed within the _CommonMark_ specification. @@ -122,8 +118,7 @@ Although this specification is about the interface that clients must provide, it - `ping {{example.com}}` MUST be rendered as "ping example.com" - `docker inspect --format '\{\{range.NetworkSettings.Networks\}\}\{\{.IPAddress\}\}\{\{end\}\}' {{container}}` MUST be rendered as "docker inspect --format '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' container" -- `mount \\{{computer_name}}\{{share_name}} Z:` MUST be rendered as "mount \\computer_name\share_name Z:" - +- `mount \\{{computer_name}}\{{share_name}} Z:` MUST be rendered as "mount \\\\computer_name\share_name Z:" ## Page resolution @@ -131,12 +126,13 @@ This section defines the algorithm by which a client can decide which page a use After transparently replacing spaces (` `) with dashes (`-`) and lowercasing the name, clients have several decisions to make: - - The language of a page to display to a client - - The platform to display a page from +- The language of a page to display to a client +- The platform to display a page from ### Platform Clients MUST default to displaying the page associated with the platform on which the client is running. + For example, a client running on _Windows 11_ will default to displaying pages from the `windows` platform. Clients MAY provide a user-configurable option to override this behaviour, however. @@ -155,6 +151,8 @@ Steps #3 and #4 may be done in either order. It is possible that due to this page resolution logic, the client may show a page which does not belong to the host platform because a page can reside in `common`, and not be present on the host platform. Clients must not assume that a given command is always executable on the host platform. +It is RECOMMENDED that clients detect new platforms added to the relevant `pages` directory automatically. + #### If a page is not found If a page cannot be found in _any_ platform, then it is RECOMMENDED that clients display an error message with a link to create a new issue against the `tldr-pages/tldr` GitHub repository. Said link might take the following form: @@ -169,7 +167,6 @@ where `{command_name}` is the name of the command that was not found. Clients th If multiple versions of a page were found for different platforms, then a client MAY choose to display a notice to the user notifying them of this. - ## Language Pages can be written in multiple languages. If a client has access to environment variables, it MUST use them to derive the preferred user language as described in the next paragraphs. If not, then clients MUST make reasonable assumptions based on the information provided by the environment in which they operate (e.g. consulting `navigator.languages` in a browser, etc.). @@ -205,12 +202,14 @@ The [`LC_MESSAGES` environment variable](https://www.gnu.org/software/gettext/ma Here's an example of how the lookup should be done on `linux` having set `LANG=it` and `LANGUAGE="it:fr:en"`: - 1. pages.it/linux/some-page.md -> does not exist - 2. pages.fr/linux/some-page.md -> does not exist - 3. pages/linux/some-page.md -> does not exist - 4. pages.it/common/some-page.md -> does not exist - 5. pages.fr/common/some-page.md -> does not exist - 6. pages/common/some-page.md -> FOUND! +Step | Path checked | Outcome +------|--------------------------------|----------------------- +1 | pages.it/linux/some-page.md | does not exist +2 | pages.fr/linux/some-page.md | does not exist +3 | pages/linux/some-page.md | does not exist +4 | pages.it/common/some-page.md | does not exist +5 | pages.fr/common/some-page.md | does not exist +6 | pages/common/some-page.md | FOUND! ## Caching @@ -218,7 +217,6 @@ If appropriate, it is RECOMMENDED that clients implement a cache of pages. If im Caching SHOULD be done according to the user's language configuration (if any), to not waste unneeded space for unused languages. Additionally, clients MAY automatically update the cache regularly. - ## Changelog - - Unreleased - - [v2.0, September 10th 2023](https://github.com/tldr-pages/tldr/blob/v2.0/CLIENT-SPECIFICATION.md) ([#10148](https://github.com/tldr-pages/tldr/pull/10148)) - - Add recommendation to support `macos` alias for `osx` ([#7514](https://github.com/tldr-pages/tldr/pull/7514)) - - Drop the special "all" platform from the `--list` flag ([#7561](https://github.com/tldr-pages/tldr/pull/7561)) - - Drop the `master` branch from the assets link. ([#9668](https://github.com/tldr-pages/tldr/pull/9668)) - - Require support for long options ([#9651](https://github.com/tldr-pages/tldr/pull/9651)) - - Add recommendation to support caching individual translation archives ([#10148](https://github.com/tldr-pages/tldr/pull/10148)) +- Unreleased - - [v1.5, March 17th 2021](https://github.com/tldr-pages/tldr/blob/v1.5/CLIENT-SPECIFICATION.md) ([#5428](https://github.com/tldr-pages/tldr/pull/5428)) - - Add requirement for converting command names to lowercase before running the page resolution algorithm. - - Use HTTPS for archive links. +- [v2.1, November 30th 2023](https://github.com/tldr-pages/tldr/blob/v2.1/CLIENT-SPECIFICATION.md) ([#11523](https://github.com/tldr-pages/tldr/pull/11523)) + - Add requirement to support escaping the placeholder syntax in certain pages ([#10730](https://github.com/tldr-pages/tldr/pull/10730)) + - Add suggestion to detect new platforms added to the relevant `pages` directory automatically ([#11523](https://github.com/tldr-pages/tldr/pull/11523)) - - [v1.4, August 13th 2020](https://github.com/tldr-pages/tldr/blob/v1.4/CLIENT-SPECIFICATION.md) ([#4246](https://github.com/tldr-pages/tldr/pull/4246)) - - Add requirement for CLI clients to use non-zero exit code on failing to find a page. +- [v2.0, September 10th 2023](https://github.com/tldr-pages/tldr/blob/v2.0/CLIENT-SPECIFICATION.md) ([#10148](https://github.com/tldr-pages/tldr/pull/10148)) + - Add recommendation to support `macos` alias for `osx` ([#7514](https://github.com/tldr-pages/tldr/pull/7514)) + - Drop the special "all" platform from the `--list` flag ([#7561](https://github.com/tldr-pages/tldr/pull/7561)) + - Drop the `master` branch from the assets link. ([#9668](https://github.com/tldr-pages/tldr/pull/9668)) + - Require support for long options ([#9651](https://github.com/tldr-pages/tldr/pull/9651)) + - Add recommendation to support caching individual translation archives ([#10148](https://github.com/tldr-pages/tldr/pull/10148)) - - [v1.3, June 11th 2020](https://github.com/tldr-pages/tldr/blob/v1.3/CLIENT-SPECIFICATION.md) ([#4101](https://github.com/tldr-pages/tldr/pull/4101)) - - Clarified fallback to English in the language resolution algorithm. - - Update the `LANG` and `LANGUAGE` environment variables to conform to the GNU spec. +- [v1.5, March 17th 2021](https://github.com/tldr-pages/tldr/blob/v1.5/CLIENT-SPECIFICATION.md) ([#5428](https://github.com/tldr-pages/tldr/pull/5428)) + - Add requirement for converting command names to lowercase before running the page resolution algorithm. + - Use HTTPS for archive links. - - [v1.2, July 3rd 2019](https://github.com/tldr-pages/tldr/blob/v1.2/CLIENT-SPECIFICATION.md) ([#3168](https://github.com/tldr-pages/tldr/pull/3168)) - - Addition of a new `-L, --language` recommended command-line option. - - Rewording of the language section, also encouraging the use of configuration files for language. - - Shift from BCP-47 to POSIX style locale tags, with consequent **deprecation of previous versions of the spec**. - - Clearer clarification about the recommended caching functionality. - - Correction of the usage of the term "arguments" in the homonym section. +- [v1.4, August 13th 2020](https://github.com/tldr-pages/tldr/blob/v1.4/CLIENT-SPECIFICATION.md) ([#4246](https://github.com/tldr-pages/tldr/pull/4246)) + - Add requirement for CLI clients to use non-zero exit code on failing to find a page. - - [v1.1, April 1st 2019](https://github.com/tldr-pages/tldr/blob/v1.1/CLIENT-SPECIFICATION.md) (deprecated) ([#2859](https://github.com/tldr-pages/tldr/pull/2859)) - - Clarified platform section. +- [v1.3, June 11th 2020](https://github.com/tldr-pages/tldr/blob/v1.3/CLIENT-SPECIFICATION.md) ([#4101](https://github.com/tldr-pages/tldr/pull/4101)) + - Clarified fallback to English in the language resolution algorithm. + - Update the `LANG` and `LANGUAGE` environment variables to conform to the GNU spec. - - [v1.0, January 23rd 2019](https://github.com/tldr-pages/tldr/blob/v1.0/CLIENT-SPECIFICATION.md) (deprecated) ([#2706](https://github.com/tldr-pages/tldr/pull/2706)) - - Initial release. +- [v1.2, July 3rd 2019](https://github.com/tldr-pages/tldr/blob/v1.2/CLIENT-SPECIFICATION.md) ([#3168](https://github.com/tldr-pages/tldr/pull/3168)) + - Addition of a new `-L, --language` recommended command-line option. + - Rewording of the language section, also encouraging the use of configuration files for language. + - Shift from BCP-47 to POSIX style locale tags, with consequent **deprecation of previous versions of the spec**. + - Clearer clarification about the recommended caching functionality. + - Correction of the usage of the term "arguments" in the homonym section. + +- [v1.1, April 1st 2019](https://github.com/tldr-pages/tldr/blob/v1.1/CLIENT-SPECIFICATION.md) (deprecated) ([#2859](https://github.com/tldr-pages/tldr/pull/2859)) + - Clarified platform section. + +- [v1.0, January 23rd 2019](https://github.com/tldr-pages/tldr/blob/v1.0/CLIENT-SPECIFICATION.md) (deprecated) ([#2706](https://github.com/tldr-pages/tldr/pull/2706)) + - Initial release. From 0e7d2cea9c3f179390d080ead5634f373f064f08 Mon Sep 17 00:00:00 2001 From: Lena <126529524+acuteenvy@users.noreply.github.com> Date: Thu, 30 Nov 2023 19:09:30 +0100 Subject: [PATCH 15/16] playerctl: update page (#11616) --- pages/linux/playerctl.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/pages/linux/playerctl.md b/pages/linux/playerctl.md index 28f058cd1f..c3ef4ce6a3 100644 --- a/pages/linux/playerctl.md +++ b/pages/linux/playerctl.md @@ -1,17 +1,17 @@ # playerctl -> Utility to control different media players. +> Control media players via MPRIS. > More information: . - Toggle play: `playerctl play-pause` -- Next media: +- Skip to the next track: `playerctl next` -- Previous media: +- Go back to the previous track: `playerctl previous` @@ -21,12 +21,12 @@ - Send a command to a specific player: -`playerctl --player={{player_name}} {{command}}` +`playerctl --player {{player_name}} {{play-pause|next|previous|...}}` - Send a command to all players: -`playerctl --all-players {{command}}` +`playerctl --all-players {{play-pause|next|previous|...}}` -- Show now playing: +- Display metadata about the current track: -`playerctl metadata --format "Now playing: {{artist}} - {{album}} - {{title}}"` +`playerctl metadata --format "{{Now playing: \{\{artist\}\} - \{\{album\}\} - \{\{title\}\}}}"` From 3b645a018bafff8851ed5ec4c6b7846b0080d1a9 Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Thu, 30 Nov 2023 19:26:17 +0000 Subject: [PATCH 16/16] rargs: add page (#11603) Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com> Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --- pages/osx/rargs.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 pages/osx/rargs.md diff --git a/pages/osx/rargs.md b/pages/osx/rargs.md new file mode 100644 index 0000000000..00c467de09 --- /dev/null +++ b/pages/osx/rargs.md @@ -0,0 +1,25 @@ +# rargs + +> Execute a command for each line of standard input. +> Like `xargs`, but with pattern matching support. +> More information: . + +- Execute a command for every line of input, just like `xargs` (`{0}` indicates where to substitute in the text): + +`{{command}} | rargs {{command}} {0}` + +- Do a dry run, which prints the commands that would be run instead of executing them: + +`{{command}} | rargs -e {{command}} {0}` + +- Remove the `.bak` extension from every file in a list: + +`{{command}} | rargs -p '(.*).bak mv {0} {1}` + +- Execute commands in parallel: + +`{{command}} | rargs -w {{max-procs}}` + +- Consider each line of input to be separated by a NUL character (`\0`) instead of a newline (`\n`): + +`{{command}} | rargs -0 {{command}} {0}`