metalint - Online en la nube

PROGRAMA:

NOMBRE

metalint: un verificador de coherencia de unidades de metaconfiguración

SINOPSIS

metalint [-hklsv ] [-L dir ]

DESCRIPCIÓN

metalint analiza las unidades y realiza algunas comprobaciones exhaustivas de coherencia, para asegurarse de que
todo el conjunto es sólido. Debido a la cantidad relativamente grande de unidades disponibles, se está volviendo
Es muy difícil mantener las unidades manualmente, y un proceso automatizado puede ser de real
ayuda, aunque no perfecta.

metalint opera desde el directorio de paquetes de nivel superior y se utiliza para asegurarse
sus propias unidades privadas se basan correctamente en las unidades disponibles públicamente. Si tu
desarrollar intensamente nuevas unidades, debe ejecutar metalint sobre ellos antes de hacerlos públicamente
para todos.

OPCIONES

metalint reconoce el siguiente conjunto de opciones:

-h Imprima una breve descripción de uso y salga.

-k Mantener temporal .MONTE directorio.

-l (aún no implementado) De forma predeterminada, metalint solo informa problemas relacionados con
sus propias unidades privadas. Este interruptor dirige metalint para informar también
problemas en unidades disponibles públicamente.

-s Modo silencioso.

-L dir Anula la ubicación de la biblioteca predeterminada. Normalmente solo es útil para metaconfig.
mantenedores para comprobar localmente las unidades que se están desarrollando en lugar de la
los disponibles públicamente. los dir especificado es el que contiene las unidades
U directorio.

-V Imprime el número de versión y sal.

La diagnostica

Los siguientes diagnósticos pueden ser emitidos por metalint:

"(? MAKE) ignorando la línea de lista de dependencias duplicada".
¿Más de una? MAKE: se encontraron dependencias de cojinetes de línea en la unidad. Puede haber
sólo una de esas líneas, aunque pueden aparecer varias líneas de acción? MAKE.

"(? MAKE) la unidad especial 'Xxx' no debe aparecer como hecha."
Un símbolo de unidad especial (la primera letra en mayúscula) solo puede aparecer como hecho en el
propia unidad especial. Para suprimir esta advertencia en casos legítimos, agregue un '+' al frente
del símbolo infractor (tenga en cuenta que para las unidades no especiales, el '+' en esta posición
indica un símbolo interno que no debería aparecer en el archivo config.sh).

"(? MAKE) '+ xxx' aparece x veces".
Una dependencia condicional se enumera más de una vez. Sin embargo, esto es inofensivo.

"(? MAKE) 'xxx' aparece x veces."
Una dependencia normal aparece más de una vez. De nuevo, un error inofensivo.

"(? MAKE) 'xxx' aparece como dependencia condicional y completa."
El símbolo se enumera como una dependencia normal y como una condicional. Metaconfiguración will
Considere esto como una dependencia total, pero puede que no sea lo que inicialmente
deseado...

"(? Y) directiva de diseño desconocida 'xxx'."
Las directivas de diseño solo pueden ser una de parte superior, tu préstamo estudiantil or fondo, pero el caso no
importar. Una directiva desconocida simplemente se ignora y se maneja como si tu préstamo estudiantil y destilado
especificado.

"(? S) descripción duplicada para la variable '$ xxx'."
El símbolo de la cáscara se describe más de una vez, y eso producirá dos entradas en el
Glosario.

"La variable (? S) '$ xxx' no aparece en la línea? MAKE:".
La unidad describe una entrada de símbolo de shell que no se puede utilizar externamente porque no
enumerado como una dependencia.

"(? S) error de sintaxis en? S: construct."
Autoexplicativo.

"(? C) descripción duplicada para el símbolo 'XXX'."
El símbolo C se describe más de una vez, y eso producirá dos entradas para él en el
Glosario.

"(? C) error de sintaxis en? C: construct."
Autoexplicativo.

"(? H) símbolo 'XXX' ya estaba definido."
Aparentemente, dos líneas? H: definen el mismo símbolo C.

"(? H) variable '$ xxx' ni siquiera aparece en la línea? MAKE:".
Se utiliza una variable, pero no aparece en la línea de dependencia.

"La sección (? H) ya estaba terminada por '? H :.'".
No puede haber más? H: líneas después del primer '? H :.' marcando el final de eso
.

"(? H) la línea cpp poco común debe protegerse con '?% <:'."
¿Todas? H: líneas que son reconocidas por metaconfiguración en los demás. metalint tienen su
inclusión en config.h protegido automáticamente por un símbolo adecuado si no hay ninguno
previsto. Sin embargo, las líneas no reconocidas deben protegerse con la secuencia '?% <:' Para
evite su inclusión en caso de que la unidad no se cargue en Configurar.

"La línea (? H) no debería aparecer aquí, sino en '? C:'".
Solo las líneas cpp deben aparecer en la sección? H :. Si tienes un comentario para poner
con respecto al símbolo, utilice? C :. Si quieres comentar una generación en particular
secuencia, colóquelos en? X: comment para que no se incluyan en config.h.

"(? H) la restricción 'xxx' es un símbolo desconocido."
Todas las restricciones? Sym: principales en las líneas? H: deben ser un shell válido o C
símbolo, definido en la unidad.

"(? M) error de sintaxis en? M: construir".
Autoexplicativo.

"(? M) símbolo 'xxx' ya aparece en una línea? M: en 'yyy'."
Se intenta una definición mágica para el símbolo xxx, pero ya se proporcionó otra.
en la unidad yyy.

"(? V) declaración visible en unidad no especial ignorada".
Las declaraciones visibles (? V: líneas) solo pueden aparecer en unidades especiales. De lo contrario, ellos
no tienen sentido.

"(? V) se hizo visible la variable deseada '$ xxx'."
No se puede crear una variable deseada (descrita como una dependencia de la línea? MAKE:)
visible ya que eso no tiene ningún sentido: la unidad no puede depender de él y luego
anunciarlo como definido localmente.

"(? V) la variable definida '$ xxx' se hace visible".
Una variable definida (listada como hecha en la línea? MAKE:) no se puede hacer visible, ya que
también podría ser buscado directamente en otra unidad.

"(? V) variable '$ xxx' ya visible por unidad yyy."
Declaración inconsistente: dos unidades hacen visible un solo símbolo ...

"(? V) variable '$ xxx' ya visible de lectura y escritura en yyy."
La variable ya se hizo visible como lectura-escritura por otra unidad.

"(? V) la variable '$ xxx' ya es de solo lectura visible en yyy."
Otra unidad ya hizo visible la variable como de solo lectura.

"(? W) la variable '$ xxx' ya se busca".
La variable ya se desea, no es necesario solicitarla explícitamente aquí.

"(? W) variable '$ xxx' también definida localmente."
Una variable deseada entraría en conflicto con una variable definida localmente y podría resultar en
obteniendo un valor basura.

"(? W) variable '$ xxx' ya aparece en una línea? W: en 'yyy'."
La variable en la sección de símbolo de shell de una línea? W: solo puede aparecer en una unidad.

"(? F) archivo producido 'xxx' declarado mutuamente."
El archivo aparece más de una vez en la línea? F:, con el mismo nombre. Esto hace
no aparecen al declarar un archivo UU privado y un archivo público con el mismo
nombre, por ejemplo.

"(? F) Archivo UU en unidad no especial ignorado."
Archivos UU privados (es decir, archivos como el mi lectura guión creado para su posterior lectura por
Configurar) solo se pueden crear en unidades especiales. Se permiten excepciones si la línea? F:
está precedido por una sugerencia? LINT: adecuada.

"(? T) símbolo temporal '$ xxx' declarado multiplicado."
Autoexplicativo.

"¿La directiva debe venir después? HAGA declaraciones".
La directiva listada entre () al principio de este mensaje realmente debería venir
después de las líneas? MAKE :. Debe volver a pedir la unidad o metalint no seré capaz de
diagnosticar correctamente los problemas.

"secuencia de control '? XXX:' ignorada dentro del cuerpo."
Intente utilizar una línea de control que no sea? X: o? LINT: en el cuerpo de la unidad, que debería
ser solo código shell

"La variable '$ xxx' ha cambiado".
Se cambia una variable listada como deseada en la línea de dependencia. Tal variable debería
ser de solo lectura para la unidad. Utilizar el el cambio pista de pelusa para suprimir este mensaje en
casos patológicos.

"¿no? MAKE: línea que describe las dependencias".
Cada unidad debe tener una línea de dependencia, o será ignorada silenciosamente por
metaconfiguración. Este mensaje está suprimido por un? LINT: sugerencia vacía.

"La primera línea del cuerpo debe ser un ': descripción' general".
La primera línea de shell de la unidad que se agregará al Configure generado
El guión debe contener una descripción del propósito de la unidad, en una línea ':'. Debe haber
un espacio después de ':', ya que es interpretado por el shell, y la descripción
debe evitar los metacaracteres como '(' o '>' a menos que se cite toda la cadena.
el mensaje está suprimido por un? LINT: sin sugerencia de comentario.

"falta un espacio después de ':' para convertirlo en un comentario".
Una línea que comienza por ':' es interpretada por el shell pero será ignorada. Debería
ser un espacio después del ':' sin embargo, o el shell intentará ejecutar un desconocido
mando...

"se encontró un metacarácter> sin comillas en la línea de comentario".
Una línea que comienza por ':' es interpretada por el shell pero será ignorada. Esto significa
que los metacaracteres significativos como '(' o '>' deben citarse o escaparse con un
barra invertida inicial.

"Se encontró una cita colgante en la línea de comentario ':'".
Se vio una comilla simple o doble sin cerrar en una línea de comentario ':'. Ya que esos
Las líneas son interpretadas por el shell, aunque ignoradas, todas las comillas deben coincidir perfectamente.

"sin terminar con una línea en blanco".
Dado que todas las unidades se reúnen para formar un gran guión, se recomienda
(por lo tanto, impuesto por metalint) que cada archivo unitario termina con una línea vacía.

"la última línea no termina con un carácter de nueva línea".
Esto está destinado simplemente a usuarios cuyo editor no siempre agrega una nueva línea en
el final de los archivos de texto. No debería suceder cuando usa vi.

"El símbolo '$ xxx' no se describió".
El símbolo de la cáscara definido por esta unidad no se documentó. Utilizar el describir pista de pelusa
para suprimir este mensaje.

"El símbolo C 'XXX' no se describió".
El símbolo C definido por esta unidad no se documentó. Utilizar el known pista de pelusa para
suprimir este mensaje.

"El símbolo C 'XXX' no fue definido por ninguna línea? H:".
El símbolo de CA fue anunciado por nunca definido, por lo que no puede aparecer en el configuración.h
archivo y por lo tanto es inútil ...

"Se debería haber configurado la variable '$ xxx'."
Una variable listada en la línea make como hecha por la unidad no fue establecida por el código de shell
cuerpo. Utilizar el . Pista de pista para suprimir este mensaje en casos patológicos.

"variable de dependencia no utilizada '$ xxx'."
Aparentemente, no se hace uso de una variable de shell. Utilizar el el cambio or use pistas de pelusa
(dependiendo de la situación) para suprimir este mensaje.

"variable condicional no utilizada '$ xxx'.
Aparentemente, no se hace uso de esta dependencia condicional. los el cambio or use hilas
se pueden utilizar sugerencias para suprimir este mensaje.

"variable temporal no utilizada '$ xxx'".
Una variable declarada como temporal en una línea? T: no se utiliza. los use la pista de pelusa lo hará
engañar metalint en pensar que de hecho se usa.

"secuencia de control desconocida '? XXX:'."
Intente utilizar una secuencia de control desconocida.

"solicitud LINT desconocida 'falsa' ignorada".
Se utilizó una etiqueta? LINT: desconocida. Todas estas etiquetas deben estar escritas en minúsculas.

"El símbolo '$ xxx' no tiene un valor predeterminado".
Un símbolo utilizado como dependencia condicional en alguna unidad no tiene un valor predeterminado establecido por un
? D: línea.

"¿rancio? MAKE: dependencia 'xxx'."
La unidad enumera un símbolo como una dependencia, pero ese símbolo es desconocido por lo demás, es decir
nunca aparece como hecho por cualquier otra unidad.

"¿Falta el símbolo '$ xxx'? HACER".
Un símbolo utilizado o definido no se incluyó como una dependencia en la línea? MAKE :.

"falta xxx de? MAKE para '$ yyy' visible".
Se usa un símbolo definido como visible por una unidad especial, pero esa unidad especial no es
parte de la línea de dependencia.

"¿rancio? M: dependencia 'xxx'."
La línea mágica enumera un símbolo C como una dependencia, pero ese símbolo no es conocido por ninguna unidad.

"símbolo desconocido '$ xxx'".
No tengo idea de qué es este símbolo. Si la variable se define externamente, esta
La advertencia se puede suprimir mediante un? LINT: extern.

"Se establece el símbolo de solo lectura '$ xxx'."
El cuerpo del código de shell de la unidad establece un símbolo que debe ser de solo lectura.

"Se utiliza el símbolo obsoleto 'xxx'".
Se utiliza un símbolo obsoleto en el código de shell de la unidad.

"Se establece el símbolo no declarado '$ xxx'."
La unidad intenta establecer una variable de shell que no haya sido declarada como hecha.
o como variable temporal, o lo que sea.

"sin cerrar? H: sección".
La sección? H: no fue terminada por un solo '? H :.' línea antes del cuerpo del
unidad o el inicio de otra sección? C :.

"El símbolo C 'xxx' se define en las siguientes unidades:"
El símbolo C se define en más de una unidad. Se enumeran las unidades infractoras.

"El símbolo de shell 'xxx' se define en las siguientes unidades:"
Un símbolo de concha se define en más de una unidad. Las unidades infractoras siguen.

"El símbolo de shell 'xxx' es totalmente:"
Un símbolo de concha está definido por algunas unidades, obsoleto por otras y utilizado como temporal.

"El símbolo de shell 'xxx' está definido y obsoleto:"
Autoexplicativo.

"El símbolo de shell 'xxx' se define y se utiliza como temporal:"
Autoexplicativo.

"El símbolo de shell 'xxx' obsoleto también se usa como temporal:"
Autoexplicativo.

"definición de '$ xxx' no cerrada por '? S :.'".
Autoexplicativo.

"definición de 'XXX' no cerrada por '? C :.'".
Autoexplicativo.

"Definición mágica de 'xxx' no cerrada por '? M :.'".
Autoexplicativo.

"La variable '$ xxx' se define externamente".
Se utiliza una variable definida externamente (es decir, en otra unidad), sin los
información de dependencia. Utilizar el externo lint sugerencia para suprimir este mensaje.

"No se creó el archivo 'xxx'."
La unidad especial no crea un archivo listado como archivo UU privado. La creación es
detectado al ver una redirección de shell explícita al archivo, no por un implícito
creación (como lo haría una compilación en C, por ejemplo). Todas las unidades especiales deben
cree solo scripts de shell explícitamente de todos modos, por lo que este mensaje no se puede suprimir a través de
una pista de pelusa.

"El archivo local 'xxx' puede anular el establecido por 'unit.U'".
Está intentando crear un archivo local, pero la unidad especial crea un rodamiento
el mismo nombre exacto y debe cargarse antes dentro Configurar, lo harías
anular ese archivo. Cambie el nombre de su archivo local.

"archivo temporal no utilizado 'xxx'.
El archivo se declaró en la línea? F: pero no parece que se utilice en ninguna parte.

"archivo temporal 'xxx' mal utilizado.
Se ha declarado un archivo temporal local en la línea? F: y se utiliza de manera que
puede que no sea el adecuado. De hecho, todos estos archivos locales deben llamarse con un
ruta relativa explícita, para evitar búsquedas de RUTA que podrían obtener otro archivo.

"Es posible que no siempre obtenga el archivo 'xxx' de 'unit.U'".
Parece que está llamando al archivo especificado, pero no utilizando un relativo explícito
nombre de ruta. No es seguro confiar en la RUTA para encontrar este archivo. Para solucionar este problema,
llama a tu archivo usando algo como ./xxx.

"Falta la unidad de? HAGA para el archivo privado 'xxx'."
Está utilizando un archivo UU privado sin enumerar la unidad especial que lo produce en
su línea de dependencia. Agregue la unidad a su lista de dependencias.

"archivo privado desconocido 'xxx'."
El archivo no aparece en ninguna línea? F:; sin embargo debería.

"El archivo 'xxx' se define en las siguientes unidades:"
Las unidades enumeradas no parecen estar de acuerdo sobre quién está definiendo el archivo.

"Aquí se desaconseja el nombre del documento vacío".
Debe abstenerse de utilizar nombres vacíos para estos documentos, ya que metalint no
monitorear esos.

"no cerrado aquí-el documento xxx comenzó la línea x".
El documento aquí abierto en la línea x nunca se cerró en esta unidad. Esto generalmente
significa que cuando se utiliza la unidad, ¡el script generado no funcionará!

"Directiva falsa 'LINT xxx'".
Ha insertado una directiva? LINT: que no se utiliza para cerrar las advertencias.

"Ciclo encontrado para:"
Se ha encontrado un ciclo de dependencia para los símbolos enumerados. Solo los símbolos involucrados
en el ciclo se enumeran.

"El ciclo implica:"
Se enumera un extracto de las dependencias donde se encontró el ciclo. Esto puede involucrar
muchos más símbolos que el mensaje anterior, porque metalint en realidad vuelve a escanear el
reglas para enfatizar el ciclo y se detiene siempre que ha encontrado uno, es decir, no
tratar de minimizarlo (el ciclo se encuentra utilizando otro algoritmo, que desafortunadamente
no puedo escupirlo, pero solo decir con seguridad que hay uno).

REFERENCIA

metalint utiliza las siguientes líneas de control, que de otro modo son ignoradas por metaconfiguración:

? V:sólo lectura símbolos:lectura-escritura símbolos
Esta línea debe usarse solo en unidades especiales. Enumera todas las variables de shell
definidas por la unidad que no deben ser utilizadas directamente como dependencias por otras unidades:
deben incluir esta unidad especial en su lista de dependencias si hacen uso de cualquier
de los símbolos descritos aquí. Esos pueden verse como símbolos exportados que
heredar de cuando depende de la unidad. Los símbolos se pueden exportar como de solo lectura o
leer escribir.

?F:archivos creado
Esta línea tiene dos propósitos: es un metalint sugerencia, y también un marcador de posición para
futuras jmake usar. Debe enumerar tres tipos de archivos: el temporal que son
creado para una prueba, los UU privados creados en el directorio UU para más tarde
detenidamente, y los públicos que quedan en el directorio raíz del paquete. Temporal
los archivos deben estar listados con un '!' carácter (que significa "¡no! no se reutilizan
¡más tarde! "), los archivos UU privados deben estar precedidos por un './' (que significa: para usarlos, digamos
./expediente, No sólo presentar), y los públicos deben nombrarse tal cual.

? T:shell temporales
Esta línea debe enumerar todas las variables de shell utilizadas como temporales dentro de la unidad
cuerpo. Esta línea debe mantenerse precisa y evita que escriba una unidad
definiendo un símbolo que se usaría como variable temporal en otra unidad ...

?HILAS:keyword lista_simbolos
Especifica una pista de pelusa. Están disponibles las siguientes palabras clave:

el cambio variable de shell ok para ser cambiada
Para crear archivo persistente ok para ser creado por una unidad no especial
definir las variables de shell enumeradas se definen en esta unidad
describir las variables de shell enumeradas se describen mediante? S:
externo variable conocida por ser definida externamente
vacío El archivo de unidad está vacío y se mantiene solo como marcador de posición.
known se describen las variables C enumeradas
sin comentarios El archivo de unidad es especial y puede perder una línea inicial ': descripción'.
aqui no los nombres enumerados no son documentos aquí (por ejemplo, "1 << foo" en una C
programa)
. las variables enumeradas se establecen
use las variables enumeradas son utilizadas por esta unidad
no cerrado los nombres enumerados de los documentos aquí no están cerrados en esta unidad
archivo de uso se utiliza el archivo listado (no anteponga el nombre con '!' para
unos)

AUTORES

Harlan Stenn[email protected]> escribió la primera versión, basada en Larry Wall
metaconfiguración desde dist 2.0.
Rafael Manfredi[email protected]> lo reescribí desde cero para 3.0 con algunos
mejoras

Use metalint en línea usando los servicios de onworks.net