בוגזילה

From GnuCash
Jump to: navigation, search
שפות אנגלית גרמנית ספרדית עִברִית פורטוגזית צרפתית

כללי

עמוד זה מתאר את אופן השימוש הרגיל בבוגזילה. למשימות בדיקות איכות (QA) ראו מנהלן בוגזילה.

מבוא

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

עצה
לבוגזילה עמוד עזרה אותו ניתן למצא בקישור הבא:בוגזילה 5.0.4+ תעוד.

סקירת מעקב תקלים

רכיבים צד שלישי

GnuCash uses several tools and is sometimes also confused with similar sounding programs, which are maintained by other teams. They have their own bug trackers:

גנוקאש לאנדרואיד
Beneath GitHub issues see also support group and feature requests.
AqBanking
has its own bugtracker.
Finance::Quote
can be tested by using the gnc-fq-* command line tools, see FAQ.
Use their Request Tracker at the Comprehensive Perl Archive Network (CPAN)
or GitHub issues. We do not know which is preferred.

סוגיות תרגום

לתרגום חסר או שגוי, נא ליצור קשר עם המתרגם או צוות התרגום ישירות.

בתוכנה

  1. מתפרית, עזרה -> אודות -> מזכה, לקראת הסוף, במקטע תרגום, "תורגם על ידי" או
  2. פשוט לשאול ברשימת הדיוור המקומית mailing list או
  3. פתיחת קובץ po בשפה שלכם ב- repository ולבדוק ב "צוות תרגום:" או "מתרגם אחרון:" לפרטי קשר של המתרגם.

בתעוד

היה על המתרגם להשאיר כתובת איש קשר בעמוד השער, אך נראה שרוב כתובות הדוא"ל הוסרו מטעמי פרטיות.

גנוקאש ובוגזילה גנום

Until 2018, GnuCash used the Gnome Bugzilla to track bugs. When Gnome Bugzilla was set to read only mode, GnuCash implemented its own Bugzilla instance. All existing GnuCash bugs on Gnome were migrated to GnuCash's copy, and all GnuCash bugs on Gnome's Bugzilla refer visitors to GnuCash's Bugzilla. New bugs must be reported at GnuCash's Bugzilla.

For all existing user accounts that touched any GnuCash bug, email address and full name were migrated. Passwords and email watch lists were not.

  • Migrated users, on first access to GnuCash Bugzilla, must reset their passwords by using the Forgot Password link at the top of the page.
  • Watch lists must be re-created on the Email Preferences tab in Preferences. See Notifications for more information.

מיון ראשוני

Before filing a new bug, you should check to see whether the problem or suggestion has already been made. It may be still open or already closed after the date of your release.

Here are several links to different Bugzilla sections:

Commenting on existing bugs or entering new ones

If a bug has already been entered for the problem or enhancement you have identified, you can add comments to that bug.

If there is no bug, then you can Open a new GnuCash bug.

Users new to the bug process would benefit by reading: How to Report Bugs Effectively.

If you are unsure how to use Bugzilla, read [https://bugzilla.readthedocs.io/en/5.0/using/index.html or use the "Help" or "?" links in Bugzilla.

Note: GnuCash has different versions that run under different operating systems. When you report a bug, you should include both the GnuCash version and the operating system you use in the bug report. You should also include any other information about your configuration that might be pertinent in your request. Examples of this include: your problem might depend on your Locale Settings (like currency, number and date format), which means you would add your language and region.

On updates
Do not change the version, except it was a typo. Instead add a comment "In version 4.4 the problem still exists."

In many cases of errors it is helpful to provide the developers with the always generated Tracefile. See logging to learn about capturing and providing error messages and filtering detail.

When reporting an actual crash of GnuCash see whether you can generate a stack trace. See Stack Trace for information on how to produce a stack trace for your bug report.

Tips
* If you refer to other bugs in your text, we suggest to use the form bug nnnnnn - Title. Bugzilla will then add a link and the reader saves time if the title can be read without following the link.
  • Do not copy and paste log files or other longer output in your comments. Instead append them as attachments.

צרופות

If a program crash or freeze only happens on a specific file (for example, a data file, an import file, or a (modified) report), it can be useful to attach a copy of that file to your bug report.

If the crash is caused by a data file, you should attach the XML file in uncompressed format (see Edit->Preferences->General->Files->Compress Files) or use gunzip, 7-zip or similar programs.

Bear in mind that this data is available on the internet, and take steps to protect your financial data, e.g., by using the ObfuscateScript. If the file is really big, try to create a minimal example. For example, when creating a Tracefile using the --debug or --extra flags, details such as your GnuCash account names will be visible in the Tracefile; some users store sensitive info such as a bank account number in the account name.

If you accidentally upload attachments with un-obfuscated financial data, take the following steps:

  1. Mark the attachment as Obsolete; this will reduce its visibility while waiting for deletion (next step). A guide on marking attachments in Bugzilla obsolete can be found here.
  2. Request a Bugzilla Administrator to delete your attachment; only Administrators have the privileges needed to delete attachments.

When uploading, adjust the MIME type of your file. Whenever possible replace application/octet-stream by a more appropriate type:

Uncompressed gnucash data files are of type text/xml.
Most import files like csv and log files are are only displayed properly, if marked as type text/plain.
Note
There are many other valid MIME types (http://www.iana.org/assignments/media-types/media-types.xhtml), but you need to test if they are displayed properly.

התראות

Notifications can be set to alert you about particular bugs, as well as entire categories of bug.

If you want to receive email notifications about a particular bug, you can add the email address that is your Bugzilla id to the CC list on the bug. Bugzilla will do this for you by default if you take any action on the bug page.

Notifications about entire categories of bugs are known as Watch lists. If you want to add a watch list to your account, add one or more of the following email addresses to your User Watch list in your Bugzilla Email Preferences:

  • After login click Preferences in the Bugzilla menu bar.
  • Select the Email Preferences tab.
  • Scroll to the User Watching section, and enter one or more special addresses.

כתובות הדוא"ל והקבוצות שהן מנתרות הן:

כתובת מעקב אחר הרכיבים
core@gnucash.bugs שרת-XML, שרת-SQL, תקציב, בניית מערכת, עיסקי, מטבעות וסחורות, מנוע, אוגדני פייטון, תנועות מחזוריות
documentation@gnucash.bugs תעוד, תרגום, אתר מרשתת
general@gnucash.bugs כללי
import@gnome.bugs AqBanking-ייבוא, CSV-ייבוא, Import-OFX, Import-Other, Import-QIF, Import-QSF, TXF Export
macos@gnucash.bugs מאק OS
reports@gnucash.bugs הדפסת המחאות, דוחות
ui@gnucash.bugs יומן, יומן-2, מנשק משתמש כללי
windows@gnucash.bugs ווינדוס
all-bugs@gnucash.bugs הכל

נדרשת עזרה

לאלו מכם שעשויים להיות מעונינים לסייע בנהול תקלים בבוגזילה, קיים מידע נוסף בBugzilla Administration.