README for PGPlus invisibility patch by astyanax ------------------------------------------------ INTRODUCTION Well, at long last I have had the patience to strip out the invisibility code from Bag End (the prototype talker where this code was developed) and make it into a formal release. It took long enough, and I fear that it may be too late to save PGPlus. REQUIREMENTS - PGPlus version 1.0.10 - A C compiler (duh :-) - GNU indent and patch. Make sure you have these two things BEFORE you start. For best compatibility, get version 2.2.4 of indent (indent --version). INSTALL Installation will be either simple or difficult, depending on how much you have modified your distribution of PGPlus. Here's the basic steps: - Extract this file: "tar zxvf invis-patch.tar.gz" should do it. - cd into pgplus - Back up your source code! Typing "cp -a src src.backup" should do the trick on Linux. if you're using another OS, you should know how to backup your src directory. - cd into src/ - run "indent -kr *.c". You may not like the K&R style of indentation, but tough luck. It's the only way I thought there was a chance that this patch would apply across modified sources. If you're worried, your original files will be saved as the filename with an ~ on the end. - cd to ../.. - Type "patch -p0 < path-to-invis-patch/pgplus-invis.diff". "path-to-invis-patch" is self-explanatory. If you see any "reject" error messages, then your modifications conflict with this patch. You'll have to look into the filename.c.rej file to see where the failure was. You can either give up (you DID back up your src directory didn't you?) or just try to figure out how to apply the differences by hand. It shouldn't be too hard (famous last words). - Cross your fingers and type "make". if you dont get any error messages, you're incredibly lucky =-). Type "make install" and reboot your talker to see the lovely effect. NOTES - This patch uses the old HOUSE priv and replaces it with INVISPRIV. Any old residents will have to be granted the 'invis' priv to be able to use it. New residents should autpmatically have the priv. - See the help files for 'invis', 'vis', and 'w' to find out more about how to use invisibility. - This code is far from perfect. It gets around people's time not being incremented while they are invisible by storing their accrued login time in a separate variable and NOTS SAVING THEM while theu are invisible. It's an awful hack, and improvement is welcome. SUPPORT - None. If you wish to mail me <chrisa@asty.org> I will try to help you out as much as I can, but no promises. This code is by nature difficult to incoporate into any code which has been changed even slightly from the stock PGPlus distribution. And if you're not running version 1.0.10, your chances of getting this to work are even smaller. Good luck! LICENSE - This code is written for use in PGPlus. It is released under the same licensing terms as PGPlus. Since PGPlus is (as of this writing) no longer supported, if someone later picks it up, please just drop me a line if you plan to start maintaining it again, and I will likely give approval to incorporated this code into the main distribution. - Of course: 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. - If by some miracle the Ew-too authors (you know who you are) ever agree to use the GNU GPL for redistribution of the Ew-too/summink/PGPlus talker base, you do not need to contact me, this code made be relicensed under the GNU GPL for reincorporation into the mainstream talker code.