1;;; url-about.el --- Show internal URLs
2
3;; Copyright (C) 2001, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
4
5;; Keywords: comm, data, processes, hypermedia
6
7;; This file is part of GNU Emacs.
8;;
9;; GNU Emacs is free software; you can redistribute it and/or modify
10;; it under the terms of the GNU General Public License as published by
11;; the Free Software Foundation; either version 2, or (at your option)
12;; any later version.
13;;
14;; GNU Emacs is distributed in the hope that it will be useful,
15;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17;; GNU General Public License for more details.
18;;
19;; You should have received a copy of the GNU General Public License
20;; along with GNU Emacs; see the file COPYING.  If not, write to the
21;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22;; Boston, MA 02110-1301, USA.
23
24;;; Commentary:
25
26;;; Code:
27
28(eval-when-compile
29  (require 'cl))
30(require 'url-util)
31(require 'url-parse)
32
33(defun url-probe-protocols ()
34  "Return a list of all potential URL schemes."
35  (or (get 'url-extension-protocols 'probed)
36      (mapc (lambda (s) (url-scheme-get-property s 'name))
37	    (or (get 'url-extension-protocols 'schemes)
38		(let ((schemes '("info" "man" "rlogin" "telnet"
39				 "tn3270" "data" "snews")))
40		  (mapc (lambda (d)
41			  (mapc (lambda (f)
42				  (if (string-match "url-\\(.*\\).el$" f)
43				      (push (match-string 1 f) schemes)))
44				(directory-files d nil "^url-.*\\.el$")))
45			load-path)
46		  (put 'url-extension-protocols 'schemes schemes)
47		  schemes)))))
48
49(defvar url-scheme-registry)
50
51(defun url-about-protocols (url)
52  (url-probe-protocols)
53  (insert "<html>\n"
54	  " <head>\n"
55	  "  <title>Supported Protocols</title>\n"
56	  " </head>\n"
57	  " <body>\n"
58	  "  <h1>Supported Protocols - URL v" url-version "</h1>\n"
59	  "  <table width='100%' border='1'>\n"
60	  "   <tr>\n"
61	  "    <td>Protocol\n"
62	  "    <td>Properties\n"
63	  "    <td>Description\n"
64	  "   </tr>\n")
65  (mapc (lambda (k)
66	  (if (string= k "proxy")
67	      ;; Ignore the proxy setting... its magic!
68	      nil
69	    (insert "   <tr>\n")
70	    ;; The name of the protocol
71	    (insert "    <td valign=top>" (or (url-scheme-get-property k 'name) k) "\n")
72
73	    ;; Now the properties.  Currently just asynchronous
74	    ;; status, default port number, and proxy status.
75	    (insert "    <td valign=top>"
76		    (if (url-scheme-get-property k 'asynchronous-p) "As" "S")
77		    "ynchronous<br>\n"
78		    (if (url-scheme-get-property k 'default-port)
79			(format "Default Port: %d<br>\n"
80				(url-scheme-get-property k 'default-port)) "")
81		    (if (assoc k url-proxy-services)
82			(format "Proxy: %s<br>\n" (assoc k url-proxy-services)) ""))
83	    ;; Now the description...
84	    (insert "    <td valign=top>"
85		    (or (url-scheme-get-property k 'description) "N/A"))))
86	(sort (let (x) (maphash (lambda (k v) (push k x)) url-scheme-registry) x) 'string-lessp))
87  (insert "  </table>\n"
88	  " </body>\n"
89	  "</html>\n"))
90
91(defun url-about (url)
92  "Show internal URLs."
93  (let* ((item (downcase (url-filename url)))
94	 (func (intern (format "url-about-%s" item))))
95    (if (fboundp func)
96	(progn
97	  (set-buffer (generate-new-buffer " *about-data*"))
98	  (insert "Content-type: text/plain\n\n")
99	  (funcall func url)
100	  (current-buffer))
101      (error "URL does not know about `%s'" item))))
102
103(provide 'url-about)
104
105;; arch-tag: 65dd7fca-db3f-4cb1-8026-7dd37d4a460e
106;;; url-about.el ends here
107