Nume

       soelim - intercalează recursiv cererile sursă în roff sau alte fișiere text

Rezumat

       soelim [-Crt] [-I dir] [fișier-intrare ...]

       soelim --help

       soelim -v
       soelim --version

Descriere

       GNU  soelim  is  a preprocessor for the groff(7) document formatting system.  soelim works as a filter to
       eliminate source requests in  roff(7)  input  files;  that  is,  it  replaces  lines  of  the  form  “.so
       included-file”  within  each  text  input-file  with  the contents of included-file, recursively.  În mod
       implicit, scrie și cereri lf (Dacă) pentru a înregistra numele și numărul de linie al fiecărui fișier  de
       intrare  și  fișier  inclus,  astfel  încât  orice diagnostic produs de procesarea ulterioară să poată fi
       urmărit cu exactitate până la intrarea originală.  Opțiunile permit ca aceste informații să fie suprimate
       (-r) sau să fie furnizate în comentarii TeX (-t).  În absența argumentelor fișier-intrare, soelim citește
       fluxul de intrare standard.  Ieșirea este scrisă în fluxul de ieșire standard.

       În cazul în care numele unui fișier-macro conține o bară oblică inversă, utilizați \\ sau \e  pentru  a-o
       include.   Pentru  a  include  un  spațiu,  scrieți  „\ ” (bara inversă urmată de un spațiu).  Orice altă
       secvență de eludare din macro-file, inclusiv „\[rs]”, împiedică soelim să înlocuiască cererea sursă.

       Punctul trebuie să se afle la începutul  unei  linii  și  trebuie  să  fie  urmat  de  „so”  fără  spații
       intermediare  sau  tabulatoare  pentru ca soelim să îl gestioneze.  Această convenție permite ca cererile
       sursă să fie „protejate” de la procesarea de către soelim, de exemplu ca parte a definițiilor macro sau a
       cererilor „if”.

       De asemenea, trebuie să existe cel puțin un spațiu între „so” și argumentul său  fișier-macro.   Opțiunea
       -C anulează această cerință.

       Cele  de mai sus reprezintă limita înțelegerii de către soelim a limbajului roff; aceasta nu înlocuieș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 în general, pentru a aplatiza un arbore de documente de intrare.

       soelim  was  designed  to  handle  situations  where  the  target  of  a  roff  source request requires a
       preprocessor such as eqn(1), pic(1), refer(1), or tbl(1).  The usual processing sequence of  groff(1)  is
       as follows.

                 input        sourced
                 file          file
                   ⎪             ⎪
                   ↓             ↓
               preprocessor ⎯→ troff ⎯→ postprocessor
                                             ⎪
                                             ↓
                                          output
                                           file

       Adică, fișierele care au ca sursă „so” sunt în mod normal citite doar de către formatorul, troff.  soelim
       nu este necesar pentru troff la fișierele sursă.

       Dacă  un  fișier  care urmează să fie preluat trebuie, de asemenea, să fie preprocesat, acesta trebuie să
       fie deja citit înainte ca fișierul de intrare să treacă prin preprocesor.  soelim, invocat în mod  normal
       prin opțiunea -s a lui groff, se ocupă de acest lucru.

                 input
                 file
                   ⎪
                   ↓
                 soelim ⎯→ preprocessor ⎯→ troff ⎯→ postprocessor
                   ↑                                     ⎪
                   ⎪                                     ↓
                sourced                               output
                 file                                  file

Opțiuni

       --help  afișează  un  mesaj de utilizare, în timp ce -v și --version afișează informații despre versiune;
       toate acestea ies după aceea.

       -C     Recunoaște o linie de intrare care începe cu .so chiar dacă  urmează  un  alt  caracter  decât  un
              spațiu sau o linie nouă.

       -I director
              Caută în ruta directorului dir fișiere-de-intrare- și fișiere-incluse.  -I poate fi specificată de
              mai  multe  ori;  fiecare  dir este căutat în ordinea dată.  Pentru a căuta în directorul de lucru
              curent înaintea altora, adăugați „-I .” în locul dorit; altfel, acesta este căutat ultimul.

       -r     Scrie fișierele „raw” (brute); nu adaugă cereri lf.

       -t     Emite linii de comentariu TeX care încep cu „%” indicând fișierul curent și numărul liniei, în loc
              de cereri lf în același scop.

       În cazul în care sunt indicate atât -r, cât și -t, ultima specificată este cea care controlează.

Consultați și

       groff(1)

TRADUCERE

       Traducerea   în   limba   română   a   acestui   manual   a   fost   făcută   de   Remus-Gabriel    Chelu
       <remusgabriel.chelu@disroot.org>

       Această  traducere  este  documentație  gratuită;  citiți  Licența publică generală GNU Versiunea 3 sau o
       versiune  ulterioară  cu  privire  la  condiții  privind  drepturile  de  autor.   NU  se   asumă   NICIO
       RESPONSABILITATE.

       Dacă  găsiți  erori  în  traducerea  acestui manual, vă rugăm să trimiteți un e-mail la translation-team-
       ro@lists.sourceforge.net.

groff 1.23.0                                     30 aprilie 2024                                       soelim(1)