From bbaf96e3a64c21bec8d8f9a3d9b4886d13aa110b Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 16:44:03 +0100 Subject: [PATCH 1/9] doc: fix misplaced .TP before %u in the English man page Commit 5fecc8d43 (ticket #4865) added the %v/%V entry with its .TP in front instead of after it, so %u/%U got merged into the %v/%V description. groff 1.24 (Fedora 45) warns about the resulting empty .TP, which makes maint/doctest.py fail in CI: warning: cannot nest .TP or .TQ inside .TP; supply a tag Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/mc.1.in | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/man/mc.1.in b/doc/man/mc.1.in index 69285dd5f..5ca7cebd0 100644 --- a/doc/man/mc.1.in +++ b/doc/man/mc.1.in @@ -2346,9 +2346,9 @@ The currently tagged files. .I %T The tagged files in the unselected panel. .TP -.TP .IR %v " and " %V Similar to the %t and %T, but expands to full names of tagged files. +.TP .IR %u " and " %U Similar to the %t and %T macros, but in addition the files are untagged. You can use this macro only once per menu file entry or extension file From a4faccb9eec92c13d52d3aa99fbd3c89cb9412d8 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 17:11:04 +0100 Subject: [PATCH 2/9] doc: remove stray .TP from the Spanish and Serbian man pages These .TP requests have no tag line after them: * es: the three translator's notes start with .TP followed by .PP. groff renders the note title as an indented hanging tag and narrows the following entries up to the next section; man2hlp indents the notes. mandoc shows a plain paragraph as intended. * sr: a .TP before the "Overview" node, added in a37e415b5, turns the section heading into an indented list item in groff and man2hlp. Found with `mandoc -T lint` ("line scope broken"). Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/es/mc.1.in | 3 --- doc/man/sr/mc.1.in | 1 - 2 files changed, 4 deletions(-) diff --git a/doc/man/es/mc.1.in b/doc/man/es/mc.1.in index 8076e192f..3fa35e3e3 100644 --- a/doc/man/es/mc.1.in +++ b/doc/man/es/mc.1.in @@ -524,7 +524,6 @@ Favoritos .\"Hotlist" y permite cambiar al directorio seleccionado. -.TP .PP .B * N. del T.: En el teclado castellano, existe un pequeño inconveniente, dado que la @@ -553,7 +552,6 @@ la selección se hará sin distinguir caracteres en mayúsculas o minúsculas. usaremos las teclas «\-» o «\e» para deseleccionar un grupo de archivos. Esta es la operación opuesta a la realizada por la tecla «+». -.TP .PP .B * N. del T.: La tecla que realiza originalmente la función descrita es la «\-» (menos) @@ -2775,7 +2773,6 @@ Invoca el visor de ayuda de hipertexto interno. .B F2 Cambia el modo de ajuste de líneas en pantalla. -.TP .PP .B * N. del T.: Envuelta (Ajustada), se muestra toda la información de la línea en la pantalla, de diff --git a/doc/man/sr/mc.1.in b/doc/man/sr/mc.1.in index 1c02c9434..0a4825896 100644 --- a/doc/man/sr/mc.1.in +++ b/doc/man/sr/mc.1.in @@ -126,7 +126,6 @@ mc \- Визуелна љуска за Униксолике системе. Ако није задата ниједна путања, текући директоријум је приказан у активном панелу, а вредност "other_dir" из panels.ini је директоријум за приказивање у пасивном панелу. -.TP .\"NODE "Overview" .SH "Преглед" Екран Поноћног наредника је подељен у четири дела. Два директоријумска окна From 03a6f1684dc51b934e67e2d0d4192abd17e20b41 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 17:30:40 +0100 Subject: [PATCH 3/9] doc: restore text lost after .PP in the Hungarian and Italian man pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit .PP takes no arguments, so groff, mandoc and man2hlp silently drop any text on the same line: * hu: the sentence about Emacs-like input lost "A Midnight Commander". * it: the "Usa le unità SI" option lost its name; mark it up like the other options in that list. Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/hu/mc.1.in | 3 ++- doc/man/it/mc.1.in | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/man/hu/mc.1.in b/doc/man/hu/mc.1.in index 084b7eae6..bcecbd58b 100644 --- a/doc/man/hu/mc.1.in +++ b/doc/man/hu/mc.1.in @@ -217,7 +217,8 @@ Meta, vagy az Alt billentyű, akkor használd az ESC\-et, a megfelelő karakter begépelésekor. A Meta funkció Linux alatt úgy érhető el, hogy megnyomjuk, majd elengedjük az ESC billentyűt. A Meta funkció az ezután megnyomott billentyűre vonatkozik! -.PP A Midnight Commander +.PP +A Midnight Commander beviteli eszköze a GNU Emacs szerkesztő billentyűzet\-kombinációihoz hasonlóan működik. .PP diff --git a/doc/man/it/mc.1.in b/doc/man/it/mc.1.in index 8a04b211d..49d8225d3 100644 --- a/doc/man/it/mc.1.in +++ b/doc/man/it/mc.1.in @@ -1797,7 +1797,8 @@ Se l'opzione è abilitata, una riga di informazioni di stato circa la voce correntemente selezionata viene mostrata sul fondo dei pannelli. Abilitata per impostazione predefinita. -.PP Usa le unità SI +.PP +.I Usa le unità SI. Se questa opzione è abilitata, Midnight Commander utilizzerà i prefissi SI (base 10) per visualizzare le dimensioni dei byte. Se disabilitata (impostazione predefinita), Midnight Commander utilizzerà i prefissi IEC (base 2). From 5c796afe70d8f71bbb4d12a33ad8b11f44d5ab30 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 17:30:40 +0100 Subject: [PATCH 4/9] doc: use .br instead of unbalanced .RE in the man pages .RE without a matching .RS was only used to put the two system-wide mc.ini paths on separate lines. .br does that without the "unbalanced .RE" warning; groff and man2hlp output is unchanged. Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/mc.1.in | 2 +- doc/man/ru/mc.1.in | 2 +- doc/man/sr/mc.1.in | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/man/mc.1.in b/doc/man/mc.1.in index 5ca7cebd0..d15eeea38 100644 --- a/doc/man/mc.1.in +++ b/doc/man/mc.1.in @@ -3874,7 +3874,7 @@ User's own extension, view configuration and edit configuration file. They override the contents of the system wide files if present. .PP .I %sysconfdir%/mc/mc.ini -.RE +.br .I %pkgdatadir%/mc.ini .IP System\-wide setup files for Midnight Commander, used only if the user diff --git a/doc/man/ru/mc.1.in b/doc/man/ru/mc.1.in index a2d43496a..d8f5fe1b7 100644 --- a/doc/man/ru/mc.1.in +++ b/doc/man/ru/mc.1.in @@ -4591,7 +4591,7 @@ insert=\ee[Op вместо общесистемного файла расширений. .PP .I %sysconfdir%/mc/mc.ini -.RE +.br .I %pkgdatadir%/mc.ini .IP Общесистемные файлы установок для Midnight Commander; используются только diff --git a/doc/man/sr/mc.1.in b/doc/man/sr/mc.1.in index 0a4825896..d2c3bf583 100644 --- a/doc/man/sr/mc.1.in +++ b/doc/man/sr/mc.1.in @@ -4014,7 +4014,7 @@ insert=\ee[Op постоје, оне намећу вредности уместо садржаја системских датотека. .PP .I %sysconfdir%/mc/mc.ini -.RE +.br .I %pkgdatadir%/mc.ini .IP Подразумевана системска подешавања Поноћног наредника. Користе се само From 84748d25cf560be0677d1ef9905be129d7c10c92 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 17:36:52 +0100 Subject: [PATCH 5/9] doc: fix stale help link to "Panel options" in the Italian man page Help links must use the English node name, so the "Opzioni del pannello" link was dead; man2hlp reported it as stale. Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/it/mc.1.in | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/man/it/mc.1.in b/doc/man/it/mc.1.in index 49d8225d3..2b991c03c 100644 --- a/doc/man/it/mc.1.in +++ b/doc/man/it/mc.1.in @@ -1496,7 +1496,7 @@ opzioni relative a come mc appare sullo schermo. Il comando .\"LINK2" Opzioni del pannello -.\"Opzioni del pannello" +.\"Panel options" apre una finestra di dialogo da cui è possibile specificare le opzioni dei pannelli del file manager. .PP From 5e46230af37d47985ed2d4c167a520cae2ba7885 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 17:36:52 +0100 Subject: [PATCH 6/9] doc: remove leftover undelfs mentions from the man pages Commit 25da8800d removed the "Undelete File System" section, but the VFS overview in every man page still listed undelfs, and the Russian one kept a help link to the removed node, which man2hlp reported as stale. Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/es/mc.1.in | 3 --- doc/man/hu/mc.1.in | 4 +--- doc/man/it/mc.1.in | 5 ++--- doc/man/mc.1.in | 3 --- doc/man/pl/mc.1.in | 5 ++--- doc/man/ru/mc.1.in | 8 -------- doc/man/sr/mc.1.in | 3 --- 7 files changed, 5 insertions(+), 26 deletions(-) diff --git a/doc/man/es/mc.1.in b/doc/man/es/mc.1.in index 3fa35e3e3..781dba1a2 100644 --- a/doc/man/es/mc.1.in +++ b/doc/man/es/mc.1.in @@ -3005,9 +3005,6 @@ utilizado para acceder al sistema de archivos Unix habitual; .I tarfs para manipular archivos empaquetados con el comando tar y acaso comprimidos; -.I undelfs -para recuperar archivos borrados en sistemas de archivos de tipo ext2 -(sistema de archivos habitual en Linux); .I ftpfs para manipular archivos en sistemas remotos a través de FTP; .I fish diff --git a/doc/man/hu/mc.1.in b/doc/man/hu/mc.1.in index bcecbd58b..991737046 100644 --- a/doc/man/hu/mc.1.in +++ b/doc/man/hu/mc.1.in @@ -2488,9 +2488,7 @@ Jelenleg a Midnight Commander a következő Csatolt Fájlrendszerekkel rendelkezik (VFS): a helyi fájlrendszert a szokásos Unix fájlrendszeren lévő fájlokhoz használja; az ftpfs\-t, az FTP protokollal rendelkező távoli gépek fájlainak módosítására használja; a tarfs\-t a tar -és tömörített tar fájlok módosítására használja; az undelfs\-t, a -törölt fájlok visszaállítására használja az ext2\-es fájlrendszeren -(az alapértelmezett fájlrendszer Linux rendszereken), a fish (a fájlok +és tömörített tar fájlok módosítására használja; a fish (a fájlok shellen keresztüli módosításához, mint pl. rsh és ssh) és végül az mcfs (a Midnight Commander fájlrendszere), amely hálózat alapú fájlrendszer. .PP diff --git a/doc/man/it/mc.1.in b/doc/man/it/mc.1.in index 2b991c03c..b886e0a80 100644 --- a/doc/man/it/mc.1.in +++ b/doc/man/it/mc.1.in @@ -2740,9 +2740,8 @@ Attualmente il Midnight Commander viene confezionato con alcuni File System Virtuali (VFS): il file system locale, usato per accedere al normale file system Unix; l'ftpfs, usato per manipolare file su sistemi remoti con il protocollo FTP; il tarfs, usato per manipolare file tar -e file tar compressi; l'undelfs, usato per recuperare file cancellati -su file system di tipo ext2 (il file system predefinito per sistemi -Unix), fish (per manipolare file su connessioni shell come rsh e ssh) e +e file tar compressi; fish (per manipolare file su connessioni shell +come rsh e ssh) e per ultimo l'mcfs (file system del Midnight Commander), un file system basato sulla rete. .PP diff --git a/doc/man/mc.1.in b/doc/man/mc.1.in index d15eeea38..98314cbf0 100644 --- a/doc/man/mc.1.in +++ b/doc/man/mc.1.in @@ -3222,9 +3222,6 @@ file system, used for accessing the regular Unix file system; the used to manipulate files on remote systems with the FTP protocol; the .IR tarfs , used to manipulate tar and compressed tar files; the -.IR undelfs , -used to recover deleted files on ext2 file systems (the default file -system for Linux systems), .I shell (for manipulating files over shell connections such as rsh and ssh). If the code was compiled with diff --git a/doc/man/pl/mc.1.in b/doc/man/pl/mc.1.in index 59211b624..32bd3eafc 100644 --- a/doc/man/pl/mc.1.in +++ b/doc/man/pl/mc.1.in @@ -2336,9 +2336,8 @@ Aktualnie Midnight Commander jest wyposażony w niektóre wirtualne systemy plików (VFS): lokalny system plików, używany do dostępu do typowych systemów plików Unixowych; ftpfs używanego do manipulowania plikami na zdalnych systemach na poprzez protokół FTP; tarfs używany do manipulania -plikami w systemach tar i w skompresowanych systemach tar; undelfs, używany -do odzyskiwania skasowanych plików na systemach typu ext2 (standardowy -system pracy systemu Linux), fish (do manipulowania plikami poprzez +plikami w systemach tar i w skompresowanych systemach tar; fish +(do manipulowania plikami poprzez połączenia powłok takich jak rsh czy ssh) i w końcu system mcfs (system plików Midnight Commandera), oparty o sieć. .PP diff --git a/doc/man/ru/mc.1.in b/doc/man/ru/mc.1.in index d8f5fe1b7..3b6fcabfc 100644 --- a/doc/man/ru/mc.1.in +++ b/doc/man/ru/mc.1.in @@ -3584,10 +3584,6 @@ Unix; \- файловой системы tarfs, используемой для обработки tar\- и сжатых tar\-файлов; .br -\- файловой системы undelfs, используемой для восстановления удалённых -файлов в файловой системе ext2 (файловая система, используемая в Linux -по умолчанию); -.br \- файловой системы shell (для манипулирования файлами при работе с оболочкой через такие программы как rsh и ssh); .br @@ -3613,10 +3609,6 @@ tar\-файлов; .\"LINK2" Файловая система SFTP (SSH File Transfer Protocol) .\"SFTP (SSH File Transfer Protocol) filesystem" -.br -.\"LINK2" -Файловая система UFS (Undelete File System) -.\"Undelete File System" .\"NODE " FTP File System" .SH " Файловая система FTP" Файловая система FTP позволяет работать с файлами на удалённых diff --git a/doc/man/sr/mc.1.in b/doc/man/sr/mc.1.in index d2c3bf583..81cf6ce22 100644 --- a/doc/man/sr/mc.1.in +++ b/doc/man/sr/mc.1.in @@ -3111,9 +3111,6 @@ C или C++, или другима). Овим се управља преко д .IR tarfs , који се користи за рад са обичним и компримованим датотекама врсте tar; систем датотека -.IR undelfs , -који се користи за опоравак обрисаних датотека на системима датотека -ext2 (подразумевани систем датотека за Линукс системе), .I shell (за рад са датотекама преко повезивања љуске, као што су rsh и ssh). Ако је код компајлиран са одговарајућом подршком, и From 19cb0958845d33f2b141b10f27a49d23ad4b4b80 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 17:44:40 +0100 Subject: [PATCH 7/9] doc: use .B instead of one-argument .BR in the man pages .BR alternates bold and roman between its arguments, so with a single argument it is just .B, and groff's style check (-rCHECKSTYLE=1) warns about it. The output is unchanged. Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/hu/mc.1.in | 4 ++-- doc/man/it/mc.1.in | 4 ++-- doc/man/pl/mc.1.in | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/man/hu/mc.1.in b/doc/man/hu/mc.1.in index 991737046..f24e93e6a 100644 --- a/doc/man/hu/mc.1.in +++ b/doc/man/hu/mc.1.in @@ -2916,7 +2916,7 @@ valamelyik gomb nem használható). .\"NODE "FILES" .SH "Fájlok" A progam minden ezzel kapcsolatos infomációt az -.BR MC_DATADIR +.B MC_DATADIR környezeti változóban tárol. Ha ezt a változót nem állítottuk be, akkor ez vissza fog állítódni a /usr könyvtárra. .PP @@ -2983,7 +2983,7 @@ Helyi felhasználó által definiált menü. Ha ez a fájl létezik, ezt használja a home, vagy rendszerszintű alkalmazás menü helyett. .PP To change default home directory of MC, you can use -.BR MC_PROFILE_ROOT +.B MC_PROFILE_ROOT environment variable. The value of MC_PROFILE_ROOT must be an absolute path. If MC_PROFILE_ROOT is unset or empty, HOME variable is used. If HOME is unset or empty, MC directories are get from GLib library. diff --git a/doc/man/it/mc.1.in b/doc/man/it/mc.1.in index b886e0a80..c1eaa3c60 100644 --- a/doc/man/it/mc.1.in +++ b/doc/man/it/mc.1.in @@ -708,7 +708,7 @@ mostra il nome del file. .B size mostra l'ampiezza del file. .TP -.BR bsize +.B bsize è una forma alternativa del formato .B size mostra l'ampiezza del file e per le directory mostra solo @@ -3296,7 +3296,7 @@ Menu locale definito dall'utente. Se questo file è presente viene usato al posto del menu delle applicazioni utente o di sistema. .PP To change default home directory of MC, you can use -.BR MC_PROFILE_ROOT +.B MC_PROFILE_ROOT environment variable. The value of MC_PROFILE_ROOT must be an absolute path. If MC_PROFILE_ROOT is unset or empty, HOME variable is used. If HOME is unset or empty, MC directories are get from GLib library. diff --git a/doc/man/pl/mc.1.in b/doc/man/pl/mc.1.in index 32bd3eafc..1a845b3ec 100644 --- a/doc/man/pl/mc.1.in +++ b/doc/man/pl/mc.1.in @@ -2995,7 +2995,7 @@ Lokalny plik zdefiniowany przez użytkownika. Jeśli ten plik jest dostępny, jest używany zamiast pliku w katalogu domowym i ogólnosystemowego. .PP To change default home directory of MC, you can use -.BR MC_PROFILE_ROOT +.B MC_PROFILE_ROOT environment variable. The value of MC_PROFILE_ROOT must be an absolute path. If MC_PROFILE_ROOT is unset or empty, HOME variable is used. If HOME is unset or empty, MC directories are get from GLib library. From 6cdad655171a5be2f50c8441750078a1e27965a0 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 17:45:02 +0100 Subject: [PATCH 8/9] doc: remove redundant paragraph macros from the man pages Drop .PP, .LP, .P, .br and blank lines that directly follow a section heading or sit next to another paragraph break. groff and mandoc already ignore them (mandoc warns "skipping paragraph macro"), so the man page output is unchanged. In the built-in help, a few doubled blank lines become single, and some pages no longer end with an empty line, as most English ones already do. Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- doc/man/es/mc.1.in | 3 --- doc/man/hu/mc.1.in | 1 - doc/man/it/mc.1.in | 3 --- doc/man/mc.1.in | 3 --- doc/man/mcdiff.1.in | 4 ---- doc/man/mcedit.1.in | 3 --- doc/man/mcview.1.in | 4 ---- doc/man/pl/mc.1.in | 52 ------------------------------------------ doc/man/ru/mc.1.in | 4 ---- doc/man/sr/mc.1.in | 4 ---- doc/man/sr/mcdiff.1.in | 4 ---- doc/man/sr/mcedit.1.in | 3 --- 12 files changed, 88 deletions(-) diff --git a/doc/man/es/mc.1.in b/doc/man/es/mc.1.in index 781dba1a2..8a9ea357c 100644 --- a/doc/man/es/mc.1.in +++ b/doc/man/es/mc.1.in @@ -2178,7 +2178,6 @@ transferencia de datos es iniciada por la máquina cliente, no por el servidor). Esta opción es la recomendada, y de hecho está activada por defecto. Si se desactiva, la conexión la inicia el servidor, y puede ser impedida por algún cortafuegos. -.PP .\"NODE " Save Setup" .SH " Guardar Configuración" Al arrancar Midnight Commander se carga la información de inicio del @@ -3366,7 +3365,6 @@ en orden, en: .br 3) .BR %pkgdatadir%/skins/ . -.br .PP Para más información consultar: @@ -3386,7 +3384,6 @@ Trazado de líneas .\"LINK2" Compatibilidad .\"Skins oldcolors" -.br .\"NODE " Skins sections" .SH " Descripción de secciones y parámetros" diff --git a/doc/man/hu/mc.1.in b/doc/man/hu/mc.1.in index f24e93e6a..3fde859e5 100644 --- a/doc/man/hu/mc.1.in +++ b/doc/man/hu/mc.1.in @@ -462,7 +462,6 @@ Megjeleníti a könyvtár előzményeket, azonos a 'v' egérrel történő lenyomásával. .\"NODE " Quick search" .SH " Quick search" -.PP .B C\-s, M\-s Elindítja a fájl keresést a könyvtár listában. Amikor a keresés aktív, a billentyűlenyomások hozzáadódnak a keresett szöveghez a diff --git a/doc/man/it/mc.1.in b/doc/man/it/mc.1.in index c1eaa3c60..c1e9045cf 100644 --- a/doc/man/it/mc.1.in +++ b/doc/man/it/mc.1.in @@ -3055,7 +3055,6 @@ La ricerca del file del tema avverrà (fino al primo trovato): .br 3) .B %pkgdatadir%/skins/ -.br .PP Il formato dei file del tema è descritto in @@ -3104,8 +3103,6 @@ La chiave `type` può avere i seguenti valori: \- SPECIAL_FIFO \- SPECIAL_DOOR .fi -.PP - .\"NODE "Special Settings" .SH "Impostazioni speciali" Molte delle impostazioni del Midnight Commander possono essere cambiate diff --git a/doc/man/mc.1.in b/doc/man/mc.1.in index 98314cbf0..fd92c8ff9 100644 --- a/doc/man/mc.1.in +++ b/doc/man/mc.1.in @@ -3590,7 +3590,6 @@ or without it). Search of skin\-file will occur in (to the first one found): .br 3) .B %pkgdatadir%/skins/ -.br .PP The format of skin files is described in @@ -3639,8 +3638,6 @@ rule case sensitive (true) or not (false). \- SPECIAL_FIFO \- SPECIAL_DOOR .fi -.PP - .\"NODE "Special Settings" .SH "Special Settings" Most of Midnight Commander settings can be changed from the diff --git a/doc/man/mcdiff.1.in b/doc/man/mcdiff.1.in index c86682399..b1c240737 100644 --- a/doc/man/mcdiff.1.in +++ b/doc/man/mcdiff.1.in @@ -5,7 +5,6 @@ mcdiff \- Internal diff viewer of GNU Midnight Commander. .B mcdiff [\-bcCdfhstVx?] file1 file2 .SH DESCRIPTION -.LP mcdiff is a link to .BR mc , the main GNU Midnight Commander executable. Executing GNU Midnight @@ -51,7 +50,6 @@ Displays the version of the program. .I "\-x" Forces xterm mode. Used when running on xterm\-capable terminals (two screen modes, and able to send mouse escape sequences). -.PP .SH FILES .I %pkgdatadir%/mc.hlp .IP @@ -71,7 +69,6 @@ affect all users, whether they have ~/.config/mc/ini or not. .IP User's own setup. If this file is present, the setup is loaded from here instead of the system\-wide startup file. -.PP .SH LICENSE This program is distributed under the terms of the GNU General Public License as published by the Free Software Foundation. See the built\-in @@ -82,7 +79,6 @@ The latest version of this program can be found at \X'tty: link https://ftp.osuosl.org/pub/midnightcommander/'https://ftp.osuosl.org/pub/midnightcommander/\X'tty: link' . .SH SEE ALSO mc(1), mcedit(1), mcview(1) -.PP .SH BUGS Bugs should be reported to \X'tty: link https://github.com/MidnightCommander/mc/issues'https://github.com/MidnightCommander/mc/issues\X'tty: link' . diff --git a/doc/man/mcedit.1.in b/doc/man/mcedit.1.in index 5cb2094ef..14daffbb3 100644 --- a/doc/man/mcedit.1.in +++ b/doc/man/mcedit.1.in @@ -8,7 +8,6 @@ mcedit \- Internal file editor of GNU Midnight Commander. .B mcedit [\-bcCdfhstVx?] file1:lineno[:] file2:lineno[:] ... .SH DESCRIPTION -.LP mcedit is a link to .BR mc , the main GNU Midnight Commander executable. Executing GNU Midnight Commander @@ -103,7 +102,6 @@ or .BR "Escape Tab" ) completes the word under the cursor using the words used in the file. .SH MACRO -.PP To define a macro, press .B Ctrl\-R and then type out the keys you want to be executed. Press @@ -240,7 +238,6 @@ where minus is symbol "\-" goes to previous function in navigation list .B Meta\-Equal where equal is symbol "=" goes to next function in navigation list (like browser's Forward button). -.PP .SH SYNTAX HIGHLIGHTING .B mcedit supports syntax highlighting. This means that keywords and contexts diff --git a/doc/man/mcview.1.in b/doc/man/mcview.1.in index 0eba9b974..b81f674ef 100644 --- a/doc/man/mcview.1.in +++ b/doc/man/mcview.1.in @@ -5,7 +5,6 @@ mcview \- Internal file viewer of GNU Midnight Commander. .B mcview [\-bcCdfhstVx?] file .SH DESCRIPTION -.LP mcview is a link to .BR mc , the main GNU Midnight Commander executable. Executing GNU Midnight @@ -49,7 +48,6 @@ Displays the version of the program. .I "\-x" Forces xterm mode. Used when running on xterm\-capable terminals (two screen modes, and able to send mouse escape sequences). -.PP .SH FILES .I %pkgdatadir%/help/mc.hlp .IP @@ -69,7 +67,6 @@ affect all users, whether they have ~/.config/mc/ini or not. .IP User's own setup. If this file is present, the setup is loaded from here instead of the system\-wide startup file. -.PP .SH LICENSE This program is distributed under the terms of the GNU General Public License as published by the Free Software Foundation. See the built\-in @@ -80,7 +77,6 @@ The latest version of this program can be found at \X'tty: link https://ftp.osuosl.org/pub/midnightcommander/'https://ftp.osuosl.org/pub/midnightcommander/\X'tty: link' . .SH SEE ALSO mc(1), mcedit(1) -.PP .SH BUGS Bugs should be reported to \X'tty: link https://github.com/MidnightCommander/mc/issues'https://github.com/MidnightCommander/mc/issues\X'tty: link' . diff --git a/doc/man/pl/mc.1.in b/doc/man/pl/mc.1.in index 1a845b3ec..6c295dfd7 100644 --- a/doc/man/pl/mc.1.in +++ b/doc/man/pl/mc.1.in @@ -131,7 +131,6 @@ piszesz pojawia się w linii poleceń i po naciśnięciu klawisza Enter zostanie wykonane przez Midnight Commandera. Przeczytaj sekcję .BR "Linia powłoki i Linia wejściowa klawiszy" , żeby nauczyć się więcej na ten temat. -.PP .\"NODE "Mouse Support" .SH "Obsługa myszy" Midnight Commander obsługuje mysz. Moduł ten jest uruchamiany wtedy kiedy @@ -218,7 +217,6 @@ pozwala zwiedzić historię komend linii poleceń. są używane do edytowania linii na wejściu (przy wpisywaniu). Oznacza, to że stosuje się je zarówno do linii poleceń jak do okien dialogowych. -.PP .\"NODE " Miscellaneous Keys" .SH "Klawisze różne" Jest tu kilka klawiszy, które nie kwalifikują się do żadnej z wymienionych @@ -288,7 +286,6 @@ Commandera dopóki nie zamkniesz zawieszonego programu. Aby dowiedzieć się czegoś na temat polskiech liter w Midnight Commanderze przeczytaj sekcję .IR "Polskie litery" . -.PP .\"NODE " Directory Panels" .SH " Panel Katalogów" Sekcja opisuje klawisze, które operują na panelu katalogów. Jeśli chcesz @@ -384,10 +381,8 @@ w '>'. .PP .BR M\-S\-h ", " M\-H . Wyświetla historię katalogów, podobne działanie do kliknięcia myszką 'v'. -.PP .\"NODE " Quick search" .SH " Quick search" -.PP .BR C\-s ", " M\-s . Uruchamia szukanie pliku w katalogu na podstawie jego nazwy. Kiedy szukanie jest aktywne, każde naciśnięcie klawisza doda jeden znak do poszukiwania @@ -435,7 +430,6 @@ a M\-n następną komendę. .PP .BR M\-h . Wyświetla historię aktualnej linii poleceń. -.PP .\"NODE " General Movement Keys" .SH " Podstawowe klawisze ruchu" Przeglądarka pomocy, podgląd plików i drzewo katalogów używają podobnych @@ -477,7 +471,6 @@ Przechodzi pół strony naprzód lub wstecz. .PP .BR g ", " G . Przechodzi do początku lub do końca. -.PP .\"NODE " Input Line Keys" .SH " Linia wejściowa klawiszy" Linie wejściowe (te używane w linii komend i w oknach dialogowych), akceptują @@ -533,7 +526,6 @@ kasuje jedno słowo wstecz (poprzednie). .BR M\-Tab . Wykonuje dokończenie nazw plików, komend, zmiennych, użytkowników, nazw hostów za Ciebie. -.PP .SH "" .\"NODE "Menu Bar" .SH "Linia menu" @@ -549,14 +541,12 @@ Menu plik pozwala na wykonanie akcji na aktualnym lub zaznaczonych plikach. .PP Menu komend mieści w sobie możliwe do wykonania akcje, które są dużo bardziej globalne i nie mają związku z aktualnym i zaznaczonymi plikami. -.PP .\"NODE " Left and Right Menus" .SH " Lewe i prawe menu" Wygląd panelu katalogowego może zostać zmieniony poprzez menu .B left i .BR right . -.PP .\"NODE " Listing Format..." .SH " Tryby wyświetlania (Listing modes)" Tryby wyświetlania są używane do zmienia ustawień przy wyświetlaniu. @@ -702,14 +692,12 @@ wstecznego (od tyłu). Standardowo, katalogi są sortowane przed plikami, ale może to być zmienione przez opcję .BR "Mix all files (mieszaj wszystkie pliki)" . -.PP .\"NODE " Filter..." .SH " Filtry (Filter...)" Komenda filtra pozwala ci na podanie rozszerzenia, które musi być spełnione, żeby pliki były widoczne (na przykład .BR "*.tar.gz" ). Niezależnie od filtru katalalogi i dowiązania do katalogów są zawsze pokazywane. -.PP .\"NODE " Reread" .SH " Odśwież (Reread)" Komenda odśwież odświeża widok wszystkich plików w katalogów. Jest to użyteczne @@ -717,7 +705,6 @@ jeśli inny proces stworzył lub usunął jakiś pliki. Jeśli użyłeś panelu zewnętrznego, wszystkie informacje zostaną przywrócone do prawdziwego stanu. .\"NODE " File Menu" .SH "Menu plików (File menu)" -.PP Midnight Commander używa klawiszy F1 \- F10 jako skrótów klawiszowych do komend występujących w menu plików. Na terminalach bez funkcji klawiszowych (F1 \- F10) można używać kombinacji klawisza Escape i numeru ( odpowiednio 1 dla F1, @@ -869,7 +856,6 @@ Zamyka Midnight Commandera. Shift\-F10 jest używany jeśli używasz "wrappera" powłoki. Shift\-F10 nie przeniesie cię do katalogu, w którym byłeś ostatnio w Midnight Commanderze, zamiast tego przejdzie do katalogu, z którego uruchomiłeś program. -.PP .\"NODE " Quick cd" .SH " Szybka zmiana katalogów (Quick cd) M\-c" Ta komenda jest bardzo użyteczna, jeśli masz już pełną linię poleceń, a @@ -878,7 +864,6 @@ w którym podajesz to co po normalnej komendzie .B cd po czym naciskasz Enter. Wszystkie opcje są dokładnie takie same jak we wbudowanej komendzie cd. -.PP .\"NODE " Command Menu" .SH " Menu komend (Command Menu)" Komenda drzewo katalogów (Directory tree) pokazuje drzewo katalogów. @@ -913,7 +898,6 @@ programów, które mają być używane do wykonywania plików z podanymi rozszerzeniami. Komenda edycji pliku menu (Edit Menu File) może być używana do edytowania menu użytkownika (tego, które pojawia się po naciśnięciu kombinacji F2). -.PP .\"NODE " Directory Tree" .SH " Drzewo katalogów (Directory Tree)" Możesz wybierać katalogi z drzewa katalogów i Midnight Commander przejdzie do @@ -999,7 +983,6 @@ Wychodzi z drzewa. Nie zmienia katalogów. Mysz jest obsługiwana. Podwójne kliknięcie ma znaczenie identyczne do klawisza Enter. Zobacz również sekcję .IR "Obsługa myszy" . -.PP .\"NODE " Find File" .SH " Znajdź plik (Find File)" Komenda znajdź plik najpierw pyta się o startowy katalog do przeszukiwania @@ -1045,7 +1028,6 @@ Możesz woleć używać panelu zewnętrznego do wykonywania niektórych operacji Szukanie pliku jest dobre tylko dla prostych zapytań. Używając panelu zewnętrznego możesz dokonywać tak skomplikowanych wyszukiwań jak tylko pragniesz. -.PP .\"NODE " External panelize" .SH " Panel zewnętrzny" Panel zewnętrzny pozwala ci na wykonywanie zewnętrznych programów i @@ -1075,7 +1057,6 @@ Możesz zapisać sobie często używane komendy pod jakąś nazwą, po to w linii wejściowej, a potem naciskająć przycisk Add. Potem wpisujesz nazwę, pod jaką ta komenda ma być widoczna. Następnym razem po prostu wybierasz tę komendę z listy i nie musisz już wpisywać jej ponownie. -.PP .\"NODE " Hotlist" .SH " Hotlist" Hotlista katalogów pokazuje nazwy katalogów wprowadzonych do hotlisty. @@ -1089,7 +1070,6 @@ nazwą ma być ten katalog widoczny. Powoduje to przechodzenie do częściej przeglądanych katalogów znacznie szybciej. Możesz używać ciągle wartości CDPATH opisanej w sekcji Wewnętrzne przemieszczanie. -.PP .\"NODE " Edit Extension File" .SH " Edycja rozszerzeń pliów (Edit Extension File)" Ta komenda wywoła twój edytor na plik @@ -1109,7 +1089,6 @@ w tle przez Midnight Commandera (tylko operacje kopiowania i przenoszenia, mogą być wykonywane w tle). Z tego menu możesz zastopować, zresetować i "zabić" proces w tle. -.PP .\"NODE " Edit Menu File" .SH " Edycja menu użytkownika (Edit Menu File)" Menu użytkownika jest bardzo użytecznym menu, które może być tworzone @@ -1242,7 +1221,6 @@ możesz poprzedzić wpis menu dwoma wierszami warunkowymi. Jednym zaczynającym się od znaku '+', a drugim od '='. .PP Wszelkie komentarze rozpoczynają się od znaku '#'. -.PP .\"NODE " Options Menu" .SH " Menu opcji (Options Menu)" Midnight Commander ma niektóre opcje, które mogą być włączane lyb wyłączane @@ -1301,7 +1279,6 @@ Komenda Save Setup .\"Save Setup" zachowuje wszystkie ustawienia z menu Lewego, Prawego i Opcji. -.PP .\"NODE " Configuration" .SH " Konfiguracja" Opcje w tym oknie są podzielone na kilka grup: @@ -1476,7 +1453,6 @@ Standardowo ta opcja jest wyłączona. Jeśli ta opcja jest włączona, kiedy wychodzisz z Midnight Commandera konfiguracja MC zostanie zachowana automatycznie (bez pytania) do pliku ~/.config/mc/ini. -.PP .\"NODE " Layout" .SH " Układ (Layout)" Okno Układ pozwala ci na różne warianty zmieniania ogólnego wyglądu @@ -1689,7 +1665,6 @@ i również poczekaj na zniknięcie okna. Kiedy skończysz już ze wszystkimi klawiszami, możesz nacisnąć Save żeby zachować zmiany do pliku ~/.config/mc/ini do sekcji [terminal:TERM] (gdzie TERM jest nazwą twojego aktualnego terminala) lub po prostu odrzucić je. -.PP .\"NODE " Virtual FS" .SH " Wirtualny system plików (Virtual FS)" Ta opcja daje ci kontrolę nad ustawieniami informacji wirtualnego systemu @@ -1757,7 +1732,6 @@ Istnieją również ustawienia, które nie mogą być zmienione z poziomu menu. Dla tych ustawień musisz wyedytować swój plik konfiguracyjny za pomocą twojego ulubionego edytora. Zobacz sekcję Specjalne ustawienia po więcej informacji. -.PP .SH "" .\"NODE "Executing operating system commands" .SH "Wykonywanie poleceń systemu operacyjnego (Executing operating system commands)" @@ -1769,7 +1743,6 @@ Jeśli naciśniesz Enter na pliku, który nie jest wykonywalny, Midnight Command sprawdzi rozszerzenie pliku i porówna je z rozszerzeniami wybranymi w pliku rozszerzeń (Extensions File). Jeśli jakaś pozycja się zgadza, wykonywana jest komenda (raczej bardziej rozszerzone makro) powiązana z tym rozszerzeniem. -.PP .\"NODE " The cd internal command" .SH " Wbudowana komenda cd (The cd internal command)" Komenda cd jest interpretowana przez Midnight Commandera, nie @@ -1801,10 +1774,8 @@ Na przykład, możesz ustawić swoją zmienną na katalogi ~/src:/usr/src, pozwalając na zmianę katalogów na jakikolwiek inny wewnątrz ~/src i /usr/src, z miejsca w którym jesteś (np. cd linux przeniesie cię do katalogu /usr/src/linux). -.PP .\"NODE " Macro Substitution" .SH " Obsługa makr (Macro Substitution)" -.PP Kiedy używamy menu użytkownika, wykonujemy plik o znajomym rozszerzeniu, lub wykonujemy komendę z linii poleceń, możemy użyć kilku bardzo prostych makr. .PP @@ -1883,7 +1854,6 @@ Pyta się o zmienną. Pokazuje się okienko wejściowe i tekst wewnątrz klamere używany jest jako zachęta (prompt). Makro jest zastępowane tekstem wpisanym przez użytkownika. Użytkownik może nacisnąć ESC lub F10 aby anulować. To makro nie działa jeszcze w linii poleceń. -.PP .\"NODE " The subshell support" .SH " Obsługa podpowłoki (The subshell support)" Podpowłoka (powłoka w tle) jest opcją, która musi być wybrana przy kompilacji, @@ -1917,7 +1887,6 @@ w Midnight Commanderze jest tą samą, którą aktualnie używasz w powłoce. .PP Zobacz sekcję Opcje po więcej informacji na temat tego, jak możesz kontrolować powłokę w tle. -.PP .\"NODE "Chmod" .SH "Chmod" Okno Chmod jest używane do zmieniania atrybutów grupy plików lub katalogów. @@ -1972,17 +1941,14 @@ ustawia atrybuty jednego pliku. .PP .B [Cancel] unieważnia komendę chmod. -.PP .\"NODE "Chown" .SH "Chown" Komenda chown jest używana do zmiany właściela/grupy pliku. Skrótem klawiszowym jest kombinacja C\-x o. -.PP .\"NODE "Advanced Chown" .SH "Zaawansowane chown (Advanced Chown)" Zaawansowane chown jest komendą łączącą w sobie komendy chmod i chown. Możesz za jednym zamachem zmienić atrybuty i właściela/grupę pliku. -.PP .\"NODE "File Operations" .SH "Operacje na plikach (File Operations)" Kiedy kopiujesz, przenosisz lub kasujesz pliki, Midnight Commander pokazuje @@ -2026,7 +1992,6 @@ wybrałeś przycisk Yes lub alL będziesz zapytany o potwierdzenie. Wybierz Jeśli zaznaczyłeś pliki, i wykonujesz operacje tylko na nich, to jeśli operacja się udała zostaną one odznaczone, te, na których operacja nie przebiegła całkowicie pomyślnie, pozostaną zaznaczone. -.PP .\"NODE "Mask Copy/Rename" .SH "Maski kopiowania/przenoszenia (Mask Copy/Rename)" Operacje przenoszenia i kopiowania pozwalają ci na tłumaczenie nazw @@ -2119,7 +2084,6 @@ nazwy. .PP Możesz również używać '\e' aby "podkreślić" znak. Na przykład, '\e\e' jest backsleshem, a '\e*' jest gwiazdką. -.PP .\"NODE "Internal File Viewer" .SH "Wbudowany podgląd plików" Wbudowany podgląd plików pozwala na dwa tryby wyśmietlania: ASCII i hex. @@ -2283,10 +2247,8 @@ w twoim katalogu domowym zawierający poniższe: /usr/bin/indent \-kr \-pcs ~/.cache/mc/mcedit/mcedit.block>& /dev/null cat /dev/null > ~/.cache/mc/mcedit/cooledit.error .fi -.PP .\"NODE "Completion" .SH Dokańczanie -.PP Pozwól Midnight Commanderowi pisać za ciebie. .PP Spróbuj użyć dokończenia na tekście przed aktualną pozycją. MC próbuje @@ -2324,7 +2286,6 @@ Complete: show all jest wyłączone, okno z listą włącza się dopiero wtedy, kiedy naciskasz .B M\-Tab po raz drugi. Za pierwszym razem MC wydaje tylko krótki dźwięk. -.PP .\"NODE "Virtual File System" .SH "Wirtualny system plików (Virtual File System)" Midnight Commander jest dostarczany z kodem pozwalający na dostęp do @@ -2344,7 +2305,6 @@ plików Midnight Commandera), oparty o sieć. Kod VFS potrafi interpretować poprawnie wszystkie nazwy ścieżek i przekazuje je do właściwego systemu plików. Format używany dla każdego z systemów plików jest opisany w swojej oddzielnej sekcji. -.PP .\"NODE " FTP File System" .SH " System plików FTP (FTP File System)" Ftpfs pozwala na manipulowanie plikami na zdalnych komputerach, do @@ -2407,7 +2367,6 @@ będą one pokazane w strukturze katalogów, dopóki nie wymusisz tego przy użyciu kombinacji C\-r. To jest dobre rozwiązanie (jeśli myślisz, że to jest bug, to pomyśl o pracy na zdalnych systemach położonych po drugiej stronie Atlantyku przy użyciu ftpfs :) ). -.PP .\"NODE " Tar File System" .SH " System plików tar (Tar File System)" System plików tar pozwala na dostęp w trybie tylko\-do\-odczytu do plików typu @@ -2432,7 +2391,6 @@ Przykłady Późniejszy podaje pełną ścieżkę archiwum tar. .\"NODE " FIle transfer over SHell filesystem" .SH " Transfer plików pomiędzy systemami plików (FIle transfer over SHell filesystem)" -.PP System plików fish jest systemem opartym na sieci, który pozwala na manipulowanie plikami na obcej maszynie tak jakby były one lokalne. Aby tego używać, druga strona musi również mieć ustawiony serwer fish, lub musi @@ -2615,7 +2573,6 @@ tu dopiszę [ patrz tłumacz na dole ;)) ]]. .PP I gotowe \- polskie literki działają również w podglądzie i wbudowanym edytorze plików. -.PP .\"NODE "Colors" .SH Kolory Midnight Commander próbuje sprawdzić czy twój terminal obsługuje @@ -2699,7 +2656,6 @@ Przeszukanie pliku skórki nastąpi w (pierwszym znalezionym): .br 3) .B %pkgdatadir%/skins/ -.br .PP Format plików skórek opisano w @@ -2748,8 +2704,6 @@ Klucz 'type' może przyjmować wartości: \- SPECIAL_FIFO \- SPECIAL_DOOR .fi -.PP - .\"NODE "Special Settings" .SH "Specjalne ustawienia" Większość ustawień Midnight Commandera może być zmieniana z poziomu menu. @@ -2829,7 +2783,6 @@ Standardowo Midnight Commander traktuje klawisz ESC jako przedrostek ESC będzie przedrostkiem dla innego klawisza, ale jeśli ten nie nastąpi, będzie on zinterpretowany jako klawisz anulowania (tak jak ESC ESC). .PP -.PP .I only_leading_plus_minus .IP zmienia znaczenia znaków '+', '\-', '*' w linii komend (wybór, odznaczenie, @@ -2886,7 +2839,6 @@ rozszerzenie pliku do tego wybranego w pliku mc.ext.ini. Jeśli ta opcja jest włączona (standardowo tak nie jest) kiedy przeglądasz plik w panelu drzewa, będzie on automatycznie przeładowywał drugi panel na zawartość wybranego katalogu. -.PP .\"NODE "Terminal databases" .SH Baza danych terminali (Terminal databases) Midnight Commander pozwala ci na naprawienie bazy danych terminali bez @@ -2929,11 +2881,9 @@ reprezentuje sekwencję wyjścia używaną do wywoływania procesu dokańczania, jest to wywoływane kombinacją M\-tab, ale możesz zdefiniować inne klawisze do wykonywania tych samych funkcji (na tych klawiaturach z toną fajnych i zupełnie bezużytecznych klawiszy). -.PP .SH "" .\"NODE "FILES" .SH PLIKI -.PP Program będzie pobierał wszystkie swoje informacje ze zmiennej .BR MC_DATADIR , jeśli jest ona nie ustawiona to znowu przetwarzany jest katalog /usr. @@ -3018,7 +2968,6 @@ tcsh(1), zsh(1). Strona Midnight Commander w sieci World Wide Web: \X'tty: link https://midnight\-commander.org'https://midnight\-commander.org\X'tty: link' .fi -.PP .\"NODE "AUTHORS" .SH AUTORZY Miguel de Icaza (miguel@roxanne.nuclecu.unam.mx), Janne Kukonlehto @@ -3053,7 +3002,6 @@ Sergey Ya. Korshunoff (seyko2@gmail.com), Thomas Pundt (tjchol01@mecca.spd.louisville.edu), Torben Fjerdingstad (torben.fjerdingstad@uni\-c.dk), Vadim Sinolitis (vvs@nsrd.npi.msu.su) and Wim Osterholt (wim@djo.wtm.tudelft.nl). -.PP .\"NODE "BUGS" .SH BŁĘDY W pliku TODO dystrybucji znajdziesz informacje na temat tego, co diff --git a/doc/man/ru/mc.1.in b/doc/man/ru/mc.1.in index 3b6fcabfc..522f97bdb 100644 --- a/doc/man/ru/mc.1.in +++ b/doc/man/ru/mc.1.in @@ -617,7 +617,6 @@ Midnight Commander\-а. Для возврата к вашему приложен .P Кроме обычных символов в имени файла также можно использовать символы маски '*' и '?'. -.P .\"NODE " Shell Command Line" .SH " Командная строка оболочки" В этом разделе перечислены команды, которые позволяют сократить число @@ -2571,7 +2570,6 @@ FTP\-сервера, в памяти (в кеше). Время, в течени .\"Edit Extension File" или запускаемых из командной строки ввода, вначале выполняются простые макроподстановки. -.PP .TP .I "%i" Отступ из пробелов, равный текущему положению курсора. Только для меню @@ -3481,7 +3479,6 @@ ASCII и шестнадцатеричный (hex). Для переключени .\"NODE "Internal File Editor / options" .SH "Опции в ini\-файле для редактора" -.PP В данном разделе кратко описаны опции ini\-файла, относящиеся к редактору. Опции записываются в секцию [Midnight\-Commander]. .TP @@ -4017,7 +4014,6 @@ color_terminals=terminal\-name1,terminal\-name2... .\"LINK2" Совместимость .\"Skins oldcolors" -.br .\"NODE " Skins sections" .SH " Описание секций" diff --git a/doc/man/sr/mc.1.in b/doc/man/sr/mc.1.in index 81cf6ce22..2d4a74a9e 100644 --- a/doc/man/sr/mc.1.in +++ b/doc/man/sr/mc.1.in @@ -3443,7 +3443,6 @@ color_terminals=terminal\-name1,terminal\-name2... .br 3) .B %pkgdatadir%/skins/ -.br .PP За додатне информације, видети: @@ -3467,7 +3466,6 @@ color_terminals=terminal\-name1,terminal\-name2... .\"LINK2" Компатибилност .\"Skins oldcolors" -.br .\"NODE " Skins sections" .SH " Опис одељака и параметара" @@ -3786,8 +3784,6 @@ color_terminals=terminal\-name1,terminal\-name2... \- SPECIAL_FIFO \- SPECIAL_DOOR .fi -.PP - .\"NODE "Special Settings" .SH "Посебна подешавања" Већина подешавања Поноћног наредника се могу изменити из менија. Међутим, diff --git a/doc/man/sr/mcdiff.1.in b/doc/man/sr/mcdiff.1.in index c1ef4a89a..008188b2f 100644 --- a/doc/man/sr/mcdiff.1.in +++ b/doc/man/sr/mcdiff.1.in @@ -5,7 +5,6 @@ mcdiff \- Уграђени diff прегледач ГНУ\-овог поноћн .B mcdiff [\-bcCdfhstVx?] дато1 дато2 .SH ОПИС -.LP mcdiff је веза ка .BR mc \-у, главној извршној датотеци ГНУ\-овог поноћног наредника. Извршавање ГНУ\-овог @@ -46,7 +45,6 @@ mcdiff је веза ка .I "\-x" Намеће xterm режим. Користи се на терминалима сагласним са xterm\-ом (два екранска режима и способност за слање ескејп секвенци миша). -.PP .SH ДАТОТЕКЕ .I %pkgdatadir%/mc.hlp .IP @@ -66,7 +64,6 @@ mcdiff је веза ка .IP Корисничка подешавања. Ако је ова датотека присутна, онда се подешавања учитавају одавде уместо из системске датотеке са подешавањима. -.PP .SH ЛИЦЕНЦА Овај програм се расподељује под одредбама ГНУ\-ове опште јавне лиценце коју је објавила Задужбина за слободни софтвер. Погледајте уграђену помоћ за детаље о @@ -76,6 +73,5 @@ mcdiff је веза ка \X'tty: link https://ftp.osuosl.org/pub/midnightcommander/'https://ftp.osuosl.org/pub/midnightcommander/\X'tty: link' . .SH ВИДЕТИ И mc(1), mcedit(1), mcview(1) -.PP .SH ГРЕШКЕ Грешке пријавите на \X'tty: link https://github.com/MidnightCommander/mc/issues'https://github.com/MidnightCommander/mc/issues\X'tty: link' . diff --git a/doc/man/sr/mcedit.1.in b/doc/man/sr/mcedit.1.in index 3219d76fd..2ef4e223a 100644 --- a/doc/man/sr/mcedit.1.in +++ b/doc/man/sr/mcedit.1.in @@ -8,7 +8,6 @@ mcedit \- Уграђени уређивач датотека ГНУ\-овог П .B mcedit [\-bcCdfhstVx?] дато1:брлиније[:] дато2:брлиније[:] ... .SH ОПИС -.LP mcedit је веза ка .BR mc , главној извршној датотеци ГНУ\-овог Поноћног наредника. Извршавање ГНУ\-овог @@ -99,7 +98,6 @@ tab\-а; истицање синтаксе за разне врсте датот .BR "Escape Tab" ) довршава реч под курсором користећи речи из датотеке. .SH МАКРОИ -.PP Да бисте дефинисали макро, притисните .B Ctrl\-R и онда укуцајте тастере које желите да извршите. Притисните @@ -225,7 +223,6 @@ ctags \-e \-\-language\-force=C \-R ./ .BR Meta\-Једнако , где је једнако симбол „=“, иде на следећу функцију у листи за навигацију (као дугме Напред у веб читачу). -.PP .SH ИСТИЦАЊЕ СИНТАКСЕ .B mcedit подржава истицање синтаксе. То значи да ће кључне речи и контексти (нпр. From b6a054671b0c91eaf267da52693596c6dbd78818 Mon Sep 17 00:00:00 2001 From: "Yury V. Zaytsev" Date: Wed, 4 Nov 2026 18:07:00 +0100 Subject: [PATCH 9/9] maint: doctest: also lint with groff style checks, mandoc and man2hlp Only groff warnings were checked, so markup bugs that groff silently tolerates kept creeping in. Add: * -rCHECKSTYLE=1 for groff/nroff (e.g. one-argument .BR, unbalanced .RE) * mandoc -T lint -W warning (e.g. tag-less .TP, text after .PP, redundant paragraph macros), ignoring the placeholder date * man2hlp on every mc.1.in to catch stale help links All of these tools are already installed in the Fedora CI job. Assisted-By: Claude Opus 5.5 Signed-off-by: Yury V. Zaytsev --- maint/doctest.py | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/maint/doctest.py b/maint/doctest.py index 456e7baf9..00840713c 100755 --- a/maint/doctest.py +++ b/maint/doctest.py @@ -2,6 +2,7 @@ import re import subprocess +import tempfile from pathlib import Path @@ -18,12 +19,21 @@ for renderer in ("groff", "nroff"): warnings.extend( subprocess.check_output( - f"{renderer} -K UTF-8 -Tutf8 -mandoc -ww '{manpage}' | grep 'warning:' || true", + f"{renderer} -K UTF-8 -Tutf8 -mandoc -ww -rCHECKSTYLE=1 '{manpage}' | grep 'warning:' || true", shell=True, stderr=subprocess.STDOUT, ).splitlines() ) + # The date is a placeholder in the sources + warnings.extend( + subprocess.check_output( + f"mandoc -T lint -W warning '{manpage}' | grep -v 'cannot parse date' || true", + shell=True, + stderr=subprocess.STDOUT, + ).splitlines() + ) + content = "\n".join(manpage.read_text().splitlines()[1:]) # skip first line # https://mandoc.bsd.lv/mdoc/intro/escaping.html @@ -48,5 +58,23 @@ ).splitlines() ) +# Check that the built-in help converts cleanly, e.g. without stale links +with tempfile.TemporaryDirectory() as tmp: + man2hlp = Path(tmp) / "man2hlp" + man2hlp.write_text( + (MC_SOURCE_ROOT / "src/man2hlp/man2hlp.in").read_text().replace("@PERL_FOR_BUILD@", "perl") + ) + + for manpage in (MC_SOURCE_ROOT / "doc/man").glob("**/mc.1.in"): + print(manpage) + lang = manpage.parent.relative_to(MC_SOURCE_ROOT / "doc/man") + template = MC_SOURCE_ROOT / "doc/hlp" / lang / "xnc.hlp" + warnings.extend( + subprocess.run( + ["perl", man2hlp, manpage, template, Path(tmp) / "mc.hlp"], + stderr=subprocess.PIPE, + ).stderr.splitlines() + ) + if set(warnings): raise AssertionError(f"roff warnings: {set(warnings)}")