QA/BugReport
TDF LibreOffice Document Liberation Project Blogs communautaires Weblate Nextcloud Redmine Ask LibreOffice Donner
Ravi que vous soyez arrivé jusqu'ici. Vous êtes sur le point d'apporter une contribution importante à LibreOffice. Un bon rapport de bug est très utile à nos développeurs. Vous trouverez ci-dessous quelques conseils pour faciliter ce processus.
Tous les bugs ne vont pas dans Bugzilla
Tous les chiens peuvent aller au paradis, mais certains rapports de bugs doivent être déposés en dehors de Bugzilla. Ceux-ci incluent :
Types de bugs | Où rapporter un bug |
---|---|
LibreOffice Extensions | With the extension author |
TDF/LibreOffice infrastructure (websites, mailing lists, etc.) | Redmine |
Building LibreOffice | Developer mailing list |
LibreOffice unit tests | Developer mailing list |
Mots manquants dans les dictionnaires | To the dictionary maintainer or repository |
Erreurs dans les traductions | Reporting them in Bugzilla is allowed, but it is more efficient to add them as suggestions in Weblate (does not require registration) |
Avant de rapporter un bug
Confirmez qu'il s'agit bien d'un bug. La plupart du temps, un bug provoque un comportement indésirable du logiciel. Il peut s'agir d'un logiciel qui ne fait pas ce que vous attendez de lui, qui fait ce que vous ne lui avez jamais demandé, ou qui plante tout simplement en utilisation normale. En coulisses, un bug peut entraîner une exécution beaucoup plus longue et une utilisation excessive des ressources du logiciel.
Consider having a look at First steps to take before submitting a bug, in particular for bugs with fonts, graphics, slideshows and computation.
Si vous connaissez assez bien LibreOffice et que vous rencontrez quelque chose qui pourrait être un bug, ou simplement quelque chose que vous ne comprenez pas, vous pouvez poser une question sur LibreOffice Users Mailing List ou Ask LibreOffice.
Mais imaginons que ce que vous avez trouvé ressemble vraiment à un bug. Voici la marche à suivre :
- Prenez des notes pour ne rien oublier de ce qui se passait au moment où le bug est apparu. Que faisiez-vous, que vous attendiez-vous à ce qu'il se passe et que s'est-il réellement passé ? Comment avez-vous su que quelque chose n'allait pas ? Pouvez-vous reproduire le comportement incorrect ?
- Si possible, recherchez des rapports de bugs similaires et existants (sans forcément y passer trop de temps; mieux vaut signaler un doublon que d'abandonner) :
- Allez dans Composants et sélectionnez le composant (ou le sous-composant) approprié.
- Si vous avez sélectionné un composant : sélectionnez le sous-composant approprié ou l'Aide étendue si vous ne le voyez pas sur cette page.
- If you selected Extended Help: select the appropriate subcomponent, or the [1] at the bottom of the list if you did not find or do not know the appropriate subcomponent.
- You will see a list of bugs with that subcomponent. At the bottom of the page, select Edit Search. There, you can modify the search according to your needs.
- If you find a bug report that concerns your problem, you can contribute to it. If you don’t find a bug report that concerns your problem, file a new bug report.
- If the bug only occurs on Ubuntu or is related to printing, go to #More Information.
- After all that, if it does not look like there is an existing ticket about this issue, follow the following instructions.
Signalement d'un bogue
Aller vers Bugzilla.
Sign in

Si vous êtes invité à vous connecter, connectez-vous avec votre compte Bugzilla.
Si vous n'avez pas de compte Bugzilla, créez-en un en cliquant sur New Account.
Composant
In Component, choose the component.
Si ce système de rapport de bogue vous impressionne avec toutes ses sélections et ses règles, vous pouvez poser votre problème sur la liste users@fr.libreoffice.org où vous obtiendrez de l'aide. Pour vous abonner à une liste, visitez Besoin d'aide ?!
If it is an urgent issue (broken parts, regression, etc.), and you are an experienced user who knows the development team, you can assign the bug report to one of the developers listed on the FindTheExpert page.
Details
If there is a Sub-component section, select the subcomponent.
If you don’t know the appropriate subcomponent, go to Components. On that page, click on the appropriate component. Read the descriptions of the all the subcomponents on the page of that component. If you don’t see a suitable subcomponent, click on Extended Help, and read the descriptions of the subcomponents on that page.
Choose the version of the application in which the bug appeared. To check what version of LibreOffice you are using, select
▸In Operating system or OS, choose the operating system of the computer you were using when you met the bug.
If there is a Hardware section, fill it in.
If there is a Severity section and you are requesting a feature, select enhancement. Otherwise ignore it unless you are experienced. If you want to know the definitions of the items in the Severity section, see this chart.
You can ignore the section latest known-working version.
Subject
Check in possibly related Bugs table on the bug-reporting page and additionally in the Duplicates Table to see whether the problem really has not been reported yet.
In the Subject section (also known as the Summary):
- Do not include information already known from the fields.
- Include the names of subcomponents from Components.
- Make the subcomponents uppercase.
- If the subcomponent can be confused with parts of a word (for example, UI is part of the word quit), surround the subcomponent with square brackets.
- Use at most two subcomponents.
- Use subcomponents exactly as they appear in the list, but you may integrate them into the subject line sentence like “WIKIHELP [UI] not available in all languages”.
- Summarize the problem fairly precisely.
- bad example: “File is broken”
- better example: “Menu File > Save as not available (greyed out)”
- Avoid short forms like “doesn’t” or “isn’t” to ease queries for strings in the Summary; instead, use the full form, such as “does not” or “is not”.
- If the problem written in the report is that LibreOffice crashes or stops responding (“hangs”), add the word CRASH to the Summary, so that these bugs can be located and tracked easily.
Description and attachments
In the Long Description or Description section, give a lengthier, factual description of the problem:
- list the steps to reproduce the bug;
- use a numbered list; and
- state the exact method to make something happen. For example, instead of writing “Open document”, write instead “In new empty LibO Spreadsheet document, use menu File > Open (LibO dialog) > file type “Text documents” > select attached sample document > double click”.
If you’re using a pre-built LibreOffice on Linux, list the exact versions of LibreOffice packages in your package management system. If you’re using Windows, list the exact filename of the installer, and from where it was downloaded.
- Including information about installed and used localization (UI language, document language) might be useful.
- Include whether a 32-bit LibreOffice is used on a 64-bit (Linux) system.
- Include the package source if it’s not the official LibreOffice build.
Write the expected behavior and the actual behavior.
You can include an attachment, such as a screenshot or a sample document. The typical way to take a screenshot is to press the "Print Screen/PrtScn" button on your keyboard. Depending on your operating system, you might have to then open an image editing application (such as Paint on Windows) and do Edit - Paste in it.
- If you create screenshots, switch the language to English before making the screenshot. You can do so in ▸ ▸ ▸ .
- You can make screenshots more useful by adding comments and marking relevant areas with LibreOffice Draw.
- If you want to attach more than one screenshot, you should collect them all in one document (copy / paste to a LibreOffice Draw document) and attach as a PDF. Please add a short comment to each screenshot to tell what you want to demonstrate with it.
- If you attach a sample document that exhibits the bug you are reporting, please make the document as minimal as possible. For example, for Writer bugs, the document should ideally have just a single paragraph. To make it easy to find the text from your document in debug tracing, use some very easily recognizable text, like AAAAAAAAAA ₂ ZZZZZZZZZZ for a bug that is triggered by that character.
- It is preferable to upload attachments individually. However, if you want to attach more than half a dozen documents, create a .zip file containing all documents and attach that .zip.
- If your attachment is too big to be attached in Bugzilla (bigger than 1 MB) you can use the Experimental upload page.
Status
The only time you should change the status to NEW is, if someone already confirmed the bug elsewhere (Ask, mailing list, some forum). In these cases, provide a link to the discussion with the confirmation.
Submit
Click Submit, and your report will be added to the Bugzilla database.
If Bugzilla seems daunting
If the Bugzilla bug tracking system seems daunting or too hard to understand, you should post your problem here:
Even if you post your problem on those channels, your goal should be to get a good bug report on Bugzilla. These channels might help you with that.
Comment rapporter les problèmes spécifiques à Ubuntu
Seuls les problèmes spécifiques à la version officielle distribuée par le projet Ubuntu devraient être rapportés suivant ces instructions :
- Vérifiez que votre problème n'est pas déjà parmi la liste de problèmes connus
- Déclarez le bogue :
- Si vous utilisez Ubuntu 10.04 LTS ou Ubuntu 10.10, ce formulaire (en anglais) et choisissez libreoffice pour "In what package did you find this bug ?".
- Si vous utilisez Ubuntu 11.04, ouvrez une fenêtre de terminal ( ▸ ▸ ) et tapez ubuntu-bug LibreOffice [Entrée], puis suivez les instructions pour compléter le rapport.
Ce que doit inclure un rapport de bogue
Les informations suivantes sont nécessaires pour nous aider à reproduire ou à localiser le problème et donc à fournir le correctif qui pourrait être disponible plus tôt pour vous :
- Si vous n'avez pas l'expérience des rapports de bogue, vous pouvez lire le bug writing guidelines (en anglais), vous y trouverez un lien en haut de la page Enter Bug !
- Utilisez correctement la sélection du Composant, de la Version et du Statut initial, des conseils figurent sur BugReport Details.
- Il y a également des sous-sélections permettant de choisir la version et l'architecture du système : e.g.
openSUSE 11.2 on x86_64, 32-bit Windows 7
- pour Linux, quelle interface : e.g.
KDE
ouGNOME
- pour Linux, quelle interface : e.g.
- La version de LibreOffice, par exemple 3.2.0. Vous l'obtenez à partir de la boîte de dialogue "Aide/À propos de LibreOffice". Si vous utilisez une pré-version de LibreOffice, sous Linux, dites les versions exactes des packages LibreOffice utilisés dans votre système de gestion de packages. Pour Windows, le nom de fichier exact de l'installeur et à partir d'où ils ont été téléchargés.
- Des informations complémentaires concernant les localisation installées et utilisées (langue de l'interface, langue du document) peuvent être utiles
- si une version 32-bit de LibreOffice est utilisée sur un système 64 bit (Linux)
- la source du package si ce n'est pas une version officielle de LibreOffice
- Veuillez indiquer un sommaire significatif pour les problèmes que vous souhaitez reporter :
- Pas de : "UI cassée"
- Mais : Menu Enregistrer sous}} non disponible (grisé)
- Étapes pour reproduire le problème, veuillez noter que chaque petit détail peut être important.
- Ainsi, n'écrivez pas : "Ouvrir le document"
- Mais: "Dans une nouvelle feuille de calcul LibO, utilisez le menu ▸ ▸ ▸ ▸
- tout autre détail utile (e.g. copies d'écran, documents d'exemple, backtrace, strace)
We are grateful for every received report. Writing a bug report can be tedious and time-consuming, but the time spent by others on analysing and eventually fixing an issue can be ten or sometimes even a hundred times longer in comparison. We therefore ask you to be understanding and kindly provide more information, if requested. Moreover, a clear report with complete information means you are well positioned for having your issue fixed.
La liste de problèmes connus affectant la version de LibreOffice distribuée officiellement avec Ubuntu se trouve à :
Refrain from posting comments along the lines of “me too” or “we have 1000 seats here and only this bug prevents us from migrating” which contain no additional useful information. An exception to this is when you comment on a bug that has been UNCONFIRMED so far. In that case, please provide reproduction steps (or confirm the ones given by the original reporter) and move the issue to status NEW. Note that if there are no clear reproduction steps, the issue might quickly move back to NEEDINFO, so finding a good and simple reproduction scenario is essential.
Comme obtenir un journal strace (sous Linux)
Minimum requirements
- OS/LibreOffice version;
- enumerated reproducible steps;
- simple attachments where appropriate; and
- observed/expected results.
Dans la plupart des cas, il est suffisant de démarrer l'application de la façon suivante :
strace -o /tmp/strace.log -f -tt -s 512 libreoffice
Puis exécutez les étapes pour reproduire le problème et quittez l'application. Commande libreoffice
peut être remplacée par
/opt/libreoffice/program/soffice surtout si vous n'avez pas l'intégration à l'environnement de bureau installée
.
Veuillez compresser le journal avant de l'attacher au rapport de bogue :
bzip2 /tmp/strace.log
Si une version 32-bit de LibreOffice est exécutée sur un système 64-bit, vous devez installer le package strace-32bit
et démarrer le binaire 32-bit directement :
cd /opt/libreoffice/program strace32 -o /tmp/strace.log -f -tt -s 512 ./soffice.bin
Comment obtenir un backtrace (sous Linux)
Reports can be less than ideal for a number of reasons. Below are some of the common problems:
One report for 5 issues
Reporting multiple issues in a single ticket―even if they affect a single document―is suboptimal, particularly in the long term. A ticket should only report a single issue.
Missing Details/Steps
All bug reports should have at minimum:
- your operating system and version of LibreOffice;
- clear reproducible steps;
- expected results;
- observed results; and
- a simple attachment where appropriate.
Adding superfluous information
Adding a lot of extra details that aren’t relevant is another common problem. Examples include:
- “this is a blocker”;
- a long list of reasons why it’s a blocker;
- “I can’t use LibreOffice because of this bug”;
- “LibreOffice sucks” (or any variation of that); and
- “I’m going to start using your competitor unless you fix it.”
Complex attachments
Attachments should be as simple as possible. Take the time to prune your examples to the bare minimum. This helps tremendously in diagnosing problems.
Assuming contributors know everything
Do not assume contributors know what you’re talking about. Describe your steps clearly, each step of the way.