Ini ialah arahan perlbug yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
perlbug - cara menghantar laporan pepijat pada Perl
SINOPSIS
perlbug
perlbug [ -v ] [ -a alamat ] [ -s tertakluk ] [ -b badan | -f fail input ] [ -F fail keluaran ]
[ -r alamat balik ] [ -e editor ] [ -c adminaddress | -C ] [ -S ] [ -t ] [ -d ] [ -A ]
[ -h ] [ -T ]
perlbug [ -v ] [ -r alamat balik ]
[ -A ] [ -okey | -baik | -nok | -nokay ]
terima kasih
DESCRIPTION
Program ini direka bentuk untuk membantu anda menjana dan menghantar laporan pepijat (dan nota terima kasih)
tentang perl5 dan modul yang dihantar bersamanya.
Dalam kebanyakan kes, anda hanya boleh menjalankannya secara interaktif daripada baris arahan tanpa sebarang khas
hujah dan ikut arahan.
Jika anda telah menemui pepijat dengan port bukan standard (yang bukan sebahagian daripada standard
pengedaran), pengedaran binari atau modul bukan teras (seperti Tk, DBI, dll), kemudian
sila lihat dokumentasi yang disertakan dengan pengedaran itu untuk menentukan yang betul
tempat melaporkan pepijat.
Jika anda tidak dapat menghantar laporan anda menggunakan perlbug (kemungkinan besar kerana sistem anda
tidak mempunyai cara untuk menghantar mel yang dikenali oleh perlbug), anda mungkin boleh menggunakan alat ini
untuk mengarang laporan anda dan menyimpannya ke fail yang kemudiannya boleh anda hantar [e-mel dilindungi]
menggunakan klien mel biasa anda.
Dalam kes yang melampau, perlbug mungkin tidak berfungsi dengan baik pada sistem anda untuk membimbing anda
mengarang laporan pepijat. Dalam kes tersebut, anda mungkin boleh menggunakan perlbug -d untuk mendapatkan sistem
maklumat konfigurasi untuk disertakan dalam laporan pepijat yang digubah secara manual kepada
[e-mel dilindungi].
Apabila melaporkan pepijat, sila jalankan senarai semak ini:
Apakah versi Perl yang anda jalankan?
Taip "perl -v" pada baris arahan untuk mengetahui.
Adakah anda menjalankan versi terbaru keluaran perl?
Lihatlah http://www.perl.org/ untuk mengetahui. Jika anda tidak menggunakan keluaran terbaru
versi, sila cuba meniru pepijat anda pada keluaran stabil terkini.
Ambil perhatian bahawa melaporkan tentang pepijat dalam versi lama Perl, terutamanya yang menunjukkan
anda juga belum menguji keluaran stabil semasa Perl, berkemungkinan menerima kurang
perhatian daripada sukarelawan yang membina dan mengekalkan Perl daripada laporan tentang pepijat masuk
siaran semasa.
Alat ini tidak sesuai untuk melaporkan pepijat dalam mana-mana versi sebelum Perl 5.0.
Adakah anda pasti apa yang anda ada ialah pepijat?
Sebilangan besar laporan pepijat yang kami terima ternyata menjadi ciri yang didokumenkan
Perl. Pastikan isu yang anda hadapi tidak disengajakan dengan melihat ke dalam
dokumentasi yang disertakan dengan pengedaran Perl.
Memandangkan jumlah dokumentasi Perl yang banyak, ini bukanlah usaha yang remeh, tetapi jika
anda boleh menunjuk kepada dokumentasi yang mencadangkan tingkah laku yang anda lihat salah,
isu anda mungkin mendapat lebih perhatian. Anda mungkin mahu mulakan dengan perldoc
perltrap untuk penunjuk kepada perangkap biasa yang dijalankan oleh pengaturcara Perl baharu (dan berpengalaman).
ke dalam.
Jika anda tidak pasti tentang maksud mesej ralat yang anda temui, perldoc
perldiag untuk penjelasan. Jika mesej itu tiada dalam perldiag, ia mungkin tidak
dihasilkan oleh Perl. Anda mungkin bernasib baik untuk merujuk dokumentasi sistem pengendalian anda
sebaliknya.
Jika anda menggunakan platform bukan UNIX perldoc perlport, kerana beberapa ciri mungkin
tidak dilaksanakan atau berfungsi secara berbeza.
Anda mungkin dapat mengetahui perkara yang salah menggunakan penyahpepijat Perl. Untuk
maklumat tentang cara menggunakan penyahpepijat perldoc perldebug.
Adakah anda mempunyai kes ujian yang betul?
Lebih mudah untuk menghasilkan semula pepijat anda, lebih besar kemungkinan ia akan dibetulkan -- jika tiada sesiapa
boleh menduplikasi masalah anda, ia mungkin tidak akan ditangani.
Kes ujian yang baik mempunyai kebanyakan atribut ini: kod ringkas dan ringkas; sedikit kebergantungan pada
arahan luaran, modul atau perpustakaan; tiada kod yang bergantung pada platform (melainkan ia a
pepijat khusus platform); dokumentasi yang jelas dan ringkas.
Kes ujian yang baik hampir selalu merupakan calon yang baik untuk disertakan dalam ujian Perl
suite. Jika anda mempunyai masa, pertimbangkan untuk menulis kes ujian anda supaya mudah
dimasukkan ke dalam suite ujian standard.
Adakah anda telah memasukkan semua maklumat yang berkaitan?
Pastikan anda memasukkan tepat mesej ralat, jika ada. "Perl memberi ralat" bukan
mesej ralat yang tepat.
Jika anda mendapat longgokan teras (atau setara), anda boleh menggunakan penyahpepijat (dbx, gdb, dll) kepada
menghasilkan surih tindanan untuk dimasukkan ke dalam laporan pepijat.
NOTA: melainkan Perl anda telah disusun dengan maklumat nyahpepijat (selalunya -g), jejak tindanan
mungkin agak sukar untuk digunakan kerana ia berkemungkinan besar hanya mengandungi
nama fungsi dan bukan hujah mereka. Jika boleh, susun semula Perl anda dengan nyahpepijat
maklumat dan menghasilkan semula ranap dan jejak tindanan.
Bolehkah anda menerangkan pepijat dalam bahasa Inggeris biasa?
Lebih mudah untuk memahami pepijat yang boleh dihasilkan semula, lebih besar kemungkinan ia akan diperbaiki.
Sebarang cerapan yang boleh anda berikan tentang masalah ini akan banyak membantu. Dalam kata lain,
cuba analisis masalah (setakat yang anda boleh) dan laporkan penemuan anda.
Bolehkah anda membetulkan pepijat itu sendiri?
Jika ya, itu berita baik; laporan pepijat dengan tampung berkemungkinan besar akan diterima
lebih perhatian dan minat daripada mereka yang tiada tampalan. Sila lampirkan tampalan anda pada
laporan menggunakan pilihan "-p". Apabila menghantar tampalan, buatnya menggunakan "git
format-patch" jika boleh, walaupun perbezaan bersatu yang dibuat dengan "diff -pu" akan berjaya
hampir juga.
Tampalan anda mungkin dikembalikan dengan permintaan untuk perubahan, atau permintaan untuk lebih terperinci
penjelasan tentang pembetulan anda.
Berikut ialah beberapa petua untuk mencipta tampung berkualiti tinggi:
Pastikan tampalan tidak diterbalikkan (hujah pertama yang berbeza biasanya
fail asal, hujah kedua fail yang anda ubah). Pastikan anda menguji tampalan anda
dengan menerapkannya dengan "git am" atau program "patch" sebelum anda menghantarnya dalam perjalanan.
Cuba ikut gaya yang sama seperti kod yang anda cuba tampal. Pastikan anda
patch benar-benar berfungsi ("buat ujian", jika perkara yang anda tampal dilindungi oleh Perl's
suite ujian).
Bolehkah anda menggunakan "perlbug" untuk menyerahkan laporan?
perlbug akan, antara lain, memastikan laporan anda mengandungi maklumat penting
tentang versi perl anda. Jika "perlbug" tidak dapat menghantar laporan anda selepas anda melakukannya
menaipnya, anda mungkin perlu mengarang mesej itu sendiri, tambah output yang dihasilkan oleh
"perlbug -d" dan e-melkannya ke [e-mel dilindungi]. Jika, atas sebab tertentu, anda tidak boleh berlari
"perlbug" sama sekali pada sistem anda, pastikan anda memasukkan keseluruhan output yang dihasilkan oleh
menjalankan "perl -V" (perhatikan huruf besar V).
Sama ada anda menggunakan "perlbug" atau menghantar e-mel secara manual, sila buat baris Subjek anda
bermaklumat. "pepijat" tidak bermaklumat. Baik "perl ranap" mahupun "BANTU!!!".
Ini tidak membantu. Penerangan padat tentang apa yang salah tidak mengapa.
Bolehkah anda menggunakan "perlbug" untuk menyerahkan nota terima kasih?
Ya, anda boleh melakukan ini sama ada dengan menggunakan pilihan "-T", atau dengan menggunakan program sebagai
"terima kasih". Nota terima kasih bagus. Ia membuat orang tersenyum.
Setelah melakukan sedikit kerja anda, sila bersedia untuk menunggu, untuk diberitahu pepijat berada dalam kod anda, atau
mungkin tidak mendapat balasan langsung. Sukarelawan yang mengekalkan Perl adalah orang yang sibuk, jadi jika
masalah anda ialah pepijat yang jelas dalam kod anda sendiri, sukar difahami atau a
pendua laporan sedia ada, anda mungkin tidak menerima balasan peribadi.
Jika penting bagi anda bahawa pepijat anda diperbaiki, lakukan pantauan [e-mel dilindungi]
senarai mel (senarai mel disederhanakan, mesej anda mungkin mengambil sedikit masa untuk dipaparkan) dan
log komit ke versi pembangunan Perl, dan menggalakkan penyelenggara dengan baik
perkataan atau tawaran minuman sejuk. (Sila berbuat baik kepada penyelenggara. Mengganggu atau
menyalakannya berkemungkinan mempunyai kesan yang bertentangan dengan kesan yang anda mahukan.)
Jangan ragu untuk mengemas kini tiket tentang pepijat anda http://rt.perl.org jika versi baharu
Perl dikeluarkan dan pepijat anda masih ada.
PILIHAN
-a Alamat untuk menghantar laporan kepada. Lalai kepada [e-mel dilindungi].
-A Jangan hantar pepijat yang diterima pengakuan ke alamat balasan. Secara umumnya ia adalah
hanya bijak untuk menggunakan pilihan ini jika anda seorang penyelenggara perl yang aktif menonton
perl porter untuk mesej anda sampai.
-b Badan laporan. Jika tidak disertakan pada baris arahan, atau dalam fail dengan -f,
anda akan mendapat peluang untuk mengedit mesej.
-C Jangan hantar salinan kepada pentadbir.
-c Alamat untuk menghantar salinan laporan kepada. Lalai kepada alamat perl tempatan
pentadbir (dirakam apabila perl dibina).
-d Mod data (lalai jika anda mengubah hala atau output paip). Ini mencetak anda
data konfigurasi, tanpa mel apa-apa. Anda boleh menggunakan ini dengan -v untuk mendapatkan
data yang lebih lengkap.
-e Editor untuk digunakan.
-f Fail yang mengandungi badan laporan. Gunakan ini untuk menghantar dengan cepat yang disediakan
mesej.
-F Failkan untuk mengeluarkan keputusan dan bukannya dihantar sebagai e-mel. Berguna terutamanya
apabila menjalankan perlbug pada mesin tanpa sambungan internet langsung.
-h Mencetak ringkasan ringkas pilihan.
-okey Laporkan kejayaan membina sistem ini kepada porter perl. Angkatan -S and -C. Angkatan
dan membekalkan nilai untuk -s and -b. Hanya meminta alamat pemulangan jika tidak boleh
rasa (untuk digunakan dengan membuat). Alamat pemulangan kepujian dinyatakan dengan -r. Anda boleh
gunakan ini dengan -v untuk mendapatkan data yang lebih lengkap. Hanya membuat laporan jika sistem ini
berumur kurang daripada 60 hari.
-baik As -okey kecuali ia akan melaporkan pada sistem yang lebih lama.
-nok Laporkan pembinaan yang tidak berjaya pada sistem ini. Angkatan -C. Memaksa dan membekalkan nilai
Untuk -s, kemudian memerlukan anda mengedit laporan dan menyatakan perkara yang salah.
Sebagai alternatif, laporan yang disediakan boleh dibekalkan menggunakan -f. Hanya gesaan untuk a
kembalikan alamat jika ia tidak dapat menekanya (untuk digunakan dengan membuat). Alamat pemulangan kepujian
ditentukan dengan -r. Anda boleh menggunakan ini dengan -v untuk mendapatkan data yang lebih lengkap. Sahaja
membuat laporan jika sistem ini berumur kurang daripada 60 hari.
-nokay As -nok kecuali ia akan melaporkan pada sistem yang lebih lama.
-p Nama satu atau lebih fail tampalan atau lampiran teks lain untuk disertakan
Laporan itu. Berbilang fail mesti dipisahkan dengan koma.
-r Alamat pemulangan anda. Program ini akan meminta anda mengesahkan lalainya jika anda tidak
gunakan pilihan ini.
-S Hantar tanpa meminta pengesahan.
-s Tertakluk untuk disertakan bersama mesej. Anda akan digesa jika anda tidak membekalkannya
pada baris arahan.
-t Mod percubaan. Alamat sasaran lalai kepada [e-mel dilindungi].
-T Hantar nota terima kasih dan bukannya laporan pepijat.
-v Sertakan data konfigurasi verbose dalam laporan.
PENGARANG
Kenneth Albanowski ([e-mel dilindungi]>), kemudiannya docdikoyak oleh Gurusamy Sarathy
(<[e-mel dilindungi]>), Tom Christiansen ([e-mel dilindungi]>), Nathan Torkington
(<[e-mel dilindungi]>), Charles F. Randall ([e-mel dilindungi]>), Mike Guy ([e-mel dilindungi]>),
Dominic Dunlop ([e-mel dilindungi]>), Hugo van der Sanden ([e-mel dilindungi]>), Jarkko
Hietaniemi ([e-mel dilindungi]>), Chris Nandor ([e-mel dilindungi]>), Jon Orwant
(<[e-mel dilindungi]>, Richard Foley ([e-mel dilindungi]>), Jesse Vincent
(<[e-mel dilindungi]>), dan Craig A. Berry ([e-mel dilindungi]>).
Gunakan perlbug dalam talian menggunakan perkhidmatan onworks.net
