# הצהרה ודיווח על באגים

## PetaPerl אינו Perl המקורי

PetaPerl היא סביבת ריצה עצמאית של Perl 5, שנכתבה מאפס ב־Rust. היא **אינה** build של מפרש perl הייחוס מ־CPAN. מודולים רבים המוכרים מ־CPAN — `PDL`, `Scalar::Util`, `Storable`, `POSIX`, ועוד עשרות — מסופקים עם PetaPerl כ**מימושים מקוריים ב־Rust** המובנים במפרש. ללא XS, ללא צורך במהדר C, ללא שלב התקנה מ־CPAN.

לכך השלכה אחת החשובה לכל משתמש:

#### IMPORTANT
כל באג, תכונה חסרה, או הבדל התנהגותי הנצפה בעת שימוש בשם מודול הקיים ב־CPAN (`PDL::Ufunc`, `Scalar::Util`, `IO::File`, …) בעת ריצה תחת PetaPerl הוא **באג שלנו, לא של המקור.**

**אין** לדווח על תקלות אלו לפרויקט CPAN המקורי. מתחזקי המקור הם מתנדבים העובדים על בסיס קוד שונה מזה שמורץ אצלכם.

## דיווחי באגים

PetaPerl היא **תצוגה מקדימה למחקר במצב שינוי במהירות גבוהה**. מנגנון ציבורי לדיווח באגים אינו פעיל עדיין.

#### NOTE
מה שאנו מבקשים לעשות היום:

- **אין לדווח על תקלות לפרויקטי CPAN המקוריים** עבור התנהגות הנצפית במימושים המקוריים מחדש של pperl. מתחזקי המקור עובדים על בסיס קוד שונה ואינם יכולים לתקן את שלנו. זוהי המסר היחיד שעמוד זה קיים כדי להעביר.
- **יש לשמור את הממצאים.** סקריפט מינימלי לשחזור, פלט `pperl -V`, ותיאור קצר של התנהגות צפויה מול בפועל הם שלושת הדברים שכל מערכת מעקב עתידית תבקש. שמירתם עתה משמעה פחות עבודה בהמשך.
- **יש לבדוק אם זה כבר ידוע.** בכל עמוד מודול קיים קטע  *הבדלים מהמקור* המפרט סטיות מכוונות. אם התצפית תואמת לסעיף שם, אין זה באג — זוהי התנהגות מתועדת.

כאשר מערכת מעקב ציבורית תיפתח, עמוד זה יעודכן עם כתובת ה־URL להגשה.

## כוונת התאימות

PetaPerl שואפת לתאימות התנהגותית של ‎~100%‎ עם **Perl 5.42** ועם הגרסאות הספציפיות של מודולי CPAN שאנו מספקים (ראו `pperl -V`, `PPERL_MODS`). היכן שאנו סוטים, אנו סוטים במכוון ומתעדים זאת.

צורות שפה ישנות יותר (למשל תכונות `use v5.18;` ששונות מגרסאות מאוחרות יותר) אינן יעד תאימות. PetaPerl עוקבת אחר Perl המקורי הנוכחי, לא Perl המקורי ההיסטורי.

## תרומות המקור

מודולי CPAN ששמותיהם נישאים על ידינו מייצגים שנות עבודה של מתחזקים מתנדבים אשר ראויים לקרדיט עבור תכנון הממשק והמימוש המקורי, גם כאשר הקוד שלנו אינו חולק שורות עם שלהם. אנו מודים להם, ואיננו רוצים שתיבות הדואר שלהם תוצפנה בתקלות שמקורן בסביבת ריצה שאותה הם לא כתבו. זו הסיבה היחידה והחשובה ביותר לקיומו של עמוד זה.

## רישיון

ראו את עמוד [הרישיון](license.md) לתנאים המלאים של PetaMem Research Preview License החלים על השימוש בתוכנה זו.