cupsctl, lpq, lprm, lpadmin, lpoptions: add pages (#11745)

* cupsctl: add page

* cupsctl: add pt_BR translation

* lpq, lprm: add pages

* lpq, lprm: add pt_BR translations

* lpadmin, lpopions: add pages

* lprm: add ... to jobs placeholders

* Update pages.pt_BR/common/lprm.md

lprm: remove unnecessary _ in pt_BR

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Apply suggestions from code review

lprm: replace "job_2_id" with "job_id2"

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* cupsctl, lpoptions: add curly brackets to placeholders

* lpadmin, lpoptions: add pt_BR translations

* cupsctl: wrap cupsd.conf inside backticks

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* cupsctl: add article

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* cupsctl: wrap error_log inside backticks

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* lpadmin: capitalize CUPS in pt_BR

* Update pages/common/cupsctl.md

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* lpadmin: capitalize CUPS

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* cupsctl: fix typo

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* lpq, lpoptions, lpadmin, lprm: don't highlight mnemonics

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* lpoptions: remove "[=value]"

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* lpoptions: don't highlight mnemonics in pt_BR

* lpadmin: remove -x mnemonic

* lpq: fix typo and remove mnemonic in pt_BR

* cupsctl: simplify description in pt_BR

* cupsctl, lpadmin, lpoptions, lpq, lprm: fix verb tenses and typos in pt_BR

Co-authored-by: Isaac Vicente <isaacvicentsocial@gmail.com>

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: Isaac Vicente <isaacvicentsocial@gmail.com>

pages.pt_BR/common/cupsctl.md

@@ -0,0 +1,28 @@
+# cupsctl
+
+> Atualiza ou consulta o cupsd.conf de um server.
+> Mais informações: <https://www.cups.org/doc/man-cupsctl.html>.
+
+- Exibe os valores de configuração atuais:
+
+`cupsctl`
+
+- Exibe os valores de configuração de um servidor específico:
+
+`cupsctl -h {{servidor[:porta]}}`
+
+- Ativar a criptografia na conexão ao scheduler:
+
+`cupsctl -E`
+
+- Ativa ou desativa o registro de depuração para o arquivo error_log:
+
+`cupsctl {{--debug-logging|--no-debug-loging}}`
+
+- Ativa ou desativa administração remota:
+
+`cupsctl {{--remote-admin|--no-remote-admin}}`
+
+- Exibe o estado atual do registro de depuração:
+
+`cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'`

pages.pt_BR/common/lpadmin.md

@@ -0,0 +1,21 @@
+# lpadmin
+
+> Configura impressoras e classes do CUPS.
+> Veja também: `lpoptions`.
+> Mais informações: <https://www.cups.org/doc/man-lpadmin.html>.
+
+- Define a impressora padrão:
+
+`lpadmin -d {{impressora}}`
+
+- Exclui uma impressora ou classe específica:
+
+`lpadmin -x {{impressora|classe}}`
+
+- Adiciona uma impressora a uma classe:
+
+`lpadmin -p {{impressora}} -c {{classe}}`
+
+- Remove uma impressora de uma classe:
+
+`lpadmin -p {{impressora}} -r {{classe}}`

pages.pt_BR/common/lpoptions.md

@@ -0,0 +1,21 @@
+# lpoptions
+
+> Exibe ou define opções e padrões de uma impressora.
+> Veja também: `lpadmin`.
+> Mais informações: <https://www.cups.org/doc/man-lpoptions.html>.
+
+- Define a impressora padrão:
+
+`lpoptions -d {{impressora[/instância]}}`
+
+- Lista opções específicas de uma impressora:
+
+`lpoptions -d {{impressora}} -l`
+
+- Define uma nova opção em uma impressora:
+
+`lpoptions -d {{impressora}} -o {{opção[=valor]}}`
+
+- Exclui as opções de uma impressora específica:
+
+`lpoptions -d {{impressora}} -x`

pages.pt_BR/common/lpq.md

@@ -0,0 +1,24 @@
+# lpq
+
+> Mostra o estado da fila de impressão.
+> Mais informações: <https://www.cups.org/doc/man-lpq.html>.
+
+- Mostra os trabalhos na fila do destino padrão:
+
+`lpq`
+
+- Mostrar os trabalhos na fila de todas as impressoras usando criptografia:
+
+`lpq -a -E`
+
+- Mostrar os trabalhos da fila em um formato longo:
+
+`lpq -l`
+
+- Mostra os trabalhos da fila de uma impressora ou classe específica:
+
+`lpq -P {{destino[/instância]}}`
+
+- Mostra os trabalhos na fila a cada n segundos até que a fila esteja vazia:
+
+`lpq +{{intervalo}}`

pages.pt_BR/common/lprm.md

@@ -0,0 +1,25 @@
+# lprm
+
+> Cancela trabalhos de impressão na fila de um servidor.
+> Veja também: `lpq`.
+> Mais informações: <https://www.cups.org/doc/man-lprm.html>.
+
+- Cancela o trabalho atual na impressora padrão:
+
+`lprm`
+
+- Cancela um trabalho de um servidor específico:
+
+`lprm -h {{servidor[:porta]}} {{id_do_trabalho}}`
+
+- Cancela múltiplos trabalhos com uma conexão criptografada com o servidor:
+
+`lprm -E {{id_do_trabalho1 id_do_trabalho2 ...}}`
+
+- Cancela todos os trabalhos:
+
+`lprm -`
+
+- Cancela o trabalho atual de uma impressora ou classe específica:
+
+`lprm -P {{destino[/instância]}}`

pages/common/cupsctl.md

@@ -0,0 +1,28 @@
+# cupsctl
+
+> Update or query a server's `cupsd.conf`.
+> More information: <https://www.cups.org/doc/man-cupsctl.html>.
+
+- Display the current configuration values:
+
+`cupsctl`
+
+- Display the configuration values of a specific server:
+
+`cupsctl -h {{server[:port]}}`
+
+- Enable encryption on the connection to the scheduler:
+
+`cupsctl -E`
+
+- Enable or disable debug logging to the `error_log` file:
+
+`cupsctl {{--debug-logging|--no-debug-logging}}`
+
+- Enable or disable remote administration:
+
+`cupsctl {{--remote-admin|--no-remote-admin}}`
+
+- Parse the current debug logging state:
+
+`cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'`

pages/common/lpadmin.md

@@ -0,0 +1,21 @@
+# lpadmin
+
+> Configure CUPS printers and classes.
+> See also: `lpoptions`.
+> More information: <https://www.cups.org/doc/man-lpadmin.html>.
+
+- Set the default printer:
+
+`lpadmin -d {{printer}}`
+
+- Delete a specific printer or class:
+
+`lpadmin -x {{printer|class}}`
+
+- Add a printer to a class:
+
+`lpadmin -p {{printer}} -c {{class}}`
+
+- Remove a printer from a class:
+
+`lpadmin -p {{printer}} -r {{class}}`

pages/common/lpoptions.md

@@ -0,0 +1,21 @@
+# lpoptions
+
+> Display or set printer options and defaults.
+> See also: `lpadmin`.
+> More information: <https://www.cups.org/doc/man-lpoptions.html>.
+
+- Set the default printer:
+
+`lpoptions -d {{printer[/instance]}}`
+
+- List printer-specific options of a specific printer:
+
+`lpoptions -d {{printer}} -l`
+
+- Set a new option on a specific printer:
+
+`lpoptions -d {{printer}} -o {{option}}`
+
+- Remove the options of a specific printer:
+
+`lpoptions -d {{printer}} -x`

pages/common/lpq.md

@@ -0,0 +1,24 @@
+# lpq
+
+> Show printer queue status.
+> More information: <https://www.cups.org/doc/man-lpq.html>.
+
+- Show the queued jobs of the default destination:
+
+`lpq`
+
+- Show the queued jobs of all printers enforcing encryption:
+
+`lpq -a -E`
+
+- Show the queued jobs in a long format:
+
+`lpq -l`
+
+- Show the queued jobs of a specific printer or class:
+
+`lpq -P {{destination[/instance]}}`
+
+- Show the queued jobs once every n seconds until the queue is empty:
+
+`lpq +{{interval}}`

pages/common/lprm.md

@@ -0,0 +1,25 @@
+# lprm
+
+> Cancel queued print jobs of a server.
+> See also: `lpq`.
+> More information: <https://www.cups.org/doc/man-lprm.html>.
+
+- Cancel current job on the default printer:
+
+`lprm`
+
+- Cancel a job of a specific server:
+
+`lprm -h {{server[:port]}} {{job_id}}`
+
+- Cancel multiple jobs with a encrypted connection to the server:
+
+`lprm -E {{job_id1 job_id2 ...}}`
+
+- Cancel all jobs:
+
+`lprm -`
+
+- Cancel the current job of a specific printer or class:
+
+`lprm -P {{destination[/instance]}}`