diff --git a/wmswallow/CHANGELOG b/wmswallow/CHANGELOG new file mode 100644 index 0000000..413e394 --- /dev/null +++ b/wmswallow/CHANGELOG @@ -0,0 +1,67 @@ + -*- text -*- +Time-stamp: <00/05/15 23:33:49 friedel> + +(Note: don't get confused, the dates in this file are in german-locale (de_DE), + because i was too lazy to use something else than + ctrl-u meta-! date... but the timestamp is in C locale...) + +0.6.1: +Fixed eternal loop under openwindows (solaris-x86) + +Added wmswallow.spec for easy building of rpm :-) + + +0.6: +Celebrated first wmswallow version without my favorite bug, with a beer :-) +Made the switches work :-) + +Added commandline switches -managed -unmanaged. -managed is the default +behaviour, we wait for the Window to be reparented. + +Added code from Jason Lowdermilk to listen to CreateWindow Events, after the +app has been started. Then i modified it heavily, because i found it was still +too unreliable. Now wmswallow Listens for ReparentNotify events. So, we rely +on WindowMaker first reparenting the windows, then sleep just a second and can +be sure that everything worked! And i don't think that the Windowmaker +behaviour (or any other windowmanager) will change in that respect :-) Well, +this might not work for xteddy (or other apps that are ignored by the +windowmanager) + +Put code to check window for WM_CLASS and WM_NAME in extra function. + + +0.5.3: +Fixed a nasty bug that i introduced by modyfying Jason's patch incorrectly and +some tiny cleanups. + +Added thanks to the contributors to README + +Incorporated patch from Jason Lowdermilk to enable +finding windows by WM_NAME (i confused WM_NAME with the name part of the +property returned by XGetClassHint. The patch fixes some memory leaks as well. +Jason says, this helps with some Java-Applications. + + + +0.5.2: +Modified README +New switch: -focus/-nofocus, to make focus-handling enabled only on demand, + more fixes to focus-handling (this time for real...) + +Small code cleanups, fixes for focus handling (windows could "lose" focus) + +Keyboard focus works now. + +Makefile modified, new target xfree tested under linux and freebsd + + +0.5.1: +softenwindows() is superfluous, removed +chidren_return is now XFree'd in findnamedwindowacc() + +0.5: +Initial beta release, all functionality present, some small bugs, some small +shortcomings. + +Shortly after freshmeat announcement i discovered a small bug in the Makefile, +but that was fixed before the news got out. diff --git a/wmswallow/INSTALL b/wmswallow/INSTALL new file mode 100644 index 0000000..8120116 --- /dev/null +++ b/wmswallow/INSTALL @@ -0,0 +1,34 @@ +INSTALLATION: ++++++++++++++ + untar the sources by typing something along the lines of + + zcat wmswallow.tar.Z|tar cvf - + cd wmswallow + make + + where platform is currently one out of + xfree, solaris, solaris-gcc + + The xfree target works under linux and freebsd. + + Linux is tested best, since i'm hacking this stuff under linux (at + home). I have access to several Solaris Workstations (some sparcs, and + 2 pcs) whith quite different Installations which i regularly use, so + the solaris target will at least get some attention. Solaris users + please read README.solaris for some hints. + + Other Unices might or might not get happy with the xfree target or + some or other... I really think using autoconf/automake for this small + app would be overkill. If you devise a proper patch for a different + Unix-flavour, i will include it, but i might not be able to test it. + (I have currently access to FreeBSD and AIX, in addition to my + "home-platforms") + + After compilation put the binary somewhere you like (e.g. in /usr/local/bin) + and in case you want to delete the Sourcetree, you might want to copy the + README to /usr/doc/wmswallow + + Now try + wmswallow -h + to get a basic idea how it works. + diff --git a/wmswallow/LICENCE b/wmswallow/LICENCE new file mode 100644 index 0000000..a52b16e --- /dev/null +++ b/wmswallow/LICENCE @@ -0,0 +1,341 @@ + + 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. + + + Copyright (C) 19yy + + 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. + + , 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. diff --git a/wmswallow/Makefile b/wmswallow/Makefile new file mode 100644 index 0000000..b75aa24 --- /dev/null +++ b/wmswallow/Makefile @@ -0,0 +1,45 @@ +MAKE=make +CC=gcc +CFLAGS=-Wall -g +RM=rm -f +X=/usr/X11R6 +INCLUDES=-I$(X)/include +LIBPATHS=-L${X}/lib +LIBS=-lXext +PROG=wmswallow +OBJS=wmswallow.o +SH=/bin/sh + +default: + @echo "Type make to compile." + @echo "Currently supported platforms are:" + @echo " xfree solaris solaris-gcc" + +xfree: + ${MAKE} main + +solaris: + ${MAKE} CC=cc CFLAGS="-g -Xa" X=/usr/openwin \ + LIBPATHS="-L/usr/openwin/lib -R/usr/openwin/lib" \ + LIBS="-lXext -lX" main + +solaris-gcc: + ${MAKE} X=/usr/openwin \ + LIBPATHS="-L/usr/openwin/lib -R/usr/openwin/lib" \ + LIBS="-lXext -lX" main + +main: ${OBJS} + ${CC} ${CFLAGS} $(INCLUDES) ${OBJS} -o ${PROG} ${LIBPATHS} ${LIBS} + +tarball: + ${SH} -c "cd ..;tar cpO wmswallow/*.c wmswallow/Makefile \ + wmswallow/todo wmswallow/LICENCE wmswallow/README \ + wmswallow/README.solaris wmswallow/version.h \ + wmswallow/CHANGELOG wmswallow/INSTALL wmswallow/wmswallow.spec\ + |compress > wmswallow.tar.Z" + +clean: + ${RM} ${PROG} *~ *.o + +.c.o: + ${CC} ${CFLAGS} $(INCLUDES) -c $< diff --git a/wmswallow/README b/wmswallow/README new file mode 100644 index 0000000..6faaac0 --- /dev/null +++ b/wmswallow/README @@ -0,0 +1,160 @@ + wmswallow + + A WindowMaker dock applet to make any application dockable. + + Copyright 2000 by Friedrich Delgado Friedrichs + + (be sure to read the LICENCE file as well) + +=========================================================================== + +Why? +---- + I wanted to have coolmail in my Windowmaker dock. + +How? +---- + +INSTALLATION: ++++++++++++++ + untar the sources by typing something along the lines of + + zcat wmswallow.tar.Z|tar cvf - + cd wmswallow + make + + where platform is currently one out of + xfree, solaris, solaris-gcc + + The xfree target works under linux and freebsd. + + Linux is tested best, since i'm hacking this stuff under linux (at + home). I have access to several Solaris Workstations (some sparcs, and + 2 pcs) whith quite different Installations which i regularly use, so + the solaris target will at least get some attention. Solaris users + please read README.solaris for some hints. + + Other Unices might or might not get happy with the xfree target or + some or other... I really think using autoconf/automake for this small + app would be overkill. If you devise a proper patch for a different + Unix-flavour, i will include it, but i might not be able to test it. + (I have currently access to FreeBSD and AIX, in addition to my + "home-platforms") + + After compilation put the binary somewhere you like (e.g. in /usr/local/bin) + and in case you want to delete the Sourcetree, you might want to copy the + README to /usr/doc/wmswallow + + Now try + wmswallow -h + to get a basic idea how it works. + +USE: +++++ + Then some things you might try out are: + (i.e. lots of) + EXAMPLES: + ========= + +------- wmswallow coolmail coolmail + (Will make coolmail docked, but it starts an xterm with mailx + per default so you will probably want:) + +------- wmswallow coolmail coolmail -e "xterm -n mutt -T mutt -e mutt" + +------- wmswallow glbiff glbiff + (glbiff is really a killer! Try it! (If you have some 3D + hardware) :-) Find it at + http://www.dgp.toronto.edu/~mac/projects/glbiff.html + +------- wmswallow asclock asclock -shape -exe plan + (Works with the unpatched "classic" version of asclock) + +------- wmswallow oclock oclock -transparent -minute red -bd green + (is one of my personal favorites) + +------- wmswallow tuXeyes tuXeyes --puppy + (a nice alternative to xeyes) + +------- wmswallow Lament /usr/local/bin/demos/lament -name Lament -geom 55x57 + (/usr/local/bin/demos is where my xscreensaver demos are + installed. + This commandline demonstrates two things: + 1. You can give a WM_CLASS on the commandline instead of a WM_NAME + 2. Some applications don't handle resizing well and must get the correct + geometry on their commandline, which is always 55x57 for dockapps.) + +------- wmswallow xaos xaos + (This kinda obsoletes wmmand :-) + +------- wmswallow xload xload -nolabel -hl LightSeaGreen -fg LightSeaGreen \ + -bg black -update 5 + (This is like wmload, but there is a frame at the edges which is a + little annoying, so wmload is a better choice) + +------- wmswallow -focus XTerm + (Weeelll... + 1. wmswallow can swallow apps without starting them + 2. it takes the first it gets + 3. swallowed apps can take keyboard focus now! (Is that useful? I doubt + it, but i could not resist :-)) + +------- wmswallow -geom 64x64 -getclick "xterm -e top" xeyes xeyes + (A more advanced example. The xeyes look better with 64x64 than + with the default width/height of 55x57, and since xeyes ignores + mouseclicks, we can grab them and execute an xterm on a click. + Note that you must poke xeyes right in the eye! :-) + +------- wmswallow -noshape -getclick gtop -geom 57x57 xload xload -nolabel \ + -hl LightSeaGreen -fg LightSeaGreen -bg black -update 5 + (This looks and behaves a little more like wmload. Executes + the "Gnome Systemmonitor" on a mouse click. The -noshape + option lets wmswallow ignore any shape the application might + have. I thought this would increase performance for some + apps, but it doesn't. [It just uses a very slight bit less + memory]) +------- wmswallow -unmanaged xteddy xteddy + (swallows the left ear of an xteddy, that will complain about it... + completely useless :-) +------- wmswallow -focus bb xterm -bg black -fg white -T bb -fn "-*-*-*-*-*-*-2-*-*-*-*-*-*-*" -geometry 50x25 -e bb -driver curses + (utterly useless as well! :) + +How not? +-------- + When should you *not* use wmswallow? + +- In general, if a special dockapp for that purpose already exists, you + should use it, because every instance of wmswallow has a memory + footprint of about 600k, and a simple dockapp usually uses less + ressources. If the WindowMaker developers will one day choose to + implement "swallowing" applications as a feature in the WindowMaker + dock, this will probably a much more simple and clean solution. + +- You should not swallow applications over slow network links. + First tests show, that 2 mbit/s are more than enough, but 90kbit/s get + terribly hogged if you run wmswallow on a remote hosts over such a + link. Note that i am not referring to your hardware, but to the + overall throughput that can be acchieved between the two hosts. + +Have a lot of fun... :-) + +Thanks +------ + The following people helped and/or contributed to wmswallow: + + Dan Piponi : + Makefile fix for FreeBSD + + Jason Lowdermilk : + diff to enable wmswallow really to look after the WM_NAME of a + window. + Valuable suggestions and code on how to identify the wanted + window more reliably. + further valuable input + + honx: + Giving me the idea to wmswallow, by constantly nagging that + WindowMaker cannot swallow apps :-) Next thing to satisfy this + dude, somebody will have to write a pager for WindowMaker + (like the one for fvwm) that works *without* gnome... Somebody + else will have to do that, since i don't like Pagers :-) diff --git a/wmswallow/README.solaris b/wmswallow/README.solaris new file mode 100644 index 0000000..4af459e --- /dev/null +++ b/wmswallow/README.solaris @@ -0,0 +1,16 @@ +Whew! You really want this stuff to run under solaris, huh? + +Well, you can try "make solaris" if you have got sun-workshop, if you use gcc +"make solaris-gcc" *might* work. The Problem is, everybody installs libXpm in +a different place. If you know that your sysadmin put everything that is X11 +related into, say, /usr/X11, the default targets will work. But if libXpm +resides in /usr/local/lib you might help yourself with: + +make SOLX=/usr/local solaris + +If all fails, you will have to look at the solaris target and adjust the +variables INCLUDES and LIBPATHS to help the compiler find the includes and +libs. + +I also noticed that on one machine wmswallow appeared to generate constant +network load (when i was using it over a remote link) so be aware of problems. \ No newline at end of file diff --git a/wmswallow/todo b/wmswallow/todo new file mode 100644 index 0000000..f9d251b --- /dev/null +++ b/wmswallow/todo @@ -0,0 +1,130 @@ + -*- text -*- +TODO: + Bugs: +------------- + + Feature-wishes: +----------------------- + detect automatically if a window wants to be managed or not (should be + easy, but the -unmanaged switch works well, too) + + Kill apps nicely when killed. (Some signal handling) + + Make wmswallow not only accept mouseclicks on ButtonPress, but also get + some contents of the cutbuffer on (say) a middleclick, and then do + something user-defineable about it. (generic solution for wmnetselect + stuff) + + Write manpage + + Maybe write freebsd port + + Do things reliably/the clean way + -> I mean, don't wait for some microsecs, when you can ask the app + what's up -> find out how! -> XSync seems to work... + -> Wait a second at the right moment helps some things greatly! + Still i don't know if it's the "right thing"[TM] + + Problems (maybe unresolvable): +-------------------------------------- + WindowMaker segfaults if an instance of wmswallow hangs when + the wm is restarted -> Probably windowmaker bug, but can be fixed by + better signal-handling on behalf of wmswallow + + If you swallow apps on the clip *and* in the dock at the same time, + the apps for the clip wander to the dock and vice versa... + Huh? This is most strange. I fear that looks like one of + WindowMaker's many bugs.. :) (Yeah, blame it on others, good + strategy!) + + Shaped apps that change their shape will look "out of sync". This is + especially visible with + wmswallow xdaliclock xdaliclock -24 -transparent -cycle \ + -geometry 61x61 -fn fixed -oink-oink + There are other problems with xdaliclock -transparent (flicker, the + seconds are lagged behind respectively out of beat) which do not + depend on wmswallow and can be noticed as well, when + xdaliclock -transparent is not being swallowed. + + perfmeter objects to have its mouseclicks selected + -> As a workaround, i make the XInputSelect Mask dependant on + whether the user wants to click on the window, or not. But + i'd like to do it better (i.e. force perfmeter to accept + the change) + -> In fact, for every application that selects ButtonPress + events, the same events cannot be selected twice (manpage + of XSelectInput(3)) + -> It seems, this "Problem" cannot be fixed! + + click works only on the surface of the swallowed window: + (Obviously, because the rest of the area belongs to the + dock... Or can that be redeemed?) + + +=============================================================================== +DONE: + Make basic dockable App + + Then steal code off fvwm2 to learn how to swallow stuff + -> done.. Wow! That's easy! + + Resize swallowed window appropriately + + Judge what to get by following rule: + 1. name + 2. class + + Get command to run from commandline and spawn program. + + Somehow handle shaped windows (Like xeyes) + -> Ok, even resizing works + + Option: -updateshape (or similar) for apps that change their shape + (like oclock -transparent) + -> is done by default behaviour! :-) + + Clean up allocated space (fix memory holes)! + -> Looks ok now. Sending multiple Events under X11 has evil + effects! + + Better command-line switch handling. Following commandline-switches: + -noshape/-shape : Switch shape functionality on or off + -getclick: Define commandline to exec when window is clicked + -geometry: Define geometry of swallowed application! + (Size is useful, position as well, to adjust asclock) + -id: Give Window-id to swallow + + Freshmeat announcement + + Let apps take keyboard focus + -> might or might not be a problem with windowmaker/dock + -> It wasn't... :-) wmMand used Enter and Leave events and then set + the focus for himself. And i blatantly stole the code... (just + 2 lines...) :-) + + The currently focused window flickers, when the shape gets updated. + This is especially strong with + wmswallow xdaliclock xdaliclock -24 -transparent -cycle \ + -geometry 61x61 -fn fixed -oink-oink + This also interferes with focus, and it can be seen that the shape + gets updated in an unclean way, i.e. the shape and the graphics seem + "out of sync" + -> Action on Focus event shortened, XMapSubwindows and XMapWindow + weren't necessary, stealshape only grabs the shape to the + iconwin + + Swallowing sometimes is unreliable (especially on WindowMaker start + with many instances) ... Why? + -> Theory: Maybe when several instances of wmswallow start, + the tree of windows gets changed in a way that sometimes a + window cannot be found anymore. + -> Jason helped a little, i figured the rest out... every + windowmanager reparents windows, and waiting for that is + very reliable... + -> done! + + some apps cannot be found (xmountains). Why? xmountains in particular + seems to lack a window-id. I didn't know that was possible... + -> resolved by Jason, i did not really check the WM_NAME + + just made an rpm specfile diff --git a/wmswallow/version.h b/wmswallow/version.h new file mode 100644 index 0000000..ca61105 --- /dev/null +++ b/wmswallow/version.h @@ -0,0 +1 @@ +#define VERSION "0.6.1" diff --git a/wmswallow/wmswallow.c b/wmswallow/wmswallow.c new file mode 100644 index 0000000..8de4bd1 --- /dev/null +++ b/wmswallow/wmswallow.c @@ -0,0 +1,678 @@ +/* wmswallow.c */ + +/* #define DEBUG 1 */ + /* Sometimes i want to get quick access to this flag :-)*/ + +/* Time-stamp: <00/05/15 23:13:43 friedel> */ + +/* Copyright 2000 Friedrich Delgado Friedrichs */ + +/* Swallow applications in the Windowmaker dock */ +/* Originally i started with asbeats 0.2 (by iznogood@bohemians.org) (simply + the smallest WindowMaker dockapp i could find, since there was no proper + Documentation to find on how to make an app dockable), which i stripped + down to have a basic dockable app, and then stole code from fvwm2 to + swallow an Application */ +/* Man, this was easy! Why did nobody implement this before? (That's me, + looking astonished at the first working version at Mon Apr 17 02:16:31 + CEST 2000 after only 4 hours of mostly learning how to program the X-Environment and + hacking and guessing a little :-) */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "version.h" + +/* That's all we need from xpm.h */ +#if ! defined(_XtIntrinsic_h) && ! defined(PIXEL_ALREADY_TYPEDEFED) +typedef unsigned long Pixel; /* Index into colormap */ +# define PIXEL_ALREADY_TYPEDEFED +#endif +/* Now we got rid of that stupid libXpm dependency :-) */ + +#define WIDTH 55 +#define HEIGHT 57 +/* 55x57 seems to be the default size for a WindowMaker dockapp */ +/* settable by "-geometry" switch */ + +Display *dpy; +Window Root; +Window iconwin,win; +Window swallowed; +XSizeHints mysizehints; + +#define MW_EVENTS (ExposureMask | ButtonPressMask |\ + StructureNotifyMask |\ + ButtonReleaseMask |\ + EnterWindowMask|LeaveWindowMask) +#define SW_EVENTS (PropertyChangeMask | StructureNotifyMask |\ + ResizeRedirectMask | SubstructureNotifyMask) +#define FIND_EVENTS (SubstructureNotifyMask | StructureNotifyMask) +#define READY_EVENTS FIND_EVENTS +#define FALSE 0 +#define TRUE (!FALSE) + +Pixel GetColor(char *name); +void FlushWindow(); +void usage (char *progname); +int parseargs(int argc, char *argv[]); +Window findnamedwindow (char *class); +Window findnamedwindowacc (char *class, Window window); +int checkwindow (Window window, char *class); +int execstuff(int argc, char *oldargv[]); +Window startandfind(int argc, char *oldargv[], char* class); +int printlist(FILE * stream, char * string, char **stringlist); +int flush_expose (Window w); +void stealshape (Window w); +int sendexpose (Window w); +void waitformap (Window win); +/* int softenwindow (Window w); */ /* won't work, kept for historical reasons */ + +/* Parameters that can be customized via commandline switches */ +char *execstring=NULL; +char *geometry=NULL; +int getclick=FALSE; +int shape=TRUE; +int focus=FALSE; +int unmanaged=FALSE; +int winid=0; +char *display_name=NULL; + +int main(int argc,char *argv[]) +{ + int screen; + int d_depth; + XWMHints mywmhints; + Pixel back_pix,fore_pix; + + int i; + unsigned int borderwidth; + char *wname="wmswallow"; + + int remainarg, remainargc; + + XEvent Event; + XTextProperty name; + XClassHint classHint; + + remainarg=parseargs(argc, argv); /* remainarg > 0 afterwards */ + remainargc=argc-remainarg; +#ifdef DEBUG + fprintf(stderr, "remainarg: %d, remainargc: %d, argc: %d\n", remainarg, + remainargc,argc); + fflush(stderr); +#endif + + if (!(dpy = XOpenDisplay(display_name))) { + fprintf(stderr,"wmswallow: can't open display %s\n", + XDisplayName(display_name)); + exit (1); + } + screen=DefaultScreen(dpy); + Root=RootWindow(dpy, screen); + + /* So, now we've got everything we need to get Events from the XServer */ + if (remainargc>1) { + winid=startandfind(remainargc-1, argv+remainarg+1, argv[remainarg]); + if (winid==0) { + perror("wmswallow: startandfind failed"); + /* Real error handling in execstuff()*/ + exit (1); + } + } + + d_depth=DefaultDepth(dpy, screen); + /* XConnectionNumber(dpy); */ /* useless */ + mysizehints.flags=USSize|USPosition; + mysizehints.x=0; + mysizehints.y=0; + back_pix=GetColor("white"); + fore_pix=GetColor("black"); + XWMGeometry(dpy, screen, geometry, NULL, (borderwidth =1), + &mysizehints, &mysizehints.x, &mysizehints.y, + &mysizehints.width, &mysizehints.height, &i); + mysizehints.width=WIDTH; + mysizehints.height=HEIGHT; + if (geometry!=NULL) { +#ifdef DEBUG + fprintf(stderr,"Setting geometry to: %s\n",geometry); + fflush(stderr); +#endif + XParseGeometry(geometry, &mysizehints.x, &mysizehints.y, + &mysizehints.width, &mysizehints.height); + } + + win=XCreateSimpleWindow(dpy, Root, mysizehints.x, mysizehints.y, + mysizehints.width, mysizehints.height, borderwidth, + fore_pix, back_pix); + iconwin=XCreateSimpleWindow(dpy, win, mysizehints.x, mysizehints.y, + mysizehints.width, mysizehints.height, borderwidth, + fore_pix, back_pix); + XSetWMNormalHints(dpy, win, &mysizehints); + classHint.res_name="wmswallow"; + classHint.res_class="WMswallow"; + XSetClassHint(dpy, win, &classHint); + XSelectInput(dpy, win, MW_EVENTS); + XSelectInput(dpy, iconwin, MW_EVENTS); + if(XStringListToTextProperty(&wname, 1, &name)==0) + { + fprintf(stderr, "wmswallow: can't allocate window name\n"); + exit(-1); + } + XSetWMName(dpy, win, &name); + mywmhints.initial_state = WithdrawnState; + mywmhints.icon_window = iconwin; + mywmhints.icon_x = mysizehints.x; + mywmhints.icon_y = mysizehints.y; + mywmhints.window_group = win; + mywmhints.flags = StateHint | IconWindowHint | + IconPositionHint | WindowGroupHint; + XSetWMHints(dpy, win, &mywmhints); + XSetCommand(dpy, win, argv, argc); + + if (winid==0) { + swallowed=findnamedwindow(argv[remainarg]); /* Find which window to + swallow*/ +#ifdef DEBUG + fprintf(stderr,"%s has Window-id 0x%lx\n", argv[remainarg], swallowed); + fflush(stderr); +#endif + } + else + swallowed=winid; + + + /* "Swallow" it */ + XReparentWindow(dpy, swallowed, iconwin, 0, 0); + if (getclick) { + /* softenwindow (swallowed); */ /* Change some attributes */ + XSelectInput(dpy, swallowed, SW_EVENTS|ButtonPressMask); + } + else { + XSelectInput(dpy, swallowed, SW_EVENTS); /* Workaround for apps like + perfmeter that don't let us + get their mouseclicks :-( */ + } + XSetWindowBorderWidth(dpy, swallowed,0); + XMoveResizeWindow(dpy, swallowed, 0, 0, + mysizehints.width, mysizehints.height); + + /* Now we do some special juju for shaped windows: */ + + /* ...tell the window to repaint itself, please! */ + if (shape) { + sendexpose(swallowed); + + /* ... ok, window should be repainted and a shaped window should have updated + its mask accordingly! (-: End of shape-juju :-) */ + + /* Now steal the shape of the Window we just swallowed! */ + stealshape(swallowed); } + XMapWindow(dpy,win); + XMapSubwindows(dpy,win); + FlushWindow(); + + while(1) + { + while (XPending(dpy)) + { + XNextEvent(dpy,&Event); + switch(Event.type) + { + case ButtonPress: +#ifdef DEBUG + fprintf (stderr, "wmswallow: Got ButtonPress Event\n"); + fflush(stderr); +#endif + if (getclick) + system(execstring); + break; + case Expose: + if(Event.xexpose.count == 0 ) { +#ifdef DEBUG + fprintf (stderr, "wmswallow: Got Expose Event, count==0\n"); + fflush(stderr); +#endif + if (shape) + stealshape(swallowed); /* Oclock changes its shape! That's why + we have to steal it *again* */ + FlushWindow(); + XMapRaised(dpy,swallowed); + /* the following Produces "focus-flicker" */ + /* XMapSubwindows(dpy,win); */ + /* XMapWindow(dpy,win); */ + } + break; + case EnterNotify: + if (focus) + XSetInputFocus(dpy, swallowed, RevertToPointerRoot, + CurrentTime); + break; + case LeaveNotify: + if (focus) + XSetInputFocus(dpy, PointerRoot, RevertToPointerRoot, + CurrentTime); + break; + + case DestroyNotify: + XCloseDisplay(dpy); + exit(0); + default: +#ifdef DEBUG + /* fprintf (stderr, "wmswallow: Got Some Other Event\n"); + fflush(stderr); */ +#endif + break; + } + } + XFlush(dpy); + usleep(50000L); + } + return 1; +} + +/* int softenwindow (Window w) { */ +/* XSetWindowAttributes attributes; */ + +/* attributes.override_redirect=FALSE; */ +/* attributes.event_mask=SW_EVENTS|MW_EVENTS; */ +/* attributes.do_not_propagate_mask=0; */ + +/* XChangeWindowAttributes(dpy, w, */ +/* CWOverrideRedirect|CWEventMask|CWDontPropagate, */ +/* &attributes); */ +/* return TRUE; */ +/* } */ + +int sendexpose (Window w) { + XExposeEvent xexp; + XEvent Event; + int retval; + + xexp.type=Expose; + xexp.serial=0; + xexp.send_event=TRUE; + xexp.display=dpy; + xexp.window=w; + xexp.x=0; + xexp.y=0; + xexp.width=mysizehints.width; + xexp.height=mysizehints.height; + xexp.count=0; + Event.xexpose=xexp; + retval=XSendEvent(dpy, w, FALSE, ExposureMask, &Event); + /* XFlush(dpy); */ /* ... send all queued Events */ + /* usleep(5000L); */ /* ... take a tiny doze */ + XSync(dpy, FALSE); /* I doubt if this is really better than Flushing and + pausing */ + return retval; +} + +void stealshape(Window w) { + XShapeCombineShape (dpy, iconwin, ShapeBounding, 0, 0, w, + ShapeBounding, ShapeSet); + /* XShapeCombineShape (dpy, win, ShapeBounding, 0, 0, w, */ + /* ShapeBounding, ShapeSet); */ + /*Re-read specs! */ + /* XShapeCombineShape (dpy, win, ShapeClip, 0, 0, w, */ + /* ShapeClip, ShapeSet); */ + /* XShapeCombineShape (dpy, iconwin, ShapeClip, 0, 0, w, */ + /* ShapeClip, ShapeSet); */ +} + +void nocolor(char *a, char *b) +{ + fprintf(stderr,"wmswallow: can't %s %s\n", a,b); +} + + +int flush_expose (Window w) +{ + XEvent dummy; + int i=0; + while(XCheckTypedWindowEvent(dpy,w,Expose,&dummy)) + i++; + return i; +} + +void FlushWindow() +{ + flush_expose(swallowed); + flush_expose (iconwin); + flush_expose(win); +} + +Pixel GetColor(char *name) +{ + XColor color; + XWindowAttributes attributes; + XGetWindowAttributes(dpy,Root,&attributes); + color.pixel=0; + if (!XParseColor(dpy,attributes.colormap,name,&color)) + nocolor("parse",name); + else if(!XAllocColor (dpy,attributes.colormap,&color)) + nocolor("alloc",name); + return color.pixel; +} + +void usage(char *progname){ + printf( + "wmswallow Version %s\n" + " by Friedrich Delgado Friedrichs (c) 2000\n" + "\n" + "Usage:\n" + " %s [] [windowname [command [args ...]]]\n" + " Will swallow the first X-Window it finds with a WM_NAME or\n" + " WM_CLASS matching \n" + "\n" + " Flags:\n" + " -h: prints this message and exits\n" + " -geometry : use specified geometry for swallowed\n" + " window\n" + " -display : connect to specified display\n" + " -shape: use the shape extension (default)\n" + " -noshape: don't use the shape extension\n" + " -focus: Window should take focus\n" + " -nofocus: Window shouldn't take focus(default)\n" + " -managed: Assume window is managed by the\n" + " windowmanager (default)\n" + " -unmanaged: Assume window is not managed by the\n" + " windowmanager\n" + " -getclick : on mouseclick, execute \n" + " instead of passing the Event to the\n" + " swallowed window.\n" + " -id [0x]: swallow window with id \n" + " The command with args will be executed, before swallowing.\n", + VERSION, progname); +} + +/* Parse commandline args, returns first non-switch argnumber */ +int parseargs(int argc, char *argv[]){ + int argnum; + int lastarg=1; + if (argc<2) { + usage(argv[0]); + exit(0); + } + + for(argnum=1; argnum0) { + for + (i=0,runner=*children_return;i +%define group X11/WindowMaker Applets +%define realname %{name} +Summary: wmswallow is a WindowMaker dock applet to make any application dockable in the WindowMaker dock +Name: %{name} +Version: %{ver} +Release: %{rel} +Copyright: %{copy} +Packager: %{ich} +URL: http://burse.uni-hamburg.de/~friedel/software/wmswallow.html +Group: %{group} +Source: http://burse.uni-hamburg.de/~friedel/software/wmswallow/wmswallow.tar.Z +BuildRoot: /var/tmp/%{name}-root +#Patch: %{name}-%{ver}.patch +%description +- wmswallow was mainly created to swallow coolmail in the WindowMaker dock, but it can + swallow about any X-window you conceive. +- The window may receive mouseclicks, +- for windows that do not get mouseclicks (like xload or xeyes), you can specify a + shell-command to execute on a click. +- The geometry for the swallowed app can be specified. Only HEIGHTxWIDTH are used, + however. +- Applications can be started on wmswallows commandline. An already running window + can be swallowed, either by name, class or directly by window-id +- The window may receive keyboard-focus, if you specify the "-focus" switch. +- Even windows (like xteddy or wine) that hide from the windowmanager can be + swallowed with the -unmanaged switch +%changelog + +%prep + +%setup -n %{realname} + +#%patch -p1 + +%build +make xfree + +%install +rm -rf $RPM_BUILD_ROOT +mkdir -p $RPM_BUILD_ROOT/usr/local/bin +cp wmswallow $RPM_BUILD_ROOT/usr/local/bin + +%clean +rm -rf $RPM_BUILD_ROOT + + +%files +%defattr(-,root,root) +%doc CHANGELOG README todo INSTALL README.solaris LICENCE +/usr/local/bin/wmswallow +