BISON(1) Polecenia uzytkownika BISON(1) NAZWA bison - generator parserow w wersji GNU (zastepuje program yacc) SKLADNIA bison [OPCJA]... PLIK OPIS bison jest generatorem parserow w stylu programu yacc(1) i powinien byc zgodny z plikami wejsciowymi stworzonym dla tego programu. Pliki wejsciowe powinny miec rozszerzenie .y zgodnie z konwencja programu yacc. W przeciwienstwie do plikow tworzonych przez program yacc, pliki wyjsciowe nie maja stalego przedrostka nazw, lecz uzywaja przedrostka nazwy pliku wejsciowego. Na przyklad, plik z opisem gramatyki o nazwie parse.y posluzy do stworzenia parsera w pliku o nazwie parse.tab.c, zamiast y.tab.c, jak w programie yacc. Ten opis opcji rozpoznawanych przez program bison zostal zaadaptowany z rozdzialu Invocation pochodzacego z opisu bison.texi, ktory powinien byc traktowany jako autorytatywne zrodlo informacji. bison rozpoznaje zarowno tradycyjne, jednoliterowe opcje, jak i latwe do zapamietania, dlugie nazwy opcji. Dlugie nazwy opcji rozpoczynaja sie od --, zamiast -. Moga byc one skracane do takiej dlugosci, aby nadal byly unikalne. Jezeli po dlugiej opcji musi nastepowac jej parametr, musi on byc polaczony z nazwa opcji znakiem =. Tworzy deterministyczny analizator skladni LR lub uogolniony LR (GLR) uzywajac tablic LALR(1), IELR(1) lub kanonicznej LR(1). Argumenty, ktore sa obowiazkowe dla dlugich opcji, sa rowniez obowiazkowe dla krotkich. To samo dotyczy argumentow opcjonalnych. Tryby dzialania: -h, --help wyswietla ten tekst i konczy prace -V, --version wyswietla informacje o wersji i konczy dzialanie --print-localedir wyswietla katalog z danymi dotyczacymi lokalizacji i konczy prace --print-datadir wyswietla katalog zawierajacy szkielety i XSLT i konczy prace -u, --update nanosi poprawki w pliku zrodlowym gramatyki i konczy prace -f, --feature[=FUNKCJE] aktywuje rozne funkcje programu FUNKCJE to lista rozdzielonych przecinkami slow sposrod: caret, diagnostics-show-caret bledy ze wskazaniami fixit, diagnostics-parseable-fixits poprawki czytelne dla maszyny syntax-only bez generowania zadnego pliku all wszystkie powyzsze none wylaczenie wszystkich powyzszych Diagnostyka: -W, --warnings[=KATEGORIA] zglasza ostrzezenia dotyczace danej kategorii --color[=KIEDY] okresla czy kolorowac informacje diagnostyczne --style=PLIK okresla PLIK CSS do kolorowania diagnostyki Kategorie ostrzezen obejmuja: conflicts-sr konflikty S/R (wlaczone domyslnie) conflicts-rr konflikty R/R (wlaczone domyslnie) counterexamples, cex generowanie kontrprzykladow konfliktow dangling-alias aliasy lancuchow nie przywiazane do symbolu deprecated przestarzale konstrukcje empty-rule puste reguly bez %empty midrule-values nie ustawione lub nie uzyte wartosci posrednie precedence bezuzyteczne pierwszenstwo i asocjacja yacc niezgodnosc z POSIX Yacc other wszystkie pozostale ostrzezenia (wlaczone domyslnie) all wszystkie ostrzezenia oprocz 'counterexamples', 'dangling-alias' i 'yacc' no-KATEGORIA wylaczenie ostrzezen z KATEGORII none wylaczenie wszystkich ostrzezen error[=KATEGORIA] traktowanie ostrzezen jako bledow KIEDY moze byc jednym z: always, yes kolorowanie wyjscia never, no bez kolorowania wyjscia auto, tty kolorowanie, jesli urzadzeniem wyjsciowym jest tty Dostrajanie analizatora skladni: -L, --language=JEZYK uzywa wyjsciowy jezyk programowania -S, --skeleton=PLIK uzywa podanego szkieletu -t, --debug produkuje analizator do sledzenia to samo, co '-Dparse.trace' --locations wlacza obliczanie lokacji -D, --define=NAZWA[=WARTOSC] podobnie jak '%define NAZWA WARTOSC' -F, --force-define=NAZWA[=WARTOSC] nadpisuje '%define NAZWA WARTOSC' -p, --name-prefix=PREFIKS dopisuje poczatkowy PREFIKS do zewnetrznych symboli zastapione przez '-Dapi.prefix={PREFIKS}' -l, --no-lines zabrania tworzenia dyrektyw '#line' -k, --token-table dolacza tablice nazw symboli leksykalnych -y, --yacc emuluje POSIX Yacc Pliki wyjsciowe: -H, --header=[PLIK] produkuje takze plik naglowkowy -d podobnie, ale bez podania PLIKU (dla POSIX Yacc) -r, --report=LISTA produkuje takze szczegoly na temat automatu --report-file=PLIK zapisuje raport do PLIKU -v, --verbose to samo co '--report=state' -b, --file-prefix=PREFIKS ustaw PREFIKS dla plikow wyjsciowych -o, --output=PLIK przekierowuje wyjscie do PLIKU -g, --graph[=PLIK] produkuje takze graf automatu --html[=PLIK] produkuje takze raport HTML na temat automatu -x, --xml[=PLIK] produkuje takze raport XML na temat automatu -M, --file-prefix-map=STARY=NOWY podmiana prefiksu STARY na NOWY przy zapisie sciezek w plikach wyjsciowych TEMATY to lista rozdzielonych przecinkami slow sposrod: states opis stanow itemsets uzupelnienie zbiorow elementow podstawowych ich domknieciem lookaheads bezposrednie wiazanie wyszukiwanych symboli leksykalnych z elementami solved opis rozwiazywania konfliktow przesuniecie/redukcja counterexamples, cex generowanie kontrprzykladow konfliktow all dolaczenie wszystkich powyzszych informacji none wylaczenie raportu AUTOR Napisany przez Roberta Corbetta i Richarda Stallmana. ZGLASZANIE BLEDOW O bledach programu poinformuj . Strona internetowa GNU Bison: . Ogolna pomoc dotyczaca oprogramowania GNU: . Dla pelnej dokumentacji, uruchom: info bison. PRAWA AUTORSKIE Copyright (C) 2021 Free Software Foundation, Inc. Jest to wolne oprogramowanie; warunki rozpowszechniania znajduja sie w zrodle programu. NIE ma gwarancji, nawet PRZYDATNOSCI HANDLOWEJ czy PRZYDATNOSCI DO OKRESLONEGO CELU. ZOBACZ TAKZE lex(1), flex(1), yacc(1). Pelna dokumentacja dla programu bison jest utrzymywana jako podrecznik Texinfo. Jesli programy info oraz bison sa wlasciwie zainstalowane, polecenie info bison powinno dac dostep do pelnego podrecznika. TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Lukasz Kowalczyk i Robert Luberda 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 . GNU Bison 3.8.2 wrzesien 2021 BISON(1)