
	Frequently Asked Questions about Kibble
$Id: FAQ,v 1.1 1998/12/07 08:09:58 joseph Exp $
Latest Kibble version as of this writing: 0.7.1

_______________________________________________________________________

Outline

   * [A] Overview
   * [B] Introduction to Kibble
   * [C] Specific Kibble questions and Trouble-shooting
_______________________________________________________________________

Detailed contents

   * [A] Overview
	* [A.1] Where can I get the latest version of this FAQ?
	* [A.2] Where can I get the latest version of Kibble?
	* [A.3] Where is Kibble mirrored?
	* [A.4] Who is working on Kibble?
	* [A.5] Are there any binary/Debian/RedHat Kibble packages?
	* [A.6] How do I report bugs, offer help, etc.?
   * [B] Introduction to Kibble
	* [B.1] What is Kibble?
	* [B.2] What system requirements are there for Kibble?
	* [B.3] How do I compile Kibble?
	* [B.4] How do I use Kibble?
	* [B.5] What is in store for Kibble?
   * [C] Specific Kibble questions and Trouble-shooting
	* [C.1] How do I save my knowledge base?
	* [C.2] What does double-clicking do?
	* [C.3] What does the right mouse button do?
	* [C.4] What does "No tree item is currently selected" mean?
	* [C.5] How can I do so-and-so really cool thing?
_______________________________________________________________________

* [A] Overview
_______________________________________________________________________

* [A.1] Where can I get the latest version of this FAQ?

This FAQ is updated at different intervals from the package. The newest version is available at:

http://wish.student.harvard.edu/kibble/FAQ
_______________________________________________________________________

* [A.2] Where can I get the latest version of Kibble?

The primary Kibble web page contains the latest version:

http://wish.student.harvard.edu/kibble

The primary Kibble FTP site is:

ftp://wish.student.harvard.edu/pub/kibble/packages
_______________________________________________________________________

* [A.3] Where is Kibble mirrored?

There are no mirrors of the Kibble website. The package is mirrored at
metalab.unc.edu (formally known as sunsite) and its repective mirrors
in the reminder directory:

ftp://metalab.unc.edu/pub/Linux/apps/reminder/

It is also mirrored at the GTK application archive and its respective
mirrors:

ftp://ftp.infodrom.north.de/pub/unix/gtk-etc/apps/kibble/

Note, however, that the primary site has an high-speed connection to
the internet and rarely overloaded. Additionally, it will have the most
recent version.
_______________________________________________________________________

* [A.4] Who is working on Kibble?

The primary author is Joseph P. Turian. Code contribution, patch, and
bug-fix authors are listed in the THANKS file of the distribution.

_______________________________________________________________________

* [A.5] Are there any binary/Debian/RedHat Kibble packages?

Statically compiled binaries for Linux boxen without GTK are available at:

ftp://wish.student.harvard.edu/pub/kibble/binaries/

Those krazy Debian people have been kind enough to make a Debian package
of Kibble without even telling me. Once they decide where to put it
(rather than in the Incoming directory), we'll post the URL here.

There is no RedHat package yet.
_______________________________________________________________________

* [A.6] How do I report bugs, offer help, etc.?

We would love to hear from you. Please email
<kibble@wish.student.harvard.edu>
_______________________________________________________________________

* [B] Introduction to Kibble
_______________________________________________________________________

* [B.1] What is Kibble?

From the README:

	This is Kibble, a knowledge base program. It is used to organize
	seemingly discursive thoughts into a cohesive engine. Basically,
	it is used it to keep track of random ideas that may prove
	useful. It is released under the GNU General Public License and
	is Open Source software.

_______________________________________________________________________

* [B.2] What system requirements are there for Kibble?

Kibble should work under any system with a working installation of GTK
1.x (http://www.gtk.org). If it doesn't, please send in a bug report.
_______________________________________________________________________

* [B.3] How do I compile Kibble?

Read INSTALL in the package. It should hopefully be no more difficult
than:

./configure
make
make install
_______________________________________________________________________

* [B.4] How do I use Kibble?

Organize your thoughts in an hierarchy (see the screen-shot for an
example).

To add a tree node, select the tree item that you want to be its
parent. Then choose "Add" in the "Edit" menu and type in the pertinent
data: the name, a brief description, and an associated file that stores
the actual info. All of these fields are optional, incidentally.

To view or edit a tree node, select that node and choose "View" in the
"Edit" menu.

To delete a node and all of its children, select the tree and choose
"Delete" in the "Edit" menu.

More complex tree operations are not yet implemented.

To save your knowledge base at any time, select "Save" in the "File"
menu. It will overwrite the previous KB and store the new one in
"~/.kibble_kb". Note that Kibble automatically saves upon quitting.
_______________________________________________________________________

* [B.5] What is in store for Kibble?

Oh, many wondrous ideas. Check the TODO file for information on long-term
goals.
_______________________________________________________________________

* [C] Specific Kibble questions and Trouble-shooting
_______________________________________________________________________

* [C.1] How do I save my knowledge base?

To save your knowledge base at any time, select "Save" in the "File" 
menu. It will overwrite the previous KB and store the new one in
"~/.kibble_kb". Note that Kibble automatically saves upon quitting.
_______________________________________________________________________

* [C.2] What does double-clicking do?

Double-clicking a tree node selects it and views it.
_______________________________________________________________________

* [C.3] What does the right mouse button do?

Right-clicking a tree node will collapse/expand the tree item.
_______________________________________________________________________

* [C.4] What does "No tree item is currently selected" mean?

You cannot add or view a node without first selecting one.
_______________________________________________________________________

* [C.5] How can I do so-and-so really cool thing?

Sorry, Kibble is early-stage software. If you have a suggestion, please
email it to us! Depending on its feasibility and usefulness, we will
assign it priority.
_______________________________________________________________________

** End of Kibble FAQ **
