summaryrefslogtreecommitdiff
path: root/plugins/Popup/docs
diff options
context:
space:
mode:
authorVadim Dashevskiy <watcherhd@gmail.com>2012-05-15 10:38:20 +0000
committerVadim Dashevskiy <watcherhd@gmail.com>2012-05-15 10:38:20 +0000
commit48540940b6c28bb4378abfeb500ec45a625b37b6 (patch)
tree2ef294c0763e802f91d868bdef4229b6868527de /plugins/Popup/docs
parent5c350913f011e119127baeb32a6aedeb4f0d33bc (diff)
initial commit
git-svn-id: http://svn.miranda-ng.org/main/trunk@2 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c
Diffstat (limited to 'plugins/Popup/docs')
-rw-r--r--plugins/Popup/docs/Changelog.txt67
-rw-r--r--plugins/Popup/docs/changelog_popup.txt50
-rw-r--r--plugins/Popup/docs/faq_popup.txt125
-rw-r--r--plugins/Popup/docs/license_popup.txt348
-rw-r--r--plugins/Popup/docs/popupplus_translate.txt149
-rw-r--r--plugins/Popup/docs/readme_popup.txt276
-rw-r--r--plugins/Popup/docs/rebase_popup.txt32
-rw-r--r--plugins/Popup/docs/road_map.txt11
-rw-r--r--plugins/Popup/docs/skin_popup.txt87
-rw-r--r--plugins/Popup/docs/translation_popup.txt127
10 files changed, 1272 insertions, 0 deletions
diff --git a/plugins/Popup/docs/Changelog.txt b/plugins/Popup/docs/Changelog.txt
new file mode 100644
index 0000000000..de46d15d50
--- /dev/null
+++ b/plugins/Popup/docs/Changelog.txt
@@ -0,0 +1,67 @@
+Popup Plus: 2.1.1.6
++added support for custom langpacks
++added hotkey to open popup history
++added action copy to clipboard
+-removed old PLUGININFO support
+*some typos
+*fixed errors with ansi plugins
+*fixed destroying all of popups windows before unloading
+*added destroing functions on exit
+*background can now be changed together with font in font options
+*link to skins section in options page
+*unhook events on exit and resource optimization
+*Fullscreen detection from core
+*Skins tab moved to Skins-PopUps
+*fixes re-enabling the "reorder popups" option
+
+2.1.1.5
++ support new mtextcontrol interface (need new mtextcontrol.dll 0.8.0.1 or later)
+- support mtextcontrol by miranda service call
++ seperate x64 unicode release PopUpW.dll
++ seperate unicode release PopUpW.dll
+* move svn to http://svn.miranda.im/mainrepo/popup
++ support Popup classes API
+* strong cleanup/fixes in code and redesigned options
+! multimonitor setting for hotswap
++ unicode support for quickreply
++ support for autoexec.ini in notificatione
+! multi "Popups" menu (!!!other plugins should wait for modulsloaded to add submenu!!!)
+! large action icon fix (default actions)
+* hiostory size setting applied without restart
+
+2.1.1.3:
+! missing show default button (contact options)
++ debug setting
+* notification options
+ -> deltete default notification
+ -> layout cleanup
+ -> tab hidden when no notification registered
+* changes/cleanup in option
+* translate left/right mouse action in notifications
+* Test effect renamed to Sqare fading
+* moved options from customize > popups to popups (thanks to mataes)
+* small changes+fixes
+
+2.1.1.2 (RC2):
+reworked changes from RC1 doe to lost code. check if it works as before.
+
+2.1.1.1 (RC1):
+! middle mouse calles right mouse button as well
+! override with contact actions only for contacts (prevents some freeze)
++ option dialog for override
++ added pin action for override
++ Hotkeysupport to toogle Popups
+* try to solve multiple popup menus
+* default skin folder %miranda%/skins/popup
+
+2.1.1.0 (BETA):
+! prevent sending empty messages
+* deleted unused test actions + small cleanup
+* tray notification not mounted by default
+* quickreply listed in action (can turn off)
+* default skin folder %miranda%/customize/skins/popup
+* root menu item shows current status
++ override left/right mouse action ------------- (change by DB value)
++ added middle mouse action ------------- (change by DB value)
++ toolbar button added
++ PopUp/GetStatus as new service to get real status of plugin (couldnt override PopUp/ModuleIsEnabeled) \ No newline at end of file
diff --git a/plugins/Popup/docs/changelog_popup.txt b/plugins/Popup/docs/changelog_popup.txt
new file mode 100644
index 0000000000..c044db186f
--- /dev/null
+++ b/plugins/Popup/docs/changelog_popup.txt
@@ -0,0 +1,50 @@
+popup plus 2.0.3.96 RC1 internal, 05-11-28, 00:44
+ [-] Fixed line breaks
+
+popup plus 2.0.3.96 RC1 internal, 05-11-27, 01:07
+ [-] Single-window mode is now back again... Implementation is completely new now
+ [-] Fixed fade out bug with disabled sliding and enabled transparency
+ [-] Multithreading fix (should help with cross-popup text mess)
+ [-] Other small fixes
+
+popup plus 2.0.3.96 RC1 internal, 05-11-19, 02:55
+ [!] Fixed memory corruption on window destruction
+ [-] Fixed fade out bug with disabled sliding
+ [-] Fixed some bugs in render (probably multiple reported statup crashes)
+ [-] Fixed proportional image measuring bug (mainly avatars, thanx theMIRon)
+
+popup plus 2.0.3.96 RC1 internal, 05-11-17, 00:49
+ [*] Fixed animation bug (jumping windows)
+ [-] Metacontact support (thanx pescuma for details)
+ [-] Small text render fix (some pixels were transparent)
+
+popup plus 2.0.3.96 RC1 internal, 05-11-16, 00:22
+ [*] Fixed timing issues in popup reordering
+ [-] Fixed animation on win9x systems
+
+popup plus 2.0.3.96 RC1 internal, 05-11-11, 01:06
+ [-] Fixed memory leak in multithreading code (I hope so!)
+ [-] Fixed GDI leak (one object per popup, or so...)
+
+popup plus 2.0.3.96 RC1 internal, 05-11-02, 13:09
+ [-] Fixed some crashes
+ [-] Some code cleanings
+
+popup plus 2.0.3.96 RC1 internal, 05-10-22, 01:31
+ [-] Fixed crash on preview without Avatar Service installed
+ [*] Cosmetic changes in preview
+
+popup plus 2.0.3.96 RC1 internal, 05-10-21, 23:00
+ [-] Fixed animation speed
+ [-] Fixed popup sizing issue
+ [*] Avatars hidden on contact list are not visible in popups too
+ [*] New preview item with random avatar and multiline title, this is useful for skin designers.
+
+older parts will be here later :)
+
+--------------------------------------------------------------------------------
+Legend:
+ [!] important note
+ [+] added feature
+ [*] improved/changed feature
+ [-] bug fixed
diff --git a/plugins/Popup/docs/faq_popup.txt b/plugins/Popup/docs/faq_popup.txt
new file mode 100644
index 0000000000..43a7d31eb6
--- /dev/null
+++ b/plugins/Popup/docs/faq_popup.txt
@@ -0,0 +1,125 @@
+===============================================================================
+ PopUp - Frequently Asked Questions
+===============================================================================
+
+Hi everybody,
+this is a collection of frequently asked questions: please read them, all of
+them.
+99% of the times I receive questions which already have an answer here. :-)
+
+I will try to explain myself easily, so that NON-SPEAKING ENGLISH users will
+understand too.
+
+I last updated this file when I released version: 1.0.1.9
+===============================================================================
+
+[1.0.1.9] Q: The plugin is good, but I don't see the popups when a message
+arrives.
+
+A: This is normal, because PopUp plugin makes the popups only when a plugin
+asks for them.
+NewStatusNotify plugin asks PopUp plugin a popup when a contact changes his
+status.
+NewEventNotify plugin asks PopUp plugin a popup when a message, file or url is
+received.
+WinampNotify does it when a new song is played in your Winamp 2.x/3.x
+MSN does it when you receive an hotmail message.
+EmotIcon does it when your received message contains an emoticon it recognizes.
+NotifyAnything lets you configure the popups on many circumstances. :-)
+===============================================================================
+
+[1.0.1.3] Q: What's the deal with "Concurrent Popups"?
+
+A: with this option ON, PopUp will create a new thread for every popup which
+needs to be created.
+The main effect on this is that fade and "animate" effects can happen at the
+same time on multiple plugins, instead of animating one at a time.
+If you use fading/animations, I suggest you keep it ON.
+If you don't use them, you don't need it. You can turn it OFF if you wish.
+It will cause no harm, though, so it's ON by default.
+
+IMPORTANT: don't play "ON-OFF-ON-OFF" with popups on your screen. If you do,
+your Miranda could be closed in the place of a popup, and you'll lose any
+unsaved changes.
+===============================================================================
+
+[1.0.0.4] Q: I've checked "AM/PM", but I don't get any AM/PM, what's wrong?
+
+A: Check your international settings (your locale). There should be an option
+page where you can configure the AM and PM symbol, and maybe they're "void" by
+default, as it was on my machines ^__^ so just write "AM" and "PM" or whatever
+you like.
+
+Q2: "I don't want to mess around with my OS! Make them translatable!"
+
+A: You're not going to *mess around* with anything. You only need to
+*configure* your OS which *IS NOT* properly configured by *DEFAULT*.
+Since AM/PM is part of the Operating System, my plugin has nothing to do with
+its translation. Blame Microsoft if they don't put a default AM/PM value!!
+===============================================================================
+
+[1.0.0.7] Q: I've noticed some strange memory leaks... can you fix them?
+
+A: I've fixed them in 1.0.0.5, so grab the latest version of PopUp plugin :-))
+===============================================================================
+
+[1.0.0.0] Q: Hey, remove XXX and add YYY to the plugin!
+
+A: Write to hrk@users.sourceforge.net explaining "why" in an intelligent way.
+If you convince me, I'll do what you ask.
+
+Examples of "asked things" are: Dynamically resizing popups; Background colour;
+Bold font for name; Fade in/out; AM/PM...
+===============================================================================
+
+[1.0.0.0] Q: The popups don't show on my system. Can you find the problem?
+
+A: Open the "Options" and click on "Preview": if you see PopUps, the plugin
+works.
+
+If the preview does not work, then there is a problem.
+I need a bug report. :)
+Get VersionInfo plugin and send me its output informations too.
+I can make you a special debug build to see if we can find out the problem.
+===============================================================================
+
+[1.0.0.0] Q: If I use MS Sans Serif as font for the popups, either my name or
+the date gets cut. Can you fix it?
+
+A: No :/ I can't fix it.
+This happens with every font of "Serif" family, so it happens with MS Sans
+Serif, MS Serif, some kind of "Lucida" and so on.
+I don't know why, but it happens.
+You can do two things:
+1) Use a font of another family.
+2) Enable "Enlarge PopUps by" and select a percentage you like. 120% should be
+good, but you can choose any value in the range 100% (no change) ~ 200% (double
+size).
+If you put 105%, you'll see no big difference in popup size (so it will not
+become huge!) and you will have a readable text.
+
+A2: It seems it's a problem related to "Latin" fonts. I cannot understand
+what's wrong so you'll have to use the workaround written above. :-)
+===============================================================================
+
+[1.0.0.0] Q: Hey, I can't stand the second line, can't I disable it?
+
+A: Yes: uncheck "Show second line".
+===============================================================================
+
+[1.0.0.0] Q: Thank for your work! Your plugin rocks, I'd like to give you
+something!
+
+A: You're welcome $_$. Anyway, my plugin is released both as freeware and Open
+Source, so you don't have to pay for it, as you don't have to pay for Miranda,
+and you can read its source code as you can read Miranda's source code. [Hmmm...
+if I were you I would not read my source code very finely, because I'm ashamed
+on how chaotic it is. :) Sooner or later I'll write it again from scratch,
+making a well organized code. Anyway, as of today it's fully commented, so it
+can be useful nevertheless.]
+
+By the way, should you feel like you want to compensate me in some way... in
+the event you upgrade your computer and have some old pieces you *won't use
+anymore*, which are *completely useless* and you don't *need them at all*...
+email me at hrk@users.sourceforge.net, because maybe I can use them. :-)
+=============================================================================== \ No newline at end of file
diff --git a/plugins/Popup/docs/license_popup.txt b/plugins/Popup/docs/license_popup.txt
new file mode 100644
index 0000000000..bda2bc214e
--- /dev/null
+++ b/plugins/Popup/docs/license_popup.txt
@@ -0,0 +1,348 @@
+Popup Plus is released under GNU General Plublic License version 2.
+Please note that due to this, distribution of Popup Plus as part of
+products not licensed under GPL (or ones that violate GPL, like
+custom Miranda IM packs with non-GPL plugins inside) is prohibited.
+
+ Victor Pavlychko
+
+ -------------------------------------------------------------------------
+
+ GNU GENERAL PUBLIC LICENSE
+ Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 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 Lesser 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) <year> <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.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 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) year 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 Lesser General
+Public License instead of this License.
diff --git a/plugins/Popup/docs/popupplus_translate.txt b/plugins/Popup/docs/popupplus_translate.txt
new file mode 100644
index 0000000000..9a3af4f79a
--- /dev/null
+++ b/plugins/Popup/docs/popupplus_translate.txt
@@ -0,0 +1,149 @@
+;
+;Group
+;
+[PopUp]
+
+;
+;General Options
+;
+;[General Options]
+
+;[PopUp Options]
+
+;[Sample text]
+
+;[Set &Font]
+
+;[Contents]
+
+;[Use &bold font for nick]
+
+;[Display &Time]
+
+;[Show s&econd line]
+
+;[Size]
+
+;[En&large PopUps by]
+
+;[You cannot specify a value lower than %d and higher than %d.]
+
+;[&Dynamically resize the popups]
+
+;[Effects]
+
+;[A&nimate PopUps (98/ME/2000/XP)]
+
+;[Fade &in/out (2000/XP)]
+
+;[Use Tr&ansparency]
+
+;[Transparency options (2000/XP)]
+
+;[Transparent] => THIS WAS REMOVED IN 1.0.1.8
+
+;[Opaque] => THIS WAS REMOVED IN 1.0.1.8
+
+;[Start windows in the...]
+
+;[... upper left corner]
+
+;[... lower left corner]
+
+;[... lower right corner]
+
+;[... upper right corner]
+
+;[... center]
+
+;[Spread...]
+
+;[... horizontally]
+
+;[... vertically]
+
+;[Use a...]
+
+;[... beveled style]
+
+;[... flat style]
+
+;[Miscellanea]
+
+;[PopUp Delay (seconds)]
+
+;[Background]
+
+;[Text]
+
+;[&Use Windows colours]
+
+;[Previe&w]
+
+;[Hey, this is a status message!]
+
+;[Hey, this is a... real message!]
+
+;1.0.0.2
+;[Reorder PopUps]
+
+;1.0.0.4
+;[&Minimum width]
+
+;1.0.0.5
+;[This is a notifying message (for developers)]
+;[This is a warning message (for developers)]
+
+;1.0.0.6
+;[Ok, something went wrong in the "%s" setting. Report back this error value: %d] => NOT NEEDED ANYMORE.
+
+;1.0.0.7
+;[Ok, something went wrong in the "%s" setting. Report back the following values:\nFacility: %X\nError code: %X\nLine number: %d]
+;[Ma&ximum width]
+;[pixels]
+
+;[Advanced Options]
+;[Multimonitor (98/ME/2000/XP)]
+;[Start the popups in the monitor that contains]
+;[Miranda's window]
+;[the active window]
+
+;1.0.1.2
+;[Disable &popup module]
+;[Enable &popup module]
+
+;[Concurrent PopUps]
+;[Use multiple threads]
+;[Note: this option may (and may not) cause some unexpected crashes, be sure to disable it before reporting a bug.]
+
+;1.0.1.4
+;New:
+;[Multiline &popups]
+;This one changed: [Hey, this is a... real message!] it's now:
+;[Hey, this is a two lined message!\nCool, isn't it?]
+
+;1.0.1.9
+;This one was missing:
+;[opacity: %d%%]
+
+;PopUp Plus 2.0.3.5
+;New:
+;[...skin for popup windows]
+;[Fast halftones]
+;[MathModule support]
+;[BBCodes (like [b]..[/b] for bold)]
+;[Emoticons]
+;[Select emoticon package type:]
+;[Select emoticon package file:]
+;[SmileyAdd 0.1.3.2 workaround]
+;Page in preferences:
+;[Plus]
+;[Disable emoticons]
+;[Use SmileyAdd settings]
+;[nConvers emoticon file (*.xep)]
+;Open file fialog title:
+;[Select emoticon pack file]
+;This probably will be changed in each version:
+;[Hey, this is a multilined message!\nCool, isn't it? Also you can use:\n- BBCodes for [b]bold[/b], [i]italic[/i] & [u]underlined[/u] text;\n- emoticons from SmileyAdd or nConvers :-)\n- MathModule formulas like this: [Math]e^i\\pi=-1[Math]]
+;[Smileys! ;-)]
+
diff --git a/plugins/Popup/docs/readme_popup.txt b/plugins/Popup/docs/readme_popup.txt
new file mode 100644
index 0000000000..b22e0fb6a9
--- /dev/null
+++ b/plugins/Popup/docs/readme_popup.txt
@@ -0,0 +1,276 @@
+PopUp plugin, v.1.0.1.9
+ by Luca "Hrk" Santarelli
+ hrk@users.sf.net
+
+- IMPORTANT -
+
+Developers, read m_popup.h. It's both in the source and in the binary package.
+
+
+- SUPPORTED PLUGINS -
+
+PLEASE, read here!
+
+PluginName Minimum Required Version
+NewStatusNotify 1.1.1.5
+Winamp Notify 1.5
+NewEventNotify x.x.x.x
+WhoIsReading[...]Notify x.x.x.x
+EmotIcon x.x.x.x
+YAHOO protocol x.x.x.x
+modified MSN protocol x.x.x.x
+Weather x.x.x.x
+NotifyAnything x.x.x.x
+... x.x.x.x
+
+- LATEST CHANGE -
+
+1.0.1.9 New: plugins can choose a custom timeout or no timeout at all (using
+ the new POPUPDATAEX structure and MS_POPUP_ADDPOPUPEX function).
+ New: PopUp plugin can be totally disabled depending on status (thanks
+ to MatriX's help).
+ Fix: Delphi/Pascal headers (m_popup_inc) had a mistake which caused
+ Access Violations. It has now be fixed. :-)
+ Change: "General Options" has been moved to "PopUps" page.
+ Fix: some sentences were missing in the langpack (andreas)
+ New: added support for Miranda Installer/Wassup by Tornado.
+
+
+- KNOWN BUGs -
+
+There are NO known bugs.
+Oh well... except for the multithreading issue ("Concurrent PopUps").
+If you get strange crashes with "Concurrent PopUps" on, disable it.
+
+
+- INFORMATIONS (you can skip this, but you can read it too!) -
+
+Hi :-)
+
+This plugin is the son of NewStatusNotify.
+You can use it even if you don't use NewStatusNotify, and probably you're here
+because some other plugin has "PopUp Plugin" as requirement. :-)
+
+This lets you have all the popups at the same place, being them status
+notifications, previewed messages, WinAmp song titles or whatever the plugin
+you installed does. :-)
+
+Should I feel that way, I'll make it so that you can have popups of different
+plugins in different places but... do you really need it?
+
+
+- USAGE -
+
+Open the options page and make your choices. You can choose:
+-> where to have the popup Window. Either one of the corners or the center of
+ the screen, but in this case the windows will appear cascaded (like the
+ old SplitMsgDialog Plugin or StatusFloater) instead of spreading.
+ You can spread them vertically or horizontally.
+
+-> Display hour and minute in the popup (thanks to the author of StatusFloater
+ for the cool idea!). You can have an "AM/PM" style too.
+
+-> Choose which style the popup should have. Border, size, second line...
+
+-> Set the interval for the popup windows to live (;-)).
+
+-> Choose the font used in the popups, and if you wish the name to be in bold
+ or not. Oh, you can choose the colour too.
+
+-> Color of the background too, obviously.
+
+-> And the default Windows' color too, obviously :-)
+
+-> Choose to have a fixed size popup, or a dynamically sizing popup: this means
+ that if the contact shown has a small nick and status text, the popup will be
+ small. If the contact shown has a long nick or long status text, the popup
+ will be large enough for the text not to be cut/clipped! :-)
+ No more clipped text! [except for "Latin"/"Serif" fonts like MS Sans Serif]
+
+-> If you enabled the resizing of PopUps, but sometimes they're too small for
+ your tastes, you can choose to have a "Minimum width", which will avoid too
+ small PopUps. Same goes with "Maximum width".
+
+-> Plugin works with "Large Fonts" systems and "Other..." systems too. It has
+ problems with "Serif" family fonts :-( (they get cut sometimes) but...
+
+-> ... you can nevertheless enlarge the PopUps by a choosen % value, avoiding
+ this annoying thing. :) [suggested is 105%, but read FAQ]
+
+-> Transparency. Should I add more? ;-) "Just slide the slider!"
+
+-> Animations, Fade in, Fade out! :-)
+
+
+- ROADMAP - (or: gee, what's next?)
+
+* Anything you think useful. :-)
+
+
+- TRANSLATION -
+
+The strings you can translate are in a separate file, made for people who don't
+use a langpack file. Just copy what you need. :)
+
+
+- CHANGES -
+
+1.0.1.9 New: plugins can choose a custom timeout or no timeout at all (using
+ the new POPUPDATAEX structure and MS_POPUP_ADDPOPUPEX function).
+ Fix: Delphi/Pascal headers (m_popup_inc) had a mistake which caused
+ Access Violations. It has now be fixed. :-)
+ Change: "General Options" has been moved to "PopUps" page.
+ Fix: some sentences were missing in the langpack (andreas)
+ New: added support for Miranda Installer/Wassup by Tornado.
+
+1.0.1.8 Fix: PopUps still running when Miranda is closed will now be cleanly
+ destroyed and memory freed. (This could prevent some crashes and could
+ just do nothing...)
+ New: Custom fade in and out delays.
+ Change: transparency percentage acts now like Miranda's one (thus
+ showing opacity and not transparency).
+ Fix: maximum width and minimum width were loaded wrongly.
+
+1.0.1.7 Fix: maximum and minimum width were saved wrongly.
+ Source will not be released due to lazyness. :)
+
+1.0.1.6 Fix: position, style and spreading option bug. Configure them again,
+ the old values had to be deleted.
+
+1.0.1.5 Fix: bug of wrong resize of popups when AM/PM is enabled.
+ Source for will not be released (I won't ever forget this bugfix...)
+
+1.0.1.4 New: multiline popups. :-)
+ Change: reordered general options dialog.
+ Fix: threads weren't killed if too much popups were created.
+ Change: PopUpList_Show() consumes less memory.
+ Change/Fix: made PUShowMessage() work better with single lined popups.
+ Change: translators, something changed. :)
+1.0.1.3 Fix: concurrent popups should work fine. They do here. :)
+ Fix: removed some debug code left in 1.0.1.2
+
+1.0.1.2 New: added a menu item to enable/disable every popup depending on PopUp
+ plugin. Note that this will not affect other plugins, but will only
+ disable *popups*. If you don't want to get status notification (as
+ example) and you have NewStatusNotify, you have to disable
+ NewStatusNotify too or you'll see no popups but you will hear the
+ sounds!
+ New: MS_POPUP_QUERY service for developers. You can enable/disable
+ every popup with it.
+ New: added an advanced option to enable/disable Concurrent PopUps. Open
+ FAQ.txt and read the documentation. :-)
+ Fix: some crashes should be fixed even if "Concurrent PopUps" is on.
+ Fix: some names weren't shown due to a bug in CreateWindow() API. It
+ has been fixed thanks to Vassily Goissa (vgoissa).
+ New: added a m_popup.inc for Delphi developers. Thanks to egodust.
+
+1.0.1.1 Fix: thanks to Tornado and BGMonster a memory leak has been removed.
+
+1.0.1.0 New/Fix: while working on multiline popups, when the text will be two
+ lines (or more) long, a "..." will be appended to the first line, and
+ the popup will be rightly sized. Just try it with NewEventNotify or
+ NewStatusNotify.
+ Fix: MultiMonitor was broken in latest release, it now works again. [If
+ you need UNICODE support, recompile the plugin with #define UNICODE]
+
+1.0.0.9 Fix: plugin will now load under WinNT and Win95. Problem was related to MultiMonitor options.
+ Fix: MultiMonitor options will now be enabled only if there is a multimonitor setup. :-)
+ Fix: "RegOpenKeyEx()" error fixed in NT platforms (9x weren't affected).
+ Fix: custom maximum width and minimum width weren't properly saved.
+ New: PUChangeText() resizes plugin (if dinamic resize is enabled).
+ This means you'll get a resizing popup with NewStatusNotify and
+ automatic read of away messages.
+ Change: many small changes, don't ask me to remember them :-)
+
+1.0.0.8 Bug fix release.
+ Fix: \r\n are not displayed correctly (which means not displayed!!)
+ Fix: threads not being killed :-)
+ Fix: Use Windows Colours wasn't working outisde of preview.
+ Fix: Default colours weren't saved on Miranda close.
+ Fix: custom maximum width wasn't saved on Miranda close.
+
+1.0.0.7 Fix: no more crashes on "Always on Top" failing (I hope).
+ Change: the new translation string (the error message) has been changed
+ a little, excuse me. :-) This time is final, though.
+ New: option to specify custom minimum width in popups.
+ New: option to specify a custom maximum width in popups (NewEventNotify
+ can show very large popups!)
+ New: multimonitor support. (wheee!)
+ New: new service added (for developers) MS_POPUP_CHANGETEXT. :-) This
+ will come in use to NewStatusNotify as soon as I code the preview of
+ away messages. Oh, what a lame, I've already done it :-P Check out
+ NSN 1.1.0.8
+ New: new message added (for developers) UM_INITPOPUP. This is sent when
+ a popup has completely been created, so your PluginData will be
+ available to you.
+ New: (for developers) some quick functions to avoid typing
+ CallService(...) ;-)
+ Fix: if the second line text is not given, but the popups are to have a
+ second line, a blank one will be drawn (currently the popup shows with
+ one line only)
+
+1.0.0.6 Fix: Reorder PopUps wasn't working due to a mistake in the fixing of
+ "Always on top". :-) Donwload this update because it could fix other
+ bugs in the showing of PopUps.
+ Change: the new translation string (the error message) has been changed
+ a little, excuse me. :-)
+
+1.0.0.5 New: (for developers) a new service function: PUShowMessage(), read
+ the documentation. Oh, read it nevertheless, since I slightly modified
+ the code examples. Be sure not to malloc() your POPUPDATA structure!
+ Fix: Thread & Handles memory leaks are now gone. There's a 2KB leak
+ sometimes, but I don't know if it's related to PopUp plugin or
+ something else. (Thanks to Kenneth)
+ Fix: popups are always on top for the two people who had problems too.
+ :-) (thanks to wintime98)
+ Change: small tweaks here and there.
+ Change: GUI improvements 8-) Options are less cluttered now... (thanks
+ Lynlimz)
+
+1.0.0.4 Fix: "always on top" was not working during fade in, but only after the
+ fade had completed. (Strange, it caused troubles in the old days of
+ NewStatusNotify, now it just works fine :-/ bah...)
+ Improvement: decreased CPU usage during fadings (in/out)... open Task
+ Manager and relax ;-) (thanks to Alex Sanyukovitch for the Sleep() hint).
+ Improvement: decreased memory usage and leaks, but there seems to be a
+ memory leak I can't fix (read readme_popup.txt && faq_popup.txt)
+ New: minimum width option to avoid too small PopUps.
+ Change: buttons and checkboxes now reflect Miranda standard ones.
+ Fix: Sample text font bug (it showed incorrectly sometimes).
+
+1.0.0.3 Fixed an issue related to Winamp Notify (my fault, not his), please
+ update NSN and WAN as soon as a new release is available.
+ Fixed "Reorder PopUps" option not being correctly saved.
+
+1.0.0.2 Users: MultiThreading now works! :-) PopUps are now concurrent. :-)
+ Developers: you'll need to compile your plugins with the new m_popup.h
+ Users: added the option to have "fixed position" popups, which means
+ they will not be reordered as every one dies.
+ Developers:Added a service (MS_POPUP_ISSECONDLINESHOWN)
+
+1.0.0.1 Fixed a GDI leak (thanks to Alex Sanyukovitch)
+ Removed the "MultiThreaded" checkbox. It's not yet the right time :-)
+
+1.0.0.0 Initial release. This plugin is "son" of NewStatusNotify. Developers,
+ you don't need to download the source code. Anyway, it's available.
+
+
+- DISCLAIMER -
+
+This plugin works just fine on my machine, it should work just fine on yours
+withouth conflicting with other plugins. Should you have any trouble, write me
+at hrk@users.sf.net where "sf" must be changed to "sourceforge".
+Anyway, if you are a smart programmer, give a look at the code and tell me
+the changes you'd make. If I like them, I'll put them inside giving you the
+right credit! :-)
+
+This plugin is released under the GPL license, I'm too lazy to copy it, though.
+Anyway, if you do have Miranda (and you should, otherwise this plugin is
+pretty useless) you already have a file called GPL.txt with tis license.
+Being GPLed you are free to modify or change the source code (you can find it
+here: http://nortiq.com/miranda/ and look for the source section) but you
+cannot sell it.
+As I already wrote: if you do modify it, notify me, I don't see a good reason
+not to share the improvements with the Miranda community. :-)
+
+Yes, I have made a quite long disclaimer, I can save the file now. :-) \ No newline at end of file
diff --git a/plugins/Popup/docs/rebase_popup.txt b/plugins/Popup/docs/rebase_popup.txt
new file mode 100644
index 0000000000..1a3cbb1a13
--- /dev/null
+++ b/plugins/Popup/docs/rebase_popup.txt
@@ -0,0 +1,32 @@
+=§= TO PLUGIN DEVELOPERS =§=
+
+This plugin has its Base Address set to:
+0x25020000
+
+Please, avoid using this BaseAddress for your plugins: using the same addresses will slow Miranda.
+Read "pluginguidelines.txt" under miranda0100/miranda32/doc/ in the CVS.
+
+This Base Address is built this way:
+
+0x25 020000
+^^^^ ^^^^^^
+My radix Incremental value related to my plugins.
+
+Range for base address is 0x10000000 to 0x50000000, so 0x25000000 fits well there.
+
+020000 is an incremental value which represents PopUp
+[Note: 000000 is used for RePosition, 020000 for PopUp, 030000 for PicPlugin and so on.]
+
+Why do I call 0x25 "My radix"?
+
+HRK = H + R + K
+H = 8th letter in the english alphabet.
+R = 18th letter in the english alphabet.
+K = 11th letter in the english alphabet.
+
+8 + 18 + 11 = 37.
+37(dec) = 25(Hex)
+
+Base Address can be found/configured:
+§ MSVC++ 6.0
+ Project->Settings->Link->Output->Base Address \ No newline at end of file
diff --git a/plugins/Popup/docs/road_map.txt b/plugins/Popup/docs/road_map.txt
new file mode 100644
index 0000000000..f171688db8
--- /dev/null
+++ b/plugins/Popup/docs/road_map.txt
@@ -0,0 +1,11 @@
+skin related classes:
+- PopUpSkin
+- Skin
+- Skins
+
+formatting-related classes:
+- Lexer
+- ChunkedText
+
+misc classes:
+- Logger
diff --git a/plugins/Popup/docs/skin_popup.txt b/plugins/Popup/docs/skin_popup.txt
new file mode 100644
index 0000000000..ee20d2d845
--- /dev/null
+++ b/plugins/Popup/docs/skin_popup.txt
@@ -0,0 +1,87 @@
+Object properties
+
+Popup skin files are used to define popup layout. Each popup consists of several objects such as bitmaps, text, title
+
+and icon. Each object is defined using object..end blocks as below:
+
+Code:
+object
+ property1
+ property2
+ property3
+end
+
+Also there are two global properties w and h used to describe popup how window size should calculated.
+
+Syntax of each property is "property value" or simply "property". Note that each property shoud be placed in separate line. Let's take a look at possible properties:
+
+Object properties
+
+type. Type can be "bitmap", "icon", "avatar", "clock", "text" or "title"
+
+x. default: 0
+- Positive or zero values mean x-coordinate of object's upper-left corner.
+- Negative value means distance form object's upper-left corner to window's right side (applicable only for bitmaps and
+
+avatars)
+
+y. default: 0
+- Positive or zero values mean y-coordinate of object's upper-left corner.
+- Negative values mean distance form object's upper-left corner to windows bottom (applicable only for bitmaps and
+
+avatars)
+
+w. default: 0
+- Positive values mean object's width.
+- Negative values mean distance form object's bottom-right corner to window's right side.
+- zero value means actual width of bitmap.
+Note: this is applicable only for bitmaps and avatars
+
+h. default: 0
+- Positive or zero values mean object's height.
+- Negative values mean distance form object's bottom-right corner to windows bottom.
+- Zero value means actual height of bitmap.
+Note: this is applicable only for bitmaps and avatars
+
+color
+- Three numbers 0..255 separated with spaces. This defines red, green and blue values of text/title's color. This may cause crashes when aplied to something different from text/title.
+
+mono
+No parameters required. Mono means that bitmap should me treated monochromatic. E.g. bitmap shoud be colorized with
+
+popup background color. When this option is on gray (0x808080) color is mapped to popup color set in options, black and white colors are left unchaned.
+
+source
+Source is used to specify bitmap file used by bitmap and clock objects
+
+clocksize
+When applied to clock object, this means widths of various clock parts:
+- left edge
+- time separator (the ':' symbol)
+- ten digits
+- am and pm marks (not used at the moment but you can provide btter compatability for your skin)
+- right edge
+
+proportional
+edit:
+usage: proportional 1
+
+When applied to bitmap or avatar object, this means that popup should keep objects proportions. With this options you can easily avoid ugly avatrs ;)
+
+layer
+Applied to a bitmap object this means that bitmap must be blended with the background.
+
+Formulas
+
+You may use formulas to define x, y, w, h properties. Each formula is a simple arithmetic expression which may use 5 basic operations ('+', '-', '*', '/' and '%'), two 'conditional' operations ('>' means "maximum" and '<' for "minimum").
+
+Also you may use some variables: icon.width, icon.height, title.width, title.height, text.width, text.height, avatar.width, avatar.height, window.maxwidth, window.width, window.height, clock.width, clock.height.
+
+A few words on how and when variables are defined and formulas are evaluated:
+1) window.width and window.maxwidth are set to maximum width defined in options
+2) Popup looks through all objects and evauates their widths and heights. Value of undefined variable (including width or height of object that is not defined yet) is supposed to be zero.
+3) window.width and window.height are evaluated using global 'w' and 'h' definitions (it they are present, otherwise popup chooses minimal suitable width)
+4) Popup looks through all objects once more to evauates their positions.
+
+Post Scriptum
+Look into 'minimal' skin supplied with preview 8, I hope this description will help you to understand what's going on ;) Also feel free to ask your questions here. \ No newline at end of file
diff --git a/plugins/Popup/docs/translation_popup.txt b/plugins/Popup/docs/translation_popup.txt
new file mode 100644
index 0000000000..3ee8740a1e
--- /dev/null
+++ b/plugins/Popup/docs/translation_popup.txt
@@ -0,0 +1,127 @@
+;
+;Group
+;
+[PopUp]
+
+;
+;General Options
+;
+;[General Options]
+
+;[PopUp Options]
+
+;[Sample text]
+
+;[Set &Font]
+
+;[Contents]
+
+;[Use &bold font for nick]
+
+;[Display &Time]
+
+;[Show s&econd line]
+
+;[Size]
+
+;[En&large PopUps by]
+
+;[You cannot specify a value lower than %d and higher than %d.]
+
+;[&Dynamically resize the popups]
+
+;[Effects]
+
+;[A&nimate PopUps (98/ME/2000/XP)]
+
+;[Fade &in/out (2000/XP)]
+
+;[Use Tr&ansparency]
+
+;[Transparency options (2000/XP)]
+
+;[Transparent] => THIS WAS REMOVED IN 1.0.1.8
+
+;[Opaque] => THIS WAS REMOVED IN 1.0.1.8
+
+;[Start windows in the...]
+
+;[... upper left corner]
+
+;[... lower left corner]
+
+;[... lower right corner]
+
+;[... upper right corner]
+
+;[... center]
+
+;[Spread...]
+
+;[... horizontally]
+
+;[... vertically]
+
+;[Use a...]
+
+;[... beveled style]
+
+;[... flat style]
+
+;[Miscellanea]
+
+;[PopUp Delay (seconds)]
+
+;[Background]
+
+;[Text]
+
+;[&Use Windows colours]
+
+;[Previe&w]
+
+;[Hey, this is a status message!]
+
+;[Hey, this is a... real message!]
+
+;1.0.0.2
+;[Reorder PopUps]
+
+;1.0.0.4
+;[&Minimum width]
+
+;1.0.0.5
+;[This is a notifying message (for developers)]
+;[This is a warning message (for developers)]
+
+;1.0.0.6
+;[Ok, something went wrong in the "%s" setting. Report back this error value: %d] => NOT NEEDED ANYMORE.
+
+;1.0.0.7
+;[Ok, something went wrong in the "%s" setting. Report back the following values:\nFacility: %X\nError code: %X\nLine number: %d]
+;[Ma&ximum width]
+;[pixels]
+
+;[Advanced Options]
+;[Multimonitor (98/ME/2000/XP)]
+;[Start the popups in the monitor that contains]
+;[Miranda's window]
+;[the active window]
+
+;1.0.1.2
+;[Disable &popup module]
+;[Enable &popup module]
+
+;[Concurrent PopUps]
+;[Use multiple threads]
+;[Note: this option may (and may not) cause some unexpected crashes, be sure to disable it before reporting a bug.]
+
+;1.0.1.4
+;New:
+;[Multiline &popups]
+;This one changed: [Hey, this is a... real message!] it's now:
+;[Hey, this is a two lined message!\nCool, isn't it?]
+
+;1.0.1.9
+;This one was missing:
+;[opacity: %d%%] \ No newline at end of file