| Please **do not** send pull-requests or open new issues on Github. |
|
|
| Github is a downstream mirror and is not frequently monitored, |
| all development is coordinated upstream on GNU resources. |
|
|
| * Send general questions or suggestions to: coreutils@gnu.org . |
| * Send bugs reports to: bug-coreutils@gnu.org . |
|
|
| ## Bug reports |
|
|
| Before reporting a new bug, please check the following resources: |
|
|
| * Coreutils FAQ: https://www.gnu.org/software/coreutils/faq/coreutils-faq.html |
|
|
| * Coreutils Gotchas: https://www.pixelbeat.org/docs/coreutils-gotchas.html |
| contains a list of some quirks and unexpected behavior (which are often |
| mistaken for bugs). |
|
|
| * Online Manual: |
| https://www.gnu.org/software/coreutils/manual/html_node/index.html |
|
|
| * Search the archives for previous questions and answers: |
|
|
| * Coreutils Mailing list (General usage and advice): |
| https://lists.gnu.org/archive/html/coreutils/ |
|
|
| * Bug reports Mailing List: |
| https://lists.gnu.org/archive/html/bug-coreutils/ |
|
|
| * Open Bugs: |
| https://debbugs.gnu.org/cgi/pkgreport.cgi?which=pkg&data=coreutils |
|
|
| * Translation related issues: |
| https://translationproject.org/domain/coreutils.html |
|
|
|
|
| ## Effective bug reports |
|
|
| * Include a descriptive subject line (e.g. the program with which |
| you experience a problem, and what the problem is). |
| * Include the version of the program (e.g. the output of `PROG --version`). |
| * Include the operating system and the type of hardware you are using |
| (e.g. the output of `uname -a`). |
| * Include the exact command and parameters you have used. |
| * Clearly explain what is the output you expected to get, and what is |
| the actual result you encountered. |
| * Include as much information as possible to reproduce the problem. |
| If the problem happens on a very large input file, try to provide |
| a minimal example (a subset of the input file) that still causes the problem. |
| *Do not* include attachments over 40kB. |
| * List policy is reply-to-all, and non-subscribers may post. |
| * There may be a moderation delay for a first-time post, whether or not |
| you subscribe. |
|
|
|
|
| ## Mailing List Etiquette |
|
|
| When sending messages to coreutils@gnu.org or bug-coreutils@gnu.org : |
|
|
| * Send messages as plain text. |
| * Do not send messages encoded as HTML nor encoded as base64 MIME nor |
| included as multiple formats. |
| * Avoid sending large messages, such as log files, system call trace |
| output, and other content resulting in messages over about 40 kB. |
| * Avoid sending screenshots (e.g. PNG files). When reporting errors |
| you encounter on the terminal, copy and paste the text to your message. |
|
|
|
|
|
|
| <!-- |
| Copyright (C) 2017-2025 Free Software Foundation, Inc. |
|
|
| This program is free software: you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation, either version 3 of the License, or |
| (at your option) any later version. |
|
|
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
|
|
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <https://www.gnu.org/licenses/>. |
| --> |
|
|
