perlthanks - Online en la nube

PROGRAMA:

NOMBRE

perlbug - cómo enviar informes de errores en Perl

SINOPSIS

perlbug

perlbug [ -v ] [ -a dirección ] [ -s sujeto ] [ -b cuerpo | -f fichero de entrada ] [ -F archivo de salida ]
[ -r dirección del remitente ] [ -e editor ] [ -c admindirección | -C ] [ -S ] [ -t ] [ -d ] [ -A ]
[ -h ] [ -T ]

perlbug [ -v ] [ -r dirección del remitente ]
[ -A ] [ -OK | -okey | -no está bien | -no está bien ]

gracias

DESCRIPCIÓN

Este programa está diseñado para ayudarlo a generar y enviar informes de errores (y notas de agradecimiento)
sobre perl5 y los módulos que lo acompañan.

En la mayoría de los casos, puede ejecutarlo de forma interactiva desde una línea de comando sin ningún tipo de
argumentos y siga las instrucciones.

Si ha encontrado un error con un puerto no estándar (uno que no formaba parte del estándar
), una distribución binaria o un módulo no principal (como Tk, DBI, etc.), luego
consulte la documentación que acompaña a esa distribución para determinar la
lugar para informar errores.

Si no puede enviar su informe utilizando perlbug (muy probablemente porque su sistema
no tiene una forma de enviar correo que perlbug reconoce), es posible que pueda usar esta herramienta
para redactar su informe y guardarlo en un archivo que luego puede enviar a [email protected]
utilizando su cliente de correo habitual.

En casos extremos, perlbug puede no funcionar lo suficientemente bien en su sistema para guiarlo a través de
redactar un informe de error. En esos casos, es posible que pueda utilizar perlbug -d para obtener el sistema
información de configuración para incluir en un informe de error compuesto manualmente
[email protected].

Al informar un error, revise esta lista de verificación:

¿Qué versión de Perl está ejecutando?
Escriba "perl -v" en la línea de comando para averiguarlo.

¿Está ejecutando la última versión publicada de perl?
Revisa http://www.perl.org/ descubrir. Si no está utilizando la última versión lanzada
versión, intente replicar su error en la última versión estable.

Tenga en cuenta que los informes sobre errores en versiones antiguas de Perl, especialmente aquellos que indican
tampoco ha probado la versión estable actual de Perl, es probable que reciba menos
atención de los voluntarios que construyen y mantienen Perl que los informes sobre errores en
la versión actual.

Esta herramienta no es apropiada para informar errores en ninguna versión anterior a Perl 5.0.

¿Estás seguro de que lo que tienes es un error?
Una gran cantidad de los informes de errores que recibimos resultan ser funciones documentadas en
Perl. Asegúrese de que el problema con el que se ha encontrado no sea intencional mirando a través del
documentación que viene con la distribución de Perl.

Dado el gran volumen de documentación de Perl, esta no es una empresa trivial, pero si
puede señalar la documentación que sugiere que el comportamiento que está viendo es Mal,
Es probable que su problema reciba más atención. Es posible que desee comenzar con perldoc
perltrap para punteros a trampas comunes que ejecutan programadores de Perl nuevos (y experimentados)
dentro.

Si no está seguro del significado de un mensaje de error con el que se ha encontrado, perldoc
perldiag para una explicación. Si el mensaje no está en perldiag, probablemente no lo esté
generado por Perl. Puede tener suerte consultando la documentación de su sistema operativo
preferiblemente.

Si está en una plataforma que no es UNIX perldoc perlport, ya que algunas características pueden ser
no implementado o funciona de manera diferente.

Es posible que pueda averiguar qué va mal utilizando el depurador de Perl. Para
información sobre cómo utilizar el depurador perldoc perldebug

¿Tiene un caso de prueba adecuado?
Cuanto más fácil sea reproducir su error, es más probable que se solucione, si nadie
puede duplicar su problema, probablemente no se abordará.

Un buen caso de prueba tiene la mayoría de estos atributos: código corto y simple; pocas dependencias de
comandos, módulos o bibliotecas externos; sin código dependiente de la plataforma (a menos que sea un
error específico de la plataforma); documentación clara y sencilla.

Un buen caso de prueba es casi siempre un buen candidato para ser incluido en la prueba de Perl.
suite. Si tiene tiempo, considere escribir su caso de prueba para que pueda ser fácilmente
incluido en el conjunto de pruebas estándar.

¿Ha incluido toda la información relevante?
Asegúrese de incluir el exacto mensajes de error, si los hay. "Perl dio un error" no es un
mensaje de error exacto.

Si obtiene un volcado de memoria (o equivalente), puede usar un depurador (dbx, gdb, etc) a
producir un seguimiento de la pila para incluirlo en el informe de error.

NOTA: a menos que su Perl haya sido compilado con información de depuración (a menudo -g), el seguimiento de la pila
Es probable que sea algo difícil de usar porque probablemente solo contendrá el
nombres de funciones y no sus argumentos. Si es posible, recompile su Perl con debug
info y reproducir el bloqueo y el seguimiento de la pila.

¿Puede describir el error en un lenguaje sencillo?
Cuanto más fácil sea comprender un error reproducible, es más probable que se solucione.
Cualquier información que pueda proporcionar sobre el problema será de gran ayuda. En otras palabras,
intente analizar el problema (en la medida de lo posible) e informe sus descubrimientos.

¿Puedes arreglar el error tú mismo?
Si es así, es una gran noticia; Es probable que los informes de errores con parches reciban
más atención e interés que los que no tienen parches. Adjunte su parche a
el informe usando la opción "-p". Cuando envíe un parche, créelo usando "git
format-patch "si es posible, aunque una diferencia unificada creada con" diff -pu "servirá
casi tan bien.

Su parche puede ser devuelto con solicitudes de cambios o solicitudes de información más detallada.
explicaciones sobre su solución.

Aquí hay algunas sugerencias para crear parches de alta calidad:

Asegúrese de que el parche no esté invertido (el primer argumento para diff es típicamente el
archivo original, el segundo argumento es su archivo modificado). Asegúrate de probar tu parche
aplicándolo con "git am" o el programa "parche" antes de enviarlo en su camino.
Intente seguir el mismo estilo que el código que está intentando parchear. Asegúrese de que su
el parche realmente funciona ("hacer prueba", si lo que está parcheando está cubierto por el
Banco de pruebas).

¿Puede utilizar "perlbug" para enviar el informe?
perlbug garantizará, entre otras cosas, que su informe incluya información crucial
acerca de su versión de perl. Si "perlbug" no puede enviar su informe por correo después de haber
lo escribió, es posible que deba redactar el mensaje usted mismo, agregar la salida producida por
"perlbug -d" y envíelo por correo electrónico a [email protected]. Si, por alguna razón, no puede ejecutar
"perlbug" en su sistema, asegúrese de incluir la salida completa producida por
ejecutando "perl -V" (observe la V mayúscula).

Ya sea que use "perlbug" o envíe el correo electrónico manualmente, haga que su línea de Asunto
informativo. "un error" no es informativo. Ni "perl se bloquea" ni "AYUDA".
Estos no ayudan. Una descripción compacta de lo que está mal está bien.

¿Puedes usar "perlbug" para enviar una nota de agradecimiento?
Sí, puede hacerlo utilizando la opción "-T" o invocando el programa como
"gracias". Las notas de agradecimiento son buenas. Hace sonreír a la gente.

Después de haber hecho su parte, esté preparado para esperar, para que le digan que el error está en su código, o
posiblemente para no obtener respuesta alguna. Los voluntarios que mantienen Perl son gente muy ocupada, así que si
su problema es un error obvio en su propio código, es difícil de entender o es un
duplicado de un informe existente, es posible que no reciba una respuesta personal.

Si es importante para usted que se solucione su error, controle el [email protected]
lista de correo (las listas de correo están moderadas, su mensaje puede tardar un poco en aparecer) y
los registros de confirmación para las versiones de desarrollo de Perl, y anime a los mantenedores con amabilidad
palabras u ofertas de bebidas heladas. (Por favor, sea amable con los mantenedores.
flamearlos probablemente tenga el efecto opuesto al que desea.)

No dude en actualizar el ticket sobre su error en http://rt.perl.org si una nueva versión de
Se lanza Perl y su error aún está presente.

OPCIONES

-a Dirección a la que enviar el informe. Predeterminado a [email protected].

-A No envíe un acuse de recibo de error a la dirección de respuesta. Generalmente es
sólo es sensato usar esta opción si usted es un mantenedor de perl que está observando activamente
perl porters para que llegue su mensaje.

-b Cuerpo del informe. Si no está incluido en la línea de comando o en un archivo con -f,
tendrás la oportunidad de editar el mensaje.

-C No envíe una copia al administrador.

-c Dirección a la que enviar copia del informe. Por defecto es la dirección del perl local.
administrador (registrado cuando se construyó perl).

-d Modo de datos (el predeterminado si redirige o canaliza la salida). Esto imprime tu
datos de configuración, sin enviar nada por correo. Puedes usar esto con -v para obtener
datos más completos.

-e Editor a utilizar.

-f Archivo que contiene el cuerpo del informe. Use esto para enviar rápidamente un preparado
mensaje.

-F Archivo para enviar los resultados en lugar de enviarlos como un correo electrónico. Útil particularmente
al ejecutar perlbug en una máquina sin conexión directa a Internet.

-h Imprime un breve resumen de las opciones.

-OK Informe a los porteros de Perl sobre la construcción exitosa de este sistema. Efectivo -S y -C. Efectivo
y proporciona valores para -s y -b. Solo solicita una dirección de devolución si no puede
adivina (para usar con make). Dirección de devolución de honores especificada con -r. Usted puede
usa esto con -v para obtener datos más completos. Solo hace un informe si este sistema
tiene menos de 60 días.

-okey As -OK excepto que informará sobre sistemas más antiguos.

-no está bien Informe una compilación fallida en este sistema. Efectivo -C. Fuerzas y suministros un valor
for -s, luego le solicita que edite el informe y diga qué salió mal.
Alternativamente, se puede proporcionar un informe preparado utilizando -f. Solo solicita una
dirección de devolución si no puede adivinarla (para usar con make). Dirección de devolución de honores
especificado con -r. Puedes usar esto con -v para obtener datos más completos. Solamente
realiza un informe si este sistema tiene menos de 60 días.

-no está bien As -no está bien excepto que informará sobre sistemas más antiguos.

-p Los nombres de uno o más archivos de parche u otros archivos adjuntos de texto que se incluirán
el informe. Varios archivos deben estar separados por comas.

-r Su dirección de devolución. El programa le pedirá que confirme su valor predeterminado si no lo hace
utilice esta opción.

-S Envíe sin pedir confirmación.

-s Asunto a incluir con el mensaje. Se le preguntará si no proporciona uno
en la línea de comando.

-t Modo de prueba. La dirección de destino predeterminada es [email protected].

-T Envíe una nota de agradecimiento en lugar de un informe de error.

-v Incluya datos de configuración detallados en el informe.

AUTORES

Kenneth Albanowski ([email protected]>), posteriormente doctored por Gurusamy Sarathy
(<[email protected]>), Tom Christiansen ([email protected]>), Nathan Torkington
(<[email protected]>), Charles F. Randall ([email protected]>), Mike Guy ([email protected]>),
Dominic Dunlop ([email protected]>), Hugo van der Sanden ([email protected]>), Jarkko
Hietaniemi[email protected]>), Chris Nandor ([email protected]>), Jon Orwant
(<[email protected]>, Richard Foley ([email protected]>), Jesse Vincent
(<[email protected]>) y Craig A. Berry ([email protected]>).

Utilice perlthanks en línea utilizando los servicios de onworks.net