iiiypuk/hexchat
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Converting, renaming, relocating

Browse Source
This commit is contained in:
Berke Viktor
2012-10-26 01:03:52 +02:00
parent a3c3608b1d
commit fb8d1a383d
10 changed files with 114 additions and 121 deletions
Download Patch File Download Diff File Expand all files Collapse all files

340
share/doc/COPYING Normal file
View File

@@ -0,0 +1,340 @@
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Library General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) 19yy <name of author>
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 2 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, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) 19yy name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.
<signature of Ty Coon>, 1 April 1989
Ty Coon, President of Vice
This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Library General
Public License instead of this License.

2265
share/doc/ChangeLog Normal file
View File

File diff suppressed because it is too large Load Diff

51
share/doc/HACKING Normal file
View File

@@ -0,0 +1,51 @@
Just some tips if you're going to help with HexChat code (patches etc):
* Use tabs, not spaces, to indent code.
* Use a tab size of 3 (most editors will let you choose this).
Type :set ts=3 in vim/gvim.
* Try to stick to the same consistant coding style:
void
routine (void)
{
if (function (a, b, c))
{
x = a + 1;
}
}
(vertically aligned braces, a space after if, while, functions etc).
* Don't use "//" C++ style comments, some compilers don't like them.
* When opening a file with unix level functions (open, read/write, close)
as opposed to the C-level functions (fopen, fwrite/fread, fclose), use
the OFLAGS macro. This makes sure it'll work on Win32 aswell as unix e.g:
fh = open ("file", OFLAGS | O_RDONLY);
* Use closesocket() for sockets, and close() for normal files.
* Don't read() from sockets, instead use recv().
* Please provide unified format diffs (run diff -u).
* Call your patch something more meaningfull than hexchat.diff (I get a
million of these files!).
* To make a really nice and clean patch, do something like this:
Have two directories, unpacked from the original archive:
hexchat-2.0.0/
hexchat-2.0.0p1/
Then edit/compile the hexchat-2.0.0p1 directory. When you're done, make
a patch with:
cd hexchat-2.0.0p1
make distclean
cd ..
diff -urN hexchat-2.0.0 hexchat-2.0.0p1 > hexchat-something.diff
If using nmake (Windows) replace "make distclean" with "nmake -f makefile.msc clean"

568
share/doc/changelog.md Normal file
View File

@@ -0,0 +1,568 @@
# HexChat ChangeLog
## 2.9.3 (2012-10-14)
- fix various URL detection bugs
- fix default folders for file transfers in portable mode
- fix Autotools warnings with recent releases
- add /ADDSERVER command
- add option to save URLs to disk on-the-fly
- add option to omit alerts when marked as being away
- add default icons for channel tree and option to turn them off
- change certain default colors
- enhance Non-BMP filtering performance
- accept license agreement by default on Windows
- update the network list
## 2.9.2 (2012-10-05)
- fix compilation on Red Hat and Fedora
- fix portable to non-portable migrations on Windows
- fix ban message in HexTray
- fix icon in Connection Complete dialog
- fix determining if the log folder path is full or relative
- fix desktop notification icons on Unix
- fix URL grabber saving an unlimited number of URLs by default
- fix URL grabber memory leaks under certain circumstances
- fix URL grabber trying to export URL lists to system folders by default
- fix opening URLs without http(s)://
- add support for regenerating text events during compilation on Windows
- add support for the theme manager on Unix
- add Unifont to the default list of alternative fonts
- add option to retain colors in the topic
- allow the installer to preserve custom GTK+ theme settings on Windows
- use the icons subfolder of the config folder for loading custom icons
- use port 6697 for SSL connections by default
- install the SASL plugin by default on Windows
- /lastlog improvements
- build system cosmetics on Unix
- open links with just left click by default
- enable timestamps and include seconds by default
- make libproxy an optional dependency on Unix
- update German translation
- update the network list
## 2.9.1 (2012-07-27)
- fix installing/loading plugins on Unix
- fix restoring the HexChat window via shortcuts on Windows
- fix HexTray icon rendering for certain events
- fix the Show marker line option in Preferences
- fix /lastlog regexp support on Windows
- add support for the Checksum, Do At, FiSHLiM and SASL plugins on Unix
- add option to retain colors when displaying scrollback
- add MS Gothic to the default list of alternative fonts
- rebranding and cleanup
- eliminate lots of compiler warnings
- Unix build system fixes and cosmetics
- make Git ignore Unix-specific intermediate files
- use better compression for Windows installers
- switch to GTK+ file dialogs on Windows
- restructure the Preferences window
- use the addons subfolder of the config folder for auto-loading plugins/scripts
- improve the dialog used for opening plugins/scripts
- remember user limits in channel list between sessions
- remember last search pattern during sessions
- update XChat to r1521
## 2.9.0 (2012-07-14)
- rebranding
- migrate code to GitHub
- update XChat to r1515
- fix x64 Perl interface installation for Perl 5.16
- improve URL detection with new TLDs and file extensions
## 1508-3 (2012-06-17)
- add XChat Theme Manager
- fix problems with Turkish locale
## 1508-2 (2012-06-15)
- add support for Perl 5.16
- update Do At plugin
- fix drawing of chat area bottom
- avoid false hits when restoring from tray via shortcut
- migrate from NMAKE to Visual Studio
## 1508 (2012-06-02)
- remove Real Name from Network List
- search window improvements
- restore XChat-WDK from tray via shortcut if X-Tray is used
## 1507 (2012-05-13)
- update OpenSSL to 1.0.1c
- FiSHLiM updates
## 1506 (2012-05-04)
- update OpenSSL to 1.0.1b
- update German translation
## 1503 (2012-03-16)
- update OpenSSL to 1.0.1
- URL grabber updates
- FiSHLiM updates
## 1500 (2012-02-16)
- add option for specifying alternative fonts
- fix crash due to invalid timestamp format
- X-Tray cosmetics
## 1499-7 (2012-02-08)
- fix update notifications
- fix compilation on Linux
- add IPv6 support to built-in identd
## 1499-6 (2012-01-20)
- add DNS plugin
## 1499-5 (2012-01-20)
- built-in fix for client crashes
- update OpenSSL to 1.0.0g
## 1499-4 (2012-01-18)
- add Non-BMP plugin to avoid client crashes
## 1499-3 (2012-01-15)
- rework and extend plugin config API
- add ADD/DEL/LIST support to X-SASL
## 1499-2 (2012-01-11)
- add X-SASL plugin
## 1499 (2012-01-09)
- fix saving FiSHLiM keys
- update OpenSSL to 1.0.0f
## 1498-4 (2011-12-05)
- fix updates not overwriting old files
- display WinSys output in one line for others
- use Strawberry Perl for building
## 1498-3 (2011-12-02)
- add plugin config API
- add Exec plugin
- add WinSys plugin
- perform periodic update checks automatically
## 1498-2 (2011-11-25)
- add FiSHLiM plugin
- add option to allow only one instance of XChat to run
## 1498 (2011-11-23)
- separate x86 and x64 installers (uninstall any previous version!)
- downgrade GTK+ to 2.16
- re-enable the transparent background option
- various X-Tray improvements
- add WMPA plugin
- add Do At plugin
- automatically save set variables to disk by default
- update OpenSSL to 1.0.0e
## 1496-6 (2011-08-09)
- add option to auto-open new tab upon /msg
- fix the update checker to use the git repo
- disable update checker cache
## 1496-5 (2011-08-07)
- fix attach/detach keyboard shortcut
- add multi-language support to the spell checker
## 1496-4 (2011-07-27)
- recognize Windows 8 when displaying OS info
- update OpenSSL certificate list
- fix X-Tray blinking on unselected events
- fix X-Tray keyboard shortcut handling
- cease support for Perl 5.10
- use Strawberry Perl for 5.12 DLLs
## 1496-3 (2011-06-16)
- add option for changing spell checker color
## 1496-2 (2011-06-05)
- add support for custom license text
## 1496 (2011-05-30)
- display build type in CTPC VERSION reply
- add support for Perl 5.14
## 1494 (2011-04-16)
- update Visual Studio to 2010 SP1
- update OpenSSL to 1.0.0d
- ship MySpell dictionaries in a separate installer
## 1489 (2011-01-26)
- fix unloading the Winamp plugin
- enable the Favorite Networks feature
- add Channel Message event support to X-Tray
- add mpcInfo plugin
## 1486 (2011-01-16)
- fix a possible memory leak in the update checker
- fix XChat-Text shortcut creation
- fix XChat version check via the plugin interface
- add option for limiting the size of files to be checksummed
- add X-Tray as an install option
- disable Plugin-Tray context menu completely
## 1479-2 (2011-01-10)
- improve command-line argument support
- add auto-copy options
- enable XChat-Text
- disable faulty tray menu items
## 1479 (2010-12-29)
- update GTK+ to 2.22.1
- update OpenSSL to 1.0.0c
- update Python to 2.7.1
- replace X-Tray with Plugin-Tray
## 1469-3 (2010-10-20)
- add Checksum plugin
- menu integration for Update Checker and Winamp
## 1469-2 (2010-10-09)
- fix DCC file sending
- native open/save dialogs
- make the version info nicer
- register XChat-WDK as IRC protocol handler
- add option to run XChat-WDK after installation
- disable erroneous uninstall warnings
- disable Plugin-Tray, provide X-Tray only
- cease support for Perl 5.8
- replace EasyWinampControl with Winamp
## 1469 (2010-10-08)
- use Visual C++ 2010 for all WDK builds
- build Enchant with WDK and update it to 1.6.0
- fix SSL validation
- fix opening the config folder from GUI in portable mode
- further improve dialog placement for closing network tabs
## 1468-2 (2010-10-02)
- update GTK+ to 2.22
- spelling support
- more config compatibility with official build
- improve dialog placement for closing network tabs
- remove themes from the installer
- disable toggle for favorite networks until it's usable
- disable transparent backgrounds
- hide mnemonic underlines until Alt key pressed
- fix XP lagometer and throttlemeter rendering
## 1468 (2010-09-19)
- update Perl to 5.12.2
- update Tcl to 8.5.9
- fix scrollback shrinking
- enable advanced settings pane
- retain emoticon settings
- add /IGNALL command
## 1464-6 (2010-09-06)
- fix Perl interface breakage
- update checker plugin
## 1464-5 (2010-08-30)
- primitive update checker
## 1464-4 (2010-08-30)
- selectable tray icon
- selectable theme for portable
- selectable plugins
## 1464-3 (2010-08-29)
- black theme for portable
## 1464-2 (2010-08-29)
- make Perl version selectable during install
## 1464 (2010-08-26)
- Perl interface updates
## 1462 (2010-08-25)
- update XChat to r1462
- build system cleanup
## 1459-3 (2010-08-23)
- more installer changes (uninstall any previous version!)
## 1459-2 (2010-08-23)
- universal installer
- update build dependencies
## 1459 (2010-08-19)
- portable mode and installer fixes
## 1457 (2010-08-17)
- disable GUI warnings
## 1455-2 (2010-08-17)
- unified installer for standard and portable
## 1455 (2010-08-15)
- support for gtkwin_ptr in the Perl interface
## 1454 (2010-08-14)
- gtkwin_ptr for plugins introduced
## 1452 (2010-08-14)
- fix taskbar alerts on x86
- upgrade Perl to 5.12 and make 5.8/5.10 builds available separately
## 1451-6 (2010-08-12)
- include Lua-WDK with the installer
## 1451-5 (2010-08-12)
- switch to Inno Setup (uninstall any previous version!)
- add Lua support
## 1451-4 (2010-08-11)
- enable the XDCC plugin
## 1451-3 (2010-08-11)
- enable Python support
## 1451-2 (2010-08-11)
- enable SSL support
- fix simultaneous connections
- re-enable identd by default
## 1451 (2010-08-10)
- update XChat to r1451
- disable identd by default
- remove DNS plugin
## 1444 (2010-07-30)
- update XChat to r1444
- downgrade Tcl to 8.5
- add Tcl support to the x64 build
## 1441 (2010-06-15)
- update XChat to r1441
- enable transfer of files bigger than 4 GB
## 1439 (2010-05-30)
- update XChat to r1439 (2.8.8)
## 1431-6 (2010-05-30)
- re-enable the transparent background option
- add branding to Plugin-Tray
- installer updates
## 1431-5 (2010-05-29)
- fix installer
- add DNS plugin status messages
## 1431-4 (2010-05-28)
- disable the transparent background option
- downgrade GTK+ to more stable 2.16
## 1431-3 (2010-05-23)
- add portable build support
## 1431-2 (2010-05-22)
- replace X-Tray with Plugin-Tray
## 1431 (2010-05-21)
- update XChat to r1431
- include a lot of XChat translations added since 2.8.6
## 1412-3 (2010-05-02)
- fix GTK function call
## 1412-2 (2010-05-02)
- re-enable taskbar alerts on x64
## 1412 (2010-05-02)
- update XChat to r1412
- update GTK+ and friends
- update Visual Studio to 2010
- fix Perl warning message
- include GTK L10n with the installer
## 1409-9 (2010-04-18)
- fix loading of scrollback
## 1409-8 (2010-04-03)
- fix X-Tray on x64
## 1409-7 (2010-04-02)
- disable taskbar notification options
## 1409-6 (2010-03-31)
- display version numbers everywhere
## 1409-5 (2010-03-31)
- add DNS plugin
- add EasyWinampControl plugin
- disable Plugin-Tray settings
## 1409-4 (2010-03-30)
- add X-Tray
## 1409-3 (2010-03-29)
- plugin linkage fixes
## 1409-2 (2010-03-29)
- enable IPv6 support
- enable NLS support
- enable Perl support
- enable Tcl support
## 1409 (2010-03-29)
- initial release

321
share/doc/faq.md Normal file
View File

@@ -0,0 +1,321 @@
HexChat Frequently Asked Questions
==================================
Using HexChat.
--------------
### How do I autoconnect and join a channel when HexChat loads?
In the Network list select the Network you want to auto-connect to and
click Edit and turn ON the "Auto connect to this network at startup"
checkbox.
List channels in the favorites list to join them on connect.
### Why does HexChat join channels before identifying?
When using the nickserv password HexChat waits a short time before joining.
To change this value (which is in seconds) by running:
> /set irc\_join\_delay number
The other option is SASL which is network dependant and can be enabled in the Network list (2.9.4+).
### How do I connect through a proxy?
Go to the menus, *Settings* -> *Preferences* -> *Network Setup* and fill in
the requested information there. Authentication (using a username and
password) is only supported for HTTP and Socks5.
### How do I show @ and + in front of nicknames that are Op and Voice when they talk?
To display @ and + characters next to nicknames as they talk, do the
following:
In the menus, open up Settings -> Text Events. Find the
*Channel Message* event in the list. The $3 code can be inserted to
print the user's mode-character (e.g. @ or +). For example, you might
want to change the default:
> %C18%H<%H$4$1%H>%H%O$t$2
To
> %C18%H<%H$4$3$1%H>%H%O$t$2
Don't forget to **press Enter**, so the changes take effect in the list at
the top of the window.
### How do I change the Op and Voice userlist icons and Tree View icons?
You can override the default icons by placing PNG files with the names listed below in
the specified directory.
#### Files
**userlist:**
> - op.png
> - hop.png
> - voice.png
> - red.png *(1 level above op)*
> - purple.png *(2 levels above op)*
**channeltree:**
> - server.png
> - channel.png
> - dialog.png
> - util.png *(Channel List, DCC, etc (if enabled as tabs))*
**tray:**
> - message.png
> - highlight.png
> - fileoffer.png
> - hexchat.png
#### Locations
You will need to create the directory.
* Unix/Linux
> ~/.config/hexchat/icons
* Windows
> %APPDATA%\\HexChat\\icons
You can hide either of them in Preferences.
### How do I set different ban types?
1. Right click the nickname in the userlist, and choose a ban type from the "Kick/Ban" submenu.
2. You can also do it manually:
> /ban nick bantype where the bantype is a number from 0 to 3.
3. Or set the default with:
> /set irc\_ban\_type bantype sets the default ban type to use for all bans. The different types are:
>
> - 0 = \*!*@*.host
> - 1 = \*!*@domain
> - 2 = \*!*user@*.host
> - 3 = \*!*user@domain
### Why does the timestamp overlap some nicknames?
Some networks allow very long nicknames (up to 32 letters). It can be
annoying to have the separator bar move too far to the right, just for
one long nick. Therefore, it has a set limit for the distance it will
move to the right. If you use a large font, you may need to adjust this
distance. It is set in pixels, for example:
> /set text\_max\_indent 320
Once you adjust this setting high enough, overlapping timestamps and
nicknames should not occur. The adjustment will not take effect
immediately, a restart may be needed.
### How do I turn on Conference mode where I will not see join or part messages?
Right-click on the tab you want to change. In the submenu of the channel
name, there's a toggle-item "Show join/part messages", simply turn this
off.
If you want to turn this option on globally go to *Preferences* -> *Advanced*
Then all channels you join **after** setting this will start with "Show
join/part messages" turned off.
### Why doesn't DCC send work behind a router (IPNat/ADSL)?
If you are behind a IP-NAT or ADSL router, you will most likely have an
address like 192.168.0.1. This address is not usable on the Internet,
and must be translated.
When offering a DCC file, HexChat will tell the receiver your address.
If it says 192.168.0.1, the receiver will not be able to connect. One
way to make it send your "real" address is to enable the "Get my IP from
IRC Server" option in HexChat. This option is available in Preferences
-> File Transfers. When you turn it ON, you will have to re-login to
the server before it'll take effect.
You will also need to forward some ports for use in DCC send. You may
pick almost any port range you wish, for example, in HexChat set:
> First DCC send port: 4990
> Last DCC send port: 5000
This will allow you to send up to ten files at the same time, which
should be plenty for most people. Lastly, configure your router/modem to
forward ports 4990-5000 to your PC's address. You'll have to consult
your router/modem's manual on how to do this.
### How do I execute multiple commands in one line?
There are three ways to do this:
- /LOAD -e <textfile>, where <textfile> is a full pathname to a
file containing commands on each line.
- Separate your commands with CTRL-SHIFT-u-a. This will appear as
a little box with numbers onit.
- You can create two UserCommands, with the same name, and then
execute the UserCommand. It will be executed in the same order as
it's written in the UserCommands GUI.
### I get this error: "Unknown file type abc.yz. Maybe you need to install the Perl or Python plugin?"
If you get this error when trying to load a Perl or Python script, it
means the plugin for running those scripts isn't loaded.
- The Perl, Python and TCL plugins come with HexChat in the same
archive.
- During ./configure, it will check for Perl, Python and TCL libs and
headers, you should check if it failed there.
- The plugins directory can be found by issuing the shell command
> hexchat -p
- All *.so files are auto-loaded at startup (*.dll on Windows).
- If you downloaded a binary package, maybe the packager decided to
exclude the Perl or Python plugins.
### How do I play sound files on certain events?
In the menus, go to: *Settings* -> *Preferences* -> *Sound*. Select the event
you want to make a sound on, then type in a sound filename (or use the
Browse button).
### How do I auto-load scripts at startup?
The root of your HexChat config is:
- Windows: %APPDATA%\\HexChat
- Unix/Linux: ~/.config/hexchat
Referred to as config from now. HexChat automatically loads, at startup:
> - config/addons/*.lua Lua scripts
> - config/addons/*.pl Perl scripts
> - config/addons/*.py Python scripts
> - config/addons/*.tcl Tcl scripts
> - config/addons/*.dll Plugins (Windows)
> - config/addons/*.so Plugins (Unix)
The addons dir may need to be created.
### How do I minimize HexChat to the System Tray (Notification Area)?
On both Unix and Windows there is an included tray plugin.
To enable minimizing to tray on exit:
> /set gui\_tray\_flags -on 1
For minimizing to tray on minimize:
> /set gui\_tray\_flags -on 4 *(use -off to disable)*
Alerts for this tray are in *Preferences* -> *Alerts*
The other option is Windows only, called HexTray. It is included with the installer.
Right click on the tray icon for its options.
### Where are the log files saved to?
* Unix/Linux
> ~/.config/hexchat/logs
* Windows
> %APPDATA%\\HexChat\\logs
### How do I rotate log files every so often?
By default settings, no rotation occurs, your log files will just keep getting larger.
Go to *Settings* -> *Preferences* -> *Logging* and change the log filename to any one of these:
> %Y-%m-%d/%n-%c.log ->2006-12-30/FreeNode-\#channel.log
>
> %n/%Y-%m-%d/%c.log ->FreeNode/2006-12-30/\#channel.log
>
> %n/%c.log -> FreeNode/\#channel.log (no rotation)
%Y, %m and %d represents the current year, month and day respectively.
%n is the network name, e.g. "FreeNode" or "UnderNet", and finally, %c
is the channel. In these examples, a new log filename and folder would
be created after midnight.
You can find more possibilities at
[http://xchat.org/docs/log/](http://xchat.org/docs/log/).
### Where did the Real Name field go?
The real name field is now removed from the Network List. This is in
order to avoid alienating newcomers (some might be afraid of their
personal data).
The network-specific real name can still be set via the GUI. If you want
to modify the global real name, just issue the following command:
> /set irc\_real\_name Stewie Griffin
### How do I migrate my settings from XChat?
* UNIX/Linux
> 1. Copy ~/.xchat2 to ~/.config/hexchat
> 2. Rename ~/.config/hexchat/xchat.conf to ~/.config/hexchat/hexchat.conf
> 3. Rename ~/.config/hexchat/xchatlogs to ~/.config/hexchat/logs
> 4. Move all your 3rd party addons to ~/.config/hexchat/addons
> 5. Rename ~/.config/hexchat/plugin\_\*.conf to ~/.config/hexchat/addon\_\*.conf
* Windows
> 1. Copy *%APPDATA%\\X-Chat 2 to %APPDATA%\\HexChat
> 2. Rename *%APPDATA%\\HexChat\\xchat.conf to %APPDATA%\\HexChat\\hexchat.conf
> 3. Rename *%APPDATA%\\HexChat\\xchatlogs to %APPDATA%\\HexChat\\logs
> 4. Move all your 3rd party addons to %APPDATA%\\HexChat\\addons
> 5. Rename *%APPDATA%\\HexChat\\plugin\_\*.conf to %APPDATA%\\HexChat\\addon\_\*.conf
Contributions, Development and Bugs.
------------------------------------
### I found a bug, what can I do?
Firstly, make sure it's the latest stable version of HexChat.
If you still experience issues, you can search for the issue on
[Github](https://github.com/hexchat/hexchat/issues?state=open)
if it has not been reported open an issue with as much detail as possible.
### Can I write a new language translation for HexChat?
You sure can, but I don't accept translations directly. They must be
done through the [Transifex
Project](https://www.transifex.com/projects/p/hexchat/). Bear in mind
that the email address with which you register on Transifex will be
visible in the translation files.
* * * * *
For pretty html: `pandoc --toc -s faq.md -o faq.html`

114
share/doc/readme.md Normal file
View File

@@ -0,0 +1,114 @@
# HexChat ReadMe
X-Chat ("xchat") Copyright (c) 1998-2010 By Peter Zelezny.
HexChat ("hexchat") Copyright (c) 2009-2012 By Berke Viktor.
This program is released under the GPL v2 with the additional exemption
that compiling, linking, and/or using OpenSSL is allowed. You may
provide binary packages linked to the OpenSSL libraries, provided that
all other requirements of the GPL are met.
See file COPYING for details.
For building instructions, see http://www.hexchat.org/developers/building
## What is it?
HexChat is an IRC client for Windows and UNIX operating systems. I.R.C. is
Internet Relay Chat, see http://irchelp.org for more information about IRC
in general. HexChat runs on most BSD and POSIX compliant operating systems.
## Requirements:
* GTK+ 2.10
* GLib 2.12
HexChat is known to work on, at least:
* Windows XP/Vista/7/8
* Linux
* FreeBSD
* OpenBSD
* NetBSD
* Solaris
* AIX
* IRIX
* DEC/Compaq Tru64 UNIX
* HP-UX 10.20 and 11
* OS X
## Notes for packagers:
If you need your packages to work on i386, you don't need to compile with
--disable-mmx, because it's also checked at run-time.
## Python Scripts:
Scripts for XChat 1.8.x are not compatible, a brand new interface has been
written. The documentation can be found here:
https://github.com/hexchat/hexchat/wiki/Python-Interface
Consider using the Python interface for your scripts, it's a very nice
API, allows for loading/unloading individual scripts, and gives you
almost all the features of the C-Plugin API.
## Perl Scripts:
Perl 5.8 or newer is required. The documentation can be found here:
https://github.com/hexchat/hexchat/wiki/Perl-Interface
Scripts for XChat 1.8.x are compatible with the following exceptions:
* IRC::command will not interpret %C, %B, %U etc.
* user_list and user_list_short:
If a user has both op and voice, only the op flag will be 1.
* add_user_list/sub_user_list/clear_user_list
These functions do nothing.
* notify_list
Not implemented. Always returns an empty list.
* server_list
Lists servers that are not connected aswell.
* Some print events may have new names and some were added.
* Text printed by scripts must now be UTF8.
* Text passed to scripts (via add_message_handler) will be encoded in UTF8.
## Autoloading Scripts and Plugins:
The root of your HexChat config is:
* Windows: %APPDATA%\HexChat
* Unix: ~/.config/hexchat
Referred to as < config > from now. HexChat automatically loads, at startup:
* < config >/addons/*.lua Lua scripts
* < config >/addons/*.pl Perl scripts
* < config >/addons/*.py Python scripts
* < config >/addons/*.tcl Tcl scripts
* < config >/addons/*.dll Plugins (Windows)
* < config >/addons/*.so Plugins (Unix)
## Control Codes:
* %% - A single percentage sign
* %C - Control-C (mIRC color code)
* %B - Bold Text
* %U - Underline Text
* %R - Reverse Text
* %O - Reset all Text attributes
* %XXX - ASCII XXX (where XXX is a decimal 3 digit number, e.g.: %007 sends a BEEP)
%Cforeground,background will produce a color code, e.g.: %C03,10
These are now disabled by default (see Settings > Preferences > Input Box).
Instead you can insert the real codes via ctrl-k, ctrl-b and ctrl-o.