soelim(1)                   General Commands Manual                  soelim(1)

Nume
       soelim - intercaleaza recursiv cererile sursa in roff sau alte
       fi<?>iere text

SINOPSIS
       soelim [-Crt] [-I dir] [fi<?>ier-intrare ...]

       soelim --help

       soelim -v

       soelim --version

Descriere
       GNU soelim este un preprocesor pentru sistemul de formatare a
       documentelor groff(7) soelim elimina cererile de sursa din roff(7) <?>i
       din alte fi<?>iere text; mai precis, inlocuie<?>te liniile de forma
       ,,.so fi<?>ier-inclus" din fiecare fi<?>ier text fi<?>ier-intrare cu
       con<?>inutul fi<?>ierului fi<?>ier-inclus in mod recursiv, aplatizand
       astfel arborele de documente.  In mod implicit, acesta scrie <?>i
       cererile roff lf pentru a inregistra numele <?>i numarul de linie al
       fiecarui fi<?>ier fi<?>ier-intrare <?>i fi<?>ier-inclus, astfel incat
       orice mesaj de diagnosticare generat in urma procesarii ulterioare sa
       poata fi asociat cu precizie cu fi<?>ierul de intrare original.
       Op<?>iunile permit ca aceste informa<?>ii sa fie suprimate (-r) sau sa
       fie furnizate in comentarii TeX (-t).  In absen<?>a argumentelor
       fi<?>ier-intrare, soelim cite<?>te fluxul de intrare standard.
       Programul scrie in fluxul de ie<?>ire standard.

       soelim cite<?>te argumentul fisier-inclus la fel ca GNU troff.  Ignora
       spa<?>iile care urmeaza imediat dupa "so"; pentru a include o
       secven<?>a de unul sau mai multe spa<?>ii ini<?>iale in argument,
       preceda<?>i secven<?>a cu o ghilimea dubla neutra (").  Spa<?>iile care
       nu sunt de inceput sunt interpretate literal.  O bara oblica inversa
       urmata de un spa<?>iu ("\ ") codifica, de asemenea, un spa<?>iu, pentru
       compatibilitate cu versiunile anterioare ale GNU soelim.  Daca numele
       fi<?>ierului inclus con<?>ine o bara oblica inversa, folosi<?>i \\ sau
       \e pentru a o ingloba.  Orice alta secven<?>a de eludare din
       fi<?>ier-inclus, inclusiv ,,\[rs]", impiedica soelim sa inlocuiasca
       solicitarea sursa.  AT&T <?>i versiunile descendente ale soelim nu au
       nicio modalitate de a include spa<?>ii in numele fi<?>ierelor; ele
       inlocuiesc primul spa<?>iu intalnit cu un caracter de linie noua <?>i
       inceteaza interpretarea cererii.

       Punctul trebuie sa se afle la inceputul unei linii <?>i trebuie sa fie
       urmat de ,,so" fara spa<?>ii intermediare sau tabulatoare pentru ca
       soelim sa il gestioneze.  Aceasta conven<?>ie permite ca cererile sursa
       sa fie ,,protejate" de la procesarea de catre soelim, de exemplu ca
       parte a defini<?>iilor macro sau a cererilor ,,if".

       De asemenea, trebuie sa existe cel pu<?>in un spa<?>iu intre ,,so" <?>i
       argumentul sau fi<?>ier-inclus.  Op<?>iunea -C anuleaza aceasta
       cerin<?>a.

       Cele de mai sus reprezinta limita in<?>elegerii de catre soelim a
       limbajului roff; aceasta nu inlocuie<?>te, de exemplu, linia de intrare
              .if 1 .so otherfile
       cu con<?>inutul din alt-fi<?>ier.  Prin urmare, cu op<?>iunea -r,
       soelim poate fi utilizat pentru procesarea fi<?>ierelor text in
       general.

       soelim a fost conceput pentru a gestiona situa<?>iile in care <?>inta
       unei cereri de sursa roff necesita un preprocesor cum ar fi eqn(1) ,
       pic(1) , refer(1) , sau tbl(1) Secven<?>a normala de procesare a lui
       groff(1) este urmatoarea:

                 input        sourced
                 file          file
                   |             |
                   v             v
               preprocessor --> troff --> postprocessor
                                             |
                                             v
                                          output
                                           file

       Adica, fi<?>ierele care au ca sursa ,,so" sunt in mod normal citite
       doar de catre formatorul, troff(1) soelim nu este necesar pentru troff
       la fi<?>ierele sursa.

       Daca un fi<?>ier care urmeaza sa fie preluat trebuie, de asemenea, sa
       fie preprocesat, acesta trebuie sa fie deja citit inainte ca intrarea
       sa treaca prin preprocesor.  soelim, invocat in mod normal prin
       op<?>iunea -s a lui groff, se ocupa de acest lucru.

                 input
                 file
                   |
                   v
                 soelim --> preprocessor --> troff --> postprocessor
                   ^                                     |
                   |                                     v
                sourced                               output
                 file                                  file

Op<?>iuni
       --help afi<?>eaza un mesaj de utilizare, in timp ce -v <?>i --version
       afi<?>eaza informa<?>ii despre versiune; toate acestea ies dupa aceea.

       -C      Recunoa<?>te o linie de intrare care incepe cu .so chiar daca
               urmeaza un alt caracter decat un spa<?>iu sau o linie noua.

       -I director
               Cauta in directorul dir fi<?>ierele fi<?>iere-intrare <?>i
               fi<?>iere-incluse. Daca este specificata de mai multe ori,
               fiecare dir este cautat in ordinea indicata.  Pentru a cauta in
               directorul de lucru curent inaintea altora, adauga<?>i ,,-I".
               in locul dorit; altfel, acesta este cautat ultimul.

       -r      Scrie fi<?>ierele ,,raw" (brute); nu adauga cereri lf.

       -t      Emite linii de comentariu TeX care incep cu ,,%" indicand
               fi<?>ierul curent <?>i numarul liniei, in loc de cereri lf in
               acela<?>i scop.

       In cazul in care sunt indicate atat -r, cat <?>i -t, ultima specificata
       este cea care controleaza.

Starea de ie<?>ire
       soelim iese cu starea 0 in cazul unei opera<?>ii reu<?>ite, cu starea 2
       daca programul nu poate interpreta argumentele din linia de comanda
       <?>i cu starea 1 daca intampina o eroare in timpul func<?>ionarii.

Consulta<?>i <?>i
       groff(1)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

groff 1.24.1                    15 martie 2026                       soelim(1)