summaryrefslogtreecommitdiffstats
path: root/stdlib/doc-lookup.tl
diff options
context:
space:
mode:
Diffstat (limited to 'stdlib/doc-lookup.tl')
-rw-r--r--stdlib/doc-lookup.tl49
1 files changed, 49 insertions, 0 deletions
diff --git a/stdlib/doc-lookup.tl b/stdlib/doc-lookup.tl
new file mode 100644
index 00000000..f1d0d380
--- /dev/null
+++ b/stdlib/doc-lookup.tl
@@ -0,0 +1,49 @@
+(load "doc-syms")
+
+(defvarl usr:*doc-url* "https://www.nongnu.org/txr/txr-manpage.html")
+
+(defvar os-symbol
+ (if (ignerr (dlsym (dlopen "libandroid.so") "AAsset_close"))
+ :android
+ (let ((u (uname)))
+ [(orf (iff (f^ #/Linux/) (ret :linux))
+ (iff (f^ #/SunOS/)
+ (ret (if (<= 5 (int-str u.release))
+ :solaris10
+ :solaris)))
+ (iff (f^ #/CYGWIN/) (ret :cygwin))
+ (iff (f^ #/CYGNAL/) (ret :cygnal))
+ (iff (f^ #/Darwin/) (ret :macos))
+ (ret :unknown))
+ u.sysname])))
+
+(caseql os-symbol
+ ((:linux :macos :solaris :solaris10 :android)
+ (defun open-url (url)
+ (if (zerop (run (caseql os-symbol
+ ((:linux :solaris :android) "xdg-open")
+ (:solaris10 "/usr/dt/bin/sdtwebclient")
+ (:macos "open"))
+ (list url)))
+ t
+ (error `~s: failed to open ~s` 'open-url url))))
+ ((:cygwin :cygnal)
+ (with-dyn-lib "shell32.dll"
+ (deffi shell-execute "ShellExecuteW"
+ cptr (cptr wstr wstr wstr wstr int))
+ (defun open-url (url)
+ (let ((hinst (shell-execute cptr-null "open" url nil nil 0)))
+ (if (> (int-cptr hinst) 32)
+ t
+ (error `~s: failed to open ~s` 'open-url url))))))
+ (t (defun open-url (url) (error "~s: not implemented" 'open-url))))
+
+(defun usr:doc (: sym)
+ (iflet ((str (typecase sym
+ (null sym)
+ (sym (let ((*package* (find-package "pub")))
+ (tostring sym)))
+ (t (tostringp sym))))
+ (tag (if str [doc-syms str] "")))
+ (open-url `@{*doc-url*}#@tag`)
+ (error "~s: ~s not found in symbol index" 'doc sym)))