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.6 ).

Note that Yelp does not currently require a separate installation of
Norm Walsh's DocBook stylesheets, or an installation of XML catalogs.
Though Yelp's XSLT stylesheets import Norm Walsh's, Yelp ships its
own copy of the 1.48 version of those stylesheets, as well as a copy
of the DocBook 4.1.2 DTD.


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.6: 
http://prdownloads.sourceforge.net/scrollkeeper/scrollkeeper-0.3.6.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.