aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2001-03-05 15:11:21 +0000
committerEli Zaretskii2001-03-05 15:11:21 +0000
commita42bec1cd71841ff6881780c0d88aeeb7463469c (patch)
treef3b1a51f52cd17d536f8ad90ba6e44a582ee082a
parent00566ee6a6159b5c02f2ba663b7c34d8c00615e8 (diff)
downloademacs-a42bec1cd71841ff6881780c0d88aeeb7463469c.tar.gz
emacs-a42bec1cd71841ff6881780c0d88aeeb7463469c.zip
Fix the Copyright notices. Change UN*X -> Unix and -- -> ---.
-rw-r--r--man/woman.texi126
1 files changed, 61 insertions, 65 deletions
diff --git a/man/woman.texi b/man/woman.texi
index 46cad4b133d..2607e8a14b8 100644
--- a/man/woman.texi
+++ b/man/woman.texi
@@ -1,10 +1,10 @@
1\input texinfo @c -*-texinfo-*- 1\input texinfo @c -*-texinfo-*-
2@c $Id: woman.texi,v 1.5 2001/02/17 16:58:25 rms Exp $ 2@c $Id: woman.texi,v 1.6 2001/03/04 07:14:22 rms Exp $
3@c %**start of header 3@c %**start of header
4@setfilename ../info/woman 4@setfilename ../info/woman
5@settitle WoMan: Browse UN*X Manual Pages ``Wo (without) Man'' 5@settitle WoMan: Browse Unix Manual Pages ``Wo (without) Man''
6@c Manual last updated: 6@c Manual last updated:
7@set UPDATED Time-stamp: <2000-08-08 12:20:51 eliz> 7@set UPDATED Time-stamp: <2001-03-05 17:10:30 eliz>
8@c Software version: 8@c Software version:
9@set VERSION 0.54 (beta) 9@set VERSION 0.54 (beta)
10@afourpaper 10@afourpaper
@@ -20,40 +20,34 @@
20@end direntry 20@end direntry
21 21
22@ifinfo 22@ifinfo
23This file documents WoMan: A program to browse UN*X manual pages `wo 23This file documents WoMan: A program to browse Unix manual pages `wo
24(without) man'. 24(without) man'.
25 25
26Copyright @copyright{} 2000 Free Software Foundation, Inc. 26Copyright @copyright{} 2001 Free Software Foundation, Inc.
27 27
28This manual and the software that it describes are subject to the GNU 28Permission is granted to copy, distribute and/or modify this document
29General Public License that is distributed with GNU Emacs -- see the 29under the terms of the GNU Free Documentation License, Version 1.1 or
30file @file{COPYING}. 30any later version published by the Free Software Foundation; with no
31Invariant Sections, with the Front-Cover texts being ``A GNU
32Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the
33license is included in the section entitled ``GNU Free Documentation
34License'' in the Emacs manual.
31 35
32Permission is granted to make and distribute verbatim copies of this 36(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
33manual provided the copyright notice and this permission notice are 37this GNU Manual, like GNU software. Copies published by the Free
34preserved on all copies. 38Software Foundation raise funds for GNU development.''
35 39
36@ignore 40This document is part of a collection distributed under the GNU Free
37Permission is granted to process this file through TeX and print the 41Documentation License. If you want to distribute this document
38results, provided the printed document carries a copying permission 42separately from the collection, you can do so by adding a copy of the
39notice identical to this one except for the removal of this paragraph 43license to the document, as described in section 6 of the license.
40(this paragraph not being relevant to the printed manual).
41
42@end ignore
43Permission is granted to copy and distribute modified versions of this
44manual under the conditions for verbatim copying and provided that the
45entire resulting derived work is distributed under the terms of a
46permission notice identical to this one.
47
48Permission is granted to copy and distribute translations of this manual
49into another language, under the above conditions for modified versions.
50@end ifinfo 44@end ifinfo
51 45
52@finalout 46@finalout
53 47
54@titlepage 48@titlepage
55@title WoMan 49@title WoMan
56@subtitle Browse UN*X Manual Pages ``Wo (without) Man'' 50@subtitle Browse Unix Manual Pages ``Wo (without) Man''
57@subtitle Software Version @value{VERSION} 51@subtitle Software Version @value{VERSION}
58@author Francis J. Wright 52@author Francis J. Wright
59@sp 2 53@sp 2
@@ -69,23 +63,25 @@ into another language, under the above conditions for modified versions.
69@comment The following two commands start the copyright page. 63@comment The following two commands start the copyright page.
70@page 64@page
71@vskip 0pt plus 1filll 65@vskip 0pt plus 1filll
72Copyright @copyright{} 2000 Francis J. Wright 66@noindent
73 67Copyright @copyright{} 2001 Free Software Foundation, Inc.
74This manual and the software that it describes are subject to the GNU 68
75General Public License that is distributed with GNU Emacs -- see the 69Permission is granted to copy, distribute and/or modify this document
76file @file{COPYING}. 70under the terms of the GNU Free Documentation License, Version 1.1 or
77 71any later version published by the Free Software Foundation; with no
78Permission is granted to make and distribute verbatim copies of this 72Invariant Sections, with the Front-Cover texts being ``A GNU
79manual provided the copyright notice and this permission notice are 73Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
80preserved on all copies. 74license is included in the section entitled ``GNU Free Documentation
81 75License'' in the Emacs manual.
82Permission is granted to copy and distribute modified versions of this 76
83manual under the conditions for verbatim copying and provided that the 77(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
84entire resulting derived work is distributed under the terms of a 78this GNU Manual, like GNU software. Copies published by the Free
85permission notice identical to this one. 79Software Foundation raise funds for GNU development.''
86 80
87Permission is granted to copy and distribute translations of this manual 81This document is part of a collection distributed under the GNU Free
88into another language, under the above conditions for modified versions. 82Documentation License. If you want to distribute this document
83separately from the collection, you can do so by adding a copy of the
84license to the document, as described in section 6 of the license.
89@end titlepage 85@end titlepage
90 86
91@contents 87@contents
@@ -95,7 +91,7 @@ into another language, under the above conditions for modified versions.
95@ifnottex 91@ifnottex
96@node Top, Introduction, (dir), (dir) 92@node Top, Introduction, (dir), (dir)
97@comment node-name, next, previous, up 93@comment node-name, next, previous, up
98@top WoMan: Browse UN*X Manual Pages ``Wo (without) Man'' 94@top WoMan: Browse Unix Manual Pages ``Wo (without) Man''
99 95
100@display 96@display
101Software Version @value{VERSION} 97Software Version @value{VERSION}
@@ -143,7 +139,7 @@ documentation files are available from
143@uref{http://centaur.maths.qmw.ac.uk/Emacs/WoMan/, my web server}. 139@uref{http://centaur.maths.qmw.ac.uk/Emacs/WoMan/, my web server}.
144 140
145WoMan implements a subset of the formatting performed by the Emacs 141WoMan implements a subset of the formatting performed by the Emacs
146@code{man} (or @code{manual-entry}) command to format a UN*X-style 142@code{man} (or @code{manual-entry}) command to format a Unix-style
147@dfn{manual page} (usually abbreviated to @dfn{man page}) for display, 143@dfn{manual page} (usually abbreviated to @dfn{man page}) for display,
148but without calling any external programs. It is intended to emulate 144but without calling any external programs. It is intended to emulate
149the whole of the @code{ROFF -man} macro package, plus those @code{ROFF} 145the whole of the @code{ROFF -man} macro package, plus those @code{ROFF}
@@ -181,7 +177,7 @@ either running the command @code{woman-mini-help} or selecting the WoMan
181menu option @samp{Mini Help}. 177menu option @samp{Mini Help}.
182 178
183WoMan is (of course) still under development! Please 179WoMan is (of course) still under development! Please
184@email{F.J.Wright@@qmw.ac.uk, let me know} what doesn't work -- I am 180@email{F.J.Wright@@qmw.ac.uk, let me know} what doesn't work---I am
185adding and improving functionality as testing shows that it is 181adding and improving functionality as testing shows that it is
186necessary. Guidance on reporting bugs is given below. @xref{Bugs, , 182necessary. Guidance on reporting bugs is given below. @xref{Bugs, ,
187Reporting Bugs}. 183Reporting Bugs}.
@@ -193,10 +189,10 @@ Reporting Bugs}.
193@chapter Background 189@chapter Background
194@cindex background 190@cindex background
195 191
196WoMan is a browser for traditional UN*X-style manual page documentation. 192WoMan is a browser for traditional Unix-style manual page documentation.
197Each such document is conventionally referred to as a @dfn{manual page}, 193Each such document is conventionally referred to as a @dfn{manual page},
198or @dfn{man page} for short, even though some are very much longer than 194or @dfn{man page} for short, even though some are very much longer than
199one page. A man page is a document written using the UN*X ``man'' 195one page. A man page is a document written using the Unix ``man''
200macros, which are themselves written in the NROFF/TROFF text processing 196macros, which are themselves written in the NROFF/TROFF text processing
201markup language. @code{NROFF} and @code{TROFF} are text processors 197markup language. @code{NROFF} and @code{TROFF} are text processors
202originally written for the UNIX operating system by Joseph F. Ossanna at 198originally written for the UNIX operating system by Joseph F. Ossanna at
@@ -229,7 +225,7 @@ most screens now support bit-mapped displays, so that any information
229that can be printed can also be rendered on screen, the only difference 225that can be printed can also be rendered on screen, the only difference
230being the resolution. 226being the resolution.
231 227
232Nevertheless, UN*X-style manual page documentation is still normally 228Nevertheless, Unix-style manual page documentation is still normally
233browsed on screen by running a program called @code{man}. This program 229browsed on screen by running a program called @code{man}. This program
234looks in a predefined set of directories for the man page matching a 230looks in a predefined set of directories for the man page matching a
235specified topic, then either formats the source file by running 231specified topic, then either formats the source file by running
@@ -267,9 +263,9 @@ decompression facility, which does call an external program.
267 263
268I began developing WoMan in the Spring of 1997 and the first version was 264I began developing WoMan in the Spring of 1997 and the first version was
269released in May 1997. The original motivation for WoMan was the fact 265released in May 1997. The original motivation for WoMan was the fact
270that many GNU and UN*X programs are ported to other platforms and come 266that many GNU and Unix programs are ported to other platforms and come
271with UN*X-style manual page documentation. This may be difficult to 267with Unix-style manual page documentation. This may be difficult to
272read because ports of the UN*X-style @code{man} program can be a little 268read because ports of the Unix-style @code{man} program can be a little
273awkward to set up. I decided that it should not be too hard to emulate 269awkward to set up. I decided that it should not be too hard to emulate
274the 20 @code{man} macros directly, without treating them as macros and 270the 20 @code{man} macros directly, without treating them as macros and
275largely ignoring the underlying @code{ROFF} requests, given the text 271largely ignoring the underlying @code{ROFF} requests, given the text
@@ -398,9 +394,9 @@ add these autoloads to your @file{.emacs} file:
398 394
399@lisp 395@lisp
400(autoload 'woman "woman" 396(autoload 'woman "woman"
401 "Decode and browse a UN*X man page." t) 397 "Decode and browse a Unix man page." t)
402(autoload 'woman-find-file "woman" 398(autoload 'woman-find-file "woman"
403 "Find, decode and browse a specific UN*X man-page file." t) 399 "Find, decode and browse a specific Unix man-page file." t)
404(autoload 'woman-dired-find-file "woman" 400(autoload 'woman-dired-find-file "woman"
405 "In dired, run the WoMan man-page browser on this file." t) 401 "In dired, run the WoMan man-page browser on this file." t)
406@end lisp 402@end lisp
@@ -743,7 +739,7 @@ all (provided WoMan is installed and loaded or set up to autoload).
743This command can be used to browse any accessible man file, regardless 739This command can be used to browse any accessible man file, regardless
744of its filename or location. If the file is compressed then automatic 740of its filename or location. If the file is compressed then automatic
745file decompression must already be turned on (e.g.@: see the 741file decompression must already be turned on (e.g.@: see the
746@samp{Help->Options} submenu) -- it is turned on automatically only by 742@samp{Help->Options} submenu)---it is turned on automatically only by
747the @code{woman} topic interface. 743the @code{woman} topic interface.
748 744
749@findex woman-dired-find-file 745@findex woman-dired-find-file
@@ -794,7 +790,7 @@ is not really supported. It originated during early experiments on how
794best to implement WoMan, before I implemented the current topic 790best to implement WoMan, before I implemented the current topic
795interface, and I subsequently stopped using it. I might revive it as a 791interface, and I subsequently stopped using it. I might revive it as a
796mechanism for storing pre-formatted WoMan files, somewhat analogous to 792mechanism for storing pre-formatted WoMan files, somewhat analogous to
797the standard UN*X @code{catman} facility. In the meantime, it exists 793the standard Unix @code{catman} facility. In the meantime, it exists
798for anyone who wants to experiment with it. Once it is set up it is 794for anyone who wants to experiment with it. Once it is set up it is
799simply a question of visiting the file and there is no WoMan-specific 795simply a question of visiting the file and there is no WoMan-specific
800user interface! 796user interface!
@@ -807,7 +803,7 @@ by automatic major mode selection.]
807(autoload 'woman-decode-region "woman") 803(autoload 'woman-decode-region "woman")
808 804
809(add-to-list 'format-alist 805(add-to-list 'format-alist
810 '(man "UN*X man-page source format" "\\.\\(TH\\|ig\\) " 806 '(man "Unix man-page source format" "\\.\\(TH\\|ig\\) "
811 woman-decode-region nil nil 807 woman-decode-region nil nil
812 (lambda (arg) 808 (lambda (arg)
813 set-visited-file-name 809 set-visited-file-name
@@ -887,12 +883,12 @@ Scroll the man page down the window (@code{scroll-down}).
887@item n 883@item n
888@kindex n 884@kindex n
889@findex Man-next-section 885@findex Man-next-section
890Move point to the Nth next section -- default 1 (@code{Man-next-section}). 886Move point to the Nth next section---default 1 (@code{Man-next-section}).
891 887
892@item p 888@item p
893@kindex p 889@kindex p
894@findex Man-previous-section 890@findex Man-previous-section
895Move point to Nth previous section -- default 1 891Move point to Nth previous section---default 1
896(@code{Man-previous-section}). 892(@code{Man-previous-section}).
897 893
898@item g 894@item g
@@ -1171,7 +1167,7 @@ set but a configuration file is found then it is parsed instead (or as
1171well) to provide a default value for @code{woman-manpath}. 1167well) to provide a default value for @code{woman-manpath}.
1172 1168
1173@item woman-manpath 1169@item woman-manpath
1174A list of strings representing @emph{directory trees} to search for UN*X 1170A list of strings representing @emph{directory trees} to search for Unix
1175manual files. Each element should be the name of a directory that 1171manual files. Each element should be the name of a directory that
1176contains subdirectories of the form @file{man?}, or more precisely 1172contains subdirectories of the form @file{man?}, or more precisely
1177subdirectories selected by the value of @code{woman-manpath-man-regexp}. 1173subdirectories selected by the value of @code{woman-manpath-man-regexp}.
@@ -1191,7 +1187,7 @@ is
1191("/usr/man" "/usr/local/man") 1187("/usr/man" "/usr/local/man")
1192@end lisp 1188@end lisp
1193 1189
1194Any environment variables (names of which must have the UN*X-style form 1190Any environment variables (names of which must have the Unix-style form
1195@code{$NAME}, e.g.@: @code{$HOME}, @code{$EMACSDATA}, @code{$EMACS_DIR}, 1191@code{$NAME}, e.g.@: @code{$HOME}, @code{$EMACSDATA}, @code{$EMACS_DIR},
1196regardless of platform) are evaluated first but each element must 1192regardless of platform) are evaluated first but each element must
1197evaluate to a @emph{single} directory name. Trailing @file{/}s are 1193evaluate to a @emph{single} directory name. Trailing @file{/}s are
@@ -1207,7 +1203,7 @@ e.g.
1207@cindex directory separator character 1203@cindex directory separator character
1208@cindex @code{MANPATH}, directory separator 1204@cindex @code{MANPATH}, directory separator
1209The @code{MANPATH} environment variable may be set using DOS 1205The @code{MANPATH} environment variable may be set using DOS
1210semi-colon-separated or UN*X / Cygwin colon-separated syntax (but not 1206semi-colon-separated or Unix-style colon-separated syntax (but not
1211mixed). 1207mixed).
1212 1208
1213@item woman-manpath-man-regexp 1209@item woman-manpath-man-regexp
@@ -1220,7 +1216,7 @@ purpose is to avoid directories such as @file{cat?}, @file{.},
1220 1216
1221@item woman-path 1217@item woman-path
1222A list of strings representing @emph{specific directories} to search for 1218A list of strings representing @emph{specific directories} to search for
1223UN*X manual files. For example 1219Unix manual files. For example
1224 1220
1225@lisp 1221@lisp
1226("/emacs/etc") 1222("/emacs/etc")
@@ -1241,7 +1237,7 @@ and unreadable files are ignored. The default value on MS-DOS is
1241@noindent 1237@noindent
1242and on other platforms is @code{nil}. 1238and on other platforms is @code{nil}.
1243 1239
1244Any environment variables (names of which must have the UN*X-style form 1240Any environment variables (names of which must have the Unix-style form
1245@code{$NAME}, e.g.@: @code{$HOME}, @code{$EMACSDATA}, @code{$EMACS_DIR}, 1241@code{$NAME}, e.g.@: @code{$HOME}, @code{$EMACSDATA}, @code{$EMACS_DIR},
1246regardless of platform) are evaluated first but each element must 1242regardless of platform) are evaluated first but each element must
1247evaluate to a @emph{single} directory name (regexp, see above). For 1243evaluate to a @emph{single} directory name (regexp, see above). For
@@ -1302,7 +1298,7 @@ automatically define @kbd{w} and @kbd{W} if they are unbound, or
1302 1298
1303@item woman-imenu-generic-expression 1299@item woman-imenu-generic-expression
1304Imenu support for Sections and Subsections: an alist with elements of 1300Imenu support for Sections and Subsections: an alist with elements of
1305the form @code{(MENU-TITLE REGEXP INDEX)} -- see the documentation for 1301the form @code{(MENU-TITLE REGEXP INDEX)}---see the documentation for
1306@code{imenu-generic-expression}. Default value is 1302@code{imenu-generic-expression}. Default value is
1307 1303
1308@lisp 1304@lisp