soelim(1) General Commands Manual soelim(1) Nazwa soelim - rekurencyjnie interpoluje zapytania zrodlowe w roff lub innych plikach tekstowych Skladnia soelim [-Crt] [-I katalog] [plik-wejsciowy ...] soelim --help soelim -v soelim --version Opis GNU soelim jest preprocesorem systemu formatowania dokumentow groff(7) soelim dziala jako filtr, sluzacy do eliminacji zapytan zrodlowych w plikach wejsciowych roff(7) tzn. zastepuje rekurencyjnie wiersze w postaci ,,.so plik-do-wlaczenia" wewnatrz kazdego pliku-wejsciowego zawartoscia pliku-do-wlaczenia. Domyslnie, zapisuje rowniez zapytania lf, aby zachowac nazwe i numer wiersza kazdego pliku-wejsciowego oraz pliku-do-wlaczenia, dzieki czemu wszelkie komunikaty diagnostyczne, tworzone przy pozniejszym przetwarzaniu, moga prawidlowo wskazywac na pierwotne wejscie. Istnieja opcje, za pomoca ktorych mozna wylaczyc te informacje (-r) lub umieszczac je w komentarzach TeX (-t). Przy braku argumentow pliku-wejsciowego, soelim czyta strumien standardowego wejscia. Wyjscie jest zapisywane na strumien standardowego wyjscia. Jesli nazwa pliku-makra zawiera odwrotny ukosnik, mozna ja osadzic za pomoca \\ lub \e. By umiescic spacje, nalezy uzyc ,,\ " (ukosnik i spacja). Wszelkie inne sekwencje specjalne w pliku-makra, w tym ,,\[rs]", przeciwdzialaja zastepowaniu zapytan zrodlowych przez soelim. W celu obslugi przez soelim, kropka musi wystepowac na poczatku wiersza i musi po niej nastapic ,,so" bez zadnych spacji lub tabulatorow. Konwencja ta pozwala na ,,uchronienie" zapytan zrodlowych przed przetwarzaniem przez soelim np. jako czesc definicji makra lub zapytan ,,if". Pomiedzy ,,so", a jego argumentem pliku-makra musi wystepowac co najmniej jedna spacja. Wymaganie to wylacza opcja -C. Powyzsze wynika z ograniczonego rozumienia jezyka roff przez soelim; nie zastapi on na przyklad wiersza wejsciowego .if 1 .so inny-plik zawartoscia innego-pliku. Za pomoca opcji -r, soelim mozna zatem uzyc do przetwarzania zwyklych plikow tekstowych, do splaszczania drzewa dokumentow wejsciowych. soelim zostal zaprojektowany do obslugi sytuacji, gdy cel zapytania zrodlowego roff wymaga preprocesora, takiego jak eqn(1), pic(1), refer(1), lub tbl(1). Standardowa sekwencja przetwarzania groff(1) jest nastepujaca: input sourced file file | | v v preprocessor --> troff --> postprocessor | v output file To jest, pliki dolaczane za pomoca ,,so" sa zazwyczaj czytane tylko przez program formatujacy troff. soelim nie jest wymagany przez pliki zrodlowe troff. Jesli plik do wczytania takze powinien byc przedprocesowany, musi zostac odczytany zanim pliki wejsciowe przejda przez preprocesor. soelim, wywolywany zwykle za pomoca opcji -s groffa, to obsluguje. input file | v soelim --> preprocessor --> troff --> postprocessor ^ | | v sourced output file file Opcje --help wyswietla pomoc, a -v i --version informacje o wersji; wszystkie koncza dzialanie programu. -C Rozpoznaje wiersze wejsciowe zaczynajace sie od .so, nawet jesli wystepuje po nim znak inny niz spacja lub znak nowego wiersza. -I katalog Przeszukuje katalog pod katem plikow-wejsciowych i plikow-do-wlaczenia. -I zostac okreslona wiecej niz raz; w takim przypadku katalogi sa przeszukiwane w podanej kolejnosci. Aby wyszukac biezacy katalog roboczy przed innymi katalogami, nalezy dodac ,,-I ." " w oczekiwanym miejscu; w innym przypadku jest przeszukiwany na koncu. -r Zapisuje ,,surowe" pliki; nie dodaje zapytan lf. -t Produkuje wiersze komentarza TeX zaczynajace sie od ,,%", wskazujace biezacy plik i numer wiersza, zamiast zadan lf, sluzacych do tego samego celu. Jesli poda sie -r i -t, wazna jest opcja podana jako ostatnia. Zobacz takze groff(1) TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Wojtek Kotwica , Robert Luberda , Szymon Lamkiewicz i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . groff 1.23.0 28 August 2024 soelim(1)