annotate lisp/mule/mule-help.el @ 207:e45d5e7c476e r20-4b2

Import from CVS: tag r20-4b2
author cvs
date Mon, 13 Aug 2007 10:03:52 +0200
parents
children 41ff10fd062f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
207
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
1 ;;; mule-help.el --- Mule-ized Help functions
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
2
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
3 ;; Copyright (C) 1997 by Free Software Foundation, Inc.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
4
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
5 ;; Author: SL Baur <steve@altair.xemacs.org>
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
6 ;; Keywords: help, internal
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
7
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
8 ;; This file is part of XEmacs.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
9
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
10 ;; XEmacs is free software; you can redistribute it and/or modify it
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
11 ;; under the terms of the GNU General Public License as published by
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
12 ;; the Free Software Foundation; either version 2, or (at your option)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
13 ;; any later version.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
14
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
15 ;; XEmacs is distributed in the hope that it will be useful, but
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
16 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
18 ;; General Public License for more details.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
19
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
20 ;; You should have received a copy of the GNU General Public License
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
21 ;; along with XEmacs; see the file COPYING. If not, write to the Free
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
22 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
23 ;; 02111-1307, USA.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
24
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
25 ;;; Synched up with: Emacs 20.1
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
26
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
27 ;;; Commentary:
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
28
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
29 ;;
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
30
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
31 ;;; Code:
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
32
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
33 ;; TUTORIAL arg is XEmacs addition
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
34 (defun help-with-tutorial (&optional arg tutorial)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
35 "Select the Emacs learn-by-doing tutorial.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
36 If there is a tutorial version written in the language
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
37 of the selected language environment, that version is used.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
38 If there's no tutorial in that language, `TUTORIAL' is selected.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
39 With arg, you are asked to select which language."
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
40 (interactive "P")
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
41 (let (lang filename file)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
42 (if arg
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
43 (or (setq lang (read-language-name 'tutorial "Language: "))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
44 (error "No tutorial file of the specified language"))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
45 (setq lang current-language-environment))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
46 (setq filename (or (get-language-info lang 'tutorial)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
47 (or tutorial "TUTORIAL")))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
48 (setq file (expand-file-name (concat "~/" filename)))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
49 (delete-other-windows)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
50 (if (get-file-buffer file)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
51 (switch-to-buffer (get-file-buffer file))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
52 (switch-to-buffer (create-file-buffer file))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
53 (setq buffer-file-name file)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
54 (setq default-directory (expand-file-name "~/"))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
55 (setq buffer-auto-save-file-name nil)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
56 (insert-file-contents (expand-file-name filename data-directory))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
57 (goto-char (point-min))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
58 (search-forward "\n<<")
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
59 (beginning-of-line)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
60 (delete-region (point) (progn (end-of-line) (point)))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
61 (let ((n (- (window-height (selected-window))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
62 (count-lines (point-min) (point))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
63 6)))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
64 (if (< n 12)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
65 (newline n)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
66 ;; Some people get confused by the large gap.
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
67 (newline (/ n 2))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
68 (insert "[Middle of page left blank for didactic purposes. "
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
69 "Text continues below]")
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
70 (newline (- n (/ n 2)))))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
71 (goto-char (point-min))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
72 (set-buffer-modified-p nil))))
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
73
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
74
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
75 (provide 'mule-help)
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
76
e45d5e7c476e Import from CVS: tag r20-4b2
cvs
parents:
diff changeset
77 ;;; mule-help.el ends here