commit 56b8000022d63613178ecc4e643b623df1fdd25b
parent e847155ebe57d32dde14956e15f4856872423f27
Auteur: Loïc Daignault-Pichette <ldp@asteride.xyz>
Date: Sun, 7 Sep 2025 19:49:56 -0400
[doc] Traduire execrom(8) au catalan
Diffstat:
| A | man/ca/execrom.8 | | | 155 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
1 fichier modifié, 155 insertions(+), 0 suppressions(-)
diff --git a/man/ca/execrom.8 b/man/ca/execrom.8
@@ -0,0 +1,155 @@
+.Dd 6 de setembre de 2025
+.Dt EXECROM 8
+.Os
+.Sh NOM
+.Nm execrom
+.Nd Executar ROMs
+.Sh SINOPSI
+.Ar ROM
+.Op Ar argument ...
+.Sh DESCRIPCIÓ
+Quan és executada,
+la utilitat
+.Nm execrom
+inspecciona el seu argument 0,
+que ha de contenir
+.Ar ROM ,
+el nom amb el qual ha estat invocat.
+Recórre després les carpetes enumerades dins
+.Dv EXECROM_CHEM
+amb l’objectiu de trobar un fitxer
+el prefix de qual correspongui a
+.Ar ROM
+seguit d’un punt (« . »).
+Atura la cerca
+quan troba un fitxer apropiat,
+i executa el programa el nom del qual correspongui
+al sufix d’aquest fitxer,
+donant
+.Ar ROM
+i
+.Op Ar argument ...
+en arguments.
+.Pp
+Així,
+els noms dels programes
+accessibles mitjançant
+.Ev EXECROM_CHEM
+tenen la forma
+.Em nom.interpretador .
+.Em nom
+és el nom del programa per interpretar.
+Per ser escollit,
+ha de ser igual a
+.Ar ROM .
+.Em interpretador
+és el nom de l’executable
+destinat a interpretar el programa.
+Aquest executable ha d’estar
+accessible mitjançant
+.Dv PATH .
+.Pp
+.Nm
+no s’ha concebut per ser executat directament,
+sinó a través d’un enllaç simbòlic apuntant cap a ell.
+.Sh ENVIRONNEMENT
+La variable d’entorn següent influencia l’execució d’\c
+.Nm .
+.Bl -tag -width "EXECROM_CHEM"
+.It Ev EXECROM_CHEM
+Llista de camins,
+apartats per dos punts (« : »),
+cap a les carpetes
+que reuneixen els programes per interpretar.
+Te la mateixa estructura que
+.Ev PATH .
+.El
+.Sh EXEMPLES
+Siguin
+.Pa ~/uxn/drifblim
+i
+.Pa ~/uxn/left ,
+dues ROMs executables
+per una màquina Varvara.
+La primera conté un assemblador uxntal
+interpretable per la màquina virtual en mode de text
+.Xr uxncli 1 .
+L’ordre següent assembla
+.Pa prog.tal
+dins
+.Pa prog.rom .
+.Bd -literal -offset indent
+$ uxncli ~/uxn/drifblim prog.tal prog.rom
+.Ed
+.Pp
+La segona ROM és un editor de text en mode gràfic.
+Per tant, l’ha d’interpretar
+.Xr uxnemu 1 .
+L’ordre següent obre el fitxer
+.Pa doc.txt
+amb l’editor de text.
+.Bd -literal -offset indent
+$ uxnemu ~/uxn/left doc.txt
+.Ed
+.Pp
+Grâce à
+Gràcies a
+.Nm ,
+és possible iniciar aquests dos programes
+sense haver d’especificar l’interpretador adient.
+Per configurar-ho,
+cal establir la variable d’entorn
+.Dv EXECROM_CHEM
+per tal que contingui
+el camí cap a les carpetes
+on resideixen les ROMs,
+aquí,
+.Pa ~/uxn.
+.Bd -literal -offset indent
+$ export EXECROM_CHEM="$HOME/uxn:$EXECROM_CHEM"
+.Ed
+.Pp
+També cal modificar el nom de cada ROM
+de tal manera que el seu prefix et el seu sufix corresponguin
+al seu nom d’invocació i
+al nom del programa destinat a interpretar-lo,
+respectivament.
+El resultat hauria de ser semblant a:
+.Bd -literal -offset indent
+$ ls ~/uxn
+drifblim.uxncli
+left.uxnemu
+.Ed
+.Pp
+Per fi,
+per cada ROM
+s’ha de crear
+un enllanç simbólic accessible mitjançant
+.Dv PATH
+i apuntant cap a l’executable d’\c
+.Nm .
+.Bd -literal -offset indent
+$ ln -s /usr/local/libexec/execrom ~/.local/bin/driftblim
+$ ln -s /usr/local/libexec/execrom ~/.local/bin/left
+.Ed
+.Pp
+Les ROMs ara es poden executar directament.
+.Bd -literal -offset indent
+$ drifblim prog.tal prog
+$ left doc.txt
+.Ed
+.Sh ESTAT DE SORTIDA
+La utilitat
+.Nm execrom
+surt amb 0 si tot ha anat bé i amb >0 si un error ha ocurregut.
+.Sh AUTORS
+.An Loïc Daignault-Pichette <ldp@asteride.xyz>
+.Sh TRADUCCIÓ
+Aquesta pàgina del manual
+va ser traduïda
+per primera vegada
+de la seva versió original en francès
+per
+.An Loïc Daignault-Pichette <ldp@asteride.xyz>
+al mes de setembre de 2025
+i està actualitzada amb la versió 1.0 de la utilitat.
