From 8408e863de860ef75a58be303b488b7c44701f9d Mon Sep 17 00:00:00 2001
From: Michael R Sweet <michael.r.sweet@gmail.com>
Date: Mon, 17 Dec 2001 14:27:03 +0000
Subject: Fl_Help_View now ignores links when the link callback returns NULL,
 and displays a sensible error message when the URI scheme isn't handled.

Fl_File_Icon no longer tries to load icon files that don't exist.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@1860 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 documentation/Fl_Help_View.html | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

(limited to 'documentation/Fl_Help_View.html')

diff --git a/documentation/Fl_Help_View.html b/documentation/Fl_Help_View.html
index 1fb420505..47e5aca2e 100644
--- a/documentation/Fl_Help_View.html
+++ b/documentation/Fl_Help_View.html
@@ -69,11 +69,23 @@ in the buffer.
 followed or a file is loaded (via
 <CODE>Fl_Help_View::load()</CODE>) that requires a different
 file or path. The callback function receives a pointer to the
-<CODE>Fl_Help_View</CODE> widget and the full pathname for the
-file in question and must return a pathname that can be opened
-as a local file. This can also be used to retrieve remote or
-virtual documents, returning the temporary file that contains
-the actual data.</P>
+<CODE>Fl_Help_View</CODE> widget and the URI or full pathname
+for the file in question. It must return a pathname that can be
+opened as a local file or <TT>NULL</TT>:</P>
+
+<UL><PRE>
+const char *fn(Fl_Widget *w, const char *uri);
+</PRE></UL>
+
+<P>The link function can be used to retrieve remote or virtual
+documents, returning a temporary file that contains the actual
+data. If the link function returns <TT>NULL</TT>, the value of
+the <TT>Fl_Help_View</TT> widget will remain unchanged.</P>
+
+<P>If the link callback cannot handle the URI scheme, it should
+return the <TT>uri</TT> value unchanged or set the <A
+HREF="Fl_Help_View.value"><TT>value()</TT></A> of the widget
+before returning <TT>NULL</TT>.</P>
 
 <H4><A NAME="Fl_Help_View.load">int load(const char *f)</A></H4>
 
-- 
cgit v1.2.3