Nume¶

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

Rezumat¶

Descriere¶

GNU soelim este un preprocesor pentru groff(7) sistemul de formatare a documentelor. soelim funcționează ca un filtru pentru a elimina cererile sursă din roff(7) fișierele de intrare; adică înlocuiește liniile de forma „.so fișier-inclus” din fiecare text fișier-intrare cu conținutul lui fișier-inclus, în mod recursiv. Î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

soelim a fost conceput pentru a gestiona situațiile în care ținta unei cereri de sursă roff necesită un preprocesor cum ar fi eqn(1), pic(1), refer(1), sau tbl(1). Secvența uzuală de procesare a groff(1) este ca cea următoare.

          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 dir

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.