README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

About:
------

Yelp is the default help browser for the GNOME desktop.  Yelp provides
a simple graphical interface for viewing DocBook, HTML, man, and info
formatted documentation.  The name Yelp was suggested by Daniel Lundin.
Yelp is pronounced the same as the swedish word for 'help'.


Requirments:
------------

* GNOME 2.0 ( >= 2.0.2 )
* A working ScrollKeeper installation ( > 0.3.14 )
* GNOME Documentation Utilities (gnome-doc-utils > 0.5.2)
* Version 4.1.2 of the DocBook XML DTD

Note that Yelp requires gnome-doc-utils for the DocBook XSLT stylesheets.  
These stylesheets are optimized for speed and allow better integration 
with Yelp.


Reporting bugs:
---------------

Bugs should be reported to the GNOME bug tracking system
(http://bugzilla.gnome.org, product Yelp.) You will need to create an
account for yourself.


Sending patches:
----------------

Please submit your patches to bugzilla.gnome.org. If the patch
fixes an existing bug, add the patch as an attachment to that bug
report.

Otherwise, enter a new bug report that describes the patch, and attach
the patch to that bug report.

Bug reports containing patches should include the PATCH keyword in their
keyword fields. If the patch adds to or changes the GTK programming
interface, the API keyword should also be included.
  
Patches should be in unified diff form. (The -u option to GNU diff.)


Help on setting your system up:
-------------------------------

A brief note on how to get the docbook stuff to work. 

1) Install Scrollkeeper 0.3.14: 
http://prdownloads.sourceforge.net/scrollkeeper/scrollkeeper-0.3.14.tar.gz

Edit /etc/scrollkeeper.conf to include your $(gnome2_prefix)/share/omf
directory. For best use in GNOME 2.0, remove all other directories. 

Run scrollkeeper-update.