]>
Commit | Line | Data |
---|---|---|
8b17e2a9 | 1 | = Contributing to WeeChat |
ecf18c81 SH |
2 | :author: Sébastien Helleu |
3 | :email: flashcode@flashtux.org | |
458dc883 SH |
4 | :lang: en |
5 | ||
ecf18c81 | 6 | |
8b17e2a9 | 7 | == Reporting bugs |
ecf18c81 | 8 | |
659cf10f | 9 | First, some basic things: |
ecf18c81 | 10 | |
659cf10f | 11 | * Use only English to communicate with developers. |
f74aa095 SH |
12 | * Search in issues if the same problem or feature request has already been |
13 | reported (a duplicate is waste of time for you and the developers!). | |
659cf10f SH |
14 | * If you can, please check if the problem has been fixed in development version |
15 | (if you are using a stable release or old version). | |
11f55cf7 | 16 | * Report only one bug or feature request per issue. |
659cf10f | 17 | |
8b17e2a9 SH |
18 | === Security reports |
19 | ||
20 | Please *DO NOT* file a GitHub issue for security related problems, but send an | |
21 | email to <security@weechat.org> instead. | |
22 | ||
659cf10f SH |
23 | === Required info |
24 | ||
8b17e2a9 SH |
25 | When reporting https://github.com/weechat/weechat/issues[issues] on GitHub, |
26 | please include: | |
659cf10f | 27 | |
c1b39ee5 SH |
28 | * Your *WeeChat version*: the output of `/v` in WeeChat, for example: |
29 | _WeeChat 1.7-dev (git: v1.6-6-g997f47f)_. + | |
8b17e2a9 | 30 | If WeeChat does not start at all, please include the version displayed by |
659cf10f | 31 | `weechat --help` (or the version installed with your package manager). |
c1b39ee5 | 32 | * Your *operating system*: its name and version (examples: Linux Debian Wheezy, |
9e5ad6aa | 33 | FreeBSD 10.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit...). |
c1b39ee5 | 34 | * The *steps to reproduce*: if possible, please include a reproducible example: |
8b17e2a9 | 35 | explain the steps which led you to the problem. + |
659cf10f SH |
36 | It's even better if you can reproduce the problem with a new config (and no |
37 | scripts loaded): try `weechat --dir /tmp/weechat` and check if you have the | |
38 | problem here. | |
c1b39ee5 SH |
39 | * The *gdb's backtrace* (only for a crash): if you can reproduce the crash |
40 | (or if you have a core file), please include the backtrace from gdb (look at | |
41 | https://weechat.org/files/doc/devel/weechat_user.en.html#report_crashes[User's guide] | |
42 | for more info). | |
084f9d7b SH |
43 | * The *actual result*. |
44 | * The *expected result*: the correct result you are expecting. | |
659cf10f | 45 | |
8b17e2a9 | 46 | [IMPORTANT] |
e6dda930 | 47 | Most of times, the WeeChat crash log file (_weechat_crash_YYYYMMDD_xxx.log_) is |
8b17e2a9 SH |
48 | *NOT USEFUL* to fix the bug, so please report this file *ONLY* if a developer |
49 | asked you to send it (and be extremely careful, this file can contain personal | |
50 | data like passwords and contents of your chats). | |
51 | ||
52 | === Scripts related issues | |
659cf10f SH |
53 | |
54 | If you are using scripts, they can cause problems/crashes. To check if the | |
55 | problem is related to one script, try to unload them one by one (using | |
56 | command `/script unload <name>`). | |
57 | ||
8b17e2a9 SH |
58 | Many issues reported are in fact related to bugs in scripts, so please first |
59 | check that before reporting any issue on WeeChat itself. | |
60 | ||
659cf10f | 61 | If you think the problem comes from a specific script, please report the issue |
8b17e2a9 SH |
62 | in the https://github.com/weechat/scripts/issues[scripts git repository] |
63 | instead. | |
659cf10f | 64 | |
8b17e2a9 | 65 | == Translations |
659cf10f | 66 | |
8b17e2a9 | 67 | Pull requests on GitHub for fixes or new translations are welcome at any |
c1b39ee5 SH |
68 | time, for https://github.com/weechat/weechat[WeeChat] and the web site |
69 | https://github.com/weechat/weechat.org[weechat.org]. | |
659cf10f | 70 | |
8b17e2a9 | 71 | To start a translation in a new language (not yet supported), please look at |
0cd2aff7 | 72 | https://weechat.org/files/doc/devel/weechat_dev.en.html#translations[translations] |
8b17e2a9 | 73 | in Developer's guide. |
ecf18c81 SH |
74 | |
75 | == Feature requests | |
76 | ||
77 | WeeChat is under active development, so your idea may already have been | |
63b2b30d | 78 | implemented, or scheduled for a future version (you can check in |
0cd2aff7 | 79 | https://weechat.org/dev[roadmap] or |
8b17e2a9 | 80 | https://github.com/weechat/weechat/milestones[milestones] on GitHub. |
ecf18c81 | 81 | |
8b17e2a9 | 82 | Pull requests on GitHub are welcome for minor new features. |
ecf18c81 | 83 | |
8b17e2a9 | 84 | For major new features, it's better to discuss about it in IRC |
e6dda930 | 85 | (server: _chat.freenode.net_, channel _#weechat_). |
ecf18c81 | 86 | |
8b17e2a9 | 87 | Before submitting any pull request, be sure you have read the |
0cd2aff7 | 88 | https://weechat.org/files/doc/devel/weechat_dev.en.html#coding_rules[coding rules] |
8b17e2a9 SH |
89 | in Developer's guide, which contains info about styles used, naming convention |
90 | and other useful info. |