This is the XNap Manual. (It's far from complete, and should probably be
converted to html or some other sane format, Java Help Framework?)

Sections:

1.) Introduction: 

    XNap is a plugin-based filesharing client written in Java, which makes it
    possible for you to run it on any platform that provides a Java Runtime
    Environment whose version is higher or equal to 1.3.0.

    Plugin-based means that in theory XNap is able to use several different
    filesharing networks at once, right at the moment however, there is only a
    plugin for the <link type="glossary"> OpenNap </link> network. More
    plugins might be added in the future. (Check http://xnap.sf.net/docs.php,
    maybe you can help us in any way.)

2.) Getting started:

    Not much should be needed to start and use XNap, the startup wizard should
    guide you through the setup process and helps you to configure the
    most important things. You can always tweak specific settings later on or
    invoke the wizard again from the File menu.

    You should be automatically connected to some OpenNap servers so that you
    can search and download files from the network. Check the status at the
    right bottom of XNap, if it shows you "some number of" servers, everything
    is well, if it doesn't read the OpenNap -> Server Panel part in the "Using
    XNap" section.

3. Using XNap:

   The Main Window

       The different Menus
	   
	   File Menu

	   Edit Menu

	   View Menu

	   OpenNap Menu

	   Plugin Menu
	   
	   Settings Menu

	   Help Menu


       The Status Bar


       The Toolbar
       

       The Search Panel
	   
	   The Option Box
	       
           The Search Filter

       
       The Transfer Panel

	   Uploads 
	   
	   Downloads
	   
       
       The OpenNap Panel

	   The Server Tab

	       Getting connected to servers.. Explain Napigator, the
	       Autoconnector...

	   The Whois Tab

	   The Console Tab
	   
	   
	The Chat Panel

	   The Global Tab

	   The XNap Channel
		   
           Individual Chat Panels


	The Hotlist Panel

	    The Hotlist Categories (Hotlist, Banned, Other, All)
		
	    Editing Users

	    
        The Library Panel

	    The Library Tree (Downloads, Incomplete, Home, Root, Shares)

	    The Library Search function.

	    Viewing and Manipulating Files (Drag&Drop, Mp3 Editor, Viewer 
								   Plugins)

	    
       
4. Configuring XNap:

      General

          Personal
	  
	      Miscellaneous
	      
	          Emacs Keybindings

		  What we refer to as Emacs keybindings is a small set of
		  keybindings which happen to be the standard keybindings in
		  GNU Emacs and the bash for editing and copying text and
		  moving the cursor in the text.

		  In the following 'C-' denotes the control key and 'M-'
		  denotes the alt/meta key.

		  These are the keybindings which are implemented so far:

		  'C-k' Deletes the text to the end of the line.

		  'C-d' Deletes the next character.

		  'M-d' Deletes the next word.
		  
		  'M-<BACKSPACE>' Deletes the previous word.
		  
		  'M-c' Capitalize the next word.

		  'M-l' Downcase the next word.

		  'M-u' Upcase the next word.
		  
		  'C-<SPACE>' Set a mark for a copy or cut operation.
		  
		  'C-w' Cuts the marked region and puts it in the kill-ring.

		  'M-w' Copies the marked region and puts it in the kill-ring.

		  'C-y' Paste text from the kill-ring.

		  'M-y' Cycle through kill-ring.

		  'C-e' Move cursor to the end of the line.

		  'C-a' Move cursor to the beginning of the line.

		  'C-n' Move cursor to the next line.

		  'C-p' Move cursor to the previous line.

		  'C-f' Move cursor to the next character.
		  
		  'C-b' Move cursor to the previous character.

		  'M-f' Move cursor to the beginning of the next word.

		  'M-b' Move cursor to the beginning of the previous word.

		  'M-<' Move cursor to the beginning of the document.

		  'M->' Move cursor to the end of the document.

		  'C-v' Move cursor one page down.

		  'M-v' Move cursor one page up.

      Appearance

      Files
  
      OpenNap
  
      Network
  
      Search
  
      Transfer
  
      Chat
  
      Editing the preference file

      There are a couple of options in XNap which can't be configured through
      its graphical user interface. The reason for this is that most of these
      options are very special and often only exist due to small disagreements
      in the development team which crept up when the corresponding features
      were implemented.

      The preference file can be found in the folder .xnap in your home
      directory. Its name is xnap2.properties. The syntax is pretty
      straightforward: each line contains one preference key and a preference
      value separated by a "=".

      Before editing this file manually you should close XNap, otherwise all
      your changes will be lost since XNap will overwrite the file on exit.

      The first settings you can change manually are the color settings for
      the progress bar in the transfer panels. The corresponding keys are
      "xnap.progressRunningColor" and "xnap.progressFinishedColor" the value
      you can set for these keys must be a natural number. This is how you
      compute this number:

      Choose values between 0 and 256 for red green and blue portion and
      compute red + 256 * green + 256 * 256 * blue.

      My preferred values are:

      xnap.progressRunningColor=2677288
      xnap.progressFinishedColor=586747

      If you're interested in what clients the peers use you're downloading
      from and uploading to you can set "xnap.plugin.nap.whoisQueryOnTransfer"
      to true.

      xnap.plugin.nap.whoisQueryOnTransfer=true

      One of our developers noticed that XNap's main window height shrunk a
      little on each restart. In case you experience the same you can set the
      key "xnap.correctivePixels" to a small number like 5.

      xnap.correctivePixels=5

      This will add five pixels to the window's height on each restart.

      Editing the preference file you can also change the order of the toplevel
      folders which are shown in the library panel. Here is my preferred
      order:
      
      xnap.libraryTreeNodes=incompletes;downloads;shares;home;root

      Make sure to use exactly these values and only change the order in which
      they appear, otherwise the corresponding folders won't show up in the
      library panel.

      The number of entries you can have in your "open with" history is
      editable too:

      xnap.maxOpenWithCommands=10

5. Linux and KDE specific tweaks

   If Noatun is your audio player of choice, you might want to enter these
   dcop commands in the "open with" dialog box to play incomplete transfers
   more directly:

   For immediate playing:
   
   dcop noatun Noatun addFile {} true

   For enqueuing:

   dcop noatun Noatun addFile {} false

6. Frequently Asked Questions


7. Credits and Licenses

   Development Team and Contributors
    

Appendix: Installation
   
   How to obtain XNap

   Compilation and Installation 

   Development and how you can help