1 ;;; woman.el --- browse UN*X manual pages `wo (without) man'
3 ;; Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005,
4 ;; 2006, 2007 Free Software Foundation, Inc.
6 ;; Author: Francis J. Wright <F.J.Wright@qmul.ac.uk>
8 ;; Keywords: help, unix
9 ;; Adapted-By: Eli Zaretskii <eliz@gnu.org>
10 ;; Version: see `woman-version'
11 ;; URL: http://centaur.maths.qmul.ac.uk/Emacs/WoMan/
13 ;; This file is part of GNU Emacs.
15 ;; GNU Emacs is free software; you can redistribute it and/or modify
16 ;; it under the terms of the GNU General Public License as published by
17 ;; the Free Software Foundation; either version 3, or (at your option)
20 ;; GNU Emacs is distributed in the hope that it will be useful,
21 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
22 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 ;; GNU General Public License for more details.
25 ;; You should have received a copy of the GNU General Public License
26 ;; along with GNU Emacs; see the file COPYING. If not, write to the
27 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
28 ;; Boston, MA 02110-1301, USA.
32 ;; WoMan implements a subset of the formatting performed by the Emacs
33 ;; `man' (or `manual-entry') command to format a UN*X manual `page'
34 ;; for display, but without calling any external programs. It is
35 ;; intended to emulate the whole of the -man macro package, plus those
36 ;; ?roff requests that are most commonly used in man pages. However,
37 ;; the emulation is modified to include the reformatting done by the
38 ;; Emacs `man' command. No hyphenation is performed.
42 ;; Much more direct, does not require any external programs.
43 ;; Supports completion on man page names.
47 ;; Not a complete emulation. Currently no support for eqn or tbl.
48 ;; Slightly slower for large man pages (but usually faster for
49 ;; small- and medium-size pages).
51 ;; This browser works quite well on simple well-written man files. It
52 ;; works less well on idiosyncratic files that `break the rules' or
53 ;; use the more obscure ?roff requests directly. Current test results
54 ;; are available in the file woman.status.
56 ;; WoMan supports the use of compressed man files via
57 ;; `auto-compression-mode' by turning it on if necessary. But you may
58 ;; need to adjust the user option `woman-file-compression-regexp'.
60 ;; Read on for (currently) the only documentation for WoMan!
62 ;; See also the documentation for the WoMan interactive commands and
63 ;; user option variables, all of which begin with the prefix `woman-'.
64 ;; This can be done most easily by loading WoMan and then running the
65 ;; command `woman-mini-help', or selecting the WoMan menu option `Mini
66 ;; Help' when WoMan is running.
68 ;; WoMan is still under development! Please let me know what doesn't
69 ;; work -- I am adding and improving functionality as testing shows
70 ;; that it is necessary. See below for guidance on reporting bugs.
75 ;; Put this in your .emacs:
76 ;; (autoload 'woman "woman"
77 ;; "Decode and browse a UN*X man page." t)
78 ;; (autoload 'woman-find-file "woman"
79 ;; "Find, decode and browse a specific UN*X man-page file." t)
81 ;; Then either (1 -- *RECOMMENDED*): If the `MANPATH' environment
82 ;; variable is set then WoMan will use it; otherwise you may need to
83 ;; reset the Lisp variable `woman-manpath', and you may also want to
84 ;; set the Lisp variable `woman-path'. Please see the online
85 ;; documentation for these variables. Now you can execute the
86 ;; extended command `woman', enter or select a manual entry topic,
87 ;; using completion, and if necessary select a filename, using
88 ;; completion. By default, WoMan suggests the word nearest to the
89 ;; cursor in the current buffer as the topic.
91 ;; Or (2): Execute the extended command `woman-find-file' and enter a
92 ;; filename, using completion. This mode of execution may be useful
93 ;; for temporary files outside the standard UN*X manual directory
96 ;; Or (3): Put the next two sexpr's in your .emacs:
97 ;; (autoload 'woman-dired-find-file "woman"
98 ;; "In dired, run the WoMan man-page browser on this file." t)
99 ;; (add-hook 'dired-mode-hook
101 ;; (define-key dired-mode-map "W" 'woman-dired-find-file)))
102 ;; and open the directory containing the man page file using dired,
103 ;; put the cursor on the file, and press `W'.
105 ;; In each case, the result should (!) be a buffer in Man mode showing
106 ;; a formatted manual entry. When called from WoMan, Man mode should
107 ;; work as advertised, but modified where necessary in the context of
108 ;; WoMan. (However, `Man' will still invoke the standard Emacs
109 ;; manual-browsing facility rather than `WoMan' -- this is
112 ;; (By default, WoMan will automatically define the dired keys "W" and
113 ;; "w" when it loads, but only if they are not already defined. This
114 ;; behaviour is controlled by the user option `woman-dired-keys'.
115 ;; Note that the `dired-x' (dired extra) package binds
116 ;; `dired-copy-filename-as-kill' to the key "w" (as pointed out by Jim
117 ;; Davidson), although "W" appears to be really unused. The `dired-x'
118 ;; package will over-write the WoMan binding to "w", whereas (by
119 ;; default) WoMan will not overwrite the `dired-x' binding.)
121 ;; The following is based on suggestions by Guy Gascoigne-Piggford and
122 ;; Juanma Barranquero. If you really want to square the man-woman
123 ;; circle then you might care to define the following bash function in
126 ;; man() { gnudoit -q '(raise-frame (selected-frame)) (woman' \"$1\" ')' ; }
128 ;; If you use Microsoft COMMAND.COM then you can create a file called
129 ;; man.bat somewhere in your path containing the two lines:
132 ;; gnudoit -q (raise-frame (selected-frame)) (woman \"%1\")
134 ;; and then (e.g. from a command prompt or the Run... option in the
135 ;; Start menu) just execute
140 ;; Using the word at point as the default topic
141 ;; ============================================
143 ;; The `woman' command uses the word nearest to point in the current
144 ;; buffer as the default topic to look up if it matches the name of a
145 ;; manual page installed on the system. The default topic can also be
146 ;; used without confirmation by setting the user-option
147 ;; `woman-use-topic-at-point' to t; thanks to Benjamin Riefenstahl for
148 ;; suggesting this functionality.
150 ;; The variable `woman-use-topic-at-point' can be rebound locally,
151 ;; which may be useful to provide special private key bindings, e.g.
153 ;; (global-set-key "\C-cw"
156 ;; (let ((woman-use-topic-at-point t))
160 ;; Customization, Hooks and Imenu
161 ;; ==============================
163 ;; WoMan supports the GNU Emacs 20+ customization facility, and puts
164 ;; a customization group called `WoMan' in the `Help' group under the
165 ;; top-level `Emacs' group. In order to be able to customize WoMan
166 ;; without first loading it, add the following sexp to your .emacs:
168 ;; (defgroup woman nil
169 ;; "Browse UNIX manual pages `wo (without) man'."
170 ;; :tag "WoMan" :group 'help :load "woman")
173 ;; WoMan currently runs two hooks: `woman-pre-format-hook' immediately
174 ;; before formatting a buffer and `woman-post-format-hook' immediately
175 ;; after formatting a buffer. These hooks can be used for special
176 ;; customizations that require code to be executed, etc., although
177 ;; most customization should be possible by setting WoMan user option
178 ;; variables, e.g. in `.emacs' and should NOT require the use of the
179 ;; hooks. `woman-pre-format-hook' might be appropriate for face
180 ;; customization, whereas `woman-post-format-hook' might be
181 ;; appropriate for installing a dynamic menu using `imenu' (although
182 ;; it is better to use the built-in WoMan imenu support).
184 ;; The WoMan menu provides an option to make a contents menu for the
185 ;; current man page (using imenu). Alternatively, if you set the
186 ;; variable `woman-imenu' to `t' then WoMan will do it automatically
187 ;; for every man page. The menu title is the value of the variable
188 ;; `woman-imenu-title', which is "CONTENTS" by default. By default,
189 ;; the menu shows manual sections and subsections, but you can change
190 ;; this by changing the value of `woman-imenu-generic-expression'.
191 ;; This facility is not yet widely tested and may be fooled by obscure
192 ;; man pages that `break the rules'.
194 ;; WoMan is configured not to replace spaces in an imenu *Completion*
195 ;; buffer. For further documentation of the use of imenu, such as
196 ;; menu sorting, see the source file imenu.el, which is distributed
199 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
201 ;; Howard Melman made (essentially) the following suggestions, which
202 ;; are slightly different from the expression that I currently use.
203 ;; You may prefer one of Howard's suggestions, which I think assume
204 ;; that `case-fold-search' is `t' (which it is by default):
206 ;; (setq woman-imenu-generic-expression
207 ;; '((nil "^\\( \\)?\\([A-Z][A-Z ]+[A-Z]\\)[ \t]*$" 2)))
209 ;; will give support for .SH and .SS, though it won't show the heading
210 ;; name hierarchy. If you just want .SH in the imenu then use:
212 ;; (setq woman-imenu-generic-expression
213 ;; '((nil "^\\([A-Z][A-Z ]+[A-Z]\\)[ \t]*$" 1)))
215 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
218 ;; Vertical spacing and blank lines
219 ;; ================================
221 ;; The number of consecutive blank lines in the formatted buffer
222 ;; should be either 0 or 1. A blank line should leave a space like
223 ;; .sp 1 (p. 14). Current policy is to output vertical space only
224 ;; immediately before text is output.
227 ;; Horizontal and vertical spacing and resolution
228 ;; ==============================================
230 ;; WoMan currently assumes 10 characters per inch horizontally, hence
231 ;; a horizontal resolution of 24 basic units, and 5 lines per inch
232 ;; vertically, hence a vertical resolution of 48 basic units. (nroff
233 ;; uses 240 per inch).
236 ;; The *WoMan-Log* buffer
237 ;; ======================
239 ;; This is modelled on the byte-compiler. It logs all files formatted
240 ;; by WoMan, and if WoMan finds anything that it cannot handle then it
241 ;; writes a warning to this buffer. If the variable `woman-show-log'
242 ;; is non-nil (by default it is `nil') then WoMan automatically
243 ;; displays this buffer. Many WoMan warnings can be completely
244 ;; ignored, because they are reporting the fact that WoMan has ignored
245 ;; requests that it is correct to ignore. In some future version this
246 ;; level of paranoia will be reduced, but not until WoMan is more
247 ;; reliable. At present, all warnings should be treated with some
248 ;; suspicion. Uninterpreted escape sequences are also logged (in some
251 ;; Uninterpreted ?roff requests can optionally be left in the
252 ;; formatted buffer to indicate precisely where they occur by
253 ;; resetting the variable `woman-ignore' to `nil' (by default it is
256 ;; Automatic initiation of woman decoding
258 ;; (Probably not a good idea. If you use it, be careful!)
260 ;; Put something like this in your .emacs. The call to
261 ;; set-visited-file-name is to avoid font-locking triggered by
262 ;; automatic major mode selection.
264 ;; (autoload 'woman-decode-region "woman")
266 ;; (setq format-alist
268 ;; '(man "UN*X man-page source format" "\\.\\(TH\\|ig\\) "
269 ;; woman-decode-region nil nil
271 ;; set-visited-file-name
272 ;; (file-name-sans-extension buffer-file-name)))))
279 ;; If WoMan fails completely, or formats a file incorrectly
280 ;; (i.e. obviously wrongly or significantly differently from man) or
281 ;; inelegantly, then please
283 ;; (a) check that you are running the latest version of woman.el
284 ;; available from my web site (see above),
286 ;; (b) check that the problem is not already described in the file
287 ;; woman.status, also available from my web site.
289 ;; If both of the above are true then please email me the entry from
290 ;; the *WoMan-Log* buffer relating to the problem file, together with
291 ;; a brief description of the problem. Please indicate where you got
292 ;; the source file from, but do not send it to me unless I ask you to!
293 ;; Thanks. (There is at present no automated bug-reporting facility
296 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
300 ;; CASE-DEPENDENCE OF FILENAMES. By default, WoMan ignores case in
301 ;; file pathnames only when it seems appropriate. MS-Windows users
302 ;; who want complete case independence should set the NTEmacs variable
303 ;; `w32-downcase-file-names' to `t' and use all lower case when
304 ;; setting WoMan file paths.
306 ;; (1) INCOMPATIBLE CHANGE! WoMan no longer uses a persistent topic
307 ;; cache by default. (It caused too much confusion!) Explicitly set
308 ;; the variable `woman-cache-filename' to save the cache between Emacs
309 ;; sessions. This is recommended only if the command `woman' is too
310 ;; slow the first time that it is run in an Emacs session, while it
311 ;; builds its cache in main memory, which MAY be VERY slow.
313 ;; (2) The user option `woman-cache-level' controls the amount of
314 ;; information cached (in main memory and, optionally, saved to disc).
316 ;; (3) UPDATING THE CACHE. A prefix argument always causes the
317 ;; `woman' command (only) to rebuild its topic cache, and to re-save
318 ;; it to `woman-cache-filename' if this variable has a non-nil value.
319 ;; This is necessary if the NAMES (not contents) of any of the
320 ;; directories or files in the paths specified by `woman-manpath' or
321 ;; `woman-path' change. If WoMan user options that affect the cache
322 ;; are changed then WoMan will automatically update its cache file on
323 ;; disc (if one is in use) the next time it is run in a new Emacs
326 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
332 ;; Reconsider case sensitivity of file names.
333 ;; MUST PROCESS .if, .nr IN ORDER ENCOUNTERED IN FILE! (rcsfile, mf).
334 ;; Allow general delimiter in `\v', cf. `\h'.
335 ;; Improve major-mode documentation.
336 ;; Pre-process conditionals in macro bodies if possible for speed?
337 ;; Emulate more complete preprocessor support for tbl (.TS/.TE)
338 ;; Emulate some preprocessor support for eqn (.EQ/.EN)
339 ;; Re-write filling and adjusting code!
340 ;; Allow word wrap at comma (for long option lists)?
341 ;; Buffer list handling not quite right.
342 ;; Make 10 or 12 pitch (cpi) optional -- 12 => ll = 78
343 ;; Use unpaddable space for tabbing?
344 ;; Tidy up handling of fonts when filling and adjusting
345 ;; -- see text/text properties?
347 ;; Add font-lock support (for quoted strings, etc.)?
348 ;; Optionally save large files in enriched format?
349 ;; Add apropos facility by searching NAME (?) entry in man files?
350 ;; Documentation -- optional auto-display of formatted WoMan man page?
351 ;; Implement a bug reporter?
352 ;; Support diversion and traps (to some extent) - for Tcl/tk pages?
353 ;; Add a menu of WoMan buffers?
357 ;; Implementation strategy [this description is now well out of date!]
358 ;; -- three main passes, each to process respectively:
360 ;; 1) non-breaking `.' requests including font macros
361 ;; 2) \ escape sequences, mainly special characters and font changes
362 ;; 3) breaking `.' requests, mainly filling and justification
364 ;; For each pass, a control function finds and pre-processes the
365 ;; escape or request and then calls the appropriate function to
366 ;; perform the required formatting. Based originally on enriched.el
369 ;; The background information that made this project possible is
370 ;; freely available courtesy of Bell Labs from
371 ;; http://cm.bell-labs.com/7thEdMan/
377 ;; For Heather, Kathryn and Madelyn, the women in my life
378 ;; (although they will probably never use it)!
380 ;; I also thank the following for helpful suggestions, bug reports,
381 ;; code fragments, general interest, etc.:
382 ;; Jari Aalto <jari.aalto@cs.tpu.fi>
383 ;; Dean Andrews <dean@dra.com>
384 ;; Juanma Barranquero <lekktu@gmail.com>
385 ;; Karl Berry <kb@cs.umb.edu>
386 ;; Jim Chapman <jchapman@netcomuk.co.uk>
387 ;; Kin Cho <kin@neoscale.com>
388 ;; Frederic Corne <frederic.corne@erli.fr>
389 ;; Peter Craft <craft@alacritech.com>
390 ;; Charles Curley <ccurley@trib.com>
391 ;; Jim Davidson <jdavidso@teknowledge.com>
392 ;; Kevin D'Elia <Kevin.DElia@mci.com>
393 ;; John Fitch <jpff@maths.bath.ac.uk>
394 ;; Hans Frosch <jwfrosch@rish.b17c.ingr.com>
395 ;; Guy Gascoigne-Piggford <ggp@informix.com>
396 ;; Brian Gorka <gorkab@sanchez.com>
397 ;; Nicolai Henriksen <nhe@lyngso-industri.dk>
398 ;; Thomas Herchenroeder <the@software-ag.de>
399 ;; Alexander Hinds <ahinds@thegrid.net>
400 ;; Stefan Hornburg <sth@hacon.de>
401 ;; Theodore Jump <tjump@cais.com>
402 ;; David Kastrup <dak@gnu.org>
403 ;; Paul Kinnucan <paulk@mathworks.com>
404 ;; Jonas Linde <jonas@init.se>
405 ;; Andrew McRae <andrewm@optimation.co.nz>
406 ;; Howard Melman <howard@silverstream.com>
407 ;; Dennis Pixton <dennis@math.binghamton.edu>
408 ;; T. V. Raman <raman@Adobe.COM>
409 ;; Bruce Ravel <bruce.ravel@nist.gov>
410 ;; Benjamin Riefenstahl <benny@crocodial.de>
411 ;; Kevin Ruland <kruland@seistl.com>
412 ;; Tom Schutter <tom@platte.com>
413 ;; Wei-Xue Shi <wxshi@ma.neweb.ne.jp>
414 ;; Fabio Somenzi <fabio@joplin.colorado.edu>
415 ;; Karel Sprenger <ks@ic.uva.nl>
416 ;; Chris Szurgot <szurgot@itribe.net>
417 ;; Paul A. Thompson <pat@po.cwru.edu>
418 ;; Arrigo Triulzi <arrigo@maths.qmw.ac.uk>
419 ;; Geoff Voelker <voelker@cs.washington.edu>
420 ;; Eli Zaretskii <eliz@gnu.org>
425 (defvar woman-version
"0.551 (beta)" "WoMan version information.")
429 (define-button-type 'WoMan-xref-man-page
430 :supertype
'Man-abstract-xref-man-page
433 ;; `woman' cannot deal with arguments that contain a
434 ;; section name, like close(2), so strip the section name.
435 (if (string-match Man-reference-regexp arg
)
436 (substring arg
0 (match-end 1))
439 (eval-when-compile ; to avoid compiler warnings
444 (defun woman-mapcan (fn x
)
445 "Return concatenated list of FN applied to successive `car' elements of X.
446 FN must return a list, cons or nil. Useful for splicing into a list."
447 ;; Based on the Standard Lisp function MAPCAN but with args swapped!
448 ;; More concise implementation than the recursive one. -- dak
449 (apply #'nconc
(mapcar fn x
)))
451 (defun woman-parse-colon-path (paths)
452 "Explode search path string PATHS into a list of directory names.
453 Allow Cygwin colon-separated search paths on Microsoft platforms.
454 Replace null components by calling `woman-parse-man.conf'.
455 As a special case, if PATHS is nil then replace it by calling
456 `woman-parse-man.conf'."
457 ;; Based on suggestions by Jari Aalto and Eli Zaretskii.
458 ;; parse-colon-path returns nil for a null path component and
459 ;; an empty substring of MANPATH denotes the default list.
460 (if (memq system-type
'(windows-nt ms-dos
))
462 (mapcar 'woman-Cyg-to-Win
(woman-parse-man.conf
)))
463 ((string-match ";" paths
)
464 ;; Assume DOS-style path-list...
465 (woman-mapcan ; splice list into list
469 (mapcar 'woman-Cyg-to-Win
(woman-parse-man.conf
))))
470 (parse-colon-path paths
)))
471 ((string-match "\\`[a-zA-Z]:" paths
)
472 ;; Assume single DOS-style path...
475 ;; Assume UNIX/Cygwin-style path-list...
476 (woman-mapcan ; splice list into list
478 (mapcar 'woman-Cyg-to-Win
479 (if x
(list x
) (woman-parse-man.conf
))))
480 (let ((path-separator ":"))
481 (parse-colon-path paths
)))))
482 ;; Assume host-default-style path-list...
483 (woman-mapcan ; splice list into list
484 (lambda (x) (if x
(list x
) (woman-parse-man.conf
)))
485 (parse-colon-path (or paths
"")))))
487 (defun woman-Cyg-to-Win (file)
488 "Convert an absolute filename FILE from Cygwin to Windows form."
489 ;; MANPATH_MAP conses are not converted since they presumably map
490 ;; Cygwin to Cygwin form.
493 ;; Code taken from w32-symlinks.el
494 (if (eq (aref file
0) ?
/)
495 ;; Try to use Cygwin mount table via `cygpath.exe'.
499 (call-process "cygpath" nil t nil
"-m" file
)
500 (buffer-substring 1 (buffer-size)))
502 ;; Assume no `cygpath' program available.
503 ;; Hack /cygdrive/x/ or /x/ or (obsolete) //x/ to x:/
504 (when (string-match "\\`\\(/cygdrive\\|/\\)?/./" file
)
505 (if (match-string 1) ; /cygdrive/x/ or //x/ -> /x/
506 (setq file
(substring file
(match-end 1))))
507 (aset file
0 (aref file
1)) ; /x/ -> xx/
508 (aset file
1 ?
:)) ; xx/ -> x:/
515 ;; NB: Group identifiers must be lowercase!
518 "Browse UNIX manual pages `wo (without) man'."
522 (defcustom woman-show-log nil
523 "If non-nil then show the *WoMan-Log* buffer if appropriate.
524 I.e. if any warning messages are written to it. Default is nil."
528 (defcustom woman-pre-format-hook nil
529 "Hook run by WoMan immediately before formatting a buffer.
530 Change only via `Customization' or the function `add-hook'."
534 (defcustom woman-post-format-hook nil
535 "Hook run by WoMan immediately after formatting a buffer.
536 Change only via `Customization' or the function `add-hook'."
543 (defgroup woman-interface nil
544 "Interface options for browsing UNIX manual pages `wo (without) man'."
545 :tag
"WoMan Interface"
548 (defcustom woman-man.conf-path
549 (let ((path '("/usr/lib" "/etc")))
550 (if (eq system-type
'windows-nt
)
551 (mapcar 'woman-Cyg-to-Win path
)
553 "List of dirs to search and/or files to try for man config file.
554 A trailing separator (`/' for UNIX etc.) on directories is
555 optional, and the filename is used if a directory specified is
556 the first to start with \"man\" and has an extension starting
557 with \".conf\". If MANPATH is not set but a config file is found
558 then it is parsed instead to provide a default value for
560 :type
'(repeat string
)
561 :group
'woman-interface
)
563 (defun woman-parse-man.conf
()
564 "Parse if possible configuration file for man command.
565 Used only if MANPATH is not set or contains null components.
566 Look in `woman-man.conf-path' and return a value for `woman-manpath'.
567 Concatenate data from all lines in the config file of the form
570 MANDATORY_MANPATH /usr/man
572 OPTIONAL_MANPATH /usr/man
574 MANPATH_MAP /opt/bin /opt/man"
575 ;; Functionality suggested by Charles Curley.
576 (let ((path woman-man.conf-path
)
581 (file-readable-p (setq file
(car path
)))
582 ;; If not a file then find the file:
583 (or (not (file-directory-p file
))
586 (directory-files file t
"\\`man.*\\.conf[a-z]*\\'" t
))
587 (file-readable-p (setq file
(car file
)))))
588 ;; Parse the file -- if no MANPATH data ignore it:
590 (insert-file-contents file
)
591 (while (re-search-forward
592 ;; `\(?: ... \)' is a "shy group"
594 ^[ \t]*\\(?:\\(?:MANDATORY_\\|OPTIONAL_\\)?MANPATH[ \t]+\\(\\S-+\\)\\|\
595 MANPATH_MAP[ \t]+\\(\\S-+\\)[ \t]+\\(\\S-+\\)\\)" nil t
)
596 (add-to-list 'manpath
597 (if (match-beginning 1)
599 (cons (match-string 2)
603 (setq path
(cdr path
)))
606 (defcustom woman-manpath
607 (or (woman-parse-colon-path (getenv "MANPATH"))
608 '("/usr/man" "/usr/share/man" "/usr/local/man"))
609 "List of DIRECTORY TREES to search for UN*X manual files.
610 Each element should be the name of a directory that contains
611 subdirectories of the form `man?', or more precisely subdirectories
612 selected by the value of `woman-manpath-man-regexp'. Non-directory
613 and unreadable files are ignored.
615 Elements can also be a cons cell indicating a mapping from PATH
616 to manual trees: if such an element's car is equal to a path
617 element of the environment variable PATH, the cdr of the cons
618 cell is included in the directory tree search.
620 If not set then the environment variable MANPATH is used. If no such
621 environment variable is found, the default list is determined by
622 consulting the man configuration file if found, which is determined by
623 the user option `woman-man.conf-path'. An empty substring of MANPATH
624 denotes the default list.
626 Any environment variables (names must have the UN*X-style form $NAME,
627 e.g. $HOME, $EMACSDATA, $emacs_dir) are evaluated first but each
628 element must evaluate to a SINGLE directory name. Trailing `/'s are
629 ignored. (Specific directories in `woman-path' are also searched.)
632 I recommend including drive letters explicitly, e.g.
634 (\"C:/Cygwin/usr/man/\" \"C:/Cygwin/usr/local/man\").
636 The MANPATH environment variable may be set using DOS semi-colon-
637 separated or UN*X/Cygwin colon-separated syntax (but not mixed)."
638 :type
'(repeat (choice string
(cons string string
)))
639 :group
'woman-interface
)
641 (defcustom woman-manpath-man-regexp
"[Mm][Aa][Nn]"
642 "Regexp to match man directories UNDER `woman-manpath' directories.
643 These normally have names of the form `man?'. Its default value is
644 \"[Mm][Aa][Nn]\", which is case-insensitive mainly for the benefit of
645 Microsoft platforms. Its purpose is to avoid `cat?', `.', `..', etc."
646 ;; Based on a suggestion by Wei-Xue Shi.
648 :group
'woman-interface
)
650 (defcustom woman-path
651 (if (eq system-type
'ms-dos
) '("$DJDIR/info" "$DJDIR/man/cat[1-9onlp]"))
652 "List of SPECIFIC DIRECTORIES to search for UN*X manual files.
657 These directories are searched in addition to the directory trees
658 specified in `woman-manpath'. Each element should be a directory
659 string or nil, which represents the current directory when the path is
660 expanded and cached. However, the last component (only) of each
661 directory string is treated as a regexp \(Emacs, not shell) and the
662 string is expanded into a list of matching directories. Non-directory
663 and unreadable files are ignored. The default value is nil.
665 Any environment variables (which must have the UN*X-style form $NAME,
666 e.g. $HOME, $EMACSDATA, $emacs_dir) are evaluated first but each
667 element must evaluate to a SINGLE directory name (regexp, see above).
670 (\"$EMACSDATA\") [or equivalently (\"$emacs_dir/etc\")].
672 Trailing `/'s are discarded. (The directory trees in `woman-manpath'
673 are also searched.) On Microsoft platforms I recommend including
674 drive letters explicitly."
675 :type
'(repeat (choice string
(const nil
)))
676 :group
'woman-interface
)
678 (defcustom woman-cache-level
2
679 "The level of topic caching.
680 1 - cache only the topic and directory lists
681 (the only level before version 0.34 - only for compatibility);
682 2 - cache also the directories for each topic
683 (faster, without using much more memory);
684 3 - cache also the actual filenames for each topic
685 (fastest, but uses twice as much memory).
686 The default value is currently 2, a good general compromise.
687 If the `woman' command is slow to find files then try 3, which may be
688 particularly beneficial with large remote-mounted man directories.
689 Run the `woman' command with a prefix argument or delete the cache
690 file `woman-cache-filename' for a change to take effect.
691 \(Values < 1 behave like 1; values > 3 behave like 3.)"
692 :type
'(choice (const :tag
"Minimal" 1)
693 (const :tag
"Default" 2)
694 (const :tag
"Maximal" 3))
695 :group
'woman-interface
)
697 (defcustom woman-cache-filename nil
698 "The full pathname of the WoMan directory and topic cache file.
699 It is used to save and restore the cache between sessions. This is
700 especially useful with remote-mounted man page files! The default
701 value of nil suppresses this action. The `standard' non-nil
702 filename is \"~/.wmncach.el\". Remember that a prefix argument forces
703 the `woman' command to update and re-write the cache."
704 :type
'(choice (const :tag
"None" nil
)
705 (const :tag
"~/.wmncach.el" "~/.wmncach.el")
707 :group
'woman-interface
)
709 (defcustom woman-dired-keys t
710 "List of `dired' mode keys to define to run WoMan on current file.
711 E.g. '(\"w\" \"W\"), or any non-null atom to automatically define
712 \"w\" and \"W\" if they are unbound, or nil to do nothing.
714 :type
'(choice (const :tag
"None" nil
)
716 (other :tag
"Auto" t
))
717 :group
'woman-interface
)
719 (defcustom woman-imenu-generic-expression
720 '((nil "\n\\([A-Z].*\\)" 1) ; SECTION, but not TITLE
721 ("*Subsections*" "^ \\([A-Z].*\\)" 1))
722 "Imenu support for Sections and Subsections.
723 An alist with elements of the form (MENU-TITLE REGEXP INDEX) --
724 see the documentation for `imenu-generic-expression'."
726 :group
'woman-interface
)
728 (defcustom woman-imenu nil
729 "If non-nil then WoMan adds a Contents menu to the menubar.
730 It does this by calling `imenu-add-to-menubar'. Default is nil."
732 :group
'woman-interface
)
734 (defcustom woman-imenu-title
"CONTENTS"
735 "The title to use if WoMan adds a Contents menu to the menubar.
736 Default is \"CONTENTS\"."
738 :group
'woman-interface
)
740 (defcustom woman-use-topic-at-point-default nil
741 ;; `woman-use-topic-at-point' may be let-bound when woman is loaded,
742 ;; in which case its global value does not get defined.
743 ;; `woman-file-name' sets it to this value if it is unbound.
744 "Default value for `woman-use-topic-at-point'."
745 :type
'(choice (const :tag
"Yes" t
)
746 (const :tag
"No" nil
))
747 :group
'woman-interface
)
749 (defcustom woman-use-topic-at-point woman-use-topic-at-point-default
750 "Control use of the word at point as the default topic.
751 If non-nil the `woman' command uses the word at point automatically,
752 without interactive confirmation, if it exists as a topic."
753 :type
'(choice (const :tag
"Yes" t
)
754 (const :tag
"No" nil
))
755 :group
'woman-interface
)
757 (defvar woman-file-regexp nil
758 "Regexp used to select (possibly compressed) man source files, e.g.
759 \"\\.\\([0-9lmnt]\\w*\\)\\(\\.\\(g?z\\|bz2\\)\\)?\\'\".
760 Built automatically from the customizable user options
761 `woman-uncompressed-file-regexp' and `woman-file-compression-regexp'.")
763 (defvar woman-uncompressed-file-regexp
) ; for the compiler
764 (defvar woman-file-compression-regexp
) ; for the compiler
766 (defun set-woman-file-regexp (symbol value
)
767 "Bind SYMBOL to VALUE and set `woman-file-regexp' as per user customizations.
768 Used as :set cookie by Customize when customizing the user options
769 `woman-uncompressed-file-regexp' and `woman-file-compression-regexp'."
770 (set-default symbol value
)
771 (and (boundp 'woman-uncompressed-file-regexp
)
772 (boundp 'woman-file-compression-regexp
)
773 (setq woman-file-regexp
774 (concat woman-uncompressed-file-regexp
776 (substring woman-file-compression-regexp
0 -
2)
779 (defcustom woman-uncompressed-file-regexp
780 "\\.\\([0-9lmnt]\\w*\\)" ; disallow no extension
781 "Do not change this unless you are sure you know what you are doing!
782 Regexp used to select man source files (ignoring any compression extension).
784 The SysV standard man pages use two character suffixes, and this is
785 becoming more common in the GNU world. For example, the man pages
786 in the ncurses package include `toe.1m', `form.3x', etc.
788 Note: an optional compression regexp will be appended, so this regexp
789 MUST NOT end with any kind of string terminator such as $ or \\'."
791 :set
'set-woman-file-regexp
792 :group
'woman-interface
)
794 (defcustom woman-file-compression-regexp
795 "\\.\\(g?z\\|bz2\\)\\'"
796 "Do not change this unless you are sure you know what you are doing!
797 Regexp used to match compressed man file extensions for which
798 decompressors are available and handled by auto-compression mode,
799 e.g. \"\\\\.\\\\(g?z\\\\|bz2\\\\)\\\\'\" for `gzip' or `bzip2'.
800 Should begin with \\. and end with \\' and MUST NOT be optional."
801 ;; Should be compatible with car of
802 ;; `jka-compr-file-name-handler-entry', but that is unduly
803 ;; complicated, includes an inappropriate extension (.tgz) and is
804 ;; not loaded by default!
806 :set
'set-woman-file-regexp
807 :group
'woman-interface
)
809 (defcustom woman-use-own-frame
; window-system
810 (or (and (fboundp 'display-graphic-p
) (display-graphic-p)) ; Emacs 21
811 (memq window-system
'(x w32
))) ; Emacs 20
812 "If non-nil then use a dedicated frame for displaying WoMan windows.
813 Only useful when run on a graphic display such as X or MS-Windows."
815 :group
'woman-interface
)
818 ;; Formatting options
820 (defgroup woman-formatting nil
821 "Formatting options for browsing UNIX manual pages `wo (without) man'."
822 :tag
"WoMan Formatting"
825 (defcustom woman-fill-column
65
826 "Right margin for formatted text -- default is 65."
828 :group
'woman-formatting
)
830 (defcustom woman-fill-frame nil
831 ;; Based loosely on a suggestion by Theodore Jump:
832 "If non-nil then most of the window width is used."
834 :group
'woman-formatting
)
836 (defcustom woman-default-indent
5
837 "Default prevailing indent set by -man macros -- default is 5.
838 Set this variable to 7 to emulate GNU man formatting."
840 :group
'woman-formatting
)
842 (defcustom woman-bold-headings t
843 "If non-nil then embolden section and subsection headings. Default is t.
844 Heading emboldening is NOT standard `man' behavior."
846 :group
'woman-formatting
)
848 (defcustom woman-ignore t
849 "If non-nil then unrecognized requests etc.. are ignored. Default is t.
850 This gives the standard ?roff behavior. If nil then they are left in
851 the buffer, which may aid debugging."
853 :group
'woman-formatting
)
855 (defcustom woman-preserve-ascii t
856 "If non-nil, preserve ASCII characters in the WoMan buffer.
857 Otherwise, to save time, some backslashes and spaces may be
858 represented differently (as the values of the variables
859 `woman-escaped-escape-char' and `woman-unpadded-space-char'
860 respectively) so that the buffer content is strictly wrong even though
861 it should display correctly. This should be irrelevant unless the
862 buffer text is searched, copied or saved to a file."
863 ;; This option should probably be removed!
865 :group
'woman-formatting
)
867 (defcustom woman-emulation
'nroff
868 "WoMan emulation, currently either nroff or troff. Default is nroff.
869 Troff emulation is experimental and largely untested.
871 :type
'(choice (const nroff
) (const troff
))
872 :group
'woman-formatting
)
877 (defgroup woman-faces nil
878 "Face options for browsing UNIX manual pages `wo (without) man'."
883 (defcustom woman-fontify
884 (or (and (fboundp 'display-color-p
) (display-color-p))
885 (and (fboundp 'display-graphic-p
) (display-graphic-p))
887 "If non-nil then WoMan assumes that face support is available.
888 It defaults to a non-nil value if the display supports either colors
893 ;; This is overkill! Troff uses just italic; Nroff uses just underline.
894 ;; You should probably select either italic or underline as you prefer, but
895 ;; not both, although italic and underline work together perfectly well!
896 (defface woman-italic
897 `((((min-colors 88) (background light
))
898 (:slant italic
:underline t
:foreground
"red1"))
899 (((background light
)) (:slant italic
:underline t
:foreground
"red"))
900 (((background dark
)) (:slant italic
:underline t
)))
901 "Face for italic font in man pages."
903 ;; backward-compatibility alias
904 (put 'woman-italic-face
'face-alias
'woman-italic
)
907 '((((min-colors 88) (background light
)) (:weight bold
:foreground
"blue1"))
908 (((background light
)) (:weight bold
:foreground
"blue"))
909 (((background dark
)) (:weight bold
:foreground
"green2")))
910 "Face for bold font in man pages."
912 ;; backward-compatibility alias
913 (put 'woman-bold-face
'face-alias
'woman-bold
)
915 ;; Brown is a good compromise: it is distinguishable from the default
916 ;; but not enough so to make font errors look terrible. (Files that use
917 ;; non-standard fonts seem to do so badly or in idiosyncratic ways!)
918 (defface woman-unknown
919 '((((background light
)) (:foreground
"brown"))
920 (((min-colors 88) (background dark
)) (:foreground
"cyan1"))
921 (((background dark
)) (:foreground
"cyan")))
922 "Face for all unknown fonts in man pages."
924 ;; backward-compatibility alias
925 (put 'woman-unknown-face
'face-alias
'woman-unknown
)
927 (defface woman-addition
928 '((t (:foreground
"orange")))
929 "Face for all WoMan additions to man pages."
931 ;; backward-compatibility alias
932 (put 'woman-addition-face
'face-alias
'woman-addition
)
934 (defun woman-default-faces ()
935 "Set foreground colors of italic and bold faces to their default values."
937 (face-spec-set 'woman-italic
(face-user-default-spec 'woman-italic
))
938 (face-spec-set 'woman-bold
(face-user-default-spec 'woman-bold
)))
940 (defun woman-monochrome-faces ()
941 "Set foreground colors of italic and bold faces to that of the default face.
942 This is usually either black or white."
944 (set-face-foreground 'woman-italic
'unspecified
)
945 (set-face-foreground 'woman-bold
'unspecified
))
947 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
948 ;; Experimental font support, initially only for MS-Windows.
949 (defconst woman-font-support
950 (eq window-system
'w32
) ; Support X later!
951 "If non-nil then non-ASCII characters and symbol font supported.")
953 (defun woman-select-symbol-fonts (fonts)
954 "Select symbol fonts from a list FONTS of font name strings."
956 ;; With NTEmacs 20.5, the PATTERN option to `x-list-fonts' does
957 ;; not seem to work and fonts may be repeated, so ...
959 (and (string-match "-Symbol-" font
)
960 (not (member font symbol-fonts
))
961 (setq symbol-fonts
(cons font symbol-fonts
))))
964 (when woman-font-support
965 (make-face 'woman-symbol
)
967 ;; Set the symbol font only if `woman-use-symbol-font' is true, to
968 ;; avoid unnecessarily upsetting the line spacing in NTEmacs 20.5!
970 (defcustom woman-use-extended-font t
971 "If non-nil then may use non-ASCII characters from the default font."
975 (defcustom woman-use-symbol-font nil
976 "If non-nil then may use the symbol font.
977 It is off by default, mainly because it may change the line spacing
982 (defconst woman-symbol-font-list
983 (or (woman-select-symbol-fonts (x-list-fonts "*" 'default
))
984 (woman-select-symbol-fonts (x-list-fonts "*")))
985 "Symbol font(s), preferably same size as default when WoMan was loaded.")
987 (defcustom woman-symbol-font
(car woman-symbol-font-list
)
988 "A string describing the symbol font to use for special characters.
989 It should be compatible with, and the same size as, the default text font.
990 Under MS-Windows, the default is
991 \"-*-Symbol-normal-r-*-*-*-*-96-96-p-*-ms-symbol\"."
993 ,@(mapcar (lambda (x) (list 'const x
))
994 woman-symbol-font-list
)
1000 ;; For non windows-nt ...
1001 (defvar woman-use-extended-font nil
)
1002 (defvar woman-use-symbol-font nil
)
1003 (defvar woman-symbol-font nil
)
1004 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1007 ;;; Internal variables:
1009 (defconst woman-justify-list
1010 '(left right center full
)
1011 "Justify styles for `fill-region-as-paragraph'.")
1012 (defconst woman-adjust-left
0 ; == adjust off, noadjust
1013 "Adjustment indicator `l' -- adjust left margin only.")
1014 (defconst woman-adjust-right
1
1015 "Adjustment indicator `r' -- adjust right margin only.")
1016 (defconst woman-adjust-center
2
1017 "Adjustment indicator `c' -- center.")
1018 (defconst woman-adjust-both
3 ; default -- adj,both
1019 "Adjustment indicator `b' or `n' -- adjust both margins.")
1021 (defvar woman-adjust woman-adjust-both
1022 "Current adjustment number-register value.")
1023 (defvar woman-adjust-previous woman-adjust
1024 "Previous adjustment number-register value.")
1025 (defvar woman-justify
1026 (nth woman-adjust woman-justify-list
) ; use vector?
1027 "Current justification style for `fill-region-as-paragraph'.")
1028 (defvar woman-justify-previous woman-justify
1029 "Previous justification style for `fill-region-as-paragraph'.")
1031 (defvar woman-left-margin woman-default-indent
1032 "Current left margin.")
1033 (defvar woman-prevailing-indent woman-default-indent
1034 "Current prevailing indent.")
1035 (defvar woman-interparagraph-distance
1
1036 "Interparagraph distance in lines.
1037 Set by .PD; used by .SH, .SS, .TP, .LP, .PP, .P, .IP, .HP.")
1038 (defvar woman-leave-blank-lines nil
1039 "Blank lines to leave as vertical space.")
1040 (defconst woman-tab-width
5
1041 "Default tab width set by -man macros.")
1042 (defvar woman-nofill nil
1043 "Current fill mode: nil for filling.")
1044 (defvar woman-RS-left-margin nil
1045 "Left margin stack for nested use of `.RS/.RE'.")
1046 (defvar woman-RS-prevailing-indent nil
1047 "Prevailing indent stack for nested use of `.RS/.RE'.")
1048 (defvar woman-nospace nil
1049 "Current no-space mode: nil for normal spacing.
1050 Set by `.ns' request; reset by any output or `.rs' request")
1052 (defsubst woman-reset-nospace
()
1053 "Set `woman-nospace' to nil."
1054 (setq woman-nospace nil
))
1056 (defconst woman-request-regexp
"^[.'][ \t]*\\(\\S +\\) *"
1057 ;; Was "^\\.[ \t]*\\([a-z0-9]+\\) *" but cvs.1 uses a macro named
1058 ;; "`" and CGI.man uses a macro named "''"!
1059 ;; CGI.man uses ' as control character in places -- it *should*
1061 ;; Could end with "\\( +\\|$\\)" instead of " *"
1062 "Regexp to match a ?roff request plus trailing white space.")
1064 (defvar woman-imenu-done nil
1065 "Buffer-local: set to true if function `woman-imenu' has been called.")
1066 (make-variable-buffer-local 'woman-imenu-done
)
1068 ;; From imenu.el -- needed when reformatting a file in its old buffer.
1069 ;; The latest buffer index used to update the menu bar menu.
1072 (make-variable-buffer-local 'imenu--last-menubar-index-alist
)
1074 (defvar woman-buffer-alist nil
1075 "An alist representing WoMan buffers that are already decoded.
1076 Each element is of the form (FILE-NAME . BUFFER-NAME).")
1078 (defvar woman-buffer-number
0
1079 "Ordinal number of current buffer entry in `woman-buffer-alist'.
1080 The ordinal numbers start from 0.")
1082 (defvar woman-if-conditions-true
'(?n ?e ?o
)
1083 "List of one-character built-in condition names that are true.
1084 Should include ?e, ?o (page even/odd) and either ?n (nroff) or ?t (troff).
1085 Default is '(?n ?e ?o). Set via `woman-emulation'.")
1088 ;;; Specialized utility functions:
1090 ;;; Fast deletion without saving on the kill ring (cf. simple.el):
1092 (defun woman-delete-line (&optional arg
)
1093 "Delete rest of current line; if all blank then delete thru newline.
1094 With a numeric argument ARG, delete that many lines from point.
1095 Negative arguments delete lines backward."
1096 ;; This is a non-interactive version of kill-line in simple.el that
1097 ;; deletes instead of killing and assumes kill-whole-line is nil,
1098 ;; which is essential!
1099 (delete-region (point)
1104 (signal 'end-of-buffer nil
))
1105 (if (looking-at "[ \t]*$")
1110 (defsubst woman-delete-whole-line
()
1111 "Delete current line from beginning including eol."
1113 (woman-delete-line 1))
1115 (defsubst woman-delete-following-space
()
1116 "Delete all spaces and tabs FOLLOWING point (cf. `delete-horizontal-space')."
1117 ;; cf. delete-horizontal-space in simple.el:
1118 (delete-region (point) (progn (skip-chars-forward " \t") (point))))
1120 (defsubst woman-delete-match
(subexp)
1121 "Delete subexpression SUBEXP of buffer text matched by last search."
1122 (delete-region (match-beginning subexp
) (match-end subexp
)))
1124 ;; delete-char does not kill by default
1125 ;; delete-backward-char does not kill by default
1126 ;; delete-horizontal-space does not kill
1127 ;; delete-blank-lines does not kill
1132 (defvar woman-expanded-directory-path nil
1133 "Expanded directory list cache. Resetting to nil forces update.")
1135 (defvar woman-topic-all-completions nil
1136 "Expanded topic alist cache. Resetting to nil forces update.")
1139 (defun woman (&optional topic re-cache
)
1140 "Browse UN*X man page for TOPIC (Without using external Man program).
1141 The major browsing mode used is essentially the standard Man mode.
1142 Choose the filename for the man page using completion, based on the
1143 topic selected from the directories specified in `woman-manpath' and
1144 `woman-path'. The directory expansions and topics are cached for
1145 speed, but a non-nil interactive argument forces the caches to be
1146 updated (e.g. to re-interpret the current directory).
1148 Used non-interactively, arguments are optional: if given then TOPIC
1149 should be a topic string and non-nil RE-CACHE forces re-caching."
1150 (interactive (list nil current-prefix-arg
))
1151 ;; The following test is for non-interactive calls via gnudoit etc.
1152 (if (or (not (stringp topic
)) (string-match "\\S " topic
))
1153 (let ((file-name (woman-file-name topic re-cache
)))
1155 (woman-find-file file-name
)
1157 "WoMan Error: No matching manual files found in search path")
1160 (message "WoMan Error: No topic specified in non-interactive call")
1164 ;; Allow WoMan to be called via the standard Help menu:
1165 (define-key-after menu-bar-manuals-menu
[woman]
1166 '(menu-item "Read Man Page (WoMan)..." woman
1167 :help "Man-page documentation Without Man") t)
1169 (defvar woman-cached-data nil
1170 "A list of cached data used to determine cache validity.
1171 Set from the cache by `woman-read-directory-cache'.")
1173 (defun woman-cached-data ()
1174 "Generate a list of data used to determine cache validity.
1175 Called both to generate and to check the cache!"
1176 ;; Must use substituted paths because values of env vars may change!
1177 (list woman-cache-level
1179 (dolist (dir woman-manpath (nreverse lst))
1183 (split-string (getenv "PATH") path-separator t)))
1184 (setq dir (and (member (car dir) path) (cdr dir))))
1185 (when dir (add-to-list 'lst (substitute-in-file-name dir)))))
1186 (mapcar 'substitute-in-file-name woman-path)))
1188 (defun woman-read-directory-cache ()
1189 "Load the directory and topic cache.
1190 It is loaded from the file named by the variable `woman-cache-filename'.
1191 Return t if the file exists, nil otherwise."
1193 woman-cache-filename
1194 (load woman-cache-filename t nil t) ; file exists
1195 (equal woman-cached-data (woman-cached-data)))) ; cache valid
1197 (defun woman-write-directory-cache ()
1198 "Save the directory and topic cache.
1199 It is saved to the file named by the variable `woman-cache-filename'."
1200 (if woman-cache-filename
1201 (with-current-buffer (generate-new-buffer "WoMan tmp buffer")
1202 ;; Make a temporary buffer; name starting with space "hides" it.
1203 (let ((standard-output (current-buffer))
1204 (backup-inhibited t))
1205 ;; (switch-to-buffer standard-output t) ; only for debugging
1206 (buffer-disable-undo standard-output)
1208 ";;; WoMan directory and topic cache -- generated automatically\n")
1210 ;; For data validity check:
1211 `(setq woman-cached-data ',(woman-cached-data)))
1213 `(setq woman-expanded-directory-path
1214 ',woman-expanded-directory-path))
1216 `(setq woman-topic-all-completions
1217 ',woman-topic-all-completions))
1218 (write-file woman-cache-filename) ; write CURRENT buffer
1219 (kill-buffer standard-output)
1222 (defvaralias 'woman-topic-history 'Man-topic-history)
1223 (defvar woman-file-history nil "File-name read history.")
1225 (defun woman-file-name (topic &optional re-cache)
1226 "Get the name of the UN*X man-page file describing a chosen TOPIC.
1227 When `woman' is called interactively, the word at point may be
1228 automatically used as the topic, if the value of the user option
1229 `woman-use-topic-at-point' is non-nil. Return nil if no file can
1230 be found. Optional argument RE-CACHE, if non-nil, forces the
1231 cache to be re-read."
1232 ;; Handle the caching of the directory and topic lists:
1233 (if (and (not re-cache)
1235 (and woman-expanded-directory-path woman-topic-all-completions)
1236 (woman-read-directory-cache)))
1238 (message "Building list of manual directory expansions...")
1239 (setq woman-expanded-directory-path
1240 (woman-expand-directory-path woman-manpath woman-path))
1241 (message "Building completion list of all manual topics...")
1242 (setq woman-topic-all-completions
1243 (woman-topic-all-completions woman-expanded-directory-path))
1244 (woman-write-directory-cache))
1245 ;; There is a problem in that I want to offer case-insensitive
1246 ;; completions, but to return only a case-sensitive match. This
1247 ;; does not seem to work properly by default, so I re-do the
1248 ;; completion if necessary.
1250 (default (current-word)))
1252 (and (if (boundp 'woman-use-topic-at-point)
1253 woman-use-topic-at-point
1254 ;; Was let-bound when file loaded, so ...
1255 (setq woman-use-topic-at-point woman-use-topic-at-point-default))
1256 (setq topic (or (current-word t) "")) ; only within or adjacent to word
1257 (test-completion topic woman-topic-all-completions))
1259 (let* ((word-at-point (current-word))
1261 (when (and word-at-point
1263 word-at-point woman-topic-all-completions))
1267 (format "Manual entry (default %s): " default)
1269 woman-topic-all-completions nil 1
1271 'woman-topic-history
1273 ;; Note that completing-read always returns a string.
1274 (if (= (length topic) 0)
1275 nil ; no topic, so no file!
1277 ((setq files (woman-file-name-all-completions topic)))
1278 ;; Complete topic more carefully, i.e. use the completion
1279 ;; rather than the string entered by the user:
1280 ((setq files (all-completions topic woman-topic-all-completions))
1281 (while (/= (length topic) (length (car files)))
1282 (setq files (cdr files)))
1283 (setq files (woman-file-name-all-completions (car files)))))
1285 ((null files) nil) ; no file found for topic.
1286 ((null (cdr files)) (car (car files))) ; only 1 file for topic.
1288 ;; Multiple files for topic, so must select 1.
1289 ;; Unread the command event (TAB = ?\t = 9) that runs the command
1290 ;; `minibuffer-complete' in order to automatically complete the
1291 ;; minibuffer contents as far as possible.
1292 (setq unread-command-events '(9)) ; and delete any type-ahead!
1293 (completing-read "Manual file: " files nil 1
1294 (try-completion "" files) 'woman-file-history))))))
1296 (defun woman-select (predicate list)
1297 "Select unique elements for which PREDICATE is true in LIST.
1298 \(Note that this function changes the value of LIST.)"
1299 ;; Intended to be fast by avoiding recursion and list copying.
1302 (member (car list) (cdr list))
1303 (not (funcall predicate (car list)))))
1304 (setq list (cdr list)))
1306 (let ((newlist list) cdr_list)
1307 (while (setq cdr_list (cdr list))
1309 (not (member (car cdr_list) (cdr cdr_list)))
1310 (funcall predicate (car cdr_list)))
1311 (setq list cdr_list)
1312 (setcdr list (cdr cdr_list)))
1316 (defun woman-file-readable-p (dir)
1317 "Return t if DIR is readable, otherwise log a warning."
1318 (or (file-readable-p dir)
1319 (WoMan-warn "Ignoring unreadable `manpath' directory tree `%s'!" dir)))
1321 (defun woman-directory-files (head dir)
1322 "Return a sorted list of files in directory HEAD matching regexp in DIR.
1323 Value is a sorted list of the absolute pathnames of all the files in
1324 directory HEAD, or the current directory if HEAD is nil, that match the
1325 regexp that is the final component of DIR. Log a warning if list is empty."
1326 (or (directory-files
1327 (or head (directory-file-name default-directory)) ; was "."
1329 (file-name-nondirectory dir))
1330 (WoMan-warn "No directories match `woman-path' entry `%s'!" dir)))
1332 (defun woman-file-accessible-directory-p (dir)
1333 "Return t if DIR is accessible, otherwise log a warning."
1334 (or (file-accessible-directory-p dir)
1335 (WoMan-warn "Ignoring inaccessible `man-page' directory `%s'!" dir)))
1337 (defun woman-expand-directory-path (woman-manpath woman-path)
1338 "Expand the manual directories in WOMAN-MANPATH and WOMAN-PATH.
1339 WOMAN-MANPATH should be a list of general manual directories, while
1340 WOMAN-PATH should be a list of specific manual directory regexps.
1341 Ignore any paths that are unreadable or not directories."
1342 ;; Allow each path to be a single string or a list of strings:
1343 (if (not (listp woman-manpath)) (setq woman-manpath (list woman-manpath)))
1344 (if (not (listp woman-path)) (setq woman-path (list woman-path)))
1345 (let (head dirs path)
1346 (dolist (dir woman-manpath)
1349 (setq path (split-string (getenv "PATH") path-separator t)))
1350 (setq dir (and (member (car dir) path)
1352 (if (and dir (woman-file-readable-p dir))
1353 ;; NB: `parse-colon-path' creates null elements for
1354 ;; redundant (semi-)colons and trailing `/'s!
1355 ;; If does not actually matter here if dir ends with `/'.
1356 ;; Need regexp "man" here to avoid "cat?", `.', `..', etc.
1357 (setq dir (woman-canonicalize-dir dir)
1358 dirs (nconc dirs (directory-files
1359 dir t woman-manpath-man-regexp)))))
1360 (dolist (dir woman-path)
1362 (null (setq dir (woman-canonicalize-dir dir)
1363 head (file-name-directory dir)))
1364 (woman-file-readable-p head))
1367 (nconc dirs (woman-directory-files head dir))
1368 (cons (directory-file-name default-directory) dirs))
1369 ;; was "." -- at head of list for later filtering
1371 (woman-select 'woman-file-accessible-directory-p dirs)))
1373 (defun woman-canonicalize-dir (dir)
1374 "Canonicalize the directory name DIR.
1375 Any UN*X-style environment variables are evaluated first."
1376 (setq dir (expand-file-name (substitute-in-file-name dir)))
1377 ;; A path that ends with / matches all directories in it,
1378 ;; including `.' and `..', so remove any trailing / !!!
1379 (if (string= (substring dir -1) "/")
1380 (setq dir (substring dir 0 -1)))
1381 (if (memq system-type '(windows-nt ms-dos cygwin)) ; what else?
1382 ;; Match capitalization used by `file-name-directory':
1383 (setq dir (concat (file-name-directory dir)
1384 (file-name-nondirectory dir))))
1387 (defsubst woman-not-member (dir path)
1388 "Return t if DIR is not a member of the list PATH, nil otherwise.
1389 If DIR is `.' it is first replaced by the current directory."
1390 (not (member dir path)))
1392 (defun woman-topic-all-completions (path)
1393 "Return an alist of the man files in all man directories in the list PATH.
1394 The cdr of each alist element is the path-index / filename."
1395 ;; Support 3 levels of caching: each element of the alist `files'
1396 ;; will be a list of the first `woman-cache-level' elements of the
1397 ;; following list: (topic path-index filename). This alist `files'
1398 ;; is re-processed by `woman-topic-all-completions-merge'.
1399 (let (files (path-index 0)) ; indexing starts at zero
1401 (setq dir (pop path))
1402 (if (woman-not-member dir path) ; use each directory only once!
1403 (push (woman-topic-all-completions-1 dir path-index)
1405 (setq path-index (1+ path-index)))
1407 ;; Concate all lists with a single nconc call to
1408 ;; avoid retraversing the first lists repeatedly -- dak
1409 (woman-topic-all-completions-merge
1410 (apply #'nconc files))))
1412 (defun woman-topic-all-completions-1 (dir path-index)
1413 "Return an alist of the man topics in directory DIR with index PATH-INDEX.
1414 A topic is a filename sans type-related extensions.
1415 Support 3 levels of caching: each element of the alist will be a list
1416 of the first `woman-cache-level' elements from the following list:
1417 \(topic path-index filename)."
1418 ;; This function used to check that each file in the directory was
1419 ;; not itself a directory, but this is very slow and should be
1420 ;; unnecessary. So let us assume that `woman-file-regexp' will
1421 ;; filter out any directories, which probably should not be there
1422 ;; anyway, i.e. it is a user error!
1424 ;; Don't sort files: we do that when merging, anyway. -- dak
1425 (let (newlst (lst (directory-files dir nil woman-file-regexp t))
1426 ;; Make an explicit regexp for stripping extension and
1427 ;; compression extension: file-name-sans-extension is a
1428 ;; far too costly function. -- dak
1429 (ext (format "\\(\\.[^.\\/]*\\)?\\(%s\\)?\\'"
1430 woman-file-compression-regexp)))
1431 ;; Use a loop instead of mapcar in order to avoid the speed
1432 ;; penalty of binding function arguments. -- dak
1433 (dolist (file lst newlst)
1436 (if (string-match ext file)
1437 (substring file 0 (match-beginning 0))
1439 (and (> woman-cache-level 1)
1442 (and (> woman-cache-level 2)
1446 (defun woman-topic-all-completions-merge (alist)
1447 "Merge the alist ALIST so that the keys are unique.
1448 Also make each path-info component into a list.
1449 \(Note that this function changes the value of ALIST.)"
1450 ;; Replaces unreadably "optimized" O(n^2) implementation.
1451 ;; Instead we use sorting to merge stuff efficiently. -- dak
1453 ;; Sort list into reverse order
1454 (setq alist (sort alist (lambda(x y) (string< (car y) (car x)))))
1455 ;; merge duplicate keys.
1456 (if (> woman-cache-level 1)
1458 (if (equal (car elt) (caar newalist))
1459 (unless (member (cdr elt) (cdar newalist))
1460 (setcdr (car newalist) (cons (cdr elt)
1462 (setcdr elt (list (cdr elt)))
1463 (push elt newalist)))
1464 ;; woman-cache-level = 1 => elements are single-element lists ...
1466 (unless (equal (car elt) (caar newalist))
1467 (push elt newalist))))
1470 (defun woman-file-name-all-completions (topic)
1471 "Return an alist of the files in all man directories that match TOPIC."
1472 ;; Support 3 levels of caching: each element of
1473 ;; woman-topic-all-completions is a list of one of the forms:
1475 ;; (topic (path-index) (path-index) ... )
1476 ;; (topic (path-index filename) (path-index filename) ... )
1477 ;; where the are no duplicates in the value lists.
1478 ;; Topic must match first `word' of filename, so ...
1481 "\\`" (regexp-quote topic) ; first `word'
1482 "\\(\\..+\\)*" ; optional subsequent `words'
1483 woman-file-regexp)) ; extension
1484 (topics woman-topic-all-completions)
1485 (path woman-expanded-directory-path)
1487 (if (cdr (car topics))
1488 ;; Use cached path-info to locate files for each topic:
1489 (let ((path-info (cdr (assoc topic topics)))
1491 (dolist (elt path-info)
1492 (setq dir (nth (car elt) path)
1493 filename (car (cdr elt))
1495 ;; Find the actual file name:
1497 (list (concat dir "/" filename))
1498 (directory-files dir t topic-regexp)
1500 ;; Search path for the files for each topic:
1502 (setq dir (car path)
1504 (if (woman-not-member dir path) ; use each directory only once!
1505 (setq files (nconc files
1506 (directory-files dir t topic-regexp))))
1508 (mapcar 'list files)
1514 (defun woman-dired-define-key (key)
1515 "Bind the argument KEY to the command `woman-dired-find-file'."
1516 (define-key dired-mode-map key 'woman-dired-find-file))
1518 (defsubst woman-dired-define-key-maybe (key)
1519 "If KEY is undefined in Dired, bind it to command `woman-dired-find-file'."
1520 (if (or (eq (lookup-key dired-mode-map key) 'undefined)
1521 (null (lookup-key dired-mode-map key)))
1522 (woman-dired-define-key key)))
1524 (defun woman-dired-define-keys ()
1525 "Define dired keys to run WoMan according to `woman-dired-keys'."
1526 (if woman-dired-keys
1527 (if (listp woman-dired-keys)
1528 (mapcar 'woman-dired-define-key woman-dired-keys)
1529 (woman-dired-define-key-maybe "w")
1530 (woman-dired-define-key-maybe "W")))
1531 (define-key-after (lookup-key dired-mode-map [menu-bar immediate])
1532 [woman] '("Read Man Page (WoMan)" . woman-dired-find-file
) 'view
))
1534 (if (featurep 'dired
)
1535 (woman-dired-define-keys)
1536 (add-hook 'dired-mode-hook
'woman-dired-define-keys
))
1539 (defun woman-dired-find-file ()
1540 "In dired, run the WoMan man-page browser on this file."
1542 ;; dired-get-filename is defined in dired.el
1543 (woman-find-file (dired-get-filename)))
1546 ;;; tar-mode support
1548 (defun woman-tar-extract-file ()
1549 "In tar mode, run the WoMan man-page browser on this file."
1551 (or (eq major-mode
'tar-mode
)
1552 (error "`woman-tar-extract-file' can be used only in `tar-mode'"))
1553 (buffer-disable-undo)
1554 (let (global-font-lock-mode)
1555 (funcall (symbol-function 'tar-extract
)) ; defined in tar-mode
1556 (let ((WoMan-current-file buffer-file-name
)) ; used for message logging
1558 (woman-make-bufname (file-name-nondirectory buffer-file-name
)))
1559 (woman-process-buffer)
1560 (goto-char (point-min)))))
1562 ;; There is currently no `tar-mode-hook' so use ...
1563 (eval-after-load "tar-mode"
1565 (define-key tar-mode-map
"w" 'woman-tar-extract-file
)
1566 (define-key-after (lookup-key tar-mode-map
[menu-bar immediate
])
1567 [woman] '("Read Man Page (WoMan)" . woman-tar-extract-file) 'view)))
1570 (defvar woman-last-file-name nil
1571 "The full pathname of the last file formatted by WoMan.")
1573 (defun woman-reformat-last-file ()
1574 "Reformat last file, e.g. after changing fill column."
1576 (if woman-last-file-name
1577 (woman-find-file woman-last-file-name t)
1578 (call-interactively 'woman-find-file)))
1581 (defun woman-find-file (file-name &optional reformat)
1582 "Find, decode and browse a specific UN*X man-page source file FILE-NAME.
1583 Use existing buffer if possible; reformat only if prefix arg given.
1584 When called interactively, optional argument REFORMAT forces reformatting
1585 of an existing WoMan buffer formatted earlier.
1586 No external programs are used, except that `gunzip' will be used to
1587 decompress the file if appropriate. See the documentation for the
1588 `woman' command for further details."
1589 (interactive "fBrowse UN*X manual file: \nP")
1590 (setq woman-last-file-name
1591 (setq file-name (expand-file-name file-name))) ; to canonicalize
1592 (let ((alist-tail woman-buffer-alist) exists)
1593 (setq woman-buffer-number 0)
1594 (while (and alist-tail (not (string= file-name (car (car alist-tail)))))
1595 (setq alist-tail (cdr alist-tail)
1596 woman-buffer-number (1+ woman-buffer-number)))
1597 (or (and (setq exists
1598 (and alist-tail (WoMan-find-buffer))) ; buffer exists
1600 ;; Format new buffer or reformat current buffer:
1601 (let* ((bufname (file-name-nondirectory file-name))
1602 (case-fold-search t)
1604 (not (not (string-match woman-file-compression-regexp bufname)))))
1606 (setq bufname (file-name-sans-extension bufname)))
1607 (setq bufname (if exists
1609 (woman-make-bufname bufname)))
1610 (woman-really-find-file file-name compressed bufname)
1612 (setq woman-buffer-alist
1613 (cons (cons file-name bufname) woman-buffer-alist)
1614 woman-buffer-number 0))
1616 (Man-build-section-alist)
1617 (Man-build-references-alist)
1618 (goto-char (point-min)))
1620 (defun woman-make-bufname (bufname)
1621 "Create an unambiguous buffer name from BUFNAME."
1622 (let ((dot (string-match "\\." bufname)))
1623 (if dot (setq bufname (concat
1624 (substring bufname (1+ dot)) " "
1625 (substring bufname 0 dot))))
1626 (generate-new-buffer-name ; ensure uniqueness
1627 (concat "*WoMan " bufname "*"))))
1629 (defvar woman-frame nil
1630 "Dedicated frame used for displaying WoMan windows.")
1632 (defun woman-really-find-file (filename compressed bufname)
1633 "Find, decompress, and decode a UN*X man page FILENAME.
1634 If COMPRESSED is non-nil, turn on auto-compression mode to decompress
1635 the file if necessary. Set buffer name BUFNAME and major mode.
1636 Do not call directly!"
1637 (let ((WoMan-current-file filename)) ; used for message logging
1638 (if woman-use-own-frame
1640 (or (and (frame-live-p woman-frame) woman-frame)
1641 (setq woman-frame (make-frame)))))
1642 (set-buffer (get-buffer-create bufname))
1644 (switch-to-buffer (current-buffer))
1645 (error (pop-to-buffer (current-buffer))))
1646 (buffer-disable-undo)
1647 (setq buffer-read-only nil)
1648 (erase-buffer) ; NEEDED for reformat
1649 (woman-insert-file-contents filename compressed)
1650 ;; Set buffer's default directory to that of the file.
1651 (setq default-directory (file-name-directory filename))
1652 (set (make-local-variable 'backup-inhibited) t)
1653 (set-visited-file-name "")
1654 (woman-process-buffer)))
1656 (defun woman-process-buffer ()
1657 "The second half of `woman-really-find-file'!"
1659 ;; Check (crudely) that this really is likely to be in UN*X
1660 ;; man-page source format, assuming we are at point-min:
1661 (goto-char (point-min))
1662 (if (re-search-forward "^[.']" 1000 t)
1663 (woman-decode-buffer)
1665 "File appears to be pre-formatted -- using source file may be better.")
1669 (defun woman-man-buffer ()
1670 "Post-process an nroff-preformatted man buffer."
1671 ;; Kill all leading whitespace:
1672 (if (looking-at "\\s-+") (woman-delete-match 0))
1673 ;; Delete all page footer/header pairs:
1674 (re-search-forward ".*") ; match header
1675 ;; Footer conventionally has page number at right, so ...
1676 (let ((regex (concat
1677 "^.*[0-9]\n\\s-*" ; footer and following blank lines
1678 (regexp-quote (match-string 0)) ; header
1679 "\\s-*\n"))) ; following blank lines
1680 (while (re-search-forward regex nil 1) ; finish at eob
1681 (woman-delete-match 0)))
1682 ;; Delete last text line (footer) and all following blank lines:
1683 (re-search-backward "\\S-")
1685 (if (looking-at ".*[0-9]$")
1686 (delete-region (point) (point-max)))
1688 ;; Squeeze multiple blank lines:
1689 (goto-char (point-min))
1690 (while (re-search-forward "^[ \t]*\n\\([ \t]*\n\\)+" nil t)
1691 (replace-match "\n" t t))
1693 ;; CJK characters are underlined by double-sized "__".
1694 ;; (Code lifted from man.el, with trivial changes.)
1695 (if (< (buffer-size) (position-bytes (point-max)))
1696 ;; Multibyte characters exist.
1698 (goto-char (point-min))
1699 (while (search-forward "__\b\b" nil t)
1700 (backward-delete-char 4)
1701 (woman-set-face (point) (1+ (point)) 'woman-italic))
1702 (goto-char (point-min))
1703 (while (search-forward "\b\b__" nil t)
1704 (backward-delete-char 4)
1705 (woman-set-face (1- (point)) (point) 'woman-italic))))
1707 ;; Interpret overprinting to indicate bold face:
1708 (goto-char (point-min))
1709 (while (re-search-forward "\\(.\\)\\(\\(\b+\\1\\)+\\)" nil t)
1710 (woman-delete-match 2)
1711 (woman-set-face (1- (point)) (point) 'woman-bold))
1713 ;; Interpret underlining to indicate italic face:
1714 ;; (Must be AFTER emboldening to interpret bold _ correctly!)
1715 (goto-char (point-min))
1716 (while (search-forward "_\b" nil t)
1718 (woman-set-face (point) (1+ (point)) 'woman-italic))
1720 ;; Leave any other uninterpreted ^H's in the buffer for now! (They
1721 ;; might indicate composite special characters, which could be
1722 ;; interpreted if I knew what to expect.)
1724 ;; Optionally embolden section and subsection headings
1725 ;; (cf. `woman-imenu-generic-expression'):
1727 (woman-bold-headings
1728 (goto-char (point-min))
1730 (while (re-search-forward "^\\( \\)?\\([A-Z].*\\)" nil t)
1731 (woman-set-face (match-beginning 2) (match-end 2) 'woman-bold))))
1734 (defun woman-insert-file-contents (filename compressed)
1735 "Insert file FILENAME into the current buffer.
1736 If COMPRESSED is t, or is non-nil and the filename implies compression,
1737 then turn on auto-compression mode to decompress the file.
1738 Leave point at end of new text. Return length of inserted text."
1739 ;; Leaves point at end of inserted text in GNU Emacs 20.3, but at
1742 (let ((case-fold-search t))
1743 ;; Co-operate with auto-compression mode:
1745 (or (eq compressed t)
1746 (string-match woman-file-compression-regexp filename))
1747 ;; (not auto-compression-mode)
1748 (not (rassq 'jka-compr-handler file-name-handler-alist)) )
1749 ;; (error "Compressed file requires Auto File Decompression turned on")
1750 (auto-compression-mode 1))
1753 (insert-file-contents filename nil)
1755 ;; Run find-file-not-found-hooks until one returns non-nil.
1756 ;; (run-hook-with-args-until-success 'find-file-not-found-hooks)
1757 (insert "\n***** File " filename " not found! *****\n\n")
1762 ;;; Major mode (Man) interface:
1764 (defvar woman-mode-map
1765 (let ((map (make-sparse-keymap)))
1766 (set-keymap-parent map Man-mode-map)
1768 (define-key map "R" 'woman-reformat-last-file)
1769 (define-key map "w" 'woman)
1770 (define-key map "\en" 'WoMan-next-manpage)
1771 (define-key map "\ep" 'WoMan-previous-manpage)
1772 (define-key map [M-mouse-2] 'woman-follow-word)
1774 ;; We don't need to call `man' when we are in `woman-mode'.
1775 (define-key map [remap man] 'woman)
1776 (define-key map [remap man-follow] 'woman-follow)
1778 "Keymap for woman mode.")
1780 (defun woman-follow (topic)
1781 "Get a Un*x manual page of the item under point and put it in a buffer."
1782 (interactive (list (Man-default-man-entry)))
1785 (error "No item under point")
1786 (woman (if (string-match Man-reference-regexp topic)
1787 (substring topic 0 (match-end 1))
1790 (defun woman-follow-word (event)
1791 "Run WoMan with word under mouse as topic.
1792 Argument EVENT is the invoking mouse event."
1793 (interactive "e") ; mouse event
1794 (goto-char (posn-point (event-start event)))
1795 (woman (or (current-word t) "")))
1797 ;; WoMan menu bar and pop-up menu:
1799 woman-menu ; (SYMBOL MAPS DOC MENU)
1800 ;; That comment was moved after the symbol `woman-menu' to make
1801 ;; find-function-search-for-symbol work. -- rost
1805 ["WoMan..." woman t] ; [NAME CALLBACK ENABLE]
1807 ["Next Section" Man-next-section t]
1808 ["Previous Section" Man-previous-section t]
1809 ["Goto Section..." Man-goto-section t]
1810 ["Goto See-Also Section" Man-goto-see-also-section t]
1811 ["Follow Reference..." Man-follow-manual-reference t]
1813 ["Previous WoMan Buffer" WoMan-previous-manpage t]
1814 ["Next WoMan Buffer" WoMan-next-manpage t]
1815 ["Bury WoMan Buffer" Man-quit t]
1816 ["Kill WoMan Buffer" Man-kill t]
1818 ;; ["Toggle Fill Frame Width" woman-toggle-fill-frame t]
1819 ["Use Full Frame Width" woman-toggle-fill-frame
1820 :active t :style toggle :selected woman-fill-frame]
1821 ["Reformat Last Man Page" woman-reformat-last-file t]
1822 ["Use Monochrome Main Faces" woman-monochrome-faces t]
1823 ["Use Default Main Faces" woman-default-faces t]
1824 ["Make Contents Menu" (woman-imenu t) (not woman-imenu-done)]
1826 ["Describe (Wo)Man Mode" describe-mode t]
1827 ["Mini Help" woman-mini-help t]
1828 ,@(if (fboundp 'customize-group)
1829 '(["Customize..." (customize-group 'woman) t]))
1830 ["Show Version" (message "WoMan %s" woman-version) t]
1833 ["View Source" (view-file woman-last-file-name) woman-last-file-name]
1834 ["Show Log" (switch-to-buffer-other-window "*WoMan-Log*" t) t]
1835 ["Extended Font" woman-toggle-use-extended-font
1836 :included woman-font-support
1837 :active t :style toggle :selected woman-use-extended-font]
1838 ["Symbol Font" woman-toggle-use-symbol-font
1839 :included woman-font-support
1840 :active t :style toggle :selected woman-use-symbol-font]
1841 ["Font Map" woman-display-extended-fonts
1842 :included woman-font-support
1843 :active woman-use-symbol-font]
1846 ["nroff" (woman-reset-emulation 'nroff)
1847 :active t :style radio :selected (eq woman-emulation 'nroff)]
1848 ["troff" (woman-reset-emulation 'troff)
1849 :active t :style radio :selected (eq woman-emulation 'troff)]
1853 (defun woman-toggle-use-extended-font ()
1854 "Toggle `woman-use-extended-font' and reformat, for menu use."
1856 (setq woman-use-extended-font (not woman-use-extended-font))
1857 (woman-reformat-last-file))
1859 (defun woman-toggle-use-symbol-font ()
1860 "Toggle `woman-use-symbol-font' and reformat, for menu use."
1862 (setq woman-use-symbol-font (not woman-use-symbol-font))
1863 (woman-reformat-last-file))
1865 (defun woman-reset-emulation (value)
1866 "Reset `woman-emulation' to VALUE and reformat, for menu use."
1868 (setq woman-emulation value)
1869 (woman-reformat-last-file))
1871 (put 'woman-mode 'mode-class 'special)
1873 (defun woman-mode ()
1874 "Turn on (most of) Man mode to browse a buffer formatted by WoMan.
1875 WoMan is an ELisp emulation of much of the functionality of the Emacs
1876 `man' command running the standard UN*X man and ?roff programs.
1877 WoMan author: F.J.Wright@Maths.QMW.ac.uk
1878 WoMan version: see `woman-version'.
1879 See `Man-mode' for additional details."
1880 (let ((Man-build-page-list (symbol-function 'Man-build-page-list))
1881 (Man-strip-page-headers (symbol-function 'Man-strip-page-headers))
1882 (Man-unindent (symbol-function 'Man-unindent))
1883 (Man-goto-page (symbol-function 'Man-goto-page)))
1884 ;; Prevent inappropriate operations:
1885 (fset 'Man-build-page-list 'ignore)
1886 (fset 'Man-strip-page-headers 'ignore)
1887 (fset 'Man-unindent 'ignore)
1888 (fset 'Man-goto-page 'ignore)
1890 (delay-mode-hooks (Man-mode))
1891 ;; Restore the status quo:
1892 (fset 'Man-build-page-list Man-build-page-list)
1893 (fset 'Man-strip-page-headers Man-strip-page-headers)
1894 (fset 'Man-unindent Man-unindent)
1895 (fset 'Man-goto-page Man-goto-page)))
1896 (setq major-mode 'woman-mode
1898 ;; Don't show page numbers like Man-mode does. (Online documents do
1900 (kill-local-variable 'mode-line-buffer-identification)
1901 (use-local-map woman-mode-map)
1903 (set (make-local-variable 'imenu-generic-expression)
1904 ;; `make-local-variable' in case imenu not yet loaded!
1905 woman-imenu-generic-expression)
1906 (set (make-local-variable 'imenu-space-replacement) " ")
1908 ;; necessary when reformatting a file in its old buffer:
1909 (setq imenu--last-menubar-index-alist nil)
1910 ;; necessary to avoid re-installing the same imenu:
1911 (setq woman-imenu-done nil)
1912 (if woman-imenu (woman-imenu))
1913 (let ((inhibit-read-only t))
1914 (Man-highlight-references 'WoMan-xref-man-page))
1915 (set-buffer-modified-p nil)
1916 (run-mode-hooks 'woman-mode-hook))
1918 (defun woman-imenu (&optional redraw)
1919 "Add a \"Contents\" menu to the menubar.
1920 Optional argument REDRAW, if non-nil, forces mode line to be updated."
1922 (if woman-imenu-done
1923 ;; This is PRIMARILY to avoid a bug in imenu-add-to-menubar that
1924 ;; causes it to corrupt the menu bar if it is run more than once
1925 ;; in the same buffer.
1927 (setq woman-imenu-done t)
1928 (imenu-add-to-menubar woman-imenu-title)
1929 (if redraw (force-mode-line-update))))
1931 (defun woman-toggle-fill-frame ()
1932 "Toggle formatting to fill (most of) the width of the current frame."
1934 (setq woman-fill-frame (not woman-fill-frame))
1935 (message "Woman fill column set to %s."
1936 (if woman-fill-frame "frame width" woman-fill-column)
1939 (defun woman-mini-help ()
1940 "Display WoMan commands and user options in an `apropos' buffer."
1941 ;; Based on apropos-command in apropos.el
1945 (let ((standard-output (get-buffer-create "*Apropos*")))
1946 (print-help-return-message 'identity))))
1947 (setq apropos-accumulator
1948 (apropos-internal "woman"
1950 (or (commandp symbol)
1951 (user-variable-p symbol)))))
1952 ;; Filter out any inhibited symbols:
1953 (dolist (sym apropos-accumulator)
1954 (if (get sym 'apropos-inhibit)
1955 (setq apropos-accumulator (delq sym apropos-accumulator))))
1956 ;; Find documentation strings:
1957 (let ((p apropos-accumulator)
1960 (setcar p (list ; must have 3 elements:
1961 (setq symbol (car p)) ; 1. name
1962 (if (functionp symbol) ; 2. command doc
1963 (if (setq doc (documentation symbol t))
1964 (substring doc 0 (string-match "\n" doc))
1965 "(not documented)"))
1966 (if (user-variable-p symbol) ; 3. variable doc
1967 (if (setq doc (documentation-property
1968 symbol 'variable-documentation t))
1969 (substring doc 0 (string-match "\n" doc))))))
1971 ;; Output the result:
1972 (and (apropos-print t nil)
1974 (message "%s" message))))
1977 (defun WoMan-getpage-in-background (topic)
1978 "Use TOPIC to start WoMan from `Man-follow-manual-reference'."
1979 ;; topic is a string, generally of the form "section topic"
1980 (let ((s (string-match " " topic)))
1981 (if s (setq topic (substring topic (1+ s))))
1984 (defvar WoMan-Man-start-time nil
1985 "Used to record formatting time used by the `man' command.")
1987 ;; Both advices are disabled because "a file in Emacs should not put
1988 ;; advice on a function in Emacs" (see Info node "(elisp)Advising
1989 ;; Functions"). Counting the formatting time is useful for
1990 ;; developping, but less applicable for daily use. The advice for
1991 ;; `Man-getpage-in-background' can be discarded, because the
1992 ;; key-binding in `woman-mode-map' has been remapped to call `woman'
1993 ;; but `man'. Michael Albinus <michael.albinus@gmx.de>
1995 ;; (defadvice Man-getpage-in-background
1996 ;; (around Man-getpage-in-background-advice (topic) activate)
1997 ;; "Use WoMan unless invoked outside a WoMan buffer or invoked explicitly.
1998 ;; Otherwise use Man and record start of formatting time."
1999 ;; (if (and (eq major-mode 'woman-mode)
2000 ;; (not (eq (caar command-history) 'man)))
2001 ;; (WoMan-getpage-in-background topic)
2002 ;; ;; Initiates man processing
2003 ;; (setq WoMan-Man-start-time (current-time))
2006 ;; (defadvice Man-bgproc-sentinel
2007 ;; (after Man-bgproc-sentinel-advice activate)
2008 ;; ;; Terminates man processing
2009 ;; "Report formatting time."
2010 ;; (let* ((time (current-time))
2011 ;; (time (+ (* (- (car time) (car WoMan-Man-start-time)) 65536)
2012 ;; (- (cadr time) (cadr WoMan-Man-start-time)))))
2013 ;; (message "Man formatting done in %d seconds" time)))
2016 ;;; Buffer handling:
2018 (defun WoMan-previous-manpage ()
2019 "Find the previous WoMan buffer."
2020 ;; Assumes currently in a WoMan buffer!
2022 (WoMan-find-buffer) ; find current existing buffer
2023 (if (null (cdr woman-buffer-alist))
2024 (error "No previous WoMan buffer"))
2025 (if (>= (setq woman-buffer-number (1+ woman-buffer-number))
2026 (length woman-buffer-alist))
2027 (setq woman-buffer-number 0))
2028 (if (WoMan-find-buffer)
2030 (if (< (setq woman-buffer-number (1- woman-buffer-number)) 0)
2031 (setq woman-buffer-number (1- (length woman-buffer-alist))))
2032 (WoMan-previous-manpage)))
2034 (defun WoMan-next-manpage ()
2035 "Find the next WoMan buffer."
2036 ;; Assumes currently in a WoMan buffer!
2038 (WoMan-find-buffer) ; find current existing buffer
2039 (if (null (cdr woman-buffer-alist))
2040 (error "No next WoMan buffer"))
2041 (if (< (setq woman-buffer-number (1- woman-buffer-number)) 0)
2042 (setq woman-buffer-number (1- (length woman-buffer-alist))))
2043 (if (WoMan-find-buffer)
2045 (WoMan-next-manpage)))
2047 (defun WoMan-find-buffer ()
2048 "Switch to buffer corresponding to `woman-buffer-number' and return it.
2049 If such a buffer does not exist then remove its association from the
2050 alist in `woman-buffer-alist' and return nil."
2051 (if (zerop woman-buffer-number)
2052 (let ((buffer (get-buffer (cdr (car woman-buffer-alist)))))
2054 (switch-to-buffer buffer)
2055 ;; Delete alist element:
2056 (setq woman-buffer-alist (cdr woman-buffer-alist))
2058 (let* ((prev-ptr (nthcdr (1- woman-buffer-number) woman-buffer-alist))
2059 (buffer (get-buffer (cdr (car (cdr prev-ptr))))))
2061 (switch-to-buffer buffer)
2062 ;; Delete alist element:
2063 (setcdr prev-ptr (cdr (cdr prev-ptr)))
2064 (if (>= woman-buffer-number (length woman-buffer-alist))
2065 (setq woman-buffer-number 0))
2070 ;;; Syntax and display tables:
2072 (defconst woman-escaped-escape-char ?\x1c
2073 ;; An arbitrary unused control character
2074 "Internal character representation of escaped escape characters.")
2075 (defconst woman-escaped-escape-string
2076 (char-to-string woman-escaped-escape-char)
2077 "Internal string representation of escaped escape characters.")
2079 (defconst woman-unpadded-space-char ?\x1d
2080 ;; An arbitrary unused control character
2081 "Internal character representation of unpadded space characters.")
2082 (defconst woman-unpadded-space-string
2083 (char-to-string woman-unpadded-space-char)
2084 "Internal string representation of unpadded space characters.")
2086 (defvar woman-syntax-table
2087 (let ((st (make-syntax-table)))
2088 ;; The following internal chars must NOT have whitespace syntax:
2089 (modify-syntax-entry woman-unpadded-space-char "." st)
2090 (modify-syntax-entry woman-escaped-escape-char "." st)
2092 "Syntax table to support special characters used internally by WoMan.")
2094 (defun woman-set-buffer-display-table ()
2095 "Set up a display table for a WoMan buffer.
2096 This display table is used for displaying internal special characters, but
2097 does not interfere with any existing display table, e.g. for displaying
2098 European characters."
2099 (setq buffer-display-table
2100 ;; The following test appears to be necessary on some
2101 ;; non-Windows platforms, e.g. Solaris 2.6 when running on a
2102 ;; tty. Thanks to T. V. Raman <raman@Adobe.COM>.
2103 ;; The MS-DOS terminal also sets standard-display-table to
2105 (if standard-display-table ; default is nil !!!
2106 (copy-sequence standard-display-table)
2107 (make-display-table)))
2108 ;; Display the following internal chars correctly:
2109 (aset buffer-display-table woman-unpadded-space-char [?\ ])
2110 (aset buffer-display-table woman-escaped-escape-char [?\\]))
2113 ;;; The main decoding driver:
2115 (defvar font-lock-mode) ; for the compiler
2117 (defun woman-decode-buffer ()
2118 "Decode a buffer in UN*X man-page source format.
2119 No external programs are used."
2120 (interactive) ; mainly for testing
2122 (run-hooks 'woman-pre-format-hook)
2123 (and (boundp 'font-lock-mode) font-lock-mode (font-lock-mode -1))
2124 ;; (fundamental-mode)
2125 (let ((start-time (current-time)) ; (HIGH LOW MICROSEC)
2126 time) ; HIGH * 2**16 + LOW seconds
2127 (message "WoMan formatting buffer...")
2128 ; (goto-char (point-min))
2130 ; ((re-search-forward "^\\.[ \t]*TH" nil t) ; wrong format if not found?
2131 ; (beginning-of-line)
2132 ; (delete-region (point-min) (point))) ; potentially dangerous!
2133 ; (t (message "WARNING: .TH request not found -- not man-page format?")))
2134 (woman-decode-region (point-min) (point-max))
2135 (setq time (current-time)
2136 time (+ (* (- (car time) (car start-time)) 65536)
2137 (- (cadr time) (cadr start-time))))
2138 (message "WoMan formatting buffer...done in %d seconds" time)
2139 (WoMan-log-end time))
2140 (run-hooks 'woman-post-format-hook))
2142 (defvar woman-string-alist ; rebound in woman-decode-region
2143 '(("S" . "") ("R" . "(Reg.)") ("Tm" . "(TM)")
2144 ("lq" . "\"") ("rq" . "\"")
2145 ("''" . "\"") ; needed for gcc.1
2146 (".T" . "") ; output device from -T option?
2148 "Alist of strings predefined in the -man macro package `tmac.an'.")
2150 (defvar woman-negative-vertical-space nil ; rebound in woman-decode-region
2151 "Set to t if .sp N with N < 0 encountered.")
2153 (defun woman-pre-process-region (from to)
2154 "Pre-process escapes and comments in the region of text between FROM and TO.
2155 To be called on original buffer and any .so insertions."
2156 ;; Hide escaped escapes \\ and printable escapes \e very early
2157 ;; (to be re-instated as just \ very late!):
2159 ;; .eo turns off escape character processing
2160 (while (re-search-forward "\\(\\\\[\\e]\\)\\|^\\.eo" to t) ; \\
2161 (if (match-string 1)
2162 (replace-match woman-escaped-escape-string t t)
2163 (woman-delete-whole-line)
2164 ;; .ec turns on escape character processing (and sets the
2165 ;; escape character to its argument, if any, which I'm ignoring
2167 (while (and (re-search-forward "\\(\\\\\\)\\|^\\.ec" to t) ; \
2169 (replace-match woman-escaped-escape-string t t))
2170 ;; ***** Need test for .ec arg and warning here! *****
2171 (woman-delete-whole-line)))
2173 ;; Delete comments .\"<anything>, \"<anything> and null requests.
2174 ;; (However, should null . requests cause a break?)
2176 (while (re-search-forward "^[.'][ \t]*\\(\\\\\".*\\)?\n\\|\\\\\".*" to t)
2177 (woman-delete-match 0)))
2179 (defun woman-non-underline-faces ()
2180 "Prepare non-underlined versions of underlined faces."
2181 (let ((face-list (face-list)))
2182 (dolist (face face-list)
2183 (let ((face-name (symbol-name face)))
2184 (if (and (string-match "\\`woman-" face-name)
2185 (face-underline-p face))
2186 (let ((face-no-ul (intern (concat face-name "-no-ul"))))
2187 (copy-face face face-no-ul)
2188 (set-face-underline-p face-no-ul nil)))))))
2193 ;; This information is based on documentation for the man command by
2194 ;; Graeme W. Wilford <G.Wilford@ee.surrey.ac.uk>
2196 ;; First, the environment variable $MANROFFSEQ is interrogated, and if
2197 ;; not set then the initial line of the nroff file is parsed for a
2198 ;; preprocessor string. To contain a valid preprocessor string, the
2199 ;; first line must resemble
2203 ;; where string can be any combination of the following letters that
2204 ;; specify the sequence of preprocessors to run before nroff or
2205 ;; troff/groff. Not all installations will have a full set of
2206 ;; preprocessors. Some of the preprocessors and the letters used to
2207 ;; designate them are: eqn (e), grap (g), pic (p), tbl (t), vgrind
2208 ;; (v), refer (r). This option overrides the $MANROFFSEQ environment
2209 ;; variable. zsoelim is always run as the very first preprocessor.
2211 (defvar woman-emulate-tbl nil
2212 "True if WoMan should emulate the tbl preprocessor.
2213 This applies to text between .TE and .TS directives.
2214 Currently set only from '\" t in the first line of the source file.")
2216 (defun woman-decode-region (from to)
2217 "Decode the region between FROM and TO in UN*X man-page source format."
2218 ;; Suitable for use in format-alist.
2219 ;; But this requires care to control major mode implied font locking.
2220 ;; Must return the new end of file. See format.el for details.
2221 ;; NB: The `to' argument is bogus: it is not currently used, and if
2222 ;; it were it would need to be a marker rather than a position!
2223 ;; First force the correct environment:
2224 (let ((case-fold-search nil) ; This is necessary!
2225 (woman-string-alist woman-string-alist)
2226 (woman-fill-column woman-fill-column)
2227 woman-negative-vertical-space)
2228 (setq woman-left-margin woman-default-indent
2229 woman-prevailing-indent woman-default-indent
2230 woman-interparagraph-distance 1
2231 woman-leave-blank-lines nil
2232 woman-RS-left-margin nil
2233 woman-RS-prevailing-indent nil
2234 woman-adjust woman-adjust-both
2235 woman-justify (nth woman-adjust woman-justify-list)
2238 (setq woman-if-conditions-true
2239 (cons (string-to-char (symbol-name woman-emulation)) '(?e ?o)))
2241 ;; Prepare non-underlined versions of underlined faces:
2242 (woman-non-underline-faces)
2243 ;; Set font of `woman-symbol' face to `woman-symbol-font' if
2244 ;; `woman-symbol-font' is well defined.
2245 (and woman-use-symbol-font
2246 (stringp woman-symbol-font)
2247 (set-face-font 'woman-symbol woman-symbol-font
2248 (and (frame-live-p woman-frame) woman-frame)))
2250 ;; Set syntax and display tables:
2251 (set-syntax-table woman-syntax-table)
2252 (woman-set-buffer-display-table)
2254 ;; Based loosely on a suggestion by Theodore Jump:
2255 (if (or woman-fill-frame
2256 (not (and (integerp woman-fill-column) (> woman-fill-column 0))))
2257 (setq woman-fill-column (- (window-width) woman-default-indent)))
2259 ;; Check for preprocessor requests:
2261 (if (looking-at "'\\\\\"[ \t]*\\([a-z]+\\)")
2262 (let ((letters (append (match-string 1) nil)))
2263 (if (memq ?t letters)
2264 (setq woman-emulate-tbl t
2265 letters (delete ?t letters)))
2267 (WoMan-warn "Unhandled preprocessor request letters %s"
2269 (woman-delete-line 1)))
2271 (woman-pre-process-region from nil)
2272 ;; Process ignore requests, macro definitions,
2273 ;; conditionals and switch source requests:
2274 (woman0-roff-buffer from)
2276 ;; Check for macro sets that woman cannot handle. We can only
2277 ;; because do this after processing source-switch directives.
2278 (goto-char (point-min))
2279 (let ((case-fold-search nil))
2280 (unless (and (re-search-forward "^\\.SH[ \n]" (point-max) t)
2281 (progn (goto-char (point-min))
2282 (re-search-forward "^\\.TH[ \n]" (point-max) t))
2283 (progn (goto-char (point-min))
2284 (not (re-search-forward "^\\.\\([pnil]p\\|sh\\)[ \n]"
2286 (error "WoMan can only format man pages written with the usual `-man' macros")))
2288 ;; Process \k escapes BEFORE changing tab width (?):
2290 (woman-mark-horizonal-position)
2292 ;; Set buffer-local variables:
2293 (setq fill-column woman-fill-column
2294 tab-width woman-tab-width)
2296 ;; Hide unpaddable and digit-width spaces \(space) and \0:
2298 (while (re-search-forward "\\\\[ 0]" nil t)
2299 (replace-match woman-unpadded-space-string t t))
2301 ;; Discard optional hyphen \%; concealed newlines \<newline>;
2302 ;; point-size change function \sN,\s+N, \s-N:
2304 (while (re-search-forward "\\\\\\([%\n]\\|s[-+]?[0-9]+\\)" nil t)
2305 (woman-delete-match 0))
2307 ;; BEWARE: THIS SHOULD PROBABLY ALL BE DONE MUCH LATER!!!!!
2308 ;; Process trivial escapes \-, \`, \.
2309 ;; (\' must be done after tab processing!):
2311 (while (re-search-forward "\\\\\\([-`.]\\)" nil t)
2312 (replace-match "\\1"))
2313 ;; NB: Must keep ALL zero-width characters \&, \|, and \^ until
2314 ;; ALL requests processed!
2316 ;; Process no-break requests and macros (including font-change macros):
2318 (woman1-roff-buffer)
2320 ;; Process strings and special character escapes \(xx:
2321 ;; (Must do this BEFORE fontifying!)
2324 ;; Special chars moved after translation in
2325 ;; `woman2-process-escapes' (for pic.1):
2327 ; (woman-special-characters)
2329 ;; Process standard font-change requests and escapes:
2331 (woman-change-fonts)
2333 ;; 1/2 em vertical motion \d, \u and general local vertical motion
2334 ;; \v'+/-N' simulated using TeX ^ and _ symbols for now.
2336 (let ((first t)) ; assume no nesting!
2337 (while (re-search-forward "\\\\\\([du]\\|v'[^']*'\\)" nil t)
2338 (let* ((esc (match-string 1))
2339 (repl (if (or (= (aref esc 0) ?u)
2340 (and (>= (length esc) 2) (= (aref esc 2) ?-)))
2343 (replace-match repl nil t)
2344 (put-text-property (1- (point)) (point) 'face 'woman-addition)
2346 "Initial vertical motion escape \\%s simulated" esc)
2348 " by TeX `%s' in woman-addition-face!" repl))
2350 (woman-delete-match 0)
2352 "Terminal vertical motion escape \\%s ignored!" esc)))
2353 (setq first (not first))
2356 ; ;; \h'+/-N' local horizontal motion.
2357 ; ;; N may include width escape \w'...'
2358 ; ;; Implement arbitrary forward motion and non-overlapping backward
2361 ; (while (re-search-forward
2362 ; ;; Delimiter can be a special char escape sequence \(.. or
2363 ; ;; a single normal char (usually '):
2364 ; "\\\\h\\(\\\\(..\\|.\\)\\(|\\)?"
2366 ; (let ((from (match-beginning 0))
2367 ; (delim (regexp-quote (match-string 1)))
2368 ; (absolute (match-string 2)) ; absolute position?
2369 ; (N (woman-parse-numeric-arg)) ; distance
2371 ; msg) ; for warning
2372 ; (if (not (looking-at delim))
2373 ; ;; Warn but leave escape in buffer unprocessed:
2375 ; "Local horizontal motion (%s) delimiter error!"
2376 ; (buffer-substring from (1+ (point)))) ; point at end of arg
2377 ; (setq to (match-end 0)
2378 ; ;; For possible warning -- save before deleting:
2379 ; msg (buffer-substring from to))
2380 ; (delete-region from to)
2381 ; (if absolute ; make relative
2382 ; (setq N (- N (current-column))))
2384 ; ;; Move forward by inserting hard spaces:
2385 ; (insert-char woman-unpadded-space-char N)
2386 ; ;; Move backwards by deleting space,
2387 ; ;; first backwards then forwards:
2389 ; (<= (setq N (1+ N)) 0)
2390 ; (cond ((memq (preceding-char) '(?\ ?\t))
2391 ; (delete-backward-char 1) t)
2392 ; ((memq (following-char) '(?\ ?\t))
2393 ; (delete-char 1) t)
2397 ; "Negative horizontal motion (%s) would overwrite!" msg))))
2400 ;; Process formatting macros
2402 (woman2-roff-buffer)
2404 ;; Go back and process negative vertical space if necessary:
2405 (if woman-negative-vertical-space
2406 (woman-negative-vertical-space from))
2408 (if woman-preserve-ascii
2409 ;; Re-instate escaped escapes to just `\' and unpaddable
2410 ;; spaces to just `space', without inheriting any text
2411 ;; properties. This is not necessary, UNLESS the buffer is to
2412 ;; be saved as ASCII.
2415 (while (search-forward woman-escaped-escape-string nil t)
2416 (delete-char -1) (insert ?\\))
2418 (while (search-forward woman-unpadded-space-string nil t)
2419 (delete-char -1) (insert ?\ ))
2422 ;; Must return the new end of file if used in format-alist.
2425 (defun woman-horizontal-escapes (to)
2426 "Process \\h'+/-N' local horizontal motion escapes upto TO.
2427 Implements arbitrary forward and non-overlapping backward motion.
2428 Preserves location of `point'."
2429 ;; Moved from `woman-decode-region' for version 0.50.
2430 ;; N may include width escape \w'...' (but may already be processed!
2431 (let ((from (point)))
2432 (while (re-search-forward
2433 ;; Delimiter can be a special char escape sequence \(.. or
2434 ;; a single normal char (usually '):
2435 "\\\\h\\(\\\\(..\\|.\\)\\(|\\)?"
2437 (let ((from (match-beginning 0))
2438 (delim (regexp-quote (match-string 1)))
2439 (absolute (match-string 2)) ; absolute position?
2440 (N (woman-parse-numeric-arg)) ; distance
2443 (if (not (looking-at delim))
2444 ;; Warn but leave escape in buffer unprocessed:
2446 "Local horizontal motion (%s) delimiter error!"
2447 (buffer-substring from (1+ (point)))) ; point at end of arg
2448 (setq to (match-end 0)
2449 ;; For possible warning -- save before deleting:
2450 msg (buffer-substring from to))
2451 (delete-region from to)
2452 (if absolute ; make relative
2453 (setq N (- N (current-column))))
2455 ;; Move forward by inserting hard spaces:
2456 (insert-char woman-unpadded-space-char N)
2457 ;; Move backwards by deleting space,
2458 ;; first backwards then forwards:
2460 (<= (setq N (1+ N)) 0)
2461 (cond ((memq (preceding-char) '(?\ ?\t))
2462 (delete-backward-char 1) t)
2463 ((memq (following-char) '(?\ ?\t))
2468 "Negative horizontal motion (%s) would overwrite!" msg))))
2474 ;; Process ignore requests (.ig), conditionals (.if etc.),
2475 ;; source-switch (.so), macro definitions (.de etc.) and macro
2478 (defvar woman0-if-to) ; marker bound in woman0-roff-buffer
2479 (defvar woman0-macro-alist) ; bound in woman0-roff-buffer
2480 (defvar woman0-search-regex) ; bound in woman0-roff-buffer
2481 (defvar woman0-search-regex-start ; bound in woman0-roff-buffer
2482 "^[.'][ \t]*\\(ig\\|if\\|ie\\|el\\|so\\|rn\\|de\\|am")
2483 (defconst woman0-search-regex-end "\\)\\([ \t]+\\|$\\)")
2484 ;; May need other terminal characters, e.g. \, but NOT \n!
2485 ;; Alternatively, force maximal match (Posix?)
2487 (defvar woman0-rename-alist) ; bound in woman0-roff-buffer
2489 (defun woman0-roff-buffer (from)
2490 "Process conditional-type requests and user-defined macros.
2491 Start at FROM and re-scan new text as appropriate."
2493 (let ((woman0-if-to (make-marker))
2494 request woman0-macro-alist
2495 (woman0-search-regex-start woman0-search-regex-start)
2496 (woman0-search-regex
2497 (concat woman0-search-regex-start woman0-search-regex-end))
2498 woman0-rename-alist)
2499 (set-marker-insertion-type woman0-if-to t)
2500 (while (re-search-forward woman0-search-regex nil t)
2501 (setq request (match-string 1))
2502 (cond ((string= request "ig") (woman0-ig))
2503 ((string= request "if") (woman0-if "if"))
2504 ((string= request "ie") (woman0-if "ie"))
2505 ((string= request "el") (woman0-el))
2506 ((string= request "so") (woman0-so))
2507 ((string= request "rn") (woman0-rn))
2508 ((string= request "de") (woman0-de))
2509 ((string= request "am") (woman0-de 'append))
2510 (t (woman0-macro request))))
2511 (set-marker woman0-if-to nil)
2513 ;; Should now re-run `woman0-roff-buffer' if any renaming was
2514 ;; done, but let's just hope this is not necessary for now!
2518 ".ig yy -- Discard input up to `.yy', which defaults to `..')."
2519 ;; The terminal request MUST begin with . (not ')!
2520 (looking-at "\\(\\S +\\)?")
2522 (let ((yy (or (match-string 1) "."))
2524 (if (re-search-forward
2525 (concat "^\\.[ \t]*" (regexp-quote yy) ".*\n") nil t)
2526 (delete-region from (point))
2528 "ig request ignored -- terminator `.%s' not found!" yy)
2529 (woman-delete-line 1))
2532 (defsubst woman0-process-escapes (from to)
2533 "Process escapes within an if/ie condition between FROM and TO."
2535 (goto-char from) ; necessary!
2536 ;; Strip font-change escapes:
2537 (while (re-search-forward "\\\\f\\(\\[[^]]+\\]\\|(..\\|.\\)" to t)
2538 (woman-delete-match 0))
2539 (goto-char from) ; necessary!
2540 (woman2-process-escapes to 'numeric))
2542 (defun woman0-if (request)
2543 ".if/ie c anything -- Discard unless c evaluates to true.
2544 Remember condition for use by a subsequent `.el'.
2545 REQUEST is the invoking directive without the leading dot."
2546 ;; c evaluates to a one-character built-in condition name or
2547 ;; 'string1'string2' or a number > 0, prefix ! negates.
2548 ;; \{ ... \} for multi-line use.
2549 ;; Leaves point at start of new text.
2550 (woman-delete-match 0)
2551 ;; (delete-horizontal-space)
2552 ;; Process escapes in condition:
2553 (let ((from (point)) negated n (c 0))
2554 (set-marker woman0-if-to
2555 (save-excursion (skip-syntax-forward "^ ") (point)))
2556 ;; Process condition:
2557 (if (setq negated (= (following-char) ?!)) (delete-char 1))
2559 ;; ((looking-at "[no]") (setq c t)) ; accept n(roff) and o(dd page)
2560 ;; ((looking-at "[te]") (setq c nil)) ; reject t(roff) and e(ven page)
2561 ((looking-at "[ntoe]")
2562 (setq c (memq (following-char) woman-if-conditions-true)))
2563 ;; Unrecognised letter so reject:
2564 ((looking-at "[A-Za-z]") (setq c nil)
2565 (WoMan-warn "%s %s -- unrecognized condition name rejected!"
2566 request (match-string 0)))
2567 ;; Accept strings if identical:
2569 (narrow-to-region from woman0-if-to)
2570 ;; String delimiter can be any non-numeric character,
2571 ;; including a special character escape:
2572 (looking-at "\\(\\\\(..\\|[^0-9]\\)\\(.*\\)\\1\\(.*\\)\\1\\'"))
2573 (let ((end1 (copy-marker (match-end 2) t))) ; End of first string.
2574 ;; Delete 2nd and 3rd delimiters to avoid processing them:
2575 (delete-region (match-end 3) woman0-if-to)
2576 (delete-region (match-end 2) (match-beginning 3))
2577 (goto-char (match-end 1))
2578 (woman0-process-escapes (point) woman0-if-to)
2579 (setq c (string= (buffer-substring (point) end1)
2580 (buffer-substring end1 woman0-if-to)))
2581 (set-marker end1 nil)
2583 ;; Accept numeric value if > 0:
2584 ((numberp (setq n (progn
2585 (woman0-process-escapes from woman0-if-to)
2586 (woman-parse-numeric-arg))))
2591 (woman-if-ignore woman0-if-to request) ; ERROR!
2592 (woman-if-body request woman0-if-to (eq c negated)))
2595 (defun woman-if-body (request to delete) ; should be reversed as `accept'?
2596 "Process if-body, including \\{ ... \\}.
2597 REQUEST is the invoking directive without the leading dot.
2598 If TO is non-nil then delete the if-body.
2599 If DELETE is non-nil then delete from point."
2600 ;; Assume concealed newlines already processed.
2601 (let ((from (point)))
2602 (if to (delete-region (point) to))
2603 (delete-horizontal-space)
2604 (cond (;;(looking-at "[^{\n]*\\\\{\\s *") ; multi-line
2605 ;; allow escaped newlines:
2606 (looking-at "[^{\n]*\\(\\\\\n\\)*\\\\{\\s *\\(\\\\\n\\)*") ; multi-line
2607 ;; including preceding .if(s) and following newline
2608 (let ((from (point)))
2609 (woman-delete-match 0)
2610 ;; Allow for nested \{ ... \} -- BUT BEWARE that this
2611 ;; algorithm only supports one level of nesting!
2613 (and (re-search-forward
2614 ;; "\\(\\\\{\\)\\|\\(\n[.']\\)?[ \t]*\\\\}[ \t]*"
2615 ;; Interpret bogus `el \}' as `el \{',
2616 ;; especially for Tcl/Tk man pages:
2617 "\\(\\\\{\\|el[ \t]*\\\\}\\)\\|\\(\n[.']\\)?[ \t]*\\\\}[ \t]*")
2619 (re-search-forward "\\\\}"))
2620 (delete-region (if delete from (match-beginning 0)) (point))
2621 (if (looking-at "^$") (delete-char 1))
2623 (delete (woman-delete-line 1)) ; single-line
2625 ;; Process matching .el anything:
2626 (cond ((string= request "ie")
2627 ;; Discard unless previous .ie c `evaluated to false'.
2628 (cond ((re-search-forward "^[.'][ \t]*el[ \t]*" nil t)
2629 (woman-delete-match 0)
2630 (woman-if-body "el" nil (not delete)))))
2631 ;; Got here after processing a single-line `.ie' as a body
2632 ;; clause to be discarded:
2633 ((string= request "el")
2634 (cond ((re-search-forward "^[.'][ \t]*el[ \t]*" nil t)
2635 (woman-delete-match 0)
2636 (woman-if-body "el" nil t))))
2642 "Isolated .el request -- should not happen!"
2643 (WoMan-warn "el request without matching `ie' rejected!")
2645 (woman-delete-match 0)
2646 (delete-horizontal-space)
2647 (woman-if-body "el" nil t))
2648 (t ; Ignore -- leave in buffer
2649 ;; This does not work too well, but it's only for debugging!
2650 (skip-chars-forward "^ \t")
2651 (if (looking-at "[ \t]*\\{") (search-forward "\\}"))
2654 (defun woman-if-ignore (to request)
2655 "Ignore but warn about an if request ending at TO, named REQUEST."
2656 (WoMan-warn-ignored request "ignored -- condition not handled!")
2658 (woman-if-body request to t)
2659 ;; Ignore -- leave in buffer
2660 ;; This does not work too well, but it's only for debugging!
2661 (skip-chars-forward "^ \t")
2662 (if (looking-at "[ \t]*\\{") (search-forward "\\}"))
2666 ".so filename -- Switch source file. `.so' requests may be nested."
2667 ;; Leaves point at start of new text.
2668 ;; (skip-chars-forward " \t")
2669 (let* ((beg (point))
2670 (end (progn (woman-forward-arg 'unquote) (point)))
2671 (name (buffer-substring beg end))
2673 ;; If the specified file does not exist in this ...
2674 (or (file-exists-p filename)
2675 ;; or the parent directory ...
2677 (setq filename (concat "../" name)))
2678 ;; then use the WoMan search mechanism to find the filename ...
2681 (file-name-sans-extension
2682 (file-name-nondirectory name))))
2683 ;; Cannot find the file, so ...
2684 (kill-buffer (current-buffer))
2685 (error "File `%s' not found" name))
2687 (woman-delete-line 1)
2688 (let* ((from (point))
2689 (length (woman-insert-file-contents filename 0))
2690 (to (copy-marker (+ from length) t)))
2691 (woman-pre-process-region from to)
2697 ;;; Process macro definitions:
2700 "Process .rn xx yy -- rename macro xx to yy."
2701 ;; For now, done backwards AFTER all macro expansion.
2702 ;; Should also allow requests and strings to be renamed!
2703 (if (eolp) ; ignore if no argument
2705 (let* ((beg (point))
2706 (end (progn (woman-forward-arg 'unquote 'concat) (point)))
2707 (old (buffer-substring beg end))
2709 (if (eolp) ; ignore if no argument
2712 end (progn (woman-forward-arg 'unquote) (point))
2713 new (buffer-substring beg end)
2714 woman0-rename-alist (cons (cons new old) woman0-rename-alist)))
2716 (woman-delete-whole-line))
2718 (defun woman0-rename ()
2719 "Effect renaming required by .rn requests."
2720 ;; For now, do this backwards AFTER all macro expansion.
2721 (dolist ((new woman0-rename-alist))
2722 (let ((old (cdr new))
2724 (goto-char (point-min))
2725 (setq new (concat "^[.'][ \t]*" (regexp-quote new)))
2726 (setq old (concat "." old))
2727 (while (re-search-forward new nil t)
2728 (replace-match old nil t)))))
2730 (defconst woman-unescape-regex
2731 (concat woman-escaped-escape-string
2732 "\\(" woman-escaped-escape-string "\\)?"))
2734 (defsubst woman-unescape (macro)
2735 "Replace escape sequences in the body of MACRO.
2736 Replaces || by |, but | by \, where | denotes the internal escape."
2738 (while (setq start (string-match woman-unescape-regex macro start))
2740 (if (match-string 1 macro)
2741 (replace-match "" t t macro 1)
2742 (replace-match "\\" t t macro))
2746 (defun woman0-de (&optional append)
2747 "Process .de/am xx yy -- (re)define/append macro xx; end at `..'.
2748 \(Should be up to call of yy, which defaults to `.')
2749 Optional argument APPEND, if non-nil, means append macro."
2750 ;; Modelled on woman-strings. BEWARE: Processing of .am is a hack!
2751 ;; Add support for .rm?
2752 ;; (skip-chars-forward " \t")
2753 (if (eolp) ; ignore if no argument
2755 (looking-at "[^ \t\n]+") ; macro name
2756 (let* ((macro (match-string 0)) from
2757 (previous (assoc macro woman0-macro-alist)))
2759 (setq woman0-search-regex-start
2760 (concat woman0-search-regex-start "\\|" (regexp-quote macro))
2762 (concat woman0-search-regex-start woman0-search-regex-end)
2764 ;; Macro body runs from start of next line to line
2765 ;; beginning with `..'."
2766 ;; The terminal request MUST begin with `.' (not ')!
2769 (re-search-forward "^\\.[ \t]*\\.")
2771 (let ((body (woman-unescape (buffer-substring from (point)))))
2772 (if (and append previous)
2773 (setq previous (cdr previous)
2774 body (concat body (cdr previous))
2775 append (car previous)
2777 (setq macro (cons macro (cons append body))))
2778 ;; This should be an update, but consing a new string
2779 ;; onto the front of the alist has the same effect:
2780 (setq woman0-macro-alist (cons macro woman0-macro-alist))
2782 (delete-region from (point))
2783 (backward-char) ; return to end of .de/am line
2785 (beginning-of-line) ; delete .de/am line
2786 (woman-delete-line 1))
2788 (defun woman0-macro (request)
2789 "Process the macro call named REQUEST."
2790 ;; Leaves point at start of new text.
2791 (let ((macro (assoc request woman0-macro-alist)))
2793 (woman-interpolate-macro (cdr macro))
2794 ;; SHOULD DELETE THE UNINTERPRETED REQUEST!!!!!
2795 ;; Output this message once only per call (cf. strings)?
2796 (WoMan-warn "Undefined macro %s not interpolated!" request))))
2798 (defun woman-interpolate-macro (macro)
2799 "Interpolate (.de) or append (.am) expansion of MACRO into the buffer."
2800 ;; Could make this more efficient by checking which arguments are
2801 ;; actually used in the expansion!
2802 (skip-chars-forward " \t")
2803 ;; Process arguments:
2804 (let ((argno 0) (append (car macro))
2805 argno-string formal-arg from actual-arg start)
2806 (setq macro (cdr macro))
2808 ;; Get next actual arg:
2809 (setq argno (1+ argno))
2810 (setq argno-string (format "%d" argno))
2811 (setq formal-arg (concat "\\\\\\$" argno-string)) ; regexp
2813 (woman-forward-arg 'unquote 'noskip)
2814 (setq actual-arg (buffer-substring from (point)))
2815 (skip-chars-forward " \t") ; now skip following whitespace!
2816 ;; Replace formal arg with actual arg:
2818 (while (setq start (string-match formal-arg macro start))
2819 (setq macro (replace-match actual-arg t t macro)))
2821 ;; Delete any remaining formal arguments:
2824 (setq start (string-match "\\\\\\$." macro start))
2825 (setq macro (replace-match "" t t macro)))
2826 ;; Replace .$ number register with actual arg:
2827 ;; (Do this properly via register mechanism later!)
2830 (setq start (string-match "\\\\n(\\.\\$" macro start)) ; regexp
2831 (setq macro (replace-match argno-string t t macro)))
2835 (woman-delete-line 1))
2836 (save-excursion ; leave point at start of new text
2840 ;;; Process strings:
2842 (defun woman-match-name ()
2843 "Match and move over name of form: x, (xx or [xxx...].
2844 Applies to number registers, fonts, strings/macros/diversions, and
2845 special characters."
2846 (cond ((= (following-char) ?\[ )
2848 (re-search-forward "[^]]+")
2849 (forward-char)) ; skip closing ]
2850 ((= (following-char) ?\( )
2852 (re-search-forward ".."))
2853 (t (re-search-forward "."))))
2855 (defun woman-strings (&optional to)
2856 "Process ?roff string requests and escape sequences up to buffer position TO.
2857 Strings are defined/updated by `.ds xx string' requests and
2858 interpolated by `\*x' and `\*(xx' escapes."
2859 ;; Add support for .as and .rm?
2861 ;; Find .ds requests and \* escapes:
2862 (re-search-forward "\\(^[.'][ \t]*ds\\)\\|\\\\\\*" to t)
2863 (cond ((match-string 1) ; .ds
2864 (skip-chars-forward " \t")
2865 (if (eolp) ; ignore if no argument
2867 (re-search-forward "[^ \t\n]+")
2868 (let ((string (match-string 0)))
2869 (skip-chars-forward " \t")
2872 ; ;; hack (?) for CGI.man!
2873 ; (cond ((looking-at "\"\"") "\"")
2874 ; ((looking-at ".*") (match-string 0)))
2876 ;; Above hack causes trouble in arguments!
2878 (setq string (cons string (match-string 0)))
2879 ;; This should be an update, but consing a new string
2880 ;; onto the front of the alist has the same effect:
2881 (setq woman-string-alist (cons string woman-string-alist))
2884 (woman-delete-line 1))
2886 (let ((beg (match-beginning 0)))
2888 (let* ((stringname (match-string 0))
2889 (string (assoc stringname woman-string-alist)))
2891 (delete-region beg (point))
2892 ;; Temporary hack in case string starts with a
2893 ;; control character:
2894 (if (bolp) (insert-before-markers "\\&"))
2895 (insert-before-markers (cdr string)))
2897 (WoMan-warn "Undefined string %s not interpolated!"
2900 ;; Output above message once only per call
2901 (delete-region beg (point))
2902 (setq woman-string-alist
2903 (cons (cons stringname "")
2904 woman-string-alist))))
2911 ;;; Process special character escapes \(xx:
2913 (defconst woman-special-characters
2914 ;; To be built heuristically as required!
2915 ;; MUST insert all characters as strings for correct conversion to
2916 ;; multibyte representation!
2917 '(("em" "--" "\276" . t) ; 3/4 Em dash
2918 ("bu" "*" "\267" . t) ; bullet
2919 ("fm" "'") ; foot mark
2920 ("co" "(C)" "\251") ; copyright
2922 ("pl" "+" "+" . t) ; math plus
2923 ("mi" "-" "-" . t) ; math minus
2924 ("**" "*" "*" . t) ; math star
2925 ("aa" "'" "\242" . t) ; acute accent
2926 ("ul" "_") ; underrule
2928 ("*S" "Sigma" "S" . t) ; Sigma
2930 (">=" ">=" "\263" . t) ; >=
2931 ("<=" "<=" "\243" . t) ; <=
2932 ("->" "->" "\256" . t) ; right arrow
2933 ("<-" "<-" "\254" . t) ; left arrow
2934 ("mu" " x " "\264" . t) ; multiply
2935 ("+-" "+/-" "\261" . t) ; plus-minus
2936 ("bv" "|") ; bold vertical
2938 ;; groff etc. extensions:
2945 "Alist of special character codes with ASCII and extended-font equivalents.
2946 Each alist elements has the form
2947 (input-string ascii-string extended-font-string . use-symbol-font)
2949 * `\\(input-string' is the ?roff encoding,
2950 * `ascii-string' is the (multi-character) ASCII simulation,
2951 * `extended-font-string' is the single-character string representing
2952 the character position in the extended 256-character font, and
2953 * `use-symbol-font' is t to indicate use of the symbol font or nil,
2954 i.e. omitted, to indicate use of the default font.
2955 Any element may be nil. Avoid control character codes (0 to \\37, \\180
2956 to \\237) in `extended-font-string' for now, since they can be
2957 displayed only with a modified display table.
2959 Use the WoMan command `woman-display-extended-fonts' or a character
2960 map accessory to help construct this alist.")
2962 (defsubst woman-replace-match (newtext &optional face)
2963 "Replace text matched by last search with NEWTEXT and return t.
2964 Set NEWTEXT in face FACE if specified."
2965 (woman-delete-match 0)
2966 (insert-before-markers newtext)
2967 (if face (put-text-property (1- (point)) (point) 'face 'woman-symbol))
2970 (defun woman-special-characters (to)
2971 "Process special character escapes \\(xx, \\[xxx] up to buffer position TO.
2972 \(This must be done AFTER translation, which may use special characters.)"
2973 (while (re-search-forward "\\\\\\(?:(\\(..\\)\\|\\[\\([[^]]+\\)\\]\\)" to t)
2974 (let* ((name (or (match-string-no-properties 1)
2975 (match-string-no-properties 2)))
2976 (replacement (assoc name woman-special-characters)))
2980 (cond ((and (cddr replacement)
2981 (if (nthcdr 3 replacement)
2982 ;; Need symbol font:
2983 (if woman-use-symbol-font
2984 (woman-replace-match (nth 2 replacement)
2986 ;; Need extended font:
2987 (if woman-use-extended-font
2988 (woman-replace-match (nth 2 replacement))))))
2989 ((cadr replacement) ; Use ASCII simulation
2990 (woman-replace-match (cadr replacement)))))
2991 (WoMan-warn (concat "Special character "
2992 (if (match-string 1) "\\(%s" "\\[%s]")
2993 " not interpolated!") name)
2994 (if woman-ignore (woman-delete-match 0))))
2997 (defun woman-display-extended-fonts ()
2998 "Display table of glyphs of graphic characters and their octal codes.
2999 All the octal codes in the ranges [32..127] and [160..255] are displayed
3000 together with the corresponding glyphs from the default and symbol fonts.
3001 Useful for constructing the alist variable `woman-special-characters'."
3003 (with-output-to-temp-buffer "*WoMan Extended Font Map*"
3004 (with-current-buffer standard-output
3007 (insert (format "\\%03o " i) (string i) " " (string i))
3008 (put-text-property (1- (point)) (point)
3009 'face 'woman-symbol)
3012 (when (= i 128) (setq i 160) (insert "\n"))
3013 (if (zerop (% i 8)) (insert "\n")))
3015 (print-help-return-message)))
3018 ;;; Formatting macros that do not cause a break:
3020 (defvar request) ; Bound locally by woman1-roff-buffer
3021 (defvar unquote) ; Bound locally by woman1-roff-buffer
3023 (defun woman-unquote (to)
3024 "Delete any double-quote characters between point and TO.
3025 Leave point at TO (which should be a marker)."
3027 (while (search-forward "\"" to 1)
3028 (if (and in-quote (looking-at "\""))
3029 ;; Repeated double-quote represents single double-quote
3031 (if (or in-quote (looking-at ".*\"")) ; paired
3033 (setq in-quote (not in-quote))
3036 (WoMan-warn "Unpaired \" in .%s arguments." request))
3039 (defsubst woman-unquote-args ()
3040 "Delete any double-quote characters up to the end of the line."
3041 (woman-unquote (save-excursion (end-of-line) (point-marker))))
3043 (defun woman1-roff-buffer ()
3044 "Process non-breaking requests."
3045 (let ((case-fold-search t)
3048 ;; Find next control line:
3049 (re-search-forward woman-request-regexp nil t)
3051 ;; Construct woman function to call:
3052 ((setq fn (intern-soft
3054 (setq request (match-string 1)))))
3055 (if (get fn 'notfont) ; not a font-change request
3057 ;; Delete request or macro name:
3058 (woman-delete-match 0)
3059 ;; If no args then apply to next line else unquote args
3060 ;; (unquote is used by called function):
3061 (setq unquote (not (eolp)))
3062 (if (eolp) (delete-char 1))
3063 ; ;; Hide leading control character in unquoted argument:
3064 ; (cond ((memq (following-char) '(?. ?'))
3066 ; (beginning-of-line)))
3067 ;; Call the appropriate function:
3069 ;; Hide leading control character in quoted argument (only):
3070 (if (and unquote (memq (following-char) '(?. ?')))
3075 ;;; Font-changing macros:
3078 ".B -- Set words of current line in bold font."
3079 (woman1-B-or-I ".ft B\n"))
3082 ".I -- Set words of current line in italic font."
3083 (woman1-B-or-I ".ft I\n"))
3085 (defun woman1-B-or-I (B-or-I)
3086 ".B/I -- Set words of current line in bold/italic font.
3087 B-OR-I is the appropriate complete control line."
3088 ;; Should NOT concatenate the arguments!
3089 (insert B-or-I) ; because it might be a control line
3090 ;; Return to bol to process .SM/.B, .B/.if etc.
3091 ;; or start of first arg to hide leading control char.
3094 (woman-unquote-args)
3095 (while (looking-at "^[.']") (forward-line))
3097 (delete-horizontal-space))
3101 ".SM -- Set the current line in small font, i.e. IGNORE!"
3104 (defalias 'woman1-SB 'woman1-B)
3105 ;; .SB -- Set the current line in small bold font, i.e. just embolden!
3106 ;; (This is what /usr/local/share/groff/tmac/tmac.an does. The
3107 ;; Linux man.7 is wrong about this!)
3110 ".BI -- Join words of current line alternating bold and italic fonts."
3111 (woman1-alt-fonts (list "\\fB" "\\fI")))
3114 ".BR -- Join words of current line alternating bold and Roman fonts."
3115 (woman1-alt-fonts (list "\\fB" "\\fR")))
3118 ".IB -- Join words of current line alternating italic and bold fonts."
3119 (woman1-alt-fonts (list "\\fI" "\\fB")))
3122 ".IR -- Join words of current line alternating italic and Roman fonts."
3123 (woman1-alt-fonts (list "\\fI" "\\fR")))
3126 ".RB -- Join words of current line alternating Roman and bold fonts."
3127 (woman1-alt-fonts (list "\\fR" "\\fB")))
3130 ".RI -- Join words of current line alternating Roman and italic fonts."
3131 (woman1-alt-fonts (list "\\fR" "\\fI")))
3133 (defun woman1-alt-fonts (fonts)
3134 "Join words using alternating fonts in FONTS, which MUST be a dynamic list."
3135 (nconc fonts fonts) ; circular list!
3136 (insert (car fonts))
3137 ;; Return to start of first arg to hide leading control char:
3139 (setq fonts (cdr fonts))
3140 (woman-forward-arg unquote 'concat) ; unquote is bound above
3142 (insert (car fonts))
3143 (setq fonts (cdr fonts))
3144 (woman-forward-arg unquote 'concat)) ; unquote is bound above
3148 (defun woman-forward-arg (&optional unquote concat)
3149 "Move forward over one ?roff argument, optionally unquoting and/or joining.
3150 If optional arg UNQUOTE is non-nil then delete any argument quotes.
3151 If optional arg CONCAT is non-nil then join arguments."
3152 (if (eq (following-char) ?\")
3154 (if unquote (delete-char 1) (forward-char))
3155 (re-search-forward "\"\\|$")
3156 ;; Repeated double-quote represents single double-quote
3157 (while (eq (following-char) ?\") ; paired
3158 (if unquote (delete-char 1) (forward-char))
3159 (re-search-forward "\"\\|$"))
3160 (if (eq (preceding-char) ?\")
3161 (if unquote (delete-backward-char 1))
3162 (WoMan-warn "Unpaired \" in .%s arguments." request)
3164 ;; (re-search-forward "[^\\\n] \\|$") ; inconsistent
3165 (skip-syntax-forward "^ "))
3166 (cond ((null concat) (skip-chars-forward " \t")) ; don't skip eol!
3167 ((eq concat 'noskip)) ; do not skip following whitespace
3168 (t (woman-delete-following-space)))
3172 ;; The following requests are not explicit font-change requests and
3173 ;; so are flagged `notfont' to turn off automatic request deletion
3174 ;; and further processing.
3176 (put 'woman1-TP 'notfont t)
3178 ".TP -- After tag line, reset font to Roman for paragraph body."
3179 ;; Same for .IP, but forward only 1 line?
3181 ;; May be an `irrelevant' control line in the way, so ...
3183 (forward-line (if (looking-at "\\.\\S-+[ \t]*$") 2 1))
3184 ;; May be looking at control line, so ...
3185 (insert ".ft R\n")))
3187 (put 'woman1-ul 'notfont t)
3189 ".ul N -- Underline (italicize) the next N input lines, default N = 1."
3190 (let ((N (if (eolp) 1 (woman-parse-numeric-arg)))) ; woman-get-numeric-arg ?
3191 (woman-delete-whole-line)
3197 ;;; Other non-breaking requests:
3200 ;; Warnings commented out.
3202 (put 'woman1-nh 'notfont t)
3204 ".nh -- No hyphenation, i.e. IGNORE!"
3205 ;; Must be handled here to avoid breaking!
3206 ;; (WoMan-log-1 ".nh request ignored -- hyphenation not supported!")
3207 (woman-delete-whole-line))
3209 (put 'woman1-hy 'notfont t)
3211 ".hy N -- Set hyphenation mode to N, i.e. IGNORE!"
3212 ;; (WoMan-log-1 ".hy request ignored -- hyphenation not supported!")
3213 (woman-delete-whole-line))
3215 (put 'woman1-hc 'notfont t)
3217 ".hc c -- Set hyphenation character to c, i.e. delete it!"
3218 (let ((c (char-to-string (following-char))))
3220 ;; "Hyphenation character %s deleted -- hyphenation not supported!" c)
3221 (woman-delete-whole-line)
3222 (setq c (concat "\\(" c "\\)\\|^[.'][ \t]*hc"))
3224 (while (and (re-search-forward c nil t)
3229 (put 'woman1-hw 'notfont t)
3231 ".hw words -- Set hyphenation exception words, i.e. IGNORE!"
3232 ;; (WoMan-log-1 ".hw request ignored -- hyphenation not supported!")
3233 (woman-delete-whole-line))
3235 ;;; Other non-breaking requests correctly ignored by nroff:
3237 (put 'woman1-ps 'notfont t)
3238 (defalias 'woman1-ps 'woman-delete-whole-line)
3239 ;; .ps -- Point size -- IGNORE!
3241 (put 'woman1-ss 'notfont t)
3242 (defalias 'woman1-ss 'woman-delete-whole-line)
3243 ;; .ss -- Space-character size -- IGNORE!
3245 (put 'woman1-cs 'notfont t)
3246 (defalias 'woman1-cs 'woman-delete-whole-line)
3247 ;; .cs -- Constant character space (width) mode -- IGNORE!
3249 (put 'woman1-ne 'notfont t)
3250 (defalias 'woman1-ne 'woman-delete-whole-line)
3251 ;; .ne -- Need vertical space -- IGNORE!
3253 (put 'woman1-vs 'notfont t)
3254 (defalias 'woman1-vs 'woman-delete-whole-line)
3255 ;; .vs -- Vertical base line spacing -- IGNORE!
3257 (put 'woman1-bd 'notfont t)
3258 (defalias 'woman1-bd 'woman-delete-whole-line)
3259 ;; .bd -- Embolden font -- IGNORE!
3261 ;;; Non-breaking SunOS-specific macros:
3264 ".TX t p -- Resolve SunOS abbrev t and join to p (usually punctuation)."
3266 (woman-forward-arg 'unquote 'concat))
3268 (put 'woman1-IX 'notfont t)
3269 (defalias 'woman1-IX 'woman-delete-whole-line)
3270 ;; .IX -- Index macro, for Sun internal use -- IGNORE!
3273 ;;; Direct font selection:
3275 (defconst woman-font-alist
3277 ("I" . woman-italic)
3281 ("2" . woman-italic)
3282 ("3" . woman-bold) ; used in bash.1
3284 "Alist of ?roff font indicators and woman font variables and names.")
3286 (defun woman-change-fonts ()
3287 "Process font changes."
3288 ;; ***** NEEDS REVISING IF IT WORKS OK *****
3289 ;; Paragraph .LP/PP/HP/IP/TP and font .B/.BI etc. macros reset font.
3290 ;; Should .SH/.SS reset font?
3291 ;; Font size setting macros (?) should reset font.
3292 (let ((font-alist woman-font-alist) ; for local updating
3293 (previous-pos (point))
3294 (previous-font 'default)
3295 (current-font 'default))
3297 ;; Find font requests, paragraph macros and font escapes:
3299 "^[.'][ \t]*\\(\\(\\ft\\)\\|\\(.P\\)\\)\\|\\(\\\\f\\)" nil 1)
3300 (let (font beg notfont fescape)
3301 ;; Match font indicator and leave point at end of sequence:
3302 (cond ((match-string 2)
3303 ;; .ft request found
3304 (setq beg (match-beginning 0))
3305 (skip-chars-forward " \t")
3306 (if (eolp) ; default is previous font
3307 (setq font previous-font)
3308 (looking-at "[^ \t\n]+"))
3309 (forward-line)) ; end of control line and \n
3311 ;; Macro that resets font found
3312 (setq font 'default))
3315 (setq beg (match-beginning 0)
3318 (t (setq notfont t)))
3323 (let ((fontstring (match-string 0)))
3324 (setq font (assoc fontstring font-alist)
3325 ;; NB: font-alist contains VARIABLE NAMES.
3328 (WoMan-warn "Unknown font %s." fontstring)
3329 ;; Output this message once only per call ...
3331 (cons (cons fontstring 'woman-unknown)
3335 ;; Delete font control line or escape sequence:
3336 (cond (beg (delete-region beg (point))
3337 (if (eq font 'previous) (setq font previous-font))))
3338 ;; Deal with things like \fB.cvsrc\fR at the start of a line.
3339 ;; After removing the font control codes, this would
3340 ;; otherwise match woman-request-regexp. The "\\&" which is
3341 ;; inserted to prevent this is removed by woman2-process-escapes.
3343 (looking-at woman-request-regexp)
3345 (woman-set-face previous-pos (point) current-font)
3347 ;; Explicit font control
3348 (setq previous-pos (point)
3349 previous-font current-font)
3350 ;; Macro that resets font
3351 ;; (forward-line) ; DOES NOT WORK! but unnecessary?
3352 ;; Must process font changes in any paragraph tag!
3353 (setq previous-pos (point)
3354 previous-font 'default))
3355 (setq current-font font)
3357 ;; Set font after last request up to eob:
3358 (woman-set-face previous-pos (point) current-font)
3361 (defun woman-set-face (from to face)
3362 "Set the face of the text from FROM to TO to face FACE.
3363 Ignore the default face and underline only word characters."
3364 (or (eq face 'default) ; ignore
3366 (if (face-underline-p face)
3368 (let ((face-no-ul (intern (concat (symbol-name face) "-no-ul"))))
3370 (while (< (point) to)
3371 (skip-syntax-forward "w" to)
3372 (put-text-property from (point) 'face face)
3374 (skip-syntax-forward "^w" to)
3375 (put-text-property from (point) 'face face-no-ul)
3378 (put-text-property from to 'face face))
3382 ;;; Output translation:
3384 (defvar translations nil) ; Also bound locally by woman2-roff-buffer
3385 ;; A list of the form (\"[ace]\" (a . b) (c . d) (e . ?\ )) or nil.
3387 (defun woman-get-next-char ()
3388 "Return and delete next char in buffer, including special chars."
3389 (if ;;(looking-at "\\\\(\\(..\\)")
3390 ;; Match special \(xx and strings \*[xxx], \*(xx, \*x:
3391 (looking-at "\\\\\\((..\\|\\*\\(\\[[^]]+\\]\\|(..\\|.\\)\\)")
3392 (prog1 (match-string 0)
3393 (woman-delete-match 0))
3394 (prog1 (char-to-string (following-char))
3397 (defun woman2-tr (to)
3398 ".tr abcde -- Translate a -> b, c -> d, ..., e -> space.
3399 Format paragraphs upto TO. Supports special chars.
3400 \(Breaks, but should not.)"
3401 ;; This should be an update, but consing onto the front of the alist
3402 ;; has the same effect and match duplicates should not matter.
3403 ;; Initialize translation data structures:
3404 (let ((matches (car translations))
3405 (alist (cdr translations))
3407 ;; `matches' must be a string:
3409 (concat (if matches (substring matches 1 -1)) "]"))
3410 ;; Process .tr arguments:
3411 (while (not (eolp)) ; (looking-at "[ \t]*$") ???
3412 (setq a (woman-get-next-char))
3415 (setq b (woman-get-next-char)))
3417 (if (= (length a) 1)
3419 (concat matches "\\|\\" a))
3420 alist (cons (cons a b) alist)))
3421 (delete-char 1) ; no blank line
3422 ;; Rebuild translations list:
3424 (if (= (string-to-char matches) ?\])
3425 (substring matches 3)
3426 (concat "[" matches))
3427 translations (cons matches alist))
3428 ;; Format any following text:
3429 (woman2-format-paragraphs to)
3432 (defsubst woman-translate (to)
3433 "Translate up to marker TO. Do this last of all transformations."
3435 (let ((matches (car translations))
3436 (alist (cdr translations)))
3437 (while (re-search-forward matches to t)
3438 ;; Done like this to retain text properties and
3439 ;; support translation of special characters:
3440 (insert-before-markers-and-inherit
3442 (buffer-substring-no-properties
3443 (match-beginning 0) (match-end 0))
3445 (woman-delete-match 0))
3451 (defvar woman-registers ; these are all read-only
3452 '((".H" 24) (".V" 48) ; resolution in basic units
3453 (".g" 0) ; not groff
3454 ;; (Iff emulating groff need to implement groff italic correction
3455 ;; \/, e.g. for pic.1)
3456 (".i" left-margin) ; current indent
3457 (".j" woman-adjust) ; current adjustment
3458 (".l" fill-column) ; current line length
3459 (".s" 12) ; current point size
3460 (".u" (if woman-nofill 0 1)) ; 1/0 in fill/nofill mode
3461 (".v" 48) ; current vertical line spacing
3463 "Register alist: the key is the register name as a string.
3464 Each element has the form (KEY VALUE . INC) -- inc may be nil.
3465 Also bound locally in `woman2-roff-buffer'.")
3467 (defun woman-mark-horizonal-position ()
3468 "\\kx -- Store current horizontal position in INPUT LINE in register x."
3469 (while (re-search-forward "\\\\k\\(.\\)" nil t)
3470 (goto-char (match-beginning 0))
3471 (setq woman-registers
3472 (cons (list (match-string 1) (current-column))
3474 (woman-delete-match 0)))
3476 (defsubst woman2-process-escapes-to-eol (&optional numeric)
3477 "Process remaining escape sequences up to eol.
3478 Handle numeric arguments specially if optional argument NUMERIC is non-nil."
3479 (woman2-process-escapes (copy-marker (line-end-position) t) numeric))
3481 (defun woman2-nr (to)
3482 ".nr R +/-N M -- Assign +/-N (wrt to previous value, if any) to register R.
3483 The increment for auto-incrementing is set to M.
3484 Format paragraphs upto TO. (Breaks, but should not!)"
3485 (let* ((name (buffer-substring
3487 (progn (skip-syntax-forward "^ ") (point))))
3488 (pm (progn ; increment
3489 (skip-chars-forward " \t")
3490 (when (memq (char-after) '(?+ ?-))
3491 (forward-char) (char-before))))
3492 (value (if (eolp) ; no value
3493 nil ; to be interpreted as zero
3494 (woman2-process-escapes-to-eol 'numeric)
3495 (woman-parse-numeric-arg)))
3496 (inc (progn ; auto-increment
3497 (skip-chars-forward " \t")
3498 (if (eolp) ; no value
3499 nil ; to be interpreted as zero ???
3500 (woman-parse-numeric-arg))))
3501 (oldvalue (assoc name woman-registers)))
3503 (setq oldvalue (cdr oldvalue)) ; (value . inc)
3504 (unless inc (setq inc (cdr oldvalue))))
3506 (setq value 0) ; correct?
3507 (WoMan-warn "nr %s -- null value assigned as zero!" name))
3509 (setq value (list 'quote value))))
3510 (if pm ; increment old value
3511 (setq oldvalue (if oldvalue (car oldvalue) 0)
3512 value (if (eq pm ?+)
3514 (- oldvalue value))))
3515 (setq woman-registers
3516 (cons (cons name (cons value inc)) woman-registers))
3517 (woman-delete-whole-line)
3518 (woman2-format-paragraphs to)))
3521 ;;; Numeric (and "non-text") request arguments:
3523 (defsubst woman-get-numeric-arg ()
3524 "Get the value of a numeric argument at or after point.
3525 The argument can include the width function and scale indicators.
3526 Assumes 10 characters per inch. Does not move point."
3527 (woman2-process-escapes-to-eol 'numeric)
3528 (save-excursion (woman-parse-numeric-arg)))
3530 (defun woman-parse-numeric-arg ()
3531 "Get the value of a numeric expression at or after point.
3532 Unlike `woman-get-numeric-arg', leaves point after the argument.
3533 The expression may be an argument in quotes."
3534 (if (= (following-char) ?\") (forward-char))
3535 ;; Allow leading +/-:
3536 (let ((value (if (looking-at "[+-]") 0 (woman-parse-numeric-value)))
3539 ((looking-at "[+-/*%]") ; arithmetic operators
3541 (setq op (intern-soft (match-string 0)))
3542 (setq value (funcall op value (woman-parse-numeric-value))))
3543 ((looking-at "[<=>]=?") ; relational operators
3544 (goto-char (match-end 0))
3545 (setq op (or (intern-soft (match-string 0))
3547 (setq value (if (funcall op value (woman-parse-numeric-value))
3549 ((memq (setq op (following-char)) '(?& ?:)) ; Boolean and / or
3552 ;; and / or are special forms, not functions, in ELisp
3556 (if (> (woman-parse-numeric-value) 0) 1 0)
3557 ;; skip second operand
3558 (prog1 0 (woman-parse-numeric-value)))
3561 ;; skip second operand
3562 (prog1 1 (woman-parse-numeric-value))
3563 (if (> (woman-parse-numeric-value) 0) 1 0))
3566 ; (if (looking-at "[ \t\nRC\)\"]") ; R, C are tab types
3568 ; (WoMan-warn "Unimplemented numerical operator `%c' in %s"
3571 ; (save-excursion (beginning-of-line) (point))
3572 ; (save-excursion (end-of-line) (point))))
3573 ; (skip-syntax-forward "^ "))
3577 (defun woman-parse-numeric-value ()
3578 "Get a single numeric value at or after point.
3579 The value can be a number register or width function (which assumes 10
3580 characters per inch) and can include scale indicators. It may be an
3581 expression in parentheses. Leaves point after the value."
3582 ;; Must replace every \' by some different single character first
3583 ;; before calling this function by calling
3584 ;; (woman2-process-escapes-to-eol 'numeric)
3585 (if (eq (following-char) ?\()
3586 ;; Treat parenthesized expression as a single value.
3589 (setq n (woman-parse-numeric-arg))
3590 (skip-syntax-forward " ")
3591 (if (eq (following-char) ?\))
3593 (WoMan-warn "Parenthesis confusion in numeric expression!"))
3595 (let ((n (cond ((looking-at "[-+]?[.0-9]+") ; single number
3596 ;; currently needed to set match-end, even though
3597 ;; string-to-number returns 0 if number not parsed.
3598 (string-to-number (match-string 0)))
3599 ((looking-at "\\\\n\\([-+]\\)?\\(?:\
3600 \\[\\([^]]+\\)\\]\\|\(\\(..\\)\\|\\(.\\)\\)")
3601 ;; interpolate number register, maybe auto-incremented
3602 (let* ((pm (match-string-no-properties 1))
3603 (name (or (match-string-no-properties 2)
3604 (match-string-no-properties 3)
3605 (match-string-no-properties 4)))
3606 (value (assoc name woman-registers)))
3609 (setq value (cdr value) ; (value . inc)
3611 ;; eval internal (.X) registers
3612 ;; stored as lisp variable names:
3613 value (eval (car value)))
3614 (if (and pm inc) ; auto-increment
3616 (funcall (intern-soft pm) value inc)
3618 (cons (cons name (cons value inc))
3621 (WoMan-warn "Undefined register %s defaulted to 0."
3623 0) ; default to zero
3626 ;; Delimiter can be special char escape \[xxx],
3627 ;; \(xx or single normal char (usually '):
3628 "\\=\\\\w\\(\\\\\\[[^]]+\\]\\|\\\\(..\\|.\\)" nil t)
3629 (let ((from (match-end 0))
3630 (delim (regexp-quote (match-string 1))))
3631 (if (re-search-forward delim nil t)
3632 ;; Return width of string:
3633 (- (match-beginning 0) from)
3634 (WoMan-warn "Width escape delimiter error!"))))
3637 ;; ERROR -- should handle this better!
3639 (WoMan-warn "Numeric/register argument error: %s"
3642 (save-excursion (end-of-line) (point))))
3643 (skip-syntax-forward "^ ")
3645 (goto-char (match-end 0))
3646 ;; Check for scale factor:
3649 ((looking-at "\\s ") nil) ; stay put!
3650 ((looking-at "[mnuv]")) ; ignore for now
3651 ((looking-at "i") (setq n (* n 10))) ; inch
3652 ((looking-at "c") (setq n (* n 3.9))) ; cm
3653 ((looking-at "P") (setq n (* n 1.7))) ; Pica
3654 ((looking-at "p") (setq n (* n 0.14))) ; point
3655 ;; NB: May be immediately followed by + or -, etc.,
3656 ;; in which case do nothing and return nil.
3658 (goto-char (match-end 0)))
3659 (if (numberp n) (round n) n))
3663 ;;; VERTICAL FORMATTING -- Formatting macros that cause a break:
3665 ;; Vertical spacing philosophy:
3666 ;; Delete all vertical space as it is encountered. Then insert
3667 ;; vertical space only before text, as required.
3669 (defun woman2-roff-buffer ()
3670 "Process breaks. Format paragraphs and headings."
3671 (let ((case-fold-search t)
3673 (canonically-space-region
3674 (symbol-function 'canonically-space-region))
3675 (insert-and-inherit (symbol-function 'insert-and-inherit))
3676 (set-text-properties (symbol-function 'set-text-properties))
3677 (woman-registers woman-registers)
3678 fn request translations
3680 (set-marker-insertion-type to t)
3681 ;; ?roff does not squeeze multiple spaces, but does fill, so...
3682 (fset 'canonically-space-region 'ignore)
3683 ;; Try to avoid spaces inheriting underlines from preceding text!
3684 (fset 'insert-and-inherit (symbol-function 'insert))
3685 (fset 'set-text-properties 'ignore)
3688 ;; Find next control line:
3689 (re-search-forward woman-request-regexp nil t)
3691 ;; Construct woman function to call:
3692 ((setq fn (intern-soft
3694 (setq request (match-string 1)))))
3695 ;; Delete request or macro name:
3696 (woman-delete-match 0))
3697 ;; Unrecognised request:
3699 ;; (WoMan-warn ".%s request ignored!" request)
3700 (WoMan-warn-ignored request "ignored!")
3701 ;; (setq fn 'woman2-LP)
3702 ;; AVOID LEAVING A BLANK LINE!
3703 ;; (setq fn 'woman2-format-paragraphs)
3705 ;; .LP assumes it is at eol and leaves a (blank) line,
3706 ;; so leave point at end of line before paragraph:
3707 ((or (looking-at "[ \t]*$") ; no argument
3708 woman-ignore) ; ignore all
3709 ;; (beginning-of-line) (kill-line)
3710 ;; AVOID LEAVING A BLANK LINE!
3711 (beginning-of-line) (woman-delete-line 1))
3712 (t (end-of-line) (insert ?\n))
3715 (and (not (memq (following-char) '(?. ?')))
3716 (setq fn 'woman2-format-paragraphs))))
3718 ;; Find next control line:
3719 (set-marker to (woman-find-next-control-line))
3720 ;; Call the appropriate function:
3722 (if (not (eobp)) ; This should not happen, but ...
3723 (woman2-format-paragraphs (copy-marker (point-max) t)
3725 (fset 'canonically-space-region canonically-space-region)
3726 (fset 'set-text-properties set-text-properties)
3727 (fset 'insert-and-inherit insert-and-inherit)
3728 (set-marker to nil))))
3730 (defun woman-find-next-control-line ()
3731 "Find and return start of next control line."
3732 ; (let ((to (save-excursion
3733 ; (re-search-forward "^\\." nil t))))
3734 ; (if to (1- to) (point-max)))
3739 ;; .br (and other requests?)
3740 ;; by deleting both the \c and the following request.
3741 ;; BEWARE THAT THIS CODE MAY BE UNRELIABLE!!!!!
3744 (setq to (re-search-forward "\\(\\\\c\\)?\n[.']" nil t))
3747 (goto-char (match-beginning 0))
3748 (woman-delete-line 2)))
3749 (if to (1- to) (point-max))))
3751 (defun woman2-PD (to)
3752 ".PD d -- Set the interparagraph distance to d.
3753 Round to whole lines, default 1 line. Format paragraphs upto TO.
3754 \(Breaks, but should not.)"
3755 ;; .ie \\n[.$] .nr PD (v;\\$1)
3756 ;; .el .nr PD .4v>?\n[.V]
3757 (woman-set-interparagraph-distance)
3758 (woman2-format-paragraphs to))
3760 (defun woman-set-interparagraph-distance ()
3761 "Set the interparagraph distance from a .PD request at point."
3762 (setq woman-interparagraph-distance
3763 (if (eolp) 1 (woman-get-numeric-arg)))
3764 ;; Should allow .PD 0 to set zero line spacing
3765 (woman-delete-line 1)) ; ignore remaining args
3767 (defsubst woman-interparagraph-space ()
3768 "Set variable `woman-leave-blank-lines' from `woman-interparagraph-distance'."
3769 ; (if (> woman-interparagraph-distance 0)
3770 ; (forward-line 1) ; leave 1 blank line
3771 ; (woman-delete-line 1)) ; do not leave blank line
3772 (setq woman-leave-blank-lines woman-interparagraph-distance)
3775 (defun woman2-TH (to)
3776 ".TH n c x v m -- Begin a man page. Format paragraphs upto TO.
3777 n is the name of the page in chapter c\; x is extra commentary\;
3778 v alters page foot left; m alters page head center.
3779 \(Should set prevailing indent and tabs to 5.)"
3780 (woman-forward-arg 'unquote 'concat)
3782 (woman-forward-arg 'unquote 'concat)
3784 (let ((start (point)) here)
3786 (cond ((looking-at "\"\"[ \t]")
3788 ;; (delete-horizontal-space)
3790 (delete-horizontal-space)
3793 (woman-forward-arg 'unquote 'concat)
3794 ;; Delete repeated arguments:
3795 (if (string-match (buffer-substring here (point))
3796 (buffer-substring start here))
3797 (delete-region here (point)))
3799 ;; Embolden heading (point is at end of heading):
3801 (save-excursion (beginning-of-line) (point)) (point) 'woman-bold)
3803 (delete-blank-lines)
3804 (setq woman-left-margin woman-default-indent)
3805 (setq woman-prevailing-indent woman-default-indent)
3806 (woman2-format-paragraphs to woman-left-margin))
3808 (defun woman2-SH (to)
3809 ".SH -- Sub-head. Leave blank line and subhead.
3810 Format paragraphs upto TO. Set prevailing indent to 5."
3811 (if (eolp) ; If no args then
3812 (delete-char 1) ; apply to next line
3813 (woman-unquote-args) ; else unquote to end of heading
3814 (beginning-of-line))
3815 (woman2-process-escapes-to-eol)
3816 (woman-leave-blank-lines woman-interparagraph-distance)
3817 (setq woman-leave-blank-lines nil)
3818 ;; Optionally embolden heading (point is at beginning of heading):
3819 (if woman-bold-headings
3821 (point) (save-excursion (end-of-line) (point)) 'woman-bold))
3823 (setq woman-left-margin woman-default-indent
3824 woman-nofill nil) ; fill output lines
3825 (setq woman-prevailing-indent woman-default-indent)
3826 (woman2-format-paragraphs to woman-left-margin))
3828 (defun woman2-SS (to)
3829 ".SS -- Sub-sub-head. Like .SH but indent heading 3 spaces.
3830 Format paragraphs upto TO."
3831 (if (eolp) ; If no args then
3832 (delete-char 1)) ; apply to next line.
3837 (defun woman2-LP (to)
3838 ".LP,.PP -- Begin paragraph. Set prevailing indent to 5.
3839 Leave 1 blank line. Format paragraphs upto TO."
3840 (woman-delete-line 1) ; ignore any arguments
3841 (woman-interparagraph-space)
3842 (setq woman-prevailing-indent woman-default-indent)
3843 (woman2-format-paragraphs to woman-left-margin))
3845 (defalias 'woman2-PP 'woman2-LP)
3846 (defalias 'woman2-P 'woman2-LP)
3848 (defun woman2-ns (to)
3849 ".ns -- Turn on no-space mode. Format paragraphs upto TO."
3850 ;; Should not cause a break!
3851 (woman-delete-line 1) ; ignore argument(s)
3852 (setq woman-nospace t)
3853 (woman2-format-paragraphs to))
3855 (defun woman2-rs (to)
3856 ".rs -- Turn off no-space mode. Format paragraphs upto TO."
3857 ;; Should not cause a break!
3858 (woman-delete-line 1) ; ignore argument(s)
3859 (setq woman-nospace nil)
3860 (woman2-format-paragraphs to))
3862 (defun woman2-sp (to)
3863 ".sp N -- If N > 0 then leave 1 blank line. Format paragraphs upto TO."
3864 (let ((N (if (eolp) 1 (woman-get-numeric-arg))))
3866 (woman-delete-line 1) ; ignore argument(s)
3867 (setq woman-negative-vertical-space t)
3870 (setq woman-leave-blank-lines N)
3871 (woman2-format-paragraphs to)))
3873 (defun woman-negative-vertical-space (from)
3874 ".sp N with N < 0 => overlap following with preceding lines at FROM."
3875 ;; Run by woman-decode-region if necessary -- not usually required.
3876 (WoMan-warn "Negative vertical spacing support is experimental!")
3879 ;; Find next control line:
3880 (re-search-forward "^\\.sp " nil t)
3881 (let ((N (woman-get-numeric-arg))
3882 overlap overwritten)
3883 (woman-delete-whole-line)
3885 overlap (buffer-substring from
3886 (progn (forward-line (- N)) (point))))
3887 (delete-region from (point))
3889 (let ((imax (length overlap))
3892 (setq c (aref overlap i))
3893 (cond ((eq c ?\n) ; skip
3895 ((eolp) ; extend line
3896 ;; Insert character INCLUDING TEXT PROPERTIES:
3897 ;; (insert (substring overlap i (1+ i)))
3898 (let ((eol (string-match "\n" overlap i)))
3899 (insert (substring overlap i eol))
3900 (setq i (or eol imax)))
3905 (if (eq (following-char) ?\t)
3906 (forward-char) ; both tabs, just skip
3907 (dotimes (i woman-tab-width)
3909 (insert ?\ ) ; extend line
3910 (forward-char)) ; skip
3913 (if (or (eq (following-char) ?\ ) ; overwrite OK
3914 overwritten) ; warning only once per ".sp -"
3916 (setq overwritten t)
3918 "Character(s) overwritten by negative vertical spacing in line %d"
3919 (count-lines 1 (point))))
3920 (delete-char 1) (insert (substring overlap i (1+ i)))))
3926 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3927 ;; The following function should probably do ALL width and number
3928 ;; register interpolation.
3929 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3931 (defun woman2-process-escapes (to &optional numeric)
3932 "Process remaining escape sequences up to marker TO, preserving point.
3933 Optional argument NUMERIC, if non-nil, means the argument is numeric."
3934 (assert (and (markerp to) (marker-insertion-type to)))
3935 ;; The first two cases below could be merged (maybe)!
3936 (let ((from (point)))
3937 ;; Discard zero width filler character used to hide leading dots
3938 ;; and zero width characters \|, \^:
3939 (while (re-search-forward "\\\\[&|^]" to t)
3940 (woman-delete-match 0))
3942 ;; Interrupt text processing -- CONTINUE current text with the
3943 ;; next text line (after any control lines, unless processing to
3945 (while (re-search-forward "\\\\c.*\n?" to t)
3946 (woman-delete-match 0))
3947 ;; but do not delete the final newline ...
3948 (if (and (or (eobp) (= (point) to)) (not (bolp)))
3949 (insert-before-markers ?\n))
3951 (woman-translate to)
3953 (woman-special-characters to)
3955 ;; Printable version of the current escape character, ASSUMED to be `\'
3956 ;; This must be done LAST of all escape processing!
3957 ;; Done like this to preserve any text properties of the `\'
3958 (while (search-forward "\\" to t)
3959 (let ((c (following-char)))
3960 (cond ((eq c ?') ; \' -> '
3962 (cond (numeric ; except in numeric args, \' -> `
3965 ((eq c ?\( )) ; uninterpreted special character
3966 ; \(.. -- do nothing
3967 ((eq c ?t) ; non-interpreted tab \t
3972 (memq c '(?w ?n ?h)))) ; leave \w, \n, \h (?????)
3973 ((eq c ?l) (woman-horizontal-line))
3975 ;; \? -> ? where ? is any remaining character
3976 (WoMan-warn "Escape ignored: \\%c -> %c" c c)
3980 ;; Process non-default tab settings:
3981 (cond (tab-stop-list
3982 (while (search-forward "\t" to t)
3983 (woman-tab-to-tab-stop))
3986 ;; Must replace \' by something before processing \w, done above.
3988 ;; Replace all `\w' and `\n' escapes:
3989 ;; (This may be a bit too recursive!)
3990 (while (re-search-forward "\\\\[nw]" to t)
3991 (let ((from (match-beginning 0)) N)
3993 (setq N (woman-parse-numeric-value))
3994 (delete-region from (point))
3995 ;; Interpolate value:
3996 (insert-before-markers (number-to-string N))))
3999 (defun woman-horizontal-line ()
4000 "\\l'Nc' -- Draw a horizontal line of length N using character c, default _."
4003 (looking-at "\\(.\\)\\(.*\\)\\1")
4005 (let* ((to (match-end 2))
4006 (from (match-beginning 0))
4007 (N (woman-parse-numeric-arg))
4008 (c (if (< (point) to) (following-char) ?_)))
4009 (delete-region from to)
4011 (insert (make-string N c))
4014 ;;; 4. Text Filling, Adjusting, and Centering
4016 (defun woman2-br (to)
4017 ".br -- Break. Leave no blank line. Format paragraphs upto TO."
4018 (woman-delete-line 1) ; ignore any arguments
4019 (woman2-format-paragraphs to))
4021 (defun woman2-fi (to)
4022 ".fi -- Fill subsequent output lines. Leave no blank line.
4023 Format paragraphs upto TO."
4024 (setq woman-nofill nil)
4025 (woman-delete-line 1) ; ignore any arguments
4026 ;; Preserve any final blank line in the nofill region:
4029 (if (looking-at "[ \t]*$") (setq woman-leave-blank-lines 1)))
4030 (woman2-format-paragraphs to))
4032 (defun woman2-nf (to)
4033 ".nf -- Nofill. Subsequent lines are neither filled nor adjusted.
4034 Input text lines are copied directly to output lines without regard
4035 for the current line length. Format paragraphs upto TO."
4036 (setq woman-nofill t)
4037 (woman-delete-line 1) ; ignore any arguments
4038 (woman2-format-paragraphs to))
4040 (defun woman2-ad (to)
4041 ".ad c -- Line adjustment is begun (once fill mode is on).
4042 Set justification mode to c if specified.
4043 Format paragraphs upto TO. (Breaks, but should not.)"
4044 ;; c = l -- left, r -- right, c -- center, b or n -- both,
4045 ;; absent -- unchanged. Initial mode adj,both.
4047 (cond ((eolp) woman-adjust-previous)
4048 ((eq (following-char) ?l) woman-adjust-left)
4049 ((eq (following-char) ?r) woman-adjust-right)
4050 ((eq (following-char) ?c) woman-adjust-center)
4051 ((memq (following-char) '(?b ?n)) woman-adjust-both)
4052 (t (woman-get-numeric-arg))
4054 woman-justify (nth woman-adjust woman-justify-list))
4055 (woman-delete-line 1) ; ignore any remaining arguments
4056 (woman2-format-paragraphs to))
4058 (defun woman2-na (to)
4059 ".na -- No adjusting. Format paragraphs upto TO.
4060 \(Breaks, but should not.)"
4061 (setq woman-adjust-previous woman-adjust
4062 woman-justify-previous woman-justify
4063 woman-adjust woman-adjust-left ; fill but do not adjust
4064 woman-justify (nth woman-adjust woman-justify-list))
4065 (woman-delete-line 1) ; ignore any arguments
4066 (woman2-format-paragraphs to))
4068 ;;; The main formatting functions:
4070 (defun woman-leave-blank-lines (&optional leave)
4071 "Delete all blank lines around point.
4072 Leave one blank line if optional argument LEAVE is non-nil and
4073 non-zero, or if LEAVE is nil and variable `woman-leave-blank-lines' is
4074 non-nil and non-zero."
4075 ;; ***** It may suffice to delete only lines ABOVE point! *****
4076 ;; NOTE: Function arguments are evaluated left to right
4077 ;; (*note (elisp)Function Forms::.).
4080 (if (not (eq (skip-syntax-backward " ") 0))
4081 (forward-line)) ; forward-char ?
4083 (progn (skip-syntax-forward " ")
4088 (if (or (null leave) (eq leave 0))
4089 ;; output any `pending' vertical space ...
4090 (setq leave woman-leave-blank-lines))
4091 (if (and leave (> leave 0)) (insert-before-markers ?\n))
4093 (setq woman-leave-blank-lines nil)
4096 ;; `fill-region-as-paragraph' in `fill.el' appears to be the principal
4097 ;; text filling function, so that is what I use here.
4099 (defvar woman-temp-indent nil)
4101 (defun woman2-format-paragraphs (to &optional new-left)
4102 "Indent, fill and adjust paragraphs upto TO to current left margin.
4103 If optional arg NEW-LEFT is non-nil then reset current left margin.
4104 If `woman-nofill' is non-nil then indent without filling or adjusting."
4105 ;; Blank space should only ever be output before text.
4106 (if new-left (setq left-margin new-left))
4107 (if (looking-at "^\\s *$")
4108 ;; A blank line should leave a space like .sp 1 (p. 14).
4109 (setq woman-leave-blank-lines 1))
4110 (skip-syntax-forward " ")
4111 ;; Successive control lines are sufficiently common to be worth a
4112 ;; special case (maybe):
4113 (if (>= (point) to) ; >= as a precaution!
4115 ;; (woman-leave-blank-lines)
4116 (woman-reset-nospace)
4117 ;; (woman2-process-escapes to) ; 7 October 1999
4118 (woman2-process-escapes to 'numeric)
4120 ;; Indent without filling or adjusting ...
4122 (woman-leave-blank-lines)
4123 (cond (woman-temp-indent
4124 (indent-to woman-temp-indent)
4126 (indent-rigidly (point) to left-margin)
4127 (woman-horizontal-escapes to)) ; 7 October 1999
4128 ;; Fill and justify ...
4129 ;; Blank lines and initial spaces cause a break.
4130 ; (cond ((and (= (point) to) (not (looking-at ".nf"))) ; Yuk!!!
4131 ; ;; No text after a request that caused a break, so delete
4132 ; ;; any spurious blank line left:
4134 ; (if (looking-at "^\\s *$") (kill-line) (forward-line))))
4135 (while (< (point) to)
4136 (woman-leave-blank-lines)
4137 (let ((from (point)))
4138 ;; Indent first lin of paragraph:
4139 (indent-to (or woman-temp-indent left-margin))
4140 (woman-horizontal-escapes to) ; 7 October 1999
4141 ;; Find the beginning of the next paragraph:
4143 ; (if (re-search-forward "\\(^\\s *$\\)\\|\\(^\\s +\\)" to 1)
4144 ; ;; A blank line should leave a space like .sp 1 (p. 14).
4147 ; (skip-syntax-forward " ")
4148 ; (setq woman-leave-blank-lines 1))
4149 ; (setq woman-leave-blank-lines nil)))
4150 (and (re-search-forward "\\(^\\s *$\\)\\|\\(^\\s +\\)" to 1)
4151 ;; A blank line should leave a space like .sp 1 (p. 14).
4153 (skip-syntax-forward " ")
4154 (setq woman-leave-blank-lines 1))
4155 ;; This shouldn't happen, but in case it does (e.g. for
4156 ;; badly-formatted manfiles with no terminating newline),
4157 ;; avoid an infinite loop.
4158 (unless (and (eolp) (eobp))
4159 (beginning-of-line))
4160 ;; If a single short line then just leave it.
4161 ;; This is necessary to preserve some table layouts.
4162 ;; PROBABLY NOT NECESSARY WITH SQUEEZE MODIFICATION !!!!!
4163 (if (or (> (count-lines from (point)) 1)
4166 (> (current-column) fill-column)))
4167 ;; ?roff does not squeeze multiple spaces
4168 ;; (fill-region-as-paragraph from (point) woman-justify t)
4169 ;; NOSQUEEZE has no effect if JUSTIFY is full, so
4170 ;; redefine canonically-space-region, see above.
4172 ;; Needs a re-write of the paragraph formatter to
4173 ;; avoid this nonsense to handle temporary indents!
4174 (if (and woman-temp-indent (< woman-temp-indent left-margin))
4175 (let ((left-margin woman-temp-indent))
4176 (fill-region-as-paragraph from (point) woman-justify)
4180 (setq from (point)))))
4181 (fill-region-as-paragraph from (point) woman-justify))
4183 ;; A blank line should leave a space like .sp 1 (p. 14).
4184 ;; Delete all but 1 trailing blank lines:
4185 ;;(woman-leave-blank-lines 1)
4188 (setq woman-temp-indent nil)
4189 ;; Non-white-space text has been processed, so ...
4190 ;;(setq woman-leave-blank-lines nil)
4194 ;;; Tagged, indented and hanging paragraphs:
4196 (defun woman2-TP (to)
4197 ".TP i -- Set prevailing indent to i. Format paragraphs upto TO.
4198 Begin indented paragraph with hanging tag given by next text line.
4199 If tag doesn't fit, place it on a separate line."
4200 (let ((i (woman2-get-prevailing-indent)))
4201 (woman-leave-blank-lines woman-interparagraph-distance)
4202 (woman2-tagged-paragraph to i)))
4204 (defun woman2-IP (to)
4205 ".IP x i -- Same as .TP with tag x. Format paragraphs upto TO."
4206 (woman-interparagraph-space)
4207 (if (eolp) ; no args
4208 ;; Like LP without resetting prevailing indent
4209 (woman2-format-paragraphs to (+ woman-left-margin
4210 woman-prevailing-indent))
4211 (woman-forward-arg 'unquote)
4212 (let ((i (woman2-get-prevailing-indent 'leave-eol)))
4214 (woman-leave-blank-lines) ; must be here,
4216 ;; The cvs.1 manpage contains some (possibly buggy) syntax that
4217 ;; confuses woman, although the man program displays it ok.
4218 ;; Most problems are caused by IP followed by another request on
4219 ;; the next line. Without the following hack, the second request
4220 ;; gets displayed raw in the output. Note that
4221 ;; woman2-tagged-paragraph also contains a hack for similar
4222 ;; issues (eg IP followed by SP).
4224 ;; i) For IP followed by one or more IPs, we ignore all but the
4225 ;; last (mimic man). The hack in w-t-p would only work for two
4226 ;; consecutive IPs, and would use the first.
4227 ;; ii) For IP followed by SP followed by one or more requests,
4228 ;; do nothing. At least in cvs.1, there is usually another IP in
4230 (unless (or (looking-at "^\\.IP")
4231 (and (looking-at "^\\.sp")
4233 (and (zerop (forward-line 1))
4234 (looking-at woman-request-regexp)))))
4235 (woman2-tagged-paragraph to i)))))
4237 (defun woman-find-next-control-line-carefully ()
4238 "Find and return start of next control line, even if already there!"
4239 (if (looking-at "^[.']")
4241 (woman-find-next-control-line)))
4243 (defun woman2-tagged-paragraph (to i)
4244 "Begin indented paragraph with hanging tag given by current text line.
4245 If tag doesn't fit, leave it on separate line.
4246 Format paragraphs upto TO. Set prevailing indent to I."
4247 (if (not (looking-at "\\s *$")) ; non-empty tag
4248 (setq woman-leave-blank-lines nil))
4250 ;; Temporary hack for bash.1, cvs.1 and groff_mmse.7 until code is revised
4251 ;; to process all requests uniformly.
4252 ;; This hack deals with IP requests followed by other requests (eg
4253 ;; SP) on the very next line. We skip over the SP, otherwise it gets
4254 ;; inserted raw in the rendered output.
4255 (cond ((and (= (point) to)
4256 (looking-at "^[.'][ \t]*\\(PD\\|br\\|ta\\|sp\\) *"))
4257 (if (member (match-string 1) '("br" "sp"))
4258 (woman-delete-line 1)
4259 (woman-delete-match 0)
4260 (if (string= (match-string 1) "ta") ; for GetInt.3
4262 (woman-set-interparagraph-distance)))
4263 (set-marker to (woman-find-next-control-line-carefully))
4266 (let ((tag (point)))
4267 (woman-reset-nospace)
4269 (woman2-process-escapes-to-eol)
4270 ;; TIDY UP THE FOLLOWING CODE
4271 ;; (indent-to woman-left-margin)
4272 (setq left-margin woman-left-margin)
4274 (fill-region-as-paragraph (save-excursion (forward-line -1) (point))
4275 (point) woman-justify)
4277 ;; Temporary hack for bash.1 until all requests processed uniformly:
4278 (cond ((and (= (point) to) (looking-at "^[.'][ \t]*PD *"))
4279 (woman-delete-match 0)
4280 (woman-set-interparagraph-distance)
4281 (set-marker to (woman-find-next-control-line-carefully))
4284 ;; Format the paragraph body, if there is one! Set indented left
4285 ;; margin anyway, because the paragraph body may begin with a
4287 (setq left-margin (+ woman-left-margin i))
4288 (cond ((< (point) to)
4289 (woman2-format-paragraphs to)
4290 (goto-char tag) (end-of-line)
4291 (cond ((> (setq i (- left-margin (current-column))) 0)
4293 (delete-horizontal-space)
4294 ;; Necessary to avoid spaces inheriting underlines.
4295 ;; Cannot simply delete (current-column) whitespace
4296 ;; characters because some may be tabs!
4297 (insert-char ?\s i)))
4298 (goto-char to) ; necessary ???
4302 (defun woman2-HP (to)
4303 ".HP i -- Set prevailing indent to i. Format paragraphs upto TO.
4304 Begin paragraph with hanging indent."
4305 (let ((i (woman2-get-prevailing-indent)))
4306 (woman-interparagraph-space)
4307 (setq woman-temp-indent woman-left-margin)
4308 (woman2-format-paragraphs to (+ woman-left-margin i))
4311 (defun woman2-get-prevailing-indent (&optional leave-eol)
4312 "Set prevailing indent to integer argument at point, and return it.
4313 If no argument then return the existing prevailing indent.
4314 Delete line from point and eol unless LEAVE-EOL is non-nil."
4316 (or leave-eol (delete-char 1))
4317 (let ((i (woman-get-numeric-arg)))
4318 (woman-delete-line) (or leave-eol (delete-char 1))
4319 ;; i = 0 if the argument was not a number
4320 ;; FIXME should this be >= 0? How else to reset to 0 indent?
4321 (if (> i 0) (setq woman-prevailing-indent i))))
4322 woman-prevailing-indent)
4324 (defmacro woman-push (value stack)
4325 "Push VALUE onto STACK."
4326 `(setq ,stack (cons ,value ,stack)))
4328 (defmacro woman-pop (variable stack)
4329 "Pop into VARIABLE the value at the top of STACK.
4330 Allow for mismatched requests!"
4332 (setq ,variable (car ,stack)
4333 ,stack (cdr ,stack))))
4335 (defun woman2-RS (to)
4336 ".RS i -- Start relative indent, move left margin in distance i.
4337 Set prevailing indent to 5 for nested indents. Format paragraphs upto TO."
4338 (woman-push woman-left-margin woman-RS-left-margin)
4339 (woman-push woman-prevailing-indent woman-RS-prevailing-indent)
4340 (setq woman-left-margin (+ woman-left-margin
4341 (woman2-get-prevailing-indent))
4342 woman-prevailing-indent woman-default-indent)
4343 (woman2-format-paragraphs to woman-left-margin))
4345 (defun woman2-RE (to)
4346 ".RE -- End of relative indent. Format paragraphs upto TO.
4347 Set prevailing indent to amount of starting .RS."
4348 (woman-pop woman-left-margin woman-RS-left-margin)
4349 (woman-pop woman-prevailing-indent woman-RS-prevailing-indent)
4350 (woman-delete-line 1) ; ignore any arguments
4351 (woman2-format-paragraphs to woman-left-margin))
4354 ;;; Line Length and Indenting:
4356 (defun woman-set-arg (arg &optional previous)
4357 "Reset, increment or decrement argument ARG, which must be quoted.
4358 If no argument then use value of optional arg PREVIOUS if non-nil,
4359 otherwise set PREVIOUS. Delete the whole remaining control line."
4360 (if (eolp) ; space already skipped
4361 (set arg (if previous (eval previous) 0))
4362 (if previous (set previous (eval arg)))
4363 (woman2-process-escapes-to-eol 'numeric)
4364 (let ((pm (if (looking-at "[+-]")
4365 (prog1 (following-char)
4367 (i (woman-parse-numeric-arg)))
4368 (cond ((null pm) (set arg i))
4369 ((= pm ?+) (set arg (+ (eval arg) i)))
4370 ((= pm ?-) (set arg (- (eval arg) i)))
4372 (beginning-of-line))
4373 (woman-delete-line 1)) ; ignore any remaining arguments
4375 ;; NEED TO RATIONALIZE NAMES FOR PREVIOUS VALUES!
4376 (defvar woman-ll-fill-column woman-fill-column)
4377 (defvar woman-in-left-margin woman-left-margin)
4379 (defun woman2-ll (to)
4380 ".ll +/-N -- Set, increment or decrement line length.
4381 Format paragraphs upto TO. (Breaks, but should not.)"
4382 (woman-set-arg 'fill-column 'woman-ll-fill-column)
4383 (woman2-format-paragraphs to))
4385 (defun woman2-in (to)
4386 ".in +/-N -- Set, increment or decrement the indent.
4387 Format paragraphs upto TO."
4388 (woman-set-arg 'left-margin 'woman-in-left-margin)
4389 (woman2-format-paragraphs to))
4391 (defun woman2-ti (to)
4392 ".ti +/-N -- Temporary indent. Format paragraphs upto TO."
4393 ;; Ignore if no argument.
4394 ;; Indent next output line only wrt current indent.
4395 ;; Current indent is not changed.
4396 (setq woman-temp-indent left-margin)
4397 (woman-set-arg 'woman-temp-indent)
4398 (woman2-format-paragraphs to nil))
4401 ;;; Tabs, Leaders, and Fields:
4403 (defun woman2-ta (to)
4404 ".ta Nt ... -- Set tabs, left type, unless t=R(right), C(centered).
4405 \(Breaks, but should not.) The tab stops are separated by spaces\;
4406 a value preceded by + represents an increment to the previous stop value.
4407 Format paragraphs upto TO."
4408 (setq tab-stop-list nil)
4409 (woman2-process-escapes-to-eol 'numeric)
4413 (let ((plus (cond ((eq (following-char) ?+) (forward-char 1) t)))
4414 (i (woman-parse-numeric-arg)))
4415 (setq tab-stop (if plus (+ tab-stop i) i)))
4416 (if (memq (following-char) '(?R ?C))
4417 (setq tab-stop (cons tab-stop (following-char))))
4418 (setq tab-stop-list (cons tab-stop tab-stop-list))
4419 (skip-syntax-forward "^ ") ; skip following R, C, `;', etc.
4420 (skip-chars-forward " \t")
4422 (woman-delete-line 1) ; ignore any remaining arguments
4423 (setq tab-stop-list (reverse tab-stop-list))
4424 (woman2-format-paragraphs to))
4426 (defsubst woman-get-tab-stop (tab-stop-list)
4427 "If TAB-STOP-LIST is a cons, return its car, else return TAB-STOP-LIST."
4428 (if (consp tab-stop-list) (car tab-stop-list) tab-stop-list))
4430 (defun woman-tab-to-tab-stop ()
4431 "Insert spaces to next defined tab-stop column.
4432 The variable `tab-stop-list' is a list whose elements are either left
4433 tab stop columns or pairs (COLUMN . TYPE) where TYPE is R or C."
4434 ;; Based on tab-to-tab-stop in indent.el.
4435 ;; R & C tabs probably not quite right!
4436 (delete-backward-char 1)
4437 (let ((tabs tab-stop-list))
4438 (while (and tabs (>= (current-column)
4439 (woman-get-tab-stop (car tabs))))
4440 (setq tabs (cdr tabs)))
4442 (let* ((tab (car tabs))
4443 (type (and (consp tab) (cdr tab)))
4446 (setq tab (woman-get-tab-stop tab)
4447 eol (save-excursion (end-of-line) (point))
4449 (search-forward "\t" eol t))
4450 n (- (if n (1- n) eol) (point))
4451 tab (- tab (if (eq type ?C) (/ n 2) n))) )
4452 (setq n (- tab (current-column)))
4453 (insert-char ?\s n))
4456 (defun woman2-DT (to)
4457 ".DT -- Restore default tabs. Format paragraphs upto TO.
4458 \(Breaks, but should not.)"
4459 ;; Currently just terminates special tab processing.
4460 (setq tab-stop-list nil)
4461 (woman-delete-line 1) ; ignore any arguments
4462 (woman2-format-paragraphs to))
4464 (defun woman2-fc (to)
4465 ".fc a b -- Set field delimiter a and pad character b.
4466 Format paragraphs upto TO.
4467 A VERY FIRST ATTEMPT to make fields at least readable!
4468 Needs doing properly!"
4470 (woman-delete-whole-line) ; ignore!
4471 (let ((delim (following-char))
4472 (pad ?\ ) end) ; pad defaults to space
4474 (skip-chars-forward " \t")
4475 (or (eolp) (setq pad (following-char)))
4476 (woman-delete-whole-line)
4478 (if (re-search-forward "^[.'][ \t]*fc\\s " nil t)
4479 (setq end (match-beginning 0))))
4480 ;; A field is contained between a pair of field delimiter
4481 ;; characters and consists of sub-strings separated by padding
4482 ;; indicator characters:
4483 (setq delim (string delim ?[ ?^ delim ?] ?* delim))
4485 (while (re-search-forward delim end t)
4486 (goto-char (match-beginning 0))
4488 (insert woman-unpadded-space-char)
4489 (goto-char (match-end 0))
4490 (delete-backward-char 1)
4491 (insert-before-markers woman-unpadded-space-char)
4492 (subst-char-in-region
4493 (match-beginning 0) (match-end 0)
4494 pad woman-unpadded-space-char t)
4497 (woman2-format-paragraphs to))
4500 ;;; Preliminary table support (.TS/.TE)
4502 (defun woman2-TS (to)
4503 ".TS -- Start of table code for the tbl processor.
4504 Format paragraphs upto TO."
4505 ;; This is a preliminary hack that seems to suffice for lilo.8.
4506 (woman-delete-line 1) ; ignore any arguments
4507 (when woman-emulate-tbl
4508 ;; Assumes column separator is \t and intercolumn spacing is 3.
4509 ;; The first line may optionally be a list of options terminated by
4510 ;; a semicolon. Currently, just delete it:
4511 (if (looking-at ".*;[ \t]*$") (woman-delete-line 1)) ;
4512 ;; The following lines must specify the format of each line of the
4513 ;; table and end with a period. Currently, just delete them:
4514 (while (not (looking-at ".*\\.[ \t]*$")) (woman-delete-line 1))
4515 (woman-delete-line 1)
4516 ;; For each column, find its width and align it:
4517 (let ((start (point)) (col 1))
4518 (while (prog1 (search-forward "\t" to t) (goto-char start))
4519 ;; Find current column width:
4520 (while (< (point) to)
4521 (when (search-forward "\t" to t)
4523 (if (> (current-column) col) (setq col (current-column))))
4525 ;; Align current column:
4527 (setq col (+ col 3)) ; intercolumn space
4528 (while (< (point) to)
4529 (when (search-forward "\t" to t)
4531 (insert-char ?\ (- col (current-column))))
4533 (goto-char start))))
4534 ;; Format table with no filling or adjusting (cf. woman2-nf):
4535 (setq woman-nofill t)
4536 (woman2-format-paragraphs to))
4538 (defalias 'woman2-TE 'woman2-fi)
4539 ;; ".TE -- End of table code for the tbl processor."
4540 ;; Turn filling and adjusting back on.
4543 ;;; WoMan message logging:
4545 ;; The basis for this logging code was shamelessly pirated from bytecomp.el
4546 ;; by Jamie Zawinski <jwz@lucid.com> & Hallvard Furuseth <hbf@ulrik.uio.no>
4548 (defvar WoMan-current-file nil) ; bound in woman-really-find-file
4549 (defvar WoMan-Log-header-point-max nil)
4551 (defun WoMan-log-begin ()
4552 "Log the beginning of formatting in *WoMan-Log*."
4553 (let ((WoMan-current-buffer (buffer-name)))
4554 (with-current-buffer (get-buffer-create "*WoMan-Log*")
4555 (or (eq major-mode 'view-mode) (view-mode 1))
4556 (setq buffer-read-only nil)
4557 (goto-char (point-max))
4558 (insert "\n\^L\nFormatting "
4559 (if (stringp WoMan-current-file)
4560 (concat "file " WoMan-current-file)
4561 (concat "buffer " WoMan-current-buffer))
4562 " at " (current-time-string) "\n")
4563 (setq WoMan-Log-header-point-max (point-max))
4566 (defun WoMan-log (format &rest args)
4567 "Log a message out of FORMAT control string and optional ARGS."
4568 (WoMan-log-1 (apply 'format format args)))
4570 (defun WoMan-warn (format &rest args)
4571 "Log a warning message out of FORMAT control string and optional ARGS."
4572 (setq format (apply 'format format args))
4573 (WoMan-log-1 (concat "** " format)))
4575 (defun WoMan-warn-ignored (request ignored)
4576 "Log a warning message about ignored directive REQUEST.
4577 IGNORED is a string appended to the log message."
4579 (buffer-substring (point)
4580 (save-excursion (end-of-line) (point)))))
4581 (if (and (> (length tail) 0)
4582 (/= (string-to-char tail) ?\ ))
4583 (setq tail (concat " " tail)))
4585 (concat "** " request tail " request " ignored))))
4587 (defun WoMan-log-end (time)
4588 "Log the end of formatting in *WoMan-Log*.
4589 TIME specifies the time it took to format the man page, to be printed
4591 (WoMan-log-1 (format "Formatting time %d seconds." time) 'end))
4593 (defun WoMan-log-1 (string &optional end)
4594 "Log a message STRING in *WoMan-Log*.
4595 If optional argument END is non-nil then make buffer read-only after
4596 logging the message."
4597 (with-current-buffer (get-buffer-create "*WoMan-Log*")
4598 (setq buffer-read-only nil)
4599 (goto-char (point-max))
4600 (or end (insert " ")) (insert string "\n")
4602 (setq buffer-read-only t)
4604 (select-window ; to return to
4605 (prog1 (selected-window) ; WoMan window
4606 (select-window (display-buffer (current-buffer)))
4607 (cond (WoMan-Log-header-point-max
4608 (goto-char WoMan-Log-header-point-max)
4612 nil) ; for woman-file-readable-p etc.
4616 ;; arch-tag: eea35e90-552f-4712-a94b-d9ffd3db7651
4617 ;;; woman.el ends here