metalint — online w chmurze

PROGRAM:

IMIĘ

metalint - narzędzie do sprawdzania spójności jednostek metaconfig

STRESZCZENIE

metalint [-hklsV ] [ -L reż ]

OPIS

Metalint analizuje jednostki i przeprowadza szczegółowe kontrole spójności, aby upewnić się, że
cały zestaw jest sprawny. Ze względu na stosunkowo ogromną ilość dostępnych jednostek staje się
bardzo trudna jest ręczna konserwacja jednostek, a zautomatyzowany proces może być realny
pomoc, choć nie doskonała.

Metalint działa z katalogu pakietu najwyższego poziomu i służy do upewnienia się
twoje własne prywatne jednostki poprawnie polegają na publicznie dostępnych jednostkach. Jeśli ty
intensywnie rozwijać nowe jednostki, powinieneś uciekać metalint na nich przed ich upublicznieniem
dostępny.

OPCJE

Metalint rozpoznaje następujący zestaw opcji:

-h Wydrukuj krótki opis użycia i wyjdź.

-k Zachowaj tymczasowe .MT katalogiem.

-l (jeszcze nie zaimplementowane) Domyślnie metalint zgłasza tylko problemy związane z
swoje prywatne jednostki. Ten przełącznik kieruje metalint też zgłosić
problemy w jednostkach ogólnodostępnych.

-s Tryb cichy.

-L reż Zastąp domyślną lokalizację biblioteki. Zwykle przydatne tylko dla metaconfig
opiekunów, aby lokalnie sprawdzali opracowywane jednostki zamiast
te ogólnodostępne. The reż określony to ten, który zawiera jednostki
U katalogiem.

-V Wydrukuj numer wersji i wyjdź.

DIAGNOSTYKA

Następujące komunikaty diagnostyczne mogą być emitowane przez metalint:

"(?MAKE) ignoruje zduplikowaną linię listy zależności."
W jednostce znaleziono więcej niż jedną zależność namiaru linii ?MAKE:. Może być
tylko jedna taka linia, chociaż może wystąpić wiele linii akcji ?MAKE.

„(? MAKE) jednostka specjalna„ Xxx ”nie powinna być wymieniona jako wyprodukowana”.
Symbol jednostki specjalnej (pierwsza litera pisana wielką literą) może być wymieniony tylko w takiej formie, w jakiej został wykonany w
sama jednostka specjalna. Aby ukryć to ostrzeżenie w uzasadnionych przypadkach, dodaj „+” z przodu
obraźliwego symbolu (zwróć uwagę, że w przypadku jednostek innych niż specjalne „+” w tym miejscu
wskazuje wewnętrzny symbol, który nie powinien pojawić się w pliku config.sh).

„(?MAKE) „+xxx” jest wymienione x razy.”
Zależność warunkowa jest wymieniona więcej niż jeden raz. To jest jednak nieszkodliwe.

"(?MAKE) 'xxx' jest wymienione x razy."
Normalna zależność jest wymieniona więcej niż jeden raz. Znowu niegroźny błąd.

„(?MAKE) 'xxx' wymienione jako zależność warunkowa i pełna."
Symbol jest wymieniony jako zależność normalna i warunkowa. Metakonfiguracja będzie
uważaj to za pełną zależność, ale może to nie być to, co początkowo
poszukiwany...

„(? Y) nieznana dyrektywa układu„ xxx ”.”
Dyrektywy układu mogą być tylko jedną z nich Top, domyślnym or dolny, ale przypadek nie
materiał. Nieznana dyrektywa jest po prostu ignorowana i traktowana tak, jakby domyślnym było
określony.

"(?S) zduplikowany opis dla zmiennej '$xxx'."
Symbol powłoki jest opisany więcej niż jeden raz, co spowoduje powstanie dwóch wpisów w pliku
Słownik.

"(?S) zmienna '$xxx' nie jest wymieniona w wierszu ?MAKE:."
Jednostka opisuje wpis symbolu powłoki, którego nie można używać zewnętrznie, ponieważ nie
wymienione jako zależność.

„(?S) błąd składniowy w konstrukcji ?S:”.
Samowyjaśniające się.

"(?C) zduplikowany opis dla symbolu 'XXX'."
Symbol C jest opisany więcej niż jeden raz, co spowoduje utworzenie dla niego dwóch wpisów w pliku
Słownik.

„(?C) błąd składniowy w konstrukcji ?C:”.
Samowyjaśniające się.

"(?H) symbol 'XXX' został już zdefiniowany."
Najwyraźniej dwie linie ?H: definiują ten sam symbol C.

„(?H) zmienna „$xxx” nie jest nawet wymieniona w wierszu ?MAKE:.
Zmienna jest używana, ale nie jest wymieniona w wierszu zależności.

"(?H) sekcja została już zakończona przez '?H:.'."
Nie może być więcej linii ?H: po pierwszym '?H:.' zaznaczając koniec tego


"(?H) niezwykła linia cpp powinna być chroniona przez '?%<:'."
Wszystkie ?H: linie rozpoznawane przez metakonfiguracja i tym samym metalint mieć ich
włączenie w config.h jest automatycznie chronione odpowiednim symbolem, jeśli żaden nie jest
pod warunkiem, że. Jednak nierozpoznane linie muszą być chronione sekwencją „?%<:”.
unikaj ich włączania, jeśli urządzenie nie zostanie załadowane w programie Configure.

„(?H) wiersz nie powinien być wymieniony tutaj, ale w „?C:”.
W sekcji ?H: powinny pojawić się tylko wiersze cpp. Jeśli masz komentarz do umieszczenia
w odniesieniu do symbolu użyj ?C:. Jeśli chcesz skomentować konkretną generację
sekwencję, umieść je w komentarzu ?X:, aby nie trafiły do ​​config.h.

„(?H) ograniczenie„ xxx ”jest nieznanym symbolem”.
Wszystkie wiodące ograniczenia ?sym: na liniach ?H: powinny być poprawną powłoką lub C
symbol zdefiniowany w jednostce.

"(?M) błąd składniowy w ?M: konstrukcja."
Samowyjaśniające się.

„(?M) symbol„ xxx ”jest już wymieniony w wierszu ?M: w„ yyy ”.”
Podjęto próbę magicznej definicji symbolu xxx, ale podano już inną
w jednostce rrrr.

„(?V) widoczna deklaracja w jednostkach niespecjalnych została zignorowana.”
Widoczne deklaracje (?V: linie) mogą pojawiać się tylko w jednostkach specjalnych. Inaczej oni
są bez sensu.

„(? V) poszukiwana zmienna „$xxx” stała się widoczna.”
Nie można utworzyć żądanej zmiennej (opisanej jako zależność od wiersza ?MAKE:).
widoczny, bo to nie ma sensu: jednostka nie może na nim polegać i wtedy
reklamuj go jako zdefiniowany lokalnie.

"(?V) zdefiniowana zmienna '$xxx' stała się widoczna."
Zdefiniowana zmienna (wyświetlona jako wykonana w wierszu ?MAKE:) nie może być widoczna, ponieważ
równie dobrze może być bezpośrednio poszukiwany w innej jednostce.

„(?V) zmienna „$xxx” jest już widoczna w jednostce yyy.”
Niespójna deklaracja: dwie jednostki sprawiają, że jeden symbol jest widoczny...

„(?V) zmienna „$xxx” jest już widoczna do odczytu i zapisu w yyy.”
Zmienna została już uwidoczniona jako odczyt i zapis przez inną jednostkę.

„(?V) zmienna „$xxx” jest już widoczna tylko do odczytu w rrrr.”
Zmienna została już uwidoczniona jako tylko do odczytu przez inną jednostkę.

„(?W) zmienna „$xxx” już jest poszukiwana.”
Zmienna jest już pożądana, nie ma potrzeby wyraźnego proszenia o nią tutaj.

"(?W) zmienna '$xxx' również zdefiniowana lokalnie."
Pożądana zmienna powodowałaby konflikt ze zmienną zdefiniowaną lokalnie i mogłaby spowodować
uzyskanie wartości śmieci.

„(?W) zmienna „$xxx” jest już wymieniona w wierszu „W: w„ yyy ”.”
Zmienna w sekcji symbolu powłoki linii ?W: może występować tylko w jednej jednostce.

„(? F) wygenerował plik„ xxx ”wielokrotnie zadeklarowany.”
Plik jest wymieniony więcej niż jeden raz w wierszu ?F: pod tą samą nazwą. To ma
nie pojawiają się podczas deklarowania zarówno prywatnego pliku UU, jak i pliku publicznego z tym samym
imię np.

„(?F) plik UU w jednostce niespecjalnej został zignorowany.”
Prywatne pliki UU (tj. pliki takie jak mójprzeczytany skrypt stworzony do późniejszego przejrzenia przez
Konfigurowanie) można tworzyć tylko w jednostkach specjalnych. Dozwolone są wyjątki, jeśli linia ?F:
jest poprzedzone odpowiednią wskazówką ?LINT:.

„(?T) tymczasowy symbol„ $xxx ”zadeklarowano mnożenie.”
Samowyjaśniające się.

"dyrektywa powinna następować po deklaracjach ?ZRÓB."
Dyrektywa wymieniona między () na początku tej wiadomości powinna naprawdę nadejść
po ?MAKE: linie. Należy ponownie zamówić urządzenie lub metalint nie będzie w stanie
prawidłowo zdiagnozować problemy.

"sekwencja kontrolna '?XXX:' zignorowana w ciele."
Spróbuj użyć linii kontrolnej innej niż ?X: lub ?LINT: w korpusie urządzenia, która powinna
być tylko kodem powłoki

"zmienna '$xxx' została zmieniona."
Zmienna wymieniona jako pożądana w wierszu zależności została zmieniona. Taka zmienna powinna
być tylko do odczytu dla jednostki. Użyj zmiana lint podpowiedź, aby ukryć tę wiadomość
przypadki patologiczne.

"nie ?MAKE: linia opisująca zależności."
Każda jednostka powinna mieć linię zależności, w przeciwnym razie zostanie po cichu zignorowana przez
metakonfiguracja. Ta wiadomość jest pomijana przez ?LINT: pusta wskazówka.

„pierwsza linia treści powinna być ogólnym „: opisem”.
Pierwsza linia powłoki jednostki, która zostanie dodana do wygenerowanej konfiguracji
skrypt powinien zawierać opis przeznaczenia jednostki w linii ':'. Musi być
spacja po „:”, ponieważ jest interpretowana przez powłokę i opis
powinien unikać metaznaków, takich jak „(” lub „>”, chyba że cały ciąg znaków jest ujęty w cudzysłów. To
wiadomość jest pomijana przez wskazówkę ?LINT: nocomment.

„brakuje spacji po „:”, aby dodać komentarz”.
Wiersz zaczynający się od ':' jest interpretowany przez powłokę, ale będzie ignorowany. Tam musi
być jednak spacją po „:”, w przeciwnym razie powłoka spróbuje wykonać niewiadomą
Komenda...

„znaleziono niecytowany metaznak > w wierszu komentarza”.
Linia zaczynająca się od ':' jest interpretowana przez powłokę, ale będzie ignorowana. To znaczy
że znaczące metaznaki, takie jak „(” lub „>”, muszą być ujęte w cudzysłowy lub poprzedzone znakiem a
wiodący ukośnik odwrotny.

„Znaleziono wiszący cytat w wierszu komentarza „:”.
Niezamknięty pojedynczy lub podwójny cudzysłów został zauważony w wierszu komentarza „:”. Od tamtych
wiersze są interpretowane przez powłokę, chociaż są ignorowane, wszystkie cudzysłowy muszą idealnie pasować.

„nie kończy się pustą linią”.
Ponieważ wszystkie jednostki są zebrane razem, tworząc jeden duży scenariusz, jest to zalecane
(stąd egzekwowane przez metalint), aby każdy plik jednostki kończył się pustą linią.

„ostatnia linia nie kończy się znakiem nowej linii”.
Jest to przeznaczone tylko dla użytkowników, których edytor nie zawsze dodaje znak nowej linii w
koniec plików tekstowych. Nie powinno się zdarzyć, gdy używasz vi.

„symbol„ $xxx ”nie został opisany.”
Symbol powłoki zdefiniowany przez tę jednostkę nie został udokumentowany. Użyj opisać wskazówka kłaczków
stłumić tę wiadomość.

"Symbol C 'XXX' nie został opisany."
Symbol C zdefiniowany przez tę jednostkę nie został udokumentowany. Użyj znany wskazówka do kłaczków
stłumić tę wiadomość.

„Symbol C„ XXX ”nie został zdefiniowany przez żadną linię ?H:”.
Symbol AC został ogłoszony przez nigdy nie zdefiniowany, stąd nie może pojawić się w konfiguracja.h
plik i dlatego jest bezużyteczny ...

„zmienna„ $xxx ”powinna była zostać ustawiona.”
Zmienna wymieniona w wierszu make jako utworzona przez jednostkę nie została ustawiona przez kod powłoki
ciało. Użyj zestaw lint podpowiedź, aby ukryć tę wiadomość w przypadkach patologicznych.

„nieużywana zmienna zależności„ $xxx ”.”
Najwyraźniej nie używa się zmiennej powłoki. Użyj zmiana or posługiwać się wskazówki dotyczące kłaczków
(w zależności od sytuacji), aby ukryć tę wiadomość.

„nieużywana zmienna warunkowa„ $xxx ”.
Najwyraźniej ta warunkowa zależność nie jest używana. The zmiana or posługiwać się szarpie
podpowiedzi mogą być użyte do pominięcia tego komunikatu.

„nieużywana zmienna tymczasowa„ $xxx ”.”
Zmienna zadeklarowana jako tymczasowa w wierszu ?T: nie jest używana. The posługiwać się wskazówka kłaczków będzie
oszukać metalint do myślenia, że ​​rzeczywiście jest używany.

"nieznana sekwencja kontrolna '?XXX:'."
Próba użycia nieznanej sekwencji sterującej.

„nieznane żądanie LINT„ fałszywe ”zignorowano”.
Użyto nieznanego znacznika ?LINT:. Wszystkie takie znaczniki muszą być pisane małymi literami.

„symbol„ $xxx ”nie ma wartości domyślnej.”
Symbol używany jako zależność warunkowa w jakiejś jednostce nie ma wartości domyślnej ustawionej przez a
?D: linia.

"nieaktualny? MAKE: zależność 'xxx'."
Jednostka wymienia symbol jako zależność, ale ten symbol jest poza tym nieznany, tj
nigdy nie pojawia się jako wykonany przez jakąkolwiek inną jednostkę.

„Brak symbolu „$xxx” w ?MAKE.
Użyty lub zdefiniowany symbol nie został wymieniony jako zależność w wierszu ?MAKE:.

„brakuje xxx z? MAKE dla widocznego„ $yyy ”.”
Używany jest symbol zdefiniowany jako widoczny przez jednostkę specjalną, ale ta jednostka specjalna nie
część linii zależności.

"nieaktualny? M: zależność 'xxx'."
Magiczna linia wymienia symbol C jako zależność, ale ten symbol nie jest znany żadnej jednostce.

„nieznany symbol„ $xxx ”.”
Nie mam pojęcia co to za symbol. Jeśli zmienna jest zdefiniowana zewnętrznie, this
ostrzeżenie może zostać stłumione przez odpowiedni ?LINT: extern.

„Ustawiono symbol tylko do odczytu„ $xxx ”.
Symbol, który powinien być tylko do odczytu, jest ustawiany przez kod powłoki jednostki.

„używany jest przestarzały symbol„ xxx ”.
W kodzie powłoki jednostki zastosowano przestarzały symbol.

„Ustawiono niezadeklarowany symbol„ $xxx ”.
Jednostka próbuje ustawić zmienną powłoki, która nie została zadeklarowana jako wykonana
lub jako zmienna tymczasowa, czy cokolwiek innego.

„niezamknięta ?H: sekcja”.
Sekcja ?H: nie została zakończona ani jednym „?H:”. linia przed korpusem
jednostka lub początek innej sekcji ?C:.

"Symbol C 'xxx' jest zdefiniowany w następujących jednostkach:"
Symbol C jest zdefiniowany w więcej niż jednej jednostce. Wymieniono jednostki naruszające prawo.

"Symbol powłoki 'xxx' jest zdefiniowany w następujących jednostkach:"
Symbol powłoki jest zdefiniowany w więcej niż jednej jednostce. Jednostki atakujące podążają za nimi.

„Symbol powłoki„ xxx ”to w sumie:”
Symbol powłoki jest definiowany przez niektóre jednostki, przestarzały przez inne i używany jako tymczasowy.

„Symbol powłoki„ xxx ”jest zarówno zdefiniowany, jak i przestarzały:”
Samowyjaśniające się.

„Symbol powłoki„ xxx ”jest zarówno zdefiniowany, jak i używany jako tymczasowy:”
Samowyjaśniające się.

„Symbol powłoki„ xxx ”przestarzały, używany również jako tymczasowy:”
Samowyjaśniające się.

"definicja '$xxx' nie jest zamknięta przez '?S:.'."
Samowyjaśniające się.

"definicja 'XXX' nie jest zamknięta przez '?C:.'."
Samowyjaśniające się.

„magiczna definicja„ xxx ”nie jest zamknięta przez„?M:.'.”
Samowyjaśniające się.

"zmienna '$xxx' jest zdefiniowana zewnętrznie."
Używana jest zmienna zdefiniowana zewnętrznie (tj. w innej jednostce), bez odpowiedniej
informacje o zależnościach. Użyj zewnętrzny lint podpowiedź, aby ukryć tę wiadomość.

„plik„ xxx ”nie został utworzony.”
Plik wymieniony jako prywatny plik UU nie jest tworzony przez jednostkę specjalną. Stworzenie jest
wykryte przez jawne przekierowanie powłoki do pliku, a nie przez niejawne
tworzenie (jak na przykład kompilacja C). Wszystkie jednostki specjalne powinny
i tak twórz jawnie tylko skrypty powłoki, więc tej wiadomości nie można ukryć za pomocą
wskazówka kłaczków.

„Plik lokalny„ xxx ”może zastąpić plik ustawiony przez„ unit.U ”.
Próbujesz utworzyć plik lokalny, ale jednostka specjalna tworzy jeden kierunek
dokładnie ta sama nazwa i czy powinna być ładowana przed wewnątrz Konfigurowanie, tak byś
zastąpić ten plik. Zmień nazwę pliku lokalnego.

„nieużywany plik tymczasowy„ xxx ”.
Plik został zadeklarowany w wierszu ?F:, ale nie wydaje się być nigdzie używany.

„niewłaściwie użyty plik tymczasowy„ xxx ”.
Lokalny plik tymczasowy został zadeklarowany w linii ?F: i jest używany w taki sposób
może nie być tym właściwym. Rzeczywiście, wszystkie takie lokalne pliki powinny być wywoływane z rozszerzeniem
wyraźna ścieżka względna, aby uniknąć wyszukiwań PATH, które mogłyby dać ci inny plik.

„nie zawsze możesz otrzymać plik„ xxx ”z„ unit.U ”.”
Wygląda na to, że dzwonisz do określonego pliku, ale nie za pomocą jawnego pliku względnego
nazwa ścieżki. Poleganie na zmiennej PATH w celu znalezienia tego pliku nie jest bezpieczne. Aby rozwiązać ten problem,
wywołaj swój plik, używając czegoś takiego jak ./xxx.

„brakuje jednostki z? MAKE dla pliku prywatnego„ xxx ”.”
Używasz prywatnego pliku UU bez wyszczególnienia jednostki specjalnej, która go tworzy
swoją linię zależności. Dodaj jednostkę do listy zależności.

„nieznany plik prywatny„ xxx ”.”
Plik nie pojawia się w żadnej linii ?F:; jednak powinno.

"Plik 'xxx' jest zdefiniowany w następujących jednostkach:"
Wymienione jednostki nie wydają się zgadzać co do tego, kto definiuje plik.

„puste tutaj — nazwa dokumentu odradzana”.
Powinieneś powstrzymać się od używania pustych nazw dla tutaj dokumentów, jak metalint nie będzie
monitorować te.

„niezamknięty tutaj dokument xxx rozpoczął wiersz x”.
Otwarty tutaj dokument w wierszu x nigdy nie został zamknięty w tej jednostce. To ogólnie
oznaczają, że gdy jednostka jest używana, wygenerowany skrypt nie będzie działał!

„fałszywa dyrektywa„ LINT xxx ”.
Wstawiłeś dyrektywę ?LINT:, która nie jest używana do zamykania ostrzeżeń.

„Znaleziono cykl dla:”
Znaleziono cykl zależności dla wymienionych symboli. Tylko zaangażowane symbole
w cyklu są wymienione.

„Cykl obejmuje:”
Wyciąg z zależności, w których cykl został znaleziony, jest wymieniony. Może to dotyczyć
znacznie więcej symboli niż poprzednia wiadomość, ponieważ metalint faktycznie ponownie skanuje
zasady podkreślają cykl i zatrzymuje się, gdy taki znajdzie, tj. nie znajdzie
spróbuj go zminimalizować (cykl znajduje się przy użyciu innego algorytmu, który niestety
nie może tego wypluć, ale tylko powiedzieć na pewno, że jest jeden).

REFERENCE

Metalint używa następujących wierszy kontrolnych, które w przeciwnym razie są ignorowane przez metakonfiguracja:

?V:tylko do odczytu symbole:czytać i pisać symbole
Ta linia powinna być używana tylko w jednostkach specjalnych. Zawiera listę wszystkich zmiennych powłoki
zdefiniowane przez jednostkę, które nie powinny być używane bezpośrednio jako zależności przez inne jednostki:
muszą uwzględnić tę specjalną jednostkę na swojej liście zależności, jeśli z jakiejś korzystają
opisanych tu symboli. Można je postrzegać jako wyeksportowane symbole, które ty
dziedziczyć po, gdy zależy od jednostki. Symbole mogą być eksportowane tylko do odczytu lub
odczyt-zapis.

?F:pliki stworzony
Ta linia służy dwóm celom: jest to a metalint wskazówka, a także symbol zastępczy dla
przyszłość zrób używać. Musi zawierać trzy rodzaje plików: tymczasowe, które są
utworzone do testu, prywatne UU utworzone w katalogu UU na później
perusal i publiczne pozostawione w katalogu głównym pakietu. Tymczasowy
pliki muszą być wymienione z poprzedzającym '!' znak (co oznacza „nie! nie są ponownie używane
później!”), prywatne pliki UU powinny być poprzedzone znakiem „./” (co oznacza: aby ich użyć, powiedzmy
./plikNie tylko filet), a publiczne powinny mieć nazwę taką, jaka jest.

?T:powłoka prowizorium
Ta linia powinna zawierać listę wszystkich zmiennych powłoki używanych jako tymczasowe w jednostce
ciało. Ta linia powinna być dokładna i zapobiega zapisywaniu jednostek
zdefiniowanie symbolu, który byłby używany jako zmienna podstawowa w innej jednostce...

?SZARPIE:keyword lista_symbolów
Określa wskazówkę dotyczącą kłaczków. Dostępne są następujące słowa kluczowe:

zmiana zmienna powłoki ok do zmiany
Stwórz trwały plik może zostać utworzony przez jednostkę niespecjalną
określić wymienione zmienne powłoki są zdefiniowane w tej jednostce
opisać wymienione zmienne powłoki są opisane przez ?S:
zewnętrzny zmienna, o której wiadomo, że jest zdefiniowana zewnętrznie
pusty unit jest pusty i jest przechowywany tylko jako symbol zastępczy.
znany wymienione zmienne C są opisane
bez komentarza unit jest specjalny i może brakować wiodącej linii „: opis”.
nie tutaj wymienione nazwy nie są tutaj dokumentami (np. "1 << foo" w C
program)
zestaw wymienione zmienne są ustawione
posługiwać się wymienione zmienne są używane przez to urządzenie
niezamknięty wymienione nazwy dokumentów tutaj nie są zamknięte w tej jednostce
plik użytkowy wymieniony plik jest używany (nie dodawaj przed nazwą '!' dla pliku tymczasowego
jedynki)

AUTORSKI

Harlana Stenna[email chroniony]> napisał pierwszą wersję, opartą na Larrym Wall'u
metakonfiguracja z odległości 2.0.
Raphael Manfredi[email chroniony]> przepisałem go od podstaw dla 3.0 z kilkoma
ulepszenia.

Używaj metalint online za pomocą usług onworks.net