diff options
| author | Eli Zaretskii | 2001-03-05 15:11:21 +0000 |
|---|---|---|
| committer | Eli Zaretskii | 2001-03-05 15:11:21 +0000 |
| commit | a42bec1cd71841ff6881780c0d88aeeb7463469c (patch) | |
| tree | f3b1a51f52cd17d536f8ad90ba6e44a582ee082a | |
| parent | 00566ee6a6159b5c02f2ba663b7c34d8c00615e8 (diff) | |
| download | emacs-a42bec1cd71841ff6881780c0d88aeeb7463469c.tar.gz emacs-a42bec1cd71841ff6881780c0d88aeeb7463469c.zip | |
Fix the Copyright notices. Change UN*X -> Unix and -- -> ---.
| -rw-r--r-- | man/woman.texi | 126 |
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 |
| 23 | This file documents WoMan: A program to browse UN*X manual pages `wo | 23 | This file documents WoMan: A program to browse Unix manual pages `wo |
| 24 | (without) man'. | 24 | (without) man'. |
| 25 | 25 | ||
| 26 | Copyright @copyright{} 2000 Free Software Foundation, Inc. | 26 | Copyright @copyright{} 2001 Free Software Foundation, Inc. |
| 27 | 27 | ||
| 28 | This manual and the software that it describes are subject to the GNU | 28 | Permission is granted to copy, distribute and/or modify this document |
| 29 | General Public License that is distributed with GNU Emacs -- see the | 29 | under the terms of the GNU Free Documentation License, Version 1.1 or |
| 30 | file @file{COPYING}. | 30 | any later version published by the Free Software Foundation; with no |
| 31 | Invariant Sections, with the Front-Cover texts being ``A GNU | ||
| 32 | Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the | ||
| 33 | license is included in the section entitled ``GNU Free Documentation | ||
| 34 | License'' in the Emacs manual. | ||
| 31 | 35 | ||
| 32 | Permission 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 |
| 33 | manual provided the copyright notice and this permission notice are | 37 | this GNU Manual, like GNU software. Copies published by the Free |
| 34 | preserved on all copies. | 38 | Software Foundation raise funds for GNU development.'' |
| 35 | 39 | ||
| 36 | @ignore | 40 | This document is part of a collection distributed under the GNU Free |
| 37 | Permission is granted to process this file through TeX and print the | 41 | Documentation License. If you want to distribute this document |
| 38 | results, provided the printed document carries a copying permission | 42 | separately from the collection, you can do so by adding a copy of the |
| 39 | notice identical to this one except for the removal of this paragraph | 43 | license 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 | ||
| 43 | Permission is granted to copy and distribute modified versions of this | ||
| 44 | manual under the conditions for verbatim copying and provided that the | ||
| 45 | entire resulting derived work is distributed under the terms of a | ||
| 46 | permission notice identical to this one. | ||
| 47 | |||
| 48 | Permission is granted to copy and distribute translations of this manual | ||
| 49 | into 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 |
| 72 | Copyright @copyright{} 2000 Francis J. Wright | 66 | @noindent |
| 73 | 67 | Copyright @copyright{} 2001 Free Software Foundation, Inc. | |
| 74 | This manual and the software that it describes are subject to the GNU | 68 | |
| 75 | General Public License that is distributed with GNU Emacs -- see the | 69 | Permission is granted to copy, distribute and/or modify this document |
| 76 | file @file{COPYING}. | 70 | under the terms of the GNU Free Documentation License, Version 1.1 or |
| 77 | 71 | any later version published by the Free Software Foundation; with no | |
| 78 | Permission is granted to make and distribute verbatim copies of this | 72 | Invariant Sections, with the Front-Cover texts being ``A GNU |
| 79 | manual provided the copyright notice and this permission notice are | 73 | Manual'', and with the Back-Cover Texts as in (a) below. A copy of the |
| 80 | preserved on all copies. | 74 | license is included in the section entitled ``GNU Free Documentation |
| 81 | 75 | License'' in the Emacs manual. | |
| 82 | Permission is granted to copy and distribute modified versions of this | 76 | |
| 83 | manual 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 |
| 84 | entire resulting derived work is distributed under the terms of a | 78 | this GNU Manual, like GNU software. Copies published by the Free |
| 85 | permission notice identical to this one. | 79 | Software Foundation raise funds for GNU development.'' |
| 86 | 80 | ||
| 87 | Permission is granted to copy and distribute translations of this manual | 81 | This document is part of a collection distributed under the GNU Free |
| 88 | into another language, under the above conditions for modified versions. | 82 | Documentation License. If you want to distribute this document |
| 83 | separately from the collection, you can do so by adding a copy of the | ||
| 84 | license 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 |
| 101 | Software Version @value{VERSION} | 97 | Software 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 | ||
| 145 | WoMan implements a subset of the formatting performed by the Emacs | 141 | WoMan 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, |
| 148 | but without calling any external programs. It is intended to emulate | 144 | but without calling any external programs. It is intended to emulate |
| 149 | the whole of the @code{ROFF -man} macro package, plus those @code{ROFF} | 145 | the 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 | |||
| 181 | menu option @samp{Mini Help}. | 177 | menu option @samp{Mini Help}. |
| 182 | 178 | ||
| 183 | WoMan is (of course) still under development! Please | 179 | WoMan 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 |
| 185 | adding and improving functionality as testing shows that it is | 181 | adding and improving functionality as testing shows that it is |
| 186 | necessary. Guidance on reporting bugs is given below. @xref{Bugs, , | 182 | necessary. Guidance on reporting bugs is given below. @xref{Bugs, , |
| 187 | Reporting Bugs}. | 183 | Reporting Bugs}. |
| @@ -193,10 +189,10 @@ Reporting Bugs}. | |||
| 193 | @chapter Background | 189 | @chapter Background |
| 194 | @cindex background | 190 | @cindex background |
| 195 | 191 | ||
| 196 | WoMan is a browser for traditional UN*X-style manual page documentation. | 192 | WoMan is a browser for traditional Unix-style manual page documentation. |
| 197 | Each such document is conventionally referred to as a @dfn{manual page}, | 193 | Each such document is conventionally referred to as a @dfn{manual page}, |
| 198 | or @dfn{man page} for short, even though some are very much longer than | 194 | or @dfn{man page} for short, even though some are very much longer than |
| 199 | one page. A man page is a document written using the UN*X ``man'' | 195 | one page. A man page is a document written using the Unix ``man'' |
| 200 | macros, which are themselves written in the NROFF/TROFF text processing | 196 | macros, which are themselves written in the NROFF/TROFF text processing |
| 201 | markup language. @code{NROFF} and @code{TROFF} are text processors | 197 | markup language. @code{NROFF} and @code{TROFF} are text processors |
| 202 | originally written for the UNIX operating system by Joseph F. Ossanna at | 198 | originally 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 | |||
| 229 | that can be printed can also be rendered on screen, the only difference | 225 | that can be printed can also be rendered on screen, the only difference |
| 230 | being the resolution. | 226 | being the resolution. |
| 231 | 227 | ||
| 232 | Nevertheless, UN*X-style manual page documentation is still normally | 228 | Nevertheless, Unix-style manual page documentation is still normally |
| 233 | browsed on screen by running a program called @code{man}. This program | 229 | browsed on screen by running a program called @code{man}. This program |
| 234 | looks in a predefined set of directories for the man page matching a | 230 | looks in a predefined set of directories for the man page matching a |
| 235 | specified topic, then either formats the source file by running | 231 | specified topic, then either formats the source file by running |
| @@ -267,9 +263,9 @@ decompression facility, which does call an external program. | |||
| 267 | 263 | ||
| 268 | I began developing WoMan in the Spring of 1997 and the first version was | 264 | I began developing WoMan in the Spring of 1997 and the first version was |
| 269 | released in May 1997. The original motivation for WoMan was the fact | 265 | released in May 1997. The original motivation for WoMan was the fact |
| 270 | that many GNU and UN*X programs are ported to other platforms and come | 266 | that many GNU and Unix programs are ported to other platforms and come |
| 271 | with UN*X-style manual page documentation. This may be difficult to | 267 | with Unix-style manual page documentation. This may be difficult to |
| 272 | read because ports of the UN*X-style @code{man} program can be a little | 268 | read because ports of the Unix-style @code{man} program can be a little |
| 273 | awkward to set up. I decided that it should not be too hard to emulate | 269 | awkward to set up. I decided that it should not be too hard to emulate |
| 274 | the 20 @code{man} macros directly, without treating them as macros and | 270 | the 20 @code{man} macros directly, without treating them as macros and |
| 275 | largely ignoring the underlying @code{ROFF} requests, given the text | 271 | largely 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). | |||
| 743 | This command can be used to browse any accessible man file, regardless | 739 | This command can be used to browse any accessible man file, regardless |
| 744 | of its filename or location. If the file is compressed then automatic | 740 | of its filename or location. If the file is compressed then automatic |
| 745 | file decompression must already be turned on (e.g.@: see the | 741 | file 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 |
| 747 | the @code{woman} topic interface. | 743 | the @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 | |||
| 794 | best to implement WoMan, before I implemented the current topic | 790 | best to implement WoMan, before I implemented the current topic |
| 795 | interface, and I subsequently stopped using it. I might revive it as a | 791 | interface, and I subsequently stopped using it. I might revive it as a |
| 796 | mechanism for storing pre-formatted WoMan files, somewhat analogous to | 792 | mechanism for storing pre-formatted WoMan files, somewhat analogous to |
| 797 | the standard UN*X @code{catman} facility. In the meantime, it exists | 793 | the standard Unix @code{catman} facility. In the meantime, it exists |
| 798 | for anyone who wants to experiment with it. Once it is set up it is | 794 | for anyone who wants to experiment with it. Once it is set up it is |
| 799 | simply a question of visiting the file and there is no WoMan-specific | 795 | simply a question of visiting the file and there is no WoMan-specific |
| 800 | user interface! | 796 | user 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 |
| 890 | Move point to the Nth next section -- default 1 (@code{Man-next-section}). | 886 | Move 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 |
| 895 | Move point to Nth previous section -- default 1 | 891 | Move 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 | |||
| 1171 | well) to provide a default value for @code{woman-manpath}. | 1167 | well) to provide a default value for @code{woman-manpath}. |
| 1172 | 1168 | ||
| 1173 | @item woman-manpath | 1169 | @item woman-manpath |
| 1174 | A list of strings representing @emph{directory trees} to search for UN*X | 1170 | A list of strings representing @emph{directory trees} to search for Unix |
| 1175 | manual files. Each element should be the name of a directory that | 1171 | manual files. Each element should be the name of a directory that |
| 1176 | contains subdirectories of the form @file{man?}, or more precisely | 1172 | contains subdirectories of the form @file{man?}, or more precisely |
| 1177 | subdirectories selected by the value of @code{woman-manpath-man-regexp}. | 1173 | subdirectories 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 | ||
| 1194 | Any environment variables (names of which must have the UN*X-style form | 1190 | Any 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}, |
| 1196 | regardless of platform) are evaluated first but each element must | 1192 | regardless of platform) are evaluated first but each element must |
| 1197 | evaluate to a @emph{single} directory name. Trailing @file{/}s are | 1193 | evaluate 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 |
| 1209 | The @code{MANPATH} environment variable may be set using DOS | 1205 | The @code{MANPATH} environment variable may be set using DOS |
| 1210 | semi-colon-separated or UN*X / Cygwin colon-separated syntax (but not | 1206 | semi-colon-separated or Unix-style colon-separated syntax (but not |
| 1211 | mixed). | 1207 | mixed). |
| 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 |
| 1222 | A list of strings representing @emph{specific directories} to search for | 1218 | A list of strings representing @emph{specific directories} to search for |
| 1223 | UN*X manual files. For example | 1219 | Unix 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 |
| 1242 | and on other platforms is @code{nil}. | 1238 | and on other platforms is @code{nil}. |
| 1243 | 1239 | ||
| 1244 | Any environment variables (names of which must have the UN*X-style form | 1240 | Any 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}, |
| 1246 | regardless of platform) are evaluated first but each element must | 1242 | regardless of platform) are evaluated first but each element must |
| 1247 | evaluate to a @emph{single} directory name (regexp, see above). For | 1243 | evaluate 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 |
| 1304 | Imenu support for Sections and Subsections: an alist with elements of | 1300 | Imenu support for Sections and Subsections: an alist with elements of |
| 1305 | the form @code{(MENU-TITLE REGEXP INDEX)} -- see the documentation for | 1301 | the 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 |