Manlifter - Online w chmurze

PROGRAM:

IMIĘ

manlifter - skrypt konwersji masy i wiązka testowa dla docliftera

STRESZCZENIE

dźwigacz [-D opcja] [-e] [-f plik listy] [-Cześć Mandir] [-m] [-M] [-o przewyższyć]
[-P katalog-poprawek] [-P] [-q] [-v] [-s Sekcja] [-X wykluczać] Nazwa...

dźwigacz [-S]

OPIS

dźwigacz to skrypt, który sekwencjonuje doklifter(1) aby przekonwertować całe drzewo strony podręcznika na
XML-Docbook, opcjonalnie także generowanie HTML z XML. Innym zastosowaniem jest
narzędzie do testowania tortur dla docliftera; rejestruje błędy na standardowym wyjściu i zbiera czasy.

Wywoływany bez żadnych argumentów pliku, manlifter próbuje przekonwertować wszystkie odpowiednie strony podręcznika
zainstalowany w systemie, umieszczając wynikowe pliki xml pod xmlman w bieżącym
informator. Każda pomyślnie przetłumaczona strona foo.N jest kopiowana do pliku manN/foo.xml pod
katalog wyjściowy, niezależnie od katalogu źródłowego, z którego pochodzi.

Strona podręcznika jest uważana za niekwalifikującą się do konwersji wsadowej, jeśli zawiera tekst wskazujący:
został wygenerowany z mistrzów DocBook z Doxygen.

Dla każdego zbadanego pliku źródłowego, jeśli plik docelowy istnieje i jest nowszy niż
źródło, konwersja jest pomijana; w ten sposób przyrostowe przebiegi dźwigacz rób najmniej pracy
potrzebne do utrzymania aktualności docelowego drzewa XML. Podobnie, w trybie -h pochodne pliki HTML są
wykonane tylko wtedy, gdy jest to konieczne.

Strony pośredniczące, które są po prostu .so przekierowania są tłumaczone na odpowiednie dowiązania symboliczne XML
pliki (oraz, z opcją -h, pliki HTML).

dźwigacz może być również wywoływany z pojedynczym argumentem plikowym, który jest interpretowany jako rdzeń
nazwa potencjalnej strony podręcznika. dźwigacz następnie przeszukuje wszystkie wybrane sekcje podręcznika pod kątem
pasującą stronę i próbuje ją przekonwertować. W tym przypadku kopia strony podręcznika i
przekonwertowane wersje są upuszczane natychmiast w katalogu wyjściowym, z nazwami
odpowiednio foobar.man i foobar.man.xml. Ten tryb jest zwykle tylko interesujący
do doklifter programiści do debugowania tego programu.

W każdym z powyższych przypadków dźwigacz zdekompresuje plik, jeśli ma .gz, .bz2 lub
Sufiks .Z na nazwie.

Opcje są następujące:

-d
Przekaż argument ciągu do każdego wywołania doclifter jako opcje. Każdy token oddzielony spacjami
w ciągu staje się oddzielnym argumentem w wywołaniu.

-e
Uruchom w trybie filtrowania dziennika (głównie interesujące dla doklifter programiści). W tym trybie
dźwigacz odczytuje dziennik testu ze standardowego wejścia i filtruje go w sposób zależny od
opcje -f i -q. Jeśli żadna z tych informacji nie zostanie podana, komunikaty z udanych przebiegów są
usunięte i tylko błędy przekazywane do standardowego wyjścia.

-f
Normalnie, uruchom doclifter na plikach nazwanych przez każdą linię w pliku argumentów. w
tryb filtrowania błędów argument jest zamiast tego interpretowany jako zwykły filtrujący
wyrażenie.

-h
Generuj również tłumaczenia HTML do katalogu wyjściowego. DocBook Cietrefentry znaczniki
jest przekształcany w hiperłącza w katalogu, a lista zawartości jest generowana do
indeks.html.

-I
Określ katalog główny drzewa stron podręcznika. Domyślnie jest to /usr/share/man.

-m
Zrób łatkę, aby poprawić ostatnią pobraną stronę. Jest kopiowany, wywoływany jest edytor
kopia (za pomocą zmiennej środowiskowej $ EDITOR), i wtedy diff(1) jest wezwany do upuszczenia
łatę w katalogu prepatch. Nie powiedzie się z błędem, jeśli taka łatka już istnieje
prezent.

-M
Podnieś określone pliki, a następnie wykonaj odpowiednik opcji -m.

-o
Ustaw katalog wyjściowy, do którego będą usuwane tłumaczenia XML-DocBook. Za pomocą
domyślnie jest to xmlman w bieżącym katalogu w trybie wsadowym lub bieżący
katalog inaczej.

-p
Zinterpretuj argument jako nazwę katalogu z poprawkami (domyślna nazwa to prepatch
w bieżącym katalogu). Każdy plik o nazwie foo.N.patch jest interpretowany jako łatka do
należy zastosować do strony podręcznika foo(N) zanim doclifter ją przetłumaczy.

-P
Włącz profilowanie za pomocą modułu hotshot Pythona; jest to przydatne tylko do strojenia
doclifter, dzięki czemu działa szybciej. Surowe dane są zapisywane do manlifter.prof, a przetrawione
raport jest dołączany do logu na standardowym wyjściu. Ostrzeżenie: surowe pliki danych mogą:
stają się ogromne, a przetwarzanie końcowe w celu generowania raportów może trwać tak długo, jak
faktyczne przetwarzanie (lub dłużej!).

-q
Zwykle do każdego wywołania docliftera należy przekazać opcję -q (cichy). W trybie filtrowania błędów
zwrócić listę plików, których tłumaczenie nie powiodło się.

-v
Przekaż opcję -v (pełny) do każdego wywołania docliftera. Tę opcję można powtórzyć, aby
zwiększyć poziom szczegółowości.

-s
Określ sekcję do skanowania. Użyj tego z argumentem; nie powinno być konieczne, gdy
robi konwersję całego drzewa.

-S
Skompiluj statystyki błędów z dźwigacz plik dziennika prezentowany na standardowym wejściu. Ten
opcja będzie interesująca głównie dla doklifter programistów.

-X
W trybie wsadowym wyklucz strony wymienione w pliku argumentów. Przeznaczony do użytku na stronach
które są znane dobrze i ich podniesienie zajmuje bardzo dużo czasu, aby zmniejszyć
czas na uruchomienie testowe. (Większość stron unosi się w mniej niż pół sekundy, ale kilka może to zająć
15 minut lub dłużej.)

dźwigacz emituje plik dziennika na standardowe wyjście. Plik zaczyna się od linii sygnatury czasowej i
pusta linia, a kończy się linią podającą czas działania i różne ciekawe statystyki.
Pomiędzy nimi znajdują się strofy oddzielone pustymi liniami, po jednej dla każdego pliku, na którym doklifter
został uruchomiony.

Pierwszy wiersz każdej zwrotki zaczyna się od „!”, po którym następuje ścieżka do źródła
manual pager, po którym następuje „=” i status powrotu docliftera uruchamiany na tym pliku.
Po tym jest przestrzeń i doklifterczas pracy w sekundach.

Po tym wierszu początkowym mogą następować komunikaty informacyjne i wyjście błędu funkcji
bieg doktorski.

dźwigacz musi znaleźć kopię doklifter w bieżącym katalogu lub jednym z
katalogi poleceń w twoim PATH aby biec.

Korzystaj z manlifter online za pomocą usług onworks.net