soelim(1)                   General Commands Manual                  soelim(1)

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

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

       soelim --help

       soelim -v
       soelim --version

Descriere
       GNU soelim este un preprocesor pentru groff(7) sistemul de formatare a
       documentelor.  soelim func<?>ioneaza ca un filtru pentru a elimina
       cererile sursa din roff(7) fi<?>ierele de intrare; adica inlocuie<?>te
       liniile de forma ,,.so fi<?>ier-inclus" din fiecare text
       fi<?>ier-intrare cu con<?>inutul lui fi<?>ier-inclus, in mod recursiv.
       In mod implicit, scrie <?>i cereri lf (Daca) pentru a inregistra numele
       <?>i numarul de linie al fiecarui fi<?>ier de intrare <?>i fi<?>ier
       inclus, astfel incat orice diagnostic produs de procesarea ulterioara
       sa poata fi urmarit cu exactitate pana la intrarea originala.
       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.
       Ie<?>irea este scrisa in fluxul de ie<?>ire standard.

       In cazul in care numele unui fi<?>ier-macro con<?>ine o bara oblica
       inversa, utiliza<?>i \\ sau \e pentru a-o include.  Pentru a include un
       spa<?>iu, scrie<?>i ,,\ " (bara inversa urmata de un spa<?>iu).  Orice
       alta secven<?>a de eludare din macro-file, inclusiv ,,\[rs]", impiedica
       soelim sa inlocuiasca cererea sursa.

       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-macro.  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 a procesa fi<?>iere text in general,
       pentru a aplatiza un arbore de documente de intrare.

       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 uzuala de procesare a
       groff(1) este ca cea urmatoare.

                 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.  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 fi<?>ierul
       de intrare 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 dir Cauta in ruta directorului dir fi<?>iere-de-intrare- <?>i
              fi<?>iere-incluse.  -I poate fi specificata de mai multe ori;
              fiecare dir este cautat in ordinea data.  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.

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.23.0                  13 septembrie 2023                     soelim(1)