[ dRUNKEN ] jOiN 1.0 - README                                                  

10 Feb. 2001
                                                                               
A full featured, lightbar-driven conference joiner for DayDream/*NIX.          
                                                                               
Code by Rezine                                                                 
Design by Threaz                                                               

                                                                               
INTRODUCTION
~~~~~~~~~~~~
  This is a door for DayDream/*NIX BBS's. It is thought to replace the
  internal "J"oin command, as it is ugly and hard to maintain.
  
  Should work fine on any platform DayDream can run on.
  

FEATURES
~~~~~~~~
  Oh damn, find out yourself. Too many for me to list here now :)

                                                                               
INSTALLATION                                                                   
~~~~~~~~~~~~                                                                   
  Installation of this door is kinda simple. Just type "./configure" in
  the directory where you unpacked the source into. Btw, no it's not a
  autoconfigure script that you might be used to.
  
  After the script finished the configuration, you can type "make" and
  after that, "make install".
  
  Then, to finish the installation, just add a new door entry to your
  daydream.cfg file, reading something like :
  
  ----->8---------->8------------------------------------------	
  
	DOOR_COMMAND.. J
	DOOR_TYPE..... 1
	DOOR_SECURITY. 10
	DOOR_EXECUTE.. /home/bbs/doors/djoin %N
	DOOR_CONFS1... XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
	DOOR_CONFS2... XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
	
  ----->8---------->8------------------------------------------	
  
  Ofcourse, you might need to change some parameters to fit your system.
  Finally, compile your daydream.cfg using ddcfg. You should be used to
  that :)
  

CONFIGURATION
~~~~~~~~~~~~~
  The main configuration is made in a textfile that usually lives within
  /home/bbs/configs and that is called djoin.cfg.
  
  This file should be pretty self-explanatory, as it is commented. Maybe
  not very well, but hey, you should figure it out :)
  
  If you should need more information about the @TAG@ system, there is a
  file called README.parser in the directory where you extracted the archive
  to (at least, it should be there :)
  
  A last thing to mention is the "conference aliases", or maybe better called
  "conference descriptions". You can give each conference on your BBS an own
  description, that will be displayed in the joiner optionally (with a tag).
  For the joiner to work correctly, you must edit the file djoin.aliases which
  is residential in /home/bbs/configs.
  
  Put each "description" for each conference on a single line in that file.
  The line number you put the description in is equal to the conference nr.
  of your BBS. If you want a conference not to have a description, just put
  an "-" for that conference. But always remember, if you use this feature,
  you must always keep it up to date if you change the conference setup.
  The aliases file must always have as many lines in it as you have confe-
  rences on your system.


"EMBEDDED" vs. HEADER/FOOTER MODE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  One hing to mention : You can use two different display modes with the
  joiner.
  
  The first one is the standard one :
  
    The door will first display the header graphics file (djoinhdr.gfx).
    Then it will display the conferences, and at last it'll display some
    footer (djoinftr.gfx).
    
 The second one, the "embedded" display mode :
 
    The door will paint one ascii on the screen and then will print the
    conferences "into" this ascii. No footer will be displayed. For this
    to work, just rm the footer file (djoinftr.gfx) from your display
    directory. And be sure to edit your djoin.cfg to set the screen 
    coordinates properly.

    Please note : This mode is not well tested, so it could still be some
                  buggy.


FINAL STUFF
~~~~~~~~~~~
  Well this thing should not be buggy in standard configuration :) It has
  been in full use on one system for a while, and no bug was reported yet.
  If you should encounter some bugs, feel free to let me know, hell yes,
  I even encourage you to do so :) And, I'd like to receive some feedback
  on this thingy too, be it negative or positives one. Heh, don't be afraid
  to write some lines :)
  

Have fun with this thing, and may the DayDream BBS system will live long
and prosper :)


Rezine (rezine@criminology.de)
Check our site at http://www.criminology.de/drunken/