diff options
Diffstat (limited to 'man')
58 files changed, 1080 insertions, 740 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index 8fe3bcd9484..3981e0c7d25 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,122 @@ +2007-04-23 Jay Belanger <jay.p.belanger@gmail.com> + + * calc.texi (Reporting bugs): Update maintainer's address. + +2007-04-23 Chong Yidong <cyd@stupidchicken.com> + + * display.texi (Highlight Interactively): Correct description of + hi-lock-file-patterns-policy. + + * files.texi (File Archives): Mention self-extracting executables. + +2007-04-23 Eli Zaretskii <eliz@gnu.org> + + * search.texi (Unconditional Replace, Query Replace): Add xref to + "Replacement and Case". + +2007-04-22 Chong Yidong <cyd@stupidchicken.com> + + * dired.texi (Image-Dired): Move from Thumbnails node. + * misc.texi (Thumbnails): Node deleted. + * emacs.texi (Top): Update node listing. + + * files.texi (File Conveniences): + * ack.texi (Acknowledgments): + * faq.texi (New in Emacs 22): Rename "tumme" to "image-dired". + +2007-04-21 Richard Stallman <rms@gnu.org> + + * display.texi (Highlight Interactively): Correct previous change. + Clarify doc of hi-lock-find-patterns, and move new features into it. + +2007-04-20 David Koppelman <koppel@ece.lsu.edu> + + * display.texi (Highlight Interactively): Document + hi-lock-file-patterns-policy. + +2007-04-20 Martin Rudalics <rudalics@gmx.at> + + * display.texi (Scrolling): Fix typo. + +2007-04-15 Jay Belanger <belanger@truman.edu> + + * calc.texi (Title page): Remove the date. + (Basic Arithmetic): Emphasize that / binds less strongly than *. + (The Standard Calc Interface): Change trail title. + (Floats): Mention that when non-decimal floats are entered, only + approximations are stored. + (Copying): Move to the appendices. + (GNU Free Documentation License): Add as an appendix. + +2007-04-15 Chong Yidong <cyd@stupidchicken.com> + + * ada-mode.texi, autotype.texi, cc-mode.texi, cl.texi: + * dired-x.texi, ebrowse.texi, ediff.texi: + * emacs-mime.texi, erc.texi, eshell.texi: + * eudc.texi, flymake.texi, forms.texi, gnus.texi: + * idlwave.texi, message.texi, newsticker.texi, org.texi: + * pcl-cvs.texi, pgg.texi, rcirc.texi, reftex.texi, sc.texi: + * ses.texi, sieve.texi, smtpmail.texi, speedbar.texi: + * tramp.texi, url.texi, vip.texi, viper.texi, widget.texi: + * woman.texi: Include GFDL. + + * doclicense.texi: Remove node heading, so that it can be included by + other files. + + * emacs.texi: Insert node heading for GFDL. + + * dired-x.texi: Relicence under GFDL. Remove date from title page. + + * calc.texi (Algebraic Tutorial): Emphasize that / binds less strongly + than *. + +2007-04-14 Carsten Dominik <dominik@science.uva.nl> + + * org.texi (Formula syntax for Calc): Emphasize the operator precedence + in Calc. + +2007-04-14 Eli Zaretskii <eliz@gnu.org> + + * cmdargs.texi (Colors): Qualify "color of window" index entry by + "command line". + + * display.texi (Faces): Refer to "Creating Frames" for face + and other frame customizations in .emacs. + + * frames.texi (Creating Frames): Mention that face customizations can + be put in .emacs. Add index entries. + +2007-04-12 Richard Stallman <rms@gnu.org> + + * glossary.texi (Glossary): Explain `iff'. + +2007-04-11 Karl Berry <karl@gnu.org> + + * gnu.texi (Top), + * macos.texi (Mac Font Specs), + * anti.texi (Antinews), + * xresources.texi (Resources), + * misc.texi (Emulation), + * calendar.texi (Daylight Saving), + * dired.texi (Dired and Find), + * rmail.texi (Remote Mailboxes), + * sending.texi (Mail Headers), + * programs.texi (Which Function), + * files.texi (Recover), + * buffers.texi (Uniquify), + * frames.texi (Wheeled Mice), + * killing.texi (Rectangles): Wording to improve breaks in + 8.5x11 format. + * mule.texi (Language Environments): \hbadness=10000 since there's + no way to reword. + * emacs.texi (smallbook): New @set to more easily switch between + smallbook and 8.5x11. + +2007-04-11 Richard Stallman <rms@gnu.org> + + * files.texi (File Conveniences): Add xref to Tumme. + Delete text about Thumbnail mode. + 2007-04-09 Romain Francoise <romain@orebokech.com> * faq.texi (New in Emacs 22): Mention improvements to the Windows and diff --git a/man/ack.texi b/man/ack.texi index 51397f0b13f..46213aa8cf5 100644 --- a/man/ack.texi +++ b/man/ack.texi @@ -186,8 +186,8 @@ Doug Cutting and Jamie Zawinski wrote @file{disass.el}, a disassembler for compiled Emacs Lisp code. @item -Mathias Dahl wrote @file{tumme.el}, a package for viewing image files -as ``thumbnails.'' +Mathias Dahl wrote @file{image-dired.el}, a package for viewing image +files as ``thumbnails.'' @item Michael DeCorte wrote @file{emacs.csh}, a C-shell script that starts a diff --git a/man/ada-mode.texi b/man/ada-mode.texi index 7acae36c74f..241149803e8 100644 --- a/man/ada-mode.texi +++ b/man/ada-mode.texi @@ -64,6 +64,7 @@ license to the document, as described in section 6 of the license. * Automatic Casing:: Adjusting the case of words automatically * Statement Templates:: Inserting code templates * Comment Handling:: Reformatting comments easily +* GNU Free Documentation License:: The license for this documentation. * Index:: @end menu @@ -1373,7 +1374,7 @@ exception (@code{ada-exception}). type (@code{ada-type}). @end table -@node Comment Handling, Index, Statement Templates, Top +@node Comment Handling, GNU Free Documentation License, Statement Templates, Top @chapter Comment Handling By default, comment lines get indented like Ada code. There are a few @@ -1392,7 +1393,11 @@ Uncomment the selected region autofill the current comment. @end table -@node Index, , Comment Handling, Top +@node GNU Free Documentation License, Index, Comment Handling, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Index, , GNU Free Documentation License, Top @unnumbered Index @printindex fn diff --git a/man/anti.texi b/man/anti.texi index a0003c012db..ebff1c7677f 100644 --- a/man/anti.texi +++ b/man/anti.texi @@ -53,9 +53,9 @@ command-line option @samp{--no-splash} is therefore obsolete, and has been removed. @item -The command line options @samp{--color}, @samp{--fullwidth}, -@samp{--fullheight}, @samp{--fullscreen}, @samp{--no-blinking-cursor}, -@samp{--no-desktop}, and @samp{-Q} have also been removed. +These command line options have also been removed: @samp{--color}, +@samp{--fullwidth}, @samp{--fullheight}, @samp{--fullscreen}, +@samp{--no-blinking-cursor}, @samp{--no-desktop}, and @samp{-Q}. @item The @samp{--geometry} option applies only to the initial frame, and diff --git a/man/autotype.texi b/man/autotype.texi index a462b7a97a2..7b51f3115ac 100644 --- a/man/autotype.texi +++ b/man/autotype.texi @@ -101,6 +101,7 @@ completions and expansions of text at point. * Tempo:: Flexible template insertion. * Hippie Expand:: Expansion of text trying various methods. +* GNU Free Documentation License:: The license for this documentation. * Concept Index:: * Command Index:: * Variable Index:: @@ -650,6 +651,9 @@ Typically you would bind @code{hippie-expand} to @kbd{M-/} with @code{dabbrev-expand}, the standard binding of @kbd{M-/}, providing one of the expansion possibilities. +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi @node Concept Index @unnumbered Concept Index diff --git a/man/buffers.texi b/man/buffers.texi index ed4b855b684..b43d72b1067 100644 --- a/man/buffers.texi +++ b/man/buffers.texi @@ -573,14 +573,14 @@ names (all but one of them). buffer name. To select one, customize the variable @code{uniquify-buffer-name-style} (@pxref{Easy Customization}). - For instance, the @code{forward} naming method puts part of the -directory name at the beginning of the buffer name; using this method, -buffers visiting @file{/u/rms/tmp/Makefile} and + To begin with, the @code{forward} naming method includes part of the +file's directory name at the beginning of the buffer name; using this +method, buffers visiting the files @file{/u/rms/tmp/Makefile} and @file{/usr/projects/zaphod/Makefile} would be named @samp{tmp/Makefile} and @samp{zaphod/Makefile}, respectively (instead of @samp{Makefile} and @samp{Makefile<2>}). - By contrast, the @code{post-forward} naming method would call the + In contrast, the @code{post-forward} naming method would call the buffers @samp{Makefile|tmp} and @samp{Makefile|zaphod}, and the @code{reverse} naming method would call them @samp{Makefile\tmp} and @samp{Makefile\zaphod}. The nontrivial difference between diff --git a/man/calc.texi b/man/calc.texi index 0544bc1e3b4..ecf85a450bd 100644 --- a/man/calc.texi +++ b/man/calc.texi @@ -92,7 +92,8 @@ under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with the Invariant Sections being just ``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover -Texts as in (a) below. +Texts as in (a) below. A copy of the license is included in the section +entitled ``GNU Free Documentation License.'' (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify this GNU Manual, like GNU software. Copies published by the Free @@ -111,8 +112,6 @@ Software Foundation raise funds for GNU development.'' @sp 4 @center GNU Emacs Calc Version 2.1 @c [volume] -@sp 1 -@center March 2005 @sp 5 @center Dave Gillespie @center daveg@@synaptics.com @@ -126,7 +125,7 @@ Copyright @copyright{} 1990, 1991, 2001, 2002, 2003, 2004, @c [begin] @ifinfo -@node Top, , (dir), (dir) +@node Top, Getting Started, (dir), (dir) @chapter The GNU Emacs Calculator @noindent @@ -145,8 +144,6 @@ longer Info tutorial.) @end ifinfo @menu -* Copying:: How you can copy and share Calc. - * Getting Started:: General description and overview. * Interactive Tutorial:: * Tutorial:: A step-by-step introduction for beginners. @@ -167,7 +164,9 @@ longer Info tutorial.) * Embedded Mode:: Working with formulas embedded in a file. * Programming:: Calc as a programmable calculator. -* Customizing Calc:: Customizing Calc. +* Copying:: How you can copy and share Calc. +* GNU Free Documentation License:: The license for this documentation. +* Customizing Calc:: Customizing Calc. * Reporting Bugs:: How to report bugs and make suggestions. * Summary:: Summary of Calc commands and functions. @@ -180,400 +179,7 @@ longer Info tutorial.) * Lisp Function Index:: Internal Lisp math functions. @end menu -@node Copying, Getting Started, Top, Top -@unnumbered GNU GENERAL PUBLIC LICENSE -@center Version 2, June 1991 - -@c This file is intended to be included in another file. - -@display -Copyright @copyright{} 1989, 1991 Free Software Foundation, Inc. -51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA - -Everyone is permitted to copy and distribute verbatim copies -of this license document, but changing it is not allowed. -@end display - -@unnumberedsec Preamble - - The licenses for most software are designed to take away your -freedom to share and change it. By contrast, the GNU General Public -License is intended to guarantee your freedom to share and change free -software---to make sure the software is free for all its users. This -General Public License applies to most of the Free Software -Foundation's software and to any other program whose authors commit to -using it. (Some other Free Software Foundation software is covered by -the GNU Lesser General Public License instead.) You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -this service if you wish), that you receive source code or can get it -if you want it, that you can change the software or use pieces of it -in new free programs; and that you know you can do these things. - - To protect your rights, we need to make restrictions that forbid -anyone to deny you these rights or to ask you to surrender the rights. -These restrictions translate to certain responsibilities for you if you -distribute copies of the software, or if you modify it. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must give the recipients all the rights that -you have. You must make sure that they, too, receive or can get the -source code. And you must show them these terms so they know their -rights. - - We protect your rights with two steps: (1) copyright the software, and -(2) offer you this license which gives you legal permission to copy, -distribute and/or modify the software. - - Also, for each author's protection and ours, we want to make certain -that everyone understands that there is no warranty for this free -software. If the software is modified by someone else and passed on, we -want its recipients to know that what they have is not the original, so -that any problems introduced by others will not reflect on the original -authors' reputations. - - Finally, any free program is threatened constantly by software -patents. We wish to avoid the danger that redistributors of a free -program will individually obtain patent licenses, in effect making the -program proprietary. To prevent this, we have made it clear that any -patent must be licensed for everyone's free use or not licensed at all. - - The precise terms and conditions for copying, distribution and -modification follow. - -@iftex -@unnumberedsec TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION -@end iftex -@ifinfo -@center TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION -@end ifinfo - -@enumerate 0 -@item -This License applies to any program or other work which contains -a notice placed by the copyright holder saying it may be distributed -under the terms of this General Public License. The ``Program'', below, -refers to any such program or work, and a ``work based on the Program'' -means either the Program or any derivative work under copyright law: -that is to say, a work containing the Program or a portion of it, -either verbatim or with modifications and/or translated into another -language. (Hereinafter, translation is included without limitation in -the term ``modification''.) Each licensee is addressed as ``you''. - -Activities other than copying, distribution and modification are not -covered by this License; they are outside its scope. The act of -running the Program is not restricted, and the output from the Program -is covered only if its contents constitute a work based on the -Program (independent of having been made by running the Program). -Whether that is true depends on what the Program does. - -@item -You may copy and distribute verbatim copies of the Program's -source code as you receive it, in any medium, provided that you -conspicuously and appropriately publish on each copy an appropriate -copyright notice and disclaimer of warranty; keep intact all the -notices that refer to this License and to the absence of any warranty; -and give any other recipients of the Program a copy of this License -along with the Program. - -You may charge a fee for the physical act of transferring a copy, and -you may at your option offer warranty protection in exchange for a fee. - -@item -You may modify your copy or copies of the Program or any portion -of it, thus forming a work based on the Program, and copy and -distribute such modifications or work under the terms of Section 1 -above, provided that you also meet all of these conditions: - -@enumerate a -@item -You must cause the modified files to carry prominent notices -stating that you changed the files and the date of any change. - -@item -You must cause any work that you distribute or publish, that in -whole or in part contains or is derived from the Program or any -part thereof, to be licensed as a whole at no charge to all third -parties under the terms of this License. - -@item -If the modified program normally reads commands interactively -when run, you must cause it, when started running for such -interactive use in the most ordinary way, to print or display an -announcement including an appropriate copyright notice and a -notice that there is no warranty (or else, saying that you provide -a warranty) and that users may redistribute the program under -these conditions, and telling the user how to view a copy of this -License. (Exception: if the Program itself is interactive but -does not normally print such an announcement, your work based on -the Program is not required to print an announcement.) -@end enumerate - -These requirements apply to the modified work as a whole. If -identifiable sections of that work are not derived from the Program, -and can be reasonably considered independent and separate works in -themselves, then this License, and its terms, do not apply to those -sections when you distribute them as separate works. But when you -distribute the same sections as part of a whole which is a work based -on the Program, the distribution of the whole must be on the terms of -this License, whose permissions for other licensees extend to the -entire whole, and thus to each and every part regardless of who wrote it. - -Thus, it is not the intent of this section to claim rights or contest -your rights to work written entirely by you; rather, the intent is to -exercise the right to control the distribution of derivative or -collective works based on the Program. - -In addition, mere aggregation of another work not based on the Program -with the Program (or with a work based on the Program) on a volume of -a storage or distribution medium does not bring the other work under -the scope of this License. - -@item -You may copy and distribute the Program (or a work based on it, -under Section 2) in object code or executable form under the terms of -Sections 1 and 2 above provided that you also do one of the following: - -@enumerate a -@item -Accompany it with the complete corresponding machine-readable -source code, which must be distributed under the terms of Sections -1 and 2 above on a medium customarily used for software interchange; or, - -@item -Accompany it with a written offer, valid for at least three -years, to give any third party, for a charge no more than your -cost of physically performing source distribution, a complete -machine-readable copy of the corresponding source code, to be -distributed under the terms of Sections 1 and 2 above on a medium -customarily used for software interchange; or, - -@item -Accompany it with the information you received as to the offer -to distribute corresponding source code. (This alternative is -allowed only for noncommercial distribution and only if you -received the program in object code or executable form with such -an offer, in accord with Subsection b above.) -@end enumerate - -The source code for a work means the preferred form of the work for -making modifications to it. For an executable work, complete source -code means all the source code for all modules it contains, plus any -associated interface definition files, plus the scripts used to -control compilation and installation of the executable. However, as a -special exception, the source code distributed need not include -anything that is normally distributed (in either source or binary -form) with the major components (compiler, kernel, and so on) of the -operating system on which the executable runs, unless that component -itself accompanies the executable. - -If distribution of executable or object code is made by offering -access to copy from a designated place, then offering equivalent -access to copy the source code from the same place counts as -distribution of the source code, even though third parties are not -compelled to copy the source along with the object code. - -@item -You may not copy, modify, sublicense, or distribute the Program -except as expressly provided under this License. Any attempt -otherwise to copy, modify, sublicense or distribute the Program is -void, and will automatically terminate your rights under this License. -However, parties who have received copies, or rights, from you under -this License will not have their licenses terminated so long as such -parties remain in full compliance. - -@item -You are not required to accept this License, since you have not -signed it. However, nothing else grants you permission to modify or -distribute the Program or its derivative works. These actions are -prohibited by law if you do not accept this License. Therefore, by -modifying or distributing the Program (or any work based on the -Program), you indicate your acceptance of this License to do so, and -all its terms and conditions for copying, distributing or modifying -the Program or works based on it. - -@item -Each time you redistribute the Program (or any work based on the -Program), the recipient automatically receives a license from the -original licensor to copy, distribute or modify the Program subject to -these terms and conditions. You may not impose any further -restrictions on the recipients' exercise of the rights granted herein. -You are not responsible for enforcing compliance by third parties to -this License. - -@item -If, as a consequence of a court judgment or allegation of patent -infringement or for any other reason (not limited to patent issues), -conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot -distribute so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you -may not distribute the Program at all. For example, if a patent -license would not permit royalty-free redistribution of the Program by -all those who receive copies directly or indirectly through you, then -the only way you could satisfy both it and this License would be to -refrain entirely from distribution of the Program. - -If any portion of this section is held invalid or unenforceable under -any particular circumstance, the balance of the section is intended to -apply and the section as a whole is intended to apply in other -circumstances. - -It is not the purpose of this section to induce you to infringe any -patents or other property right claims or to contest validity of any -such claims; this section has the sole purpose of protecting the -integrity of the free software distribution system, which is -implemented by public license practices. Many people have made -generous contributions to the wide range of software distributed -through that system in reliance on consistent application of that -system; it is up to the author/donor to decide if he or she is willing -to distribute software through any other system and a licensee cannot -impose that choice. - -This section is intended to make thoroughly clear what is believed to -be a consequence of the rest of this License. - -@item -If the distribution and/or use of the Program is restricted in -certain countries either by patents or by copyrighted interfaces, the -original copyright holder who places the Program under this License -may add an explicit geographical distribution limitation excluding -those countries, so that distribution is permitted only in or among -countries not thus excluded. In such case, this License incorporates -the limitation as if written in the body of this License. - -@item -The Free Software Foundation may publish revised and/or new versions -of the General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - -Each version is given a distinguishing version number. If the Program -specifies a version number of this License which applies to it and ``any -later version'', you have the option of following the terms and conditions -either of that version or of any later version published by the Free -Software Foundation. If the Program does not specify a version number of -this License, you may choose any version ever published by the Free Software -Foundation. - -@item -If you wish to incorporate parts of the Program into other free -programs whose distribution conditions are different, write to the author -to ask for permission. For software which is copyrighted by the Free -Software Foundation, write to the Free Software Foundation; we sometimes -make exceptions for this. Our decision will be guided by the two goals -of preserving the free status of all derivatives of our free software and -of promoting the sharing and reuse of software generally. - -@iftex -@heading NO WARRANTY -@end iftex -@ifinfo -@center NO WARRANTY -@end ifinfo - -@item -BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY -FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN -OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES -PROVIDE THE PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED -OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF -MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS -TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE -PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, -REPAIR OR CORRECTION. - -@item -IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR -REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, -INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING -OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED -TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY -YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER -PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE -POSSIBILITY OF SUCH DAMAGES. -@end enumerate - -@iftex -@heading END OF TERMS AND CONDITIONS -@end iftex -@ifinfo -@center END OF TERMS AND CONDITIONS -@end ifinfo - -@page -@unnumberedsec Appendix: How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -convey the exclusion of warranty; and each file should have at least -the ``copyright'' line and a pointer to where the full notice is found. - -@smallexample -@var{one line to give the program's name and a brief idea of what it does.} -Copyright (C) @var{yyyy} @var{name of author} - -This program is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. -@end smallexample - -Also add information on how to contact you by electronic and paper mail. - -If the program is interactive, make it output a short notice like this -when it starts in an interactive mode: - -@smallexample -Gnomovision version 69, Copyright (C) @var{yyyy} @var{name of author} -Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. -This is free software, and you are welcome to redistribute it -under certain conditions; type `show c' for details. -@end smallexample - -The hypothetical commands @samp{show w} and @samp{show c} should show -the appropriate parts of the General Public License. Of course, the -commands you use may be called something other than @samp{show w} and -@samp{show c}; they could even be mouse-clicks or menu items---whatever -suits your program. - -You should also get your employer (if you work as a programmer) or your -school, if any, to sign a ``copyright disclaimer'' for the program, if -necessary. Here is a sample; alter the names: - -@example -Yoyodyne, Inc., hereby disclaims all copyright interest in the program -`Gnomovision' (which makes passes at compilers) written by James Hacker. - -@var{signature of Ty Coon}, 1 April 1989 -Ty Coon, President of Vice -@end example - -This General Public License does not permit incorporating your program into -proprietary programs. If your program is a subroutine library, you may -consider it more useful to permit linking proprietary applications with the -library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. - -@node Getting Started, Tutorial, Copying, Top +@node Getting Started, Interactive Tutorial, Top, Top @chapter Getting Started @noindent This chapter provides a general overview of Calc, the GNU Emacs @@ -1019,7 +625,7 @@ with the file you were editing on top and Calc on the bottom. ... --**-Emacs: myfile (Fundamental)----All---------------------- ---- Emacs Calculator Mode --- |Emacs Calc Mode v2.1 ... +--- Emacs Calculator Mode --- |Emacs Calculator Trail 2: 17.3 | 17.3 1: -5 | 3 . | 2 @@ -1348,7 +954,7 @@ A slope of one-third corresponds to an angle of 18.4349488229 degrees. @c [fix-ref Embedded Mode] @xref{Embedded Mode}, for full details. -@node Other C-x * Commands, , Embedded Mode Overview, Using Calc +@node Other C-x * Commands, , Embedded Mode Overview, Using Calc @subsection Other @kbd{C-x *} Commands @noindent @@ -1514,7 +1120,7 @@ and record them as the current keyboard macro. its initial state: Empty stack, and initial mode settings. @end table -@node History and Acknowledgements, , Using Calc, Getting Started +@node History and Acknowledgements, , Using Calc, Getting Started @section History and Acknowledgements @noindent @@ -1617,7 +1223,7 @@ finished in two weeks. @ifinfo @c This node is accessed by the `C-x * t' command. -@node Interactive Tutorial, , , Top +@node Interactive Tutorial, Tutorial, Getting Started, Top @chapter Tutorial @noindent @@ -1647,7 +1253,7 @@ Press @kbd{1} now to enter the first section of the Tutorial. @end menu @end ifinfo -@node Tutorial, Introduction, Getting Started, Top +@node Tutorial, Introduction, Interactive Tutorial, Top @chapter Tutorial @noindent @@ -2128,6 +1734,10 @@ Calculator in Algebraic mode, which is closer to the way non-RPN calculators work. In Algebraic mode, you enter formulas in traditional @expr{2+3} notation. +@strong{Warning:} Note that @samp{/} has lower precedence than +@samp{*}, so that @samp{a/b*c} is interpreted as @samp{a/(b*c)}. See +below for details. + You don't really need any special ``mode'' to enter algebraic formulas. You can enter a formula at any time by pressing the apostrophe (@kbd{'}) key. Answer the prompt with the desired formula, then press @key{RET}. @@ -2553,7 +2163,7 @@ new number. This works for formulas, vectors, and all other types of values you can put on the stack. The @kbd{`} key also works during entry of a number or algebraic formula. -@node Modes Tutorial, , Undo Tutorial, Basic Tutorial +@node Modes Tutorial, , Undo Tutorial, Basic Tutorial @subsection Mode-Setting Commands @noindent @@ -3891,7 +3501,7 @@ $$ @noindent @xref{Matrix Answer 3, 3}. (@bullet{}) -@node List Tutorial, , Matrix Tutorial, Vector/Matrix Tutorial +@node List Tutorial, , Matrix Tutorial, Vector/Matrix Tutorial @subsection Vectors as Lists @noindent @@ -5641,7 +5251,7 @@ details and examples. @c hard exercise: simplify (2^(n r) - 2^(r*(n - 1))) / (2^r - 1) 2^(n - 1) @c to 2^((n-1)*(r-1)). -@node Rewrites Tutorial, , Basic Algebra Tutorial, Algebra Tutorial +@node Rewrites Tutorial, , Basic Algebra Tutorial, Algebra Tutorial @subsection Rewrite Rules @noindent @@ -6757,7 +6367,7 @@ The rest of this manual tells the whole story. @c Volume II of this manual, the @dfn{Calc Reference}, tells the whole story. @page -@node Answers to Exercises, , Programming Tutorial, Tutorial +@node Answers to Exercises, , Programming Tutorial, Tutorial @section Answers to Exercises @noindent @@ -9945,7 +9555,7 @@ first, because @code{read-kbd-macro} doesn't need to execute the definition as it reads it in. For this reason, @code{C-x * m} is often the easiest way to create recursive programs in Calc. -@node Programming Answer 12, , Programming Answer 11, Answers to Exercises +@node Programming Answer 12, , Programming Answer 11, Answers to Exercises @subsection Programming Tutorial Exercise 12 @noindent @@ -10738,7 +10348,7 @@ the stack and mode settings of the buffer being quit as the new defaults. There is only one trail buffer, @samp{*Calc Trail*}, used by all Calculator buffers. -@node Troubleshooting Commands, , Multiple Calculators, Introduction +@node Troubleshooting Commands, , Multiple Calculators, Introduction @section Troubleshooting Commands @noindent @@ -10829,7 +10439,7 @@ If you suspect a Calculator cache has become corrupt, you can use the The @kbd{C-x * 0} (with the zero key) command also resets caches along with all other aspects of the Calculator's state. -@node Debugging Calc, , Caches, Troubleshooting Commands +@node Debugging Calc, , Caches, Troubleshooting Commands @subsection Debugging Calc @noindent @@ -11022,16 +10632,19 @@ Calculator's arithmetic is not intended to be IEEE-conformant in any way. While floats are always @emph{stored} in decimal, they can be entered -and displayed in any radix just like integers and fractions. The -notation @samp{@var{radix}#@var{ddd}.@var{ddd}} is a floating-point -number whose digits are in the specified radix. Note that the @samp{.} -is more aptly referred to as a ``radix point'' than as a decimal -point in this case. The number @samp{8#123.4567} is defined as -@samp{8#1234567 * 8^-4}. If the radix is 14 or less, you can use -@samp{e} notation to write a non-decimal number in scientific notation. -The exponent is written in decimal, and is considered to be a power -of the radix: @samp{8#1234567e-4}. If the radix is 15 or above, the -letter @samp{e} is a digit, so scientific notation must be written +and displayed in any radix just like integers and fractions. Since a +float that is entered in a radix other that 10 will be converted to +decimal, the number that Calc stores may not be exactly the number that +was entered, it will be the closest decimal approximation given the +current precison. The notation @samp{@var{radix}#@var{ddd}.@var{ddd}} +is a floating-point number whose digits are in the specified radix. +Note that the @samp{.} is more aptly referred to as a ``radix point'' +than as a decimal point in this case. The number @samp{8#123.4567} is +defined as @samp{8#1234567 * 8^-4}. If the radix is 14 or less, you can +use @samp{e} notation to write a non-decimal number in scientific +notation. The exponent is written in decimal, and is considered to be a +power of the radix: @samp{8#1234567e-4}. If the radix is 15 or above, +the letter @samp{e} is a digit, so scientific notation must be written out, e.g., @samp{16#123.4567*16^2}. The first two exercises of the Modes Tutorial explore some of the properties of non-decimal floats. @@ -11906,7 +11519,7 @@ a value into any of these special variables. @xref{Store and Recall}, for a discussion of commands dealing with variables. -@node Formulas, , Variables, Data Types +@node Formulas, , Variables, Data Types @section Formulas @noindent @@ -12352,7 +11965,7 @@ kills the @var{n} lines below or above the selected one. The @kbd{t .} (@code{calc-full-trail-vectors}) command is described elsewhere; @pxref{Vector and Matrix Formats}. -@node Keep Arguments, , Trail Commands, Stack and Trail +@node Keep Arguments, , Trail Commands, Stack and Trail @section Keep Arguments @noindent @@ -12854,7 +12467,7 @@ To update @samp{=>} operators in an Embedded buffer while automatic recomputation is off, use @w{@kbd{C-x * u}}. @xref{Embedded Mode}. -@node Working Message, , Automatic Recomputation, Calculation Modes +@node Working Message, , Automatic Recomputation, Calculation Modes @subsection Working Messages @noindent @@ -13235,7 +12848,7 @@ using a variable for a new purpose, it is best to use @kbd{s d} or @kbd{s D} to check to make sure you don't still have an old declaration for the variable that will conflict with its new meaning. -@node Functions for Declarations, , Kinds of Declarations, Declarations +@node Functions for Declarations, , Kinds of Declarations, Declarations @subsection Functions for Declarations @noindent @@ -13935,7 +13548,7 @@ minus sign on the year value. If you always enter a four-digit year, and use a name instead of a number for the month, there is no danger of ambiguity. -@node Standard Date Formats, , Free-Form Dates, Date Formats +@node Standard Date Formats, , Free-Form Dates, Date Formats @subsubsection Standard Date Formats @noindent @@ -14070,7 +13683,7 @@ when positioning by explicit origins and widths. In the latter case, the display is formatted as specified, and then uniformly shifted over four spaces to fit the line numbers. -@node Labels, , Justification, Display Modes +@node Labels, , Justification, Display Modes @subsection Labels @noindent @@ -15361,7 +14974,7 @@ For @samp{a / b} in Big mode, @code{cascent} returns 2 and @code{cdescent} returns 1. The only formula for which @code{cascent} will return zero is @samp{cvspace(0)} or equivalents. -@node User-Defined Compositions, , Information about Compositions, Compositions +@node User-Defined Compositions, , Information about Compositions, Compositions @subsubsection User-Defined Compositions @noindent @@ -15492,7 +15105,7 @@ produce a large, unwieldy integer. You can save your display formats permanently using the @kbd{Z P} command (@pxref{Creating User Keys}). -@node Syntax Tables, , Compositions, Language Modes +@node Syntax Tables, , Compositions, Language Modes @subsection Syntax Tables @noindent @@ -15825,7 +15438,7 @@ backs up and tries the other alternative. Thus Calc has ``partial'' backtracking. A fully backtracking parser would go on to make sure the rest of the pattern matched before finalizing the choice. -@node Conditional Syntax Rules, , Advanced Syntax Patterns, Syntax Tables +@node Conditional Syntax Rules, , Advanced Syntax Patterns, Syntax Tables @subsubsection Conditional Syntax Rules @noindent @@ -16001,7 +15614,7 @@ would not work for fixed-point mode, but it wouldn't be hard to do a full emulation with the help of the @kbd{Z [} and @kbd{Z ]} programming commands. @xref{Conditionals in Macros}.) -@node Calc Mode Line, , Modes Variable, Mode Settings +@node Calc Mode Line, , Modes Variable, Mode Settings @section The Calc Mode Line @noindent @@ -16362,20 +15975,24 @@ whereas @w{@samp{[-2 ..@: 3] ^ 2}} is @samp{[0 ..@: 9]}. @mindex @null @end ignore @tindex / -The @kbd{/} (@code{calc-divide}) command divides two numbers. When -dividing a scalar @expr{B} by a square matrix @expr{A}, the computation -performed is @expr{B} times the inverse of @expr{A}. This also occurs -if @expr{B} is itself a vector or matrix, in which case the effect is -to solve the set of linear equations represented by @expr{B}. If @expr{B} -is a matrix with the same number of rows as @expr{A}, or a plain vector -(which is interpreted here as a column vector), then the equation -@expr{A X = B} is solved for the vector or matrix @expr{X}. Otherwise, -if @expr{B} is a non-square matrix with the same number of @emph{columns} -as @expr{A}, the equation @expr{X A = B} is solved. If you wish a vector -@expr{B} to be interpreted as a row vector to be solved as @expr{X A = B}, -make it into a one-row matrix with @kbd{C-u 1 v p} first. To force a -left-handed solution with a square matrix @expr{B}, transpose @expr{A} and -@expr{B} before dividing, then transpose the result. +The @kbd{/} (@code{calc-divide}) command divides two numbers. Note that +when using algebraic entry, @samp{/} has lower precedence than @samp{*}, +so that @samp{a/b*c} is interpreted as @samp{a/(b*c)}. + +When dividing a scalar @expr{B} by a square matrix @expr{A}, the +computation performed is @expr{B} times the inverse of @expr{A}. This +also occurs if @expr{B} is itself a vector or matrix, in which case the +effect is to solve the set of linear equations represented by @expr{B}. +If @expr{B} is a matrix with the same number of rows as @expr{A}, or a +plain vector (which is interpreted here as a column vector), then the +equation @expr{A X = B} is solved for the vector or matrix @expr{X}. +Otherwise, if @expr{B} is a non-square matrix with the same number of +@emph{columns} as @expr{A}, the equation @expr{X A = B} is solved. If +you wish a vector @expr{B} to be interpreted as a row vector to be +solved as @expr{X A = B}, make it into a one-row matrix with @kbd{C-u 1 +v p} first. To force a left-handed solution with a square matrix +@expr{B}, transpose @expr{A} and @expr{B} before dividing, then +transpose the result. HMS forms can be divided by real numbers or by other HMS forms. Error forms can be divided in any combination of ways. Modulo forms where both @@ -17359,7 +16976,7 @@ any date form and returns 1 if that date falls on a weekend or holiday, as defined in @code{Holidays}, or 0 if the date is a business day. -@node Time Zones, , Business Days, Date Arithmetic +@node Time Zones, , Business Days, Date Arithmetic @subsection Time Zones @noindent @@ -18006,7 +17623,7 @@ Summing columns with @kbd{V R : +} yields @expr{[10000, 10000, 10000]}; the total depreciation in any method is (by definition) the difference between the cost and the salvage value. -@node Definitions of Financial Functions, , Depreciation Functions, Financial Functions +@node Definitions of Financial Functions, , Depreciation Functions, Financial Functions @subsection Definitions @noindent @@ -18161,7 +17778,7 @@ and the depreciation is zero for all subsequent periods. The @code{ddb} function returns the amount the book value decreased in the specified period. -@node Binary Functions, , Financial Functions, Arithmetic +@node Binary Functions, , Financial Functions, Arithmetic @section Binary Number Functions @noindent @@ -19092,7 +18709,7 @@ elements of this vector. @xref{Matrix Functions}. * Random Number Generator:: (Complete description of Calc's algorithm) @end menu -@node Random Number Generator, , Random Numbers, Random Numbers +@node Random Number Generator, , Random Numbers, Random Numbers @subsection Random Number Generator Calc's random number generator uses several methods to ensure that @@ -19408,7 +19025,7 @@ distinct factors, this is @expr{(-1)^k}. If the input number has any duplicate factors (i.e., can be divided by the same prime more than once), the result is zero. -@node Probability Distribution Functions, , Combinatorial Functions, Scientific Functions +@node Probability Distribution Functions, , Combinatorial Functions, Scientific Functions @section Probability Distribution Functions @noindent @@ -20858,7 +20475,7 @@ arguments, interpreted in the same way as the other functions in this section. For example, @samp{vflat(1, [2, [3, 4]], 5)} returns @samp{[1, 2, 3, 4, 5]}. -@node Paired-Sample Statistics, , Single-Variable Statistics, Statistical Operations +@node Paired-Sample Statistics, , Single-Variable Statistics, Statistical Operations @subsection Paired-Sample Statistics @noindent @@ -21350,7 +20967,7 @@ computes the square root of @samp{A} given the initial guess @samp{B}, stopping when the result is correct within the specified tolerance, or when 20 steps have been taken, whichever is sooner. -@node Generalized Products, , Nesting and Fixed Points, Reducing and Mapping +@node Generalized Products, , Nesting and Fixed Points, Reducing and Mapping @subsection Generalized Products @kindex V O @@ -21385,7 +21002,7 @@ use @kbd{$} twice to take both operator formulas from the stack, the first (multiplicative) operator is taken from the top of the stack and the second (additive) operator is taken from second-to-top. -@node Vector and Matrix Formats, , Reducing and Mapping, Matrix Functions +@node Vector and Matrix Formats, , Reducing and Mapping, Matrix Functions @section Vector and Matrix Display Formats @noindent @@ -22006,7 +21623,7 @@ to be simplified. @end group @end smallexample -@node Rearranging with Selections, , Operating on Selections, Selecting Subformulas +@node Rearranging with Selections, , Operating on Selections, Selecting Subformulas @subsection Rearranging Formulas using Selections @noindent @@ -23104,7 +22721,7 @@ on whether you believe @expr{x} is positive or negative). The @kbd{a M /} command can be used to divide a factor out of both sides of an inequality. -@node Simplification of Units, , Unsafe Simplifications, Simplifying Formulas +@node Simplification of Units, , Unsafe Simplifications, Simplifying Formulas @subsection Simplification of Units @noindent @@ -23738,7 +23355,7 @@ The integral of @samp{1/sqrt(x)} from 0 to 1 exists (it can be found by Calc's symbolic integrator, for example), but @kbd{a I} will fail because the integrand goes to infinity at one of the endpoints. -@node Taylor Series, , Numerical Integration, Calculus +@node Taylor Series, , Numerical Integration, Calculus @subsection Taylor Series @noindent @@ -23984,7 +23601,7 @@ Another way to deal with certain kinds of overdetermined systems of equations is the @kbd{a F} command, which does least-squares fitting to satisfy the equations. @xref{Curve Fitting}. -@node Decomposing Polynomials, , Solving Systems of Equations, Solving Equations +@node Decomposing Polynomials, , Solving Systems of Equations, Solving Equations @subsection Decomposing Polynomials @noindent @@ -24295,7 +23912,7 @@ the initial guess is a complex number the variable will be minimized over the complex numbers; if it is real or an interval it will be minimized over the reals. -@node Numerical Systems of Equations, , Minimization, Numerical Solutions +@node Numerical Systems of Equations, , Minimization, Numerical Solutions @subsection Systems of Equations @noindent @@ -25343,7 +24960,7 @@ linearizer was unable to put the model into the required form. The @code{efit} (corresponding to @kbd{H a F}) and @code{xfit} (for @kbd{I a F}) functions are completely analogous. -@node Interpolation, , Curve Fitting Details, Curve Fitting +@node Interpolation, , Curve Fitting Details, Curve Fitting @subsection Polynomial Interpolation @kindex a p @@ -25940,7 +25557,7 @@ declarations are used when deciding whether a formula is true; it returns 0 when @code{dnonzero} would return 0 or leave itself in symbolic form.) -@node Rewrite Rules, , Logical Operations, Algebra +@node Rewrite Rules, , Logical Operations, Algebra @section Rewrite Rules @noindent @@ -27607,7 +27224,7 @@ buffer (with @kbd{C-x k *Trace* @key{RET}}). If you leave it in existence and forget about it, all your future rewrite commands will be needlessly slow. -@node Examples of Rewrite Rules, , Debugging Rewrites, Rewrite Rules +@node Examples of Rewrite Rules, , Debugging Rewrites, Rewrite Rules @subsection Examples of Rewrite Rules @noindent @@ -28029,7 +27646,7 @@ really is unitless.) @c Describe angular units, luminosity vs. steradians problem. -@node User-Defined Units, , Predefined Units, Units +@node User-Defined Units, , Predefined Units, Units @section User-Defined Units @noindent @@ -28573,7 +28190,7 @@ example, letting @expr{n=2} in @samp{f(n pi)} with @kbd{a b} will produce @samp{f(2 pi)}, whereas @kbd{s l} would give @samp{f(6.28)} since the evaluation step will also evaluate @code{pi}. -@node Evaluates-To Operator, , Let Command, Store and Recall +@node Evaluates-To Operator, , Let Command, Store and Recall @section The Evaluates-To Operator @noindent @@ -29206,7 +28823,7 @@ lines, and the third curve to have lines in style 3. Point styles will still be assigned automatically, but you could store another vector in @code{PointStyles} to define them, too. -@node Devices, , Graphics Options, Graphics +@node Devices, , Graphics Options, Graphics @section Graphical Devices @noindent @@ -29637,7 +29254,7 @@ The @kbd{C-x * y} key sequence is equivalent to @kbd{y} except that it can be typed anywhere, not just in Calc. This provides an easy way to guarantee that Calc knows which editing buffer you want to use! -@node X Cut and Paste, , Yanking Into Buffers, Kill and Yank +@node X Cut and Paste, , Yanking Into Buffers, Kill and Yank @section X Cut and Paste @noindent @@ -30007,7 +29624,7 @@ With @key{INV}, @key{HYP}, or @key{INV} and @key{HYP}, the @kbd{"x"} key pushes the variable names @expr{y}, @expr{z}, and @expr{t}, respectively. -@node Keypad Modes Menu, , Keypad Vectors Menu, Keypad Mode +@node Keypad Modes Menu, , Keypad Vectors Menu, Keypad Mode @section Modes Menu @smallexample @@ -30799,7 +30416,7 @@ annotations at all. When Embedded mode is not enabled, mode-recording modes except for @code{Save} have no effect. -@node Customizing Embedded Mode, , Mode Settings in Embedded Mode, Embedded Mode +@node Customizing Embedded Mode, , Mode Settings in Embedded Mode, Embedded Mode @section Customizing Embedded Mode @noindent @@ -30953,7 +30570,7 @@ is simply a newline, @code{"\n"}, but may be different for different major modes. If you change this, it is a good idea still to end with a newline so that mode annotations will appear on lines by themselves. -@node Programming, Customizing Calc, Embedded Mode, Top +@node Programming, Copying, Embedded Mode, Top @chapter Programming @noindent @@ -31406,7 +31023,7 @@ The contents of the stack and trail, values of non-quick variables, and other settings such as the language mode and the various display modes, are @emph{not} affected by @kbd{Z `} and @kbd{Z '}. -@node Queries in Macros, , Local Values in Macros, Keyboard Macros +@node Queries in Macros, , Local Values in Macros, Keyboard Macros @subsection Queries in Keyboard Macros @c @noindent @@ -31591,7 +31208,7 @@ default simplifications cures this problem: The definition will be stored in symbolic form without ever activating the @code{deriv} function. Press @kbd{m D} to turn the default simplifications back on afterwards. -@node Lisp Definitions, , Algebraic Definitions, Programming +@node Lisp Definitions, , Algebraic Definitions, Programming @section Programming with Lisp @noindent @@ -32296,7 +31913,7 @@ actually they are less efficient because each operation is really a division by 512 in disguise; @code{idivmod} allows us to do the same thing with a single division by 512. -@node Sine Example, , Bit Counting Example, Example Definitions +@node Sine Example, , Bit Counting Example, Example Definitions @subsubsection The Sine Function @noindent @@ -32776,7 +32393,7 @@ Note the use of @code{insert-before-markers} when changing between ``F'' and ``C'', so that the character winds up before the cursor instead of after it. -@node Internals, , Calling Calc from Your Programs, Lisp Definitions +@node Internals, , Calling Calc from Your Programs, Lisp Definitions @subsection Calculator Internals @noindent @@ -34668,7 +34285,7 @@ If composition @var{c} is a ``flat'' composition, return the last @comment @noindent @comment (This section is currently unfinished.) -@node Hooks, , Formatting Lisp Functions, Internals +@node Hooks, , Formatting Lisp Functions, Internals @subsubsection Hooks @noindent @@ -34832,7 +34449,404 @@ used the first time, your hook should add a variable to the list and also call @code{make-local-variable} itself. @end defvar -@node Customizing Calc, Reporting Bugs, Programming, Top +@node Copying, GNU Free Documentation License, Programming, Top +@appendix GNU GENERAL PUBLIC LICENSE +@center Version 2, June 1991 + +@c This file is intended to be included in another file. + +@display +Copyright @copyright{} 1989, 1991 Free Software Foundation, Inc. +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + +Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed. +@end display + +@unnumberedsec Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software---to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + +@iftex +@unnumberedsec TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION +@end iftex +@ifinfo +@center TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION +@end ifinfo + +@enumerate 0 +@item +This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The ``Program'', below, +refers to any such program or work, and a ``work based on the Program'' +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term ``modification''.) Each licensee is addressed as ``you''. + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + +@item +You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + +@item +You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + +@enumerate a +@item +You must cause the modified files to carry prominent notices +stating that you changed the files and the date of any change. + +@item +You must cause any work that you distribute or publish, that in +whole or in part contains or is derived from the Program or any +part thereof, to be licensed as a whole at no charge to all third +parties under the terms of this License. + +@item +If the modified program normally reads commands interactively +when run, you must cause it, when started running for such +interactive use in the most ordinary way, to print or display an +announcement including an appropriate copyright notice and a +notice that there is no warranty (or else, saying that you provide +a warranty) and that users may redistribute the program under +these conditions, and telling the user how to view a copy of this +License. (Exception: if the Program itself is interactive but +does not normally print such an announcement, your work based on +the Program is not required to print an announcement.) +@end enumerate + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + +@item +You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + +@enumerate a +@item +Accompany it with the complete corresponding machine-readable +source code, which must be distributed under the terms of Sections +1 and 2 above on a medium customarily used for software interchange; or, + +@item +Accompany it with a written offer, valid for at least three +years, to give any third party, for a charge no more than your +cost of physically performing source distribution, a complete +machine-readable copy of the corresponding source code, to be +distributed under the terms of Sections 1 and 2 above on a medium +customarily used for software interchange; or, + +@item +Accompany it with the information you received as to the offer +to distribute corresponding source code. (This alternative is +allowed only for noncommercial distribution and only if you +received the program in object code or executable form with such +an offer, in accord with Subsection b above.) +@end enumerate + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + +@item +You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + +@item +You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + +@item +Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + +@item +If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + +@item +If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + +@item +The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and ``any +later version'', you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + +@item +If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + +@iftex +@heading NO WARRANTY +@end iftex +@ifinfo +@center NO WARRANTY +@end ifinfo + +@item +BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + +@item +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. +@end enumerate + +@iftex +@heading END OF TERMS AND CONDITIONS +@end iftex +@ifinfo +@center END OF TERMS AND CONDITIONS +@end ifinfo + +@page +@unnumberedsec Appendix: How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the ``copyright'' line and a pointer to where the full notice is found. + +@smallexample +@var{one line to give the program's name and a brief idea of what it does.} +Copyright (C) @var{yyyy} @var{name of author} + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. +@end smallexample + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + +@smallexample +Gnomovision version 69, Copyright (C) @var{yyyy} @var{name of author} +Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. +This is free software, and you are welcome to redistribute it +under certain conditions; type `show c' for details. +@end smallexample + +The hypothetical commands @samp{show w} and @samp{show c} should show +the appropriate parts of the General Public License. Of course, the +commands you use may be called something other than @samp{show w} and +@samp{show c}; they could even be mouse-clicks or menu items---whatever +suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a ``copyright disclaimer'' for the program, if +necessary. Here is a sample; alter the names: + +@example +Yoyodyne, Inc., hereby disclaims all copyright interest in the program +`Gnomovision' (which makes passes at compilers) written by James Hacker. + +@var{signature of Ty Coon}, 1 April 1989 +Ty Coon, President of Vice +@end example + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. + +@node GNU Free Documentation License, Customizing Calc, Copying, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Customizing Calc, Reporting Bugs, GNU Free Documentation License, Top @appendix Customizing Calc The usual prefix for Calc is the key sequence @kbd{C-x *}. If you wish @@ -35151,7 +35165,7 @@ and @code{calc-embedded-open-close-plain-alist}. If you find a bug in Calc, send e-mail to Jay Belanger, @example -belanger@@truman.edu +jay.p.belanger@@gmail.com @end example @noindent @@ -36457,7 +36471,7 @@ in your Calc init file or @file{.emacs} file. @printindex vr -@node Lisp Function Index, , Variable Index, Top +@node Lisp Function Index, , Variable Index, Top @unnumbered Index of Lisp Math Functions The following functions are meant to be used with @code{defmath}, not diff --git a/man/calendar.texi b/man/calendar.texi index 11b24f7c210..58ca24af7d9 100644 --- a/man/calendar.texi +++ b/man/calendar.texi @@ -1614,11 +1614,12 @@ minutes. The value for Cambridge, Massachusetts is 60. @c @vindex calendar-daylight-savings-starts-time too long! @vindex calendar-daylight-savings-ends-time - The two variables @code{calendar-daylight-savings-starts-time} and -@code{calendar-daylight-savings-ends-time} specify the number of minutes -after midnight local time when the transition to and from daylight -saving time should occur. For Cambridge, Massachusetts both variables' -values are 120. + Finally, the two variables +@code{calendar-daylight-savings-starts-time} and +@code{calendar-daylight-savings-ends-time} specify the number of +minutes after midnight local time when the transition to and from +daylight saving time should occur. For Cambridge, Massachusetts both +variables' values are 120. @node Time Intervals @section Summing Time Intervals diff --git a/man/cc-mode.texi b/man/cc-mode.texi index bc804fa01dc..217c32ff911 100644 --- a/man/cc-mode.texi +++ b/man/cc-mode.texi @@ -255,6 +255,7 @@ functions, classes etc - there are other packages for that. * FAQ:: * Updating CC Mode:: * Mailing Lists and Bug Reports:: +* GNU Free Documentation License:: * Command and Function Index:: * Variable Index:: * Concept and Key Index:: @@ -6892,7 +6893,7 @@ compatibility, etc. are all available on the web site: @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -@node Mailing Lists and Bug Reports, Command and Function Index, Updating CC Mode, Top +@node Mailing Lists and Bug Reports, GNU Free Documentation License, Updating CC Mode, Top @comment node-name, next, previous, up @appendix Mailing Lists and Submitting Bug Reports @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! @@ -6934,9 +6935,15 @@ to the Usenet newsgroups @code{gnu.emacs.sources}, @code{comp.emacs}, @code{comp.lang.idl}, and @code{comp.lang.awk}. @c There is no newsgroup for Pike. :-( + +@node GNU Free Documentation License, Command and Function Index, Mailing Lists and Bug Reports, Top +@appendix GNU Free Documentation License +@include doclicense.texi + + @c Removed the tentative node "Mode Initialization" from here, 2005/8/27. @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -@node Command and Function Index, Variable Index, Mailing Lists and Bug Reports, Top +@node Command and Function Index, Variable Index, GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Command and Function Index @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! diff --git a/man/cl.texi b/man/cl.texi index 6a6663fcd5b..676b9edc5ad 100644 --- a/man/cl.texi +++ b/man/cl.texi @@ -78,6 +78,7 @@ does assume a basic familiarity with Emacs Lisp. * Old CL Compatibility:: All known differences with old cl.el * Porting Common Lisp:: Hints for porting Common Lisp code +* GNU Free Documentation License:: The license for this documentation. * Function Index:: * Variable Index:: @end menu @@ -5141,7 +5142,7 @@ older versions of the old package used the unadorned names @code{floor}, @code{ceiling}, etc.; @code{cl-compat} cannot use these names because they conflict with Emacs built-ins. -@node Porting Common Lisp, Function Index, Old CL Compatibility, Top +@node Porting Common Lisp, GNU Free Documentation License, Old CL Compatibility, Top @appendix Porting Common Lisp @noindent @@ -5353,7 +5354,11 @@ note that the current Emacs Lisp compiler does not optimize tail recursion. @end itemize -@node Function Index, Variable Index, Porting Common Lisp, Top +@node GNU Free Documentation License, Function Index, Porting Common Lisp, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Function Index, Variable Index, GNU Free Documentation License, Top @unnumbered Function Index @printindex fn diff --git a/man/cmdargs.texi b/man/cmdargs.texi index 860d9ac1403..676d4cdf3b5 100644 --- a/man/cmdargs.texi +++ b/man/cmdargs.texi @@ -892,7 +892,7 @@ displays the entire font @samp{6x13}. @node Colors @appendixsec Window Color Options -@cindex color of window +@cindex color of window, from command line @cindex text colors, from command line @findex list-colors-display diff --git a/man/dired-x.texi b/man/dired-x.texi index 0d9e385b789..bf2d5288abc 100644 --- a/man/dired-x.texi +++ b/man/dired-x.texi @@ -25,38 +25,27 @@ @comment %**end of header (This is for running Texinfo on a region.) @copying -This documents the ``extra'' features for Dired Mode for GNU Emacs found in -the file @file{dired-x.el}. - -Copyright @copyright{} 1993, 1994, 2001, 2002, 2003, 2004, +Copyright @copyright{} 1994, 1995, 1999, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. @quotation -Permission is granted to make and distribute verbatim copies of this -manual provided the copyright notice and this permission notice are -preserved on all copies. - -Permission is granted to copy and distribute modified versions of -this manual under the conditions for verbatim copying, provided that -the entire resulting derived work is distributed under the terms of -a permission notice identical to this one. - -Permission is granted to copy and distribute translations of this -manual into another language, under the above conditions for -modified versions, except that this permission notice may be stated -in a translation approved by the Free Software Foundation. - -The file used to create this is called @file{dired-x.texi}, but the -original work that was altered to make that file was called -@file{dired.texi} written by Sebastian Kremer. - -@ignore -Permission is granted to process this file through TeX and print the -results, provided the printed document carries copying permission -notice identical to this one except for the removal of this paragraph -(this paragraph not being relevant to the printed manual). - -@end ignore +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with the +Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and +``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU +Manual'', and with the Back-Cover Texts as in (a) below. A copy of the +license is included in the section entitled ``GNU Free Documentation +License'' in the Emacs manual. + +(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify +this GNU Manual, like GNU software. Copies published by the Free +Software Foundation raise funds for GNU development.'' + +This document is part of a collection distributed under the GNU Free +Documentation License. If you want to distribute this document +separately from the collection, you can do so by adding a copy of the +license to the document, as described in section 6 of the license. @end quotation @end copying @@ -80,9 +69,6 @@ notice identical to this one except for the removal of this paragraph @sp 1 @center @titlefont{Directory Editor} @sp 4 -@center Manual Revision: 2.53 -@center 2001/02/25 14:05:46 -@sp 5 @center Lawrence R@. Dodd @c @center @t{dodd@@roebling.poly.edu} @sp 5 @@ -138,6 +124,7 @@ For @file{dired-x.el} revision 2 * Miscellaneous Commands:: * Bugs:: +* GNU Free Documentation License:: * Concept Index:: * Command Index:: * Key Index:: @@ -1228,7 +1215,7 @@ Bound to @kbd{%Y}. Relative symlink all marked files containing info. @end table -@node Bugs, Concept Index, Miscellaneous Commands, Top +@node Bugs, GNU Free Documentation License, Miscellaneous Commands, Top @comment node-name, next, previous, up @chapter Bugs @cindex Bugs @@ -1252,7 +1239,11 @@ maladjustment. Lawrence R. Dodd @c <dodd@@roebling.poly.edu> -@node Concept Index, Command Index, Bugs, Top +@node GNU Free Documentation License, Concept Index, Bugs, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Concept Index, Command Index, GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Concept Index @printindex cp diff --git a/man/dired.texi b/man/dired.texi index c40030147b4..922914a123f 100644 --- a/man/dired.texi +++ b/man/dired.texi @@ -44,6 +44,7 @@ on all of them with on command. * Updating: Dired Updating. Discarding lines for files of no interest. * Find: Dired and Find. Using `find' to choose the files for Dired. * Wdired:: Operating on files by editing the Dired buffer. +* Image-Dired:: Viewing image thumbnails in Dired * Misc: Misc Dired Features. Various other features. @end menu @@ -920,6 +921,9 @@ Use the @kbd{l} command (@code{dired-do-redisplay}) to update the subdirectory's contents. Use @kbd{C-u k} on the subdirectory header line to delete the subdirectory. @xref{Dired Updating}. + + + @ifnottex @include dired-xtra.texi @end ifnottex @@ -1132,9 +1136,9 @@ may need to change the value of this variable. @findex locate-with-filter @cindex file database (locate) @vindex locate-command - @kbd{M-x locate} provides a similar interface to the @code{locate} -program. @kbd{M-x locate-with-filter} is similar, but keeps only files -whose names match a given regular expression. + The command @kbd{M-x locate} provides a similar interface to the +@code{locate} program. @kbd{M-x locate-with-filter} is similar, but +keeps only files whose names match a given regular expression. These buffers don't work entirely like ordinary Dired buffers: file operations work, but do not always automatically update the buffer. @@ -1174,6 +1178,78 @@ change @samp{-rw-r--r--} to @samp{-rw-rw-rw-} to make a file world-writable. These changes also take effect when you type @kbd{C-c C-c}. +@node Image-Dired +@section Viewing Image Thumbnails in Dired +@cindex image-dired mode +@cindex image-dired + + Image-Dired is a facility for browsing image files. It provides viewing +the images either as thumbnails or in full size, either inside Emacs +or through an external viewer. + +@kindex C-t d @r{(Image-Dired)} +@findex image-dired-display-thumbs + To enter Image-Dired, mark the image files you want to look at in +the Dired buffer, using @kbd{m} as usual. Then type @kbd{C-t d} +(@code{image-dired-display-thumbs}). This creates and switches to a +buffer containing image-dired, corresponding to the marked files. + + You can also enter Image-Dired directly by typing @kbd{M-x +image-dired}. This prompts for a directory; specify one that has +images files. This creates thumbnails for all the images in that +directory, and displays them all in the ``thumbnail buffer.'' This +takes a long time if the directory contains many image files, and it +asks for confirmation if the number of image files exceeds +@code{image-dired-show-all-from-dir-max-files}. + + With point in the thumbnail buffer, type @kbd{RET} +(@code{image-dired-display-thumbnail-original-image}) to display a +sized version of it in another window. This sizes the image to fit +the window. Use the arrow keys to move around in the buffer. For +easy browsing, type @kbd{SPC} +(@code{image-dired-display-next-thumbnail-original}) to advance and +display the next image. Typing @kbd{DEL} +(@code{image-dired-display-previous-thumbnail-original}) backs up to +the previous thumbnail and displays that instead. + +@vindex image-dired-external-viewer + To view and the image in its original size, either provide a prefix +argument (@kbd{C-u}) before pressing @kbd{RET}, or type +@kbd{C-@key{RET}} (@code{image-dired-thumbnail-display-external}) to +display the image in an external viewer. You must first configure +@code{image-dired-external-viewer}. + + You can delete images through Image-Dired also. Type @kbd{d} +(@code{image-dired-flag-thumb-original-file}) to flag the image file +for deletion in the Dired buffer. You can also delete the thumbnail +image from the thumbnail buffer with @kbd{C-d} +(@code{image-dired-delete-char}). + + More advanced features include @dfn{image tags}, which are metadata +used to categorize image files. The tags are stored in a plain text +file configured by @code{image-dired-db-file}. + + To tag image files, mark them in the dired buffer (you can also mark +files in Dired from the thumbnail buffer by typing @kbd{m}) and type +@kbd{C-t t} (@code{image-dired-tag-files}). You will be prompted for +a tag. To mark files having a certain tag, type @kbd{C-t f} +(@code{image-dired-mark-tagged-files}). After marking image files +with a certain tag, you can use @kbd{C-t d} to view them. + + You can also tag a file directly from the thumbnail buffer by typing +@kbd{t t} and you can remove a tag by typing @kbd{t r}. There is also +a special ``tag'' called ``comment'' for each file (it is not a tag in +the exact same sense as the other tags, it is handled slightly +different). That is used to enter a comment or description about the +image. You comment a file from the thumbnail buffer by typing +@kbd{c}. You will be prompted for a comment. Type @kbd{C-t c} to add +a comment from Dired (@code{image-dired-dired-comment-files}). + + Image-Dired also provides simple image manipulation. In the +thumbnail buffer, type @kbd{L} to rotate the original image 90 degrees +anti clockwise, and @kbd{R} to rotate it 90 degrees clockwise. This +rotation is lossless, and uses an external utility called JpegTRAN. + @node Misc Dired Features @section Other Dired Features diff --git a/man/display.texi b/man/display.texi index 020721fb462..6cb2d857165 100644 --- a/man/display.texi +++ b/man/display.texi @@ -128,7 +128,7 @@ same screen line. To enable this behavior, set the variable @code{scroll-preserve-screen-position} to a non-@code{nil} value. In this mode, when these commands would scroll the text around point off the screen, or within @code{scroll-margin} lines of the edge, they -moves point to keep the same vertical position within the window. +move point to keep the same vertical position within the window. This mode is convenient for browsing through a file by scrolling by screenfuls; if you come back to the screen where you started, point goes back to the line where it started. However, this mode is @@ -333,6 +333,11 @@ those to be created in the future. (You can also set foreground and background colors for the current frame only; see @ref{Frame Parameters}.) + If you want to alter the appearance of all Emacs frames, you need to +customize the frame parameters in the variable +@code{default-frame-alist}; see @ref{Creating Frames, +default-frame-alist}. + Emacs can correctly display variable-width fonts, but Emacs commands that calculate width and indentation do not know how to calculate variable widths. This can sometimes lead to incorrect results when @@ -646,15 +651,14 @@ recently. @cindex Hi Lock mode @findex hi-lock-mode - Hi Lock mode is another minor mode, which highlights text that -matches your specified regular expressions. For example, you might -wish to see all the references to a certain variable in a program -source file, highlight certain parts in a voluminous output of some -program, or make certain names stand out in an article. Use the -@kbd{M-x hi-lock-mode} command to enable (or disable) Hi Lock mode. -To enable Hi Lock mode for all buffers, use @kbd{M-x -global-hi-lock-mode} or place @code{(global-hi-lock-mode 1)} in your -@file{.emacs} file. + Hi Lock mode highlights text that matches regular expressions you +specify. For example, you might wish to see all the references to a +certain variable in a program source file, highlight certain parts in +a voluminous output of some program, or make certain names stand out +in an article. Use the @kbd{M-x hi-lock-mode} command to enable (or +disable) Hi Lock mode. To enable Hi Lock mode for all buffers, use +@kbd{M-x global-hi-lock-mode} or place @code{(global-hi-lock-mode 1)} +in your @file{.emacs} file. Hi Lock mode works like Font Lock mode (@pxref{Font Lock}), except that you specify explicitly the regular expressions to highlight. You @@ -706,26 +710,36 @@ at point, with comment delimiters to prevent them from changing your program. (This key binding runs the @code{hi-lock-write-interactive-patterns} command.) -These patterns will be read the next time you visit the file while -Hi Lock mode is enabled, or whenever you use the @kbd{M-x -hi-lock-find-patterns} command. +These patterns are extracted from the comments, if appropriate, if you +invoke @kbd{M-x hi-lock-find-patterns}, or if you visit the file while +Hi Lock mode is enabled (since that runs @code{hi-lock-find-patterns}). @item C-x w i @kindex C-x w i @findex hi-lock-find-patterns -@vindex hi-lock-exclude-modes -Re-read regexp/face pairs in the current buffer -(@code{hi-lock-write-interactive-patterns}). Users familiar with Font -Lock keywords might interactively enter patterns -(@code{highlight-regexp}), write them into the file -(@code{hi-lock-write-interactive-patterns}), edit them, perhaps +Extract regexp/face pairs from comments in the current buffer +(@code{hi-lock-find-patterns}). Thus, you can enter patterns +interactively with @code{highlight-regexp}, store them into the file +with @code{hi-lock-write-interactive-patterns}, edit them (perhaps including different faces for different parenthesized parts of the -match, and finally use this command -(@code{hi-lock-write-interactive-patterns}) to have Hi Lock highlight -them. +match), and finally use this command (@code{hi-lock-find-patterns}) to +have Hi Lock highlight the edited patterns. + +@vindex hi-lock-file-patterns-policy +The variable @code{hi-lock-file-patterns-policy} controls whether Hi +Lock mode should automatically extract and highlight patterns found in +a file when it is visited. Its value can be @code{nil} (never +highlight), @code{t} (highlight the patterns), @code{ask} (query the +user), or a function. If it is a function, +@code{hi-lock-find-patterns} calls it with the patterns as argument; +if the function returns non-@code{nil}, the patterns are used. The +default is @code{nil}. Note that patterns are always highlighted if +you call @code{hi-lock-find-patterns} directly, regardless of the +value of this variable. -This command does nothing if the current major mode's symbol is a member -of the list @code{hi-lock-exclude-modes}. +@vindex hi-lock-exclude-modes +Also, @code{hi-lock-find-patterns} does nothing if the current major +mode's symbol is a member of the list @code{hi-lock-exclude-modes}. @end table @node Fringes diff --git a/man/doclicense.texi b/man/doclicense.texi index 14fb9926897..83e9d6b5579 100644 --- a/man/doclicense.texi +++ b/man/doclicense.texi @@ -1,6 +1,4 @@ @c -*-texinfo-*- -@node GNU Free Documentation License, Emacs Invocation, Copying, Top -@appendix GNU Free Documentation License @center Version 1.2, November 2002 @display diff --git a/man/ebrowse.texi b/man/ebrowse.texi index 25262625e92..c04f99f954c 100644 --- a/man/ebrowse.texi +++ b/man/ebrowse.texi @@ -42,8 +42,6 @@ license to the document, as described in section 6 of the license. @title Ebrowse User's Manual @sp 4 @subtitle Ebrowse/Emacs -@sp 1 -@subtitle May 2000 @sp 5 @author Gerd Moellmann @page @@ -65,6 +63,7 @@ Ebrowse. * Tree Buffers:: Traversing class hierarchies * Member Buffers:: Looking at member information * Tags-like Functions:: Finding members from source files +* GNU Free Documentation License:: The license for this documentation. * Concept Index:: An entry for each concept defined @end menu @@ -1240,7 +1239,7 @@ This key is bound to @code{describe-mode}. @comment *** TAGS LIKE FUNCTIONS @comment ************************************************************** -@node Tags-like Functions, Concept Index, Member Buffers, Top +@node Tags-like Functions, GNU Free Documentation License, Member Buffers, Top @comment node-name, next, previous, up @chapter Tags-like Functions @@ -1438,7 +1437,7 @@ The command @kbd{C-c C-m @key{TAB}} completes the symbol in front of point. -@node Member Buffer Display, , Symbol Completion, Tags-like Functions +@node Member Buffer Display, , Symbol Completion, Tags-like Functions @section Quick Member Display @cindex member buffer, for member at point @@ -1446,7 +1445,12 @@ You can quickly display a member buffer containing the member the cursor in on with the command @kbd{C-c C-m m}. -@node Concept Index, , Tags-like Functions, Top +@node GNU Free Documentation License, Concept Index, Tags-like Functions, Top +@appendix GNU Free Documentation License +@include doclicense.texi + + +@node Concept Index, , GNU Free Documentation License, Top @unnumbered Concept Index @printindex cp diff --git a/man/ediff.texi b/man/ediff.texi index 52823cdb8fb..6bb2605e0c6 100644 --- a/man/ediff.texi +++ b/man/ediff.texi @@ -56,9 +56,9 @@ license to the document, as described in section 6 of the license. @titlepage @title Ediff User's Manual @sp 4 -@subtitle Ediff version 2.76.1 +@subtitle Ediff version 2.81.1 @sp 1 -@subtitle January 2002 +@subtitle April 2007 @sp 5 @author Michael Kifer @page @@ -80,6 +80,7 @@ license to the document, as described in section 6 of the license. * Remote and Compressed Files:: You may want to know about this. * Customization:: How to make Ediff work the way YOU want. * Credits:: Thanks to those who helped. +* GNU Free Documentation License:: The license for this documentation. * Index:: @end menu @@ -2411,7 +2412,7 @@ non-@code{nil} only if Ediff uses the multiframe display, i.e., when the control buffer is in its own frame. @end table -@node Credits, Index, Customization, Top +@node Credits, GNU Free Documentation License, Customization, Top @chapter Credits Ediff was written by Michael Kifer <kifer@@cs.stonybrook.edu>. It was inspired @@ -2527,7 +2528,12 @@ Ilya Zakharevich (ilya@@math.ohio-state.edu), Eli Zaretskii (eliz@@is.elta.co.il) @end example -@node Index, , Credits, Top +@node GNU Free Documentation License, Index, Credits, Top +@appendix GNU Free Documentation License +@include doclicense.texi + + +@node Index, , GNU Free Documentation License, Top @unnumbered Index @printindex cp diff --git a/man/emacs-mime.texi b/man/emacs-mime.texi index a805b3f581b..56f130b67fb 100644 --- a/man/emacs-mime.texi +++ b/man/emacs-mime.texi @@ -75,6 +75,7 @@ read at least RFC2045 and RFC2047. * Interface Functions:: An abstraction over the basic functions. * Basic Functions:: Utility and basic parsing functions. * Standards:: A summary of RFCs and working documents used. +* GNU Free Documentation License:: The license for this documentation. * Index:: Function and variable index. @end menu @@ -1805,6 +1806,9 @@ Documentation of the text/plain format parameter for flowed text. @end table +@node GNU Free Documentation License +@chapter GNU Free Documentation License +@include doclicense.texi @node Index @chapter Index diff --git a/man/emacs.texi b/man/emacs.texi index 800532edf2f..bf18bfb6f02 100644 --- a/man/emacs.texi +++ b/man/emacs.texi @@ -5,7 +5,7 @@ @c The edition number appears in several places in this file @set EDITION Sixteenth -@set EMACSVER 22.0.97 +@set EMACSVER 22.0.98 @copying This is the @value{EDITION} edition of the @cite{GNU Emacs Manual}, @@ -39,15 +39,20 @@ Software Foundation raise funds for GNU development.'' @c in general, keep the following line commented out, unless doing a @c copy of this manual that will be published. the manual should go @c onto the distribution in the full, 8.5 x 11" size. +@set smallbook +@ifset smallbook @smallbook +@end ifset @c per rms and peterb, use 10pt fonts for the main text, mostly to @c save on paper cost. Also do not declare @setchapternewpage odd. @c Do this inside @tex for now, so current makeinfo does not complain. @tex +@ifset smallbook @fonttextsize 10 -\global\hbadness=6000 % don't worry about not-too-underfull boxes +@end ifset +\global\hbadness=6666 % don't worry about not-too-underfull boxes @end tex @defcodeindex op @@ -217,7 +222,6 @@ Advanced Features "recursive editing level". * Emulation:: Emulating some other editors with Emacs. * Hyperlinking:: Following links in buffers. -* Thumbnails:: Browsing images using thumbnails. * Dissociated Press:: Dissociating text for fun. * Amusements:: Various games and hacks. * Customization:: Modifying the behavior of Emacs. @@ -796,6 +800,7 @@ Dired, the Directory Editor * Dired Updating:: Discarding lines for files of no interest. * Dired and Find:: Using `find' to choose the files for Dired. * Wdired:: Operating on files by editing the Dired buffer. +* Image-Dired:: Viewing image thumbnails in Dired * Misc Dired Features:: Various other features. The Calendar and the Diary @@ -1683,7 +1688,10 @@ consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. +@node GNU Free Documentation License, Emacs Invocation, Copying, Top +@appendix GNU Free Documentation License @include doclicense.texi + @include cmdargs.texi @include xresources.texi diff --git a/man/erc.texi b/man/erc.texi index 3f9f506bef8..72561b33072 100644 --- a/man/erc.texi +++ b/man/erc.texi @@ -20,7 +20,14 @@ Copyright @copyright{} 2005, 2006, 2007 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no -Invariant Sections, Front-Cover texts, or Back-Cover Texts. +Invariant Sections, Front-Cover texts, or Back-Cover Texts. A copy of +the license is included in the section entitled ``GNU Free +Documentation License'' in the Emacs manual. + +This document is part of a collection distributed under the GNU Free +Documentation License. If you want to distribute this document +separately from the collection, you can do so by adding a copy of the +license to the document, as described in section 6 of the license. All Emacs Lisp code contained in this document may be used, distributed, and modified without restriction. @@ -61,6 +68,7 @@ and modified without restriction. * Advanced Usage:: Cool ways of using ERC. * Getting Help and Reporting Bugs:: * History:: The history of ERC. +* GNU Free Documentation License:: The license for this documentation. * Concept Index:: Search for terms. @detailmenu @@ -939,7 +947,7 @@ questions. @end itemize -@node History, Concept Index, Getting Help and Reporting Bugs, Top +@node History, GNU Free Documentation License, Getting Help and Reporting Bugs, Top @comment node-name, next, previous, up @chapter History @cindex history, of ERC @@ -1001,7 +1009,11 @@ our revision control system. Our mailing list address changed as well. @end itemize -@node Concept Index, , History, Top +@node GNU Free Documentation License, Concept Index, History, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Concept Index, , GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Index diff --git a/man/eshell.texi b/man/eshell.texi index 47f76a1d69a..3a4b705d2c9 100644 --- a/man/eshell.texi +++ b/man/eshell.texi @@ -89,6 +89,7 @@ handling the sort of tasks accomplished by those tools. * Extension modules:: * Extras and Goodies:: * Bugs and ideas:: Known problems, and future ideas. +* GNU Free Documentation License:: The license for this documentation. * Concept Index:: * Function and Variable Index:: * Key Index:: @@ -922,6 +923,10 @@ Since it keeps the cursor up where the command was invoked. @end table +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi + @node Concept Index @unnumbered Concept Index diff --git a/man/eudc.texi b/man/eudc.texi index 08c02131f3e..7a8dbbee524 100644 --- a/man/eudc.texi +++ b/man/eudc.texi @@ -70,6 +70,7 @@ LDAP or the CCSO white pages directory system (PH/QI) * Installation:: How to install EUDC * Usage:: The various usage possibilities explained * Credits:: Who's done what +* GNU Free Documentation License:: The license for this documentation. * Command and Function Index:: * Variables Index:: @end menu @@ -949,7 +950,7 @@ Update all EUDC variables according to their local settings. -@node Credits, Command and Function Index, Usage, Top +@node Credits, GNU Free Documentation License, Usage, Top @comment node-name, next, previous, up @chapter Credits @@ -959,7 +960,11 @@ same author. Thanks to Soren Dayton for his suggestions, his enthusiasm and his help in testing and proofreading the code and docs of @file{ph.el}. -@node Command and Function Index, Variables Index, Credits, Top +@node GNU Free Documentation License, Command and Function Index, Credits, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Command and Function Index, Variables Index, GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Command and Function Index diff --git a/man/faq.texi b/man/faq.texi index 781d7b5ce56..787a85443fc 100644 --- a/man/faq.texi +++ b/man/faq.texi @@ -1211,8 +1211,8 @@ indicated in the source buffer. @item @cindex New modes Many new modes and packages have been included in Emacs, such as Calc, -TRAMP, URL, IDO, CUA, ERC, rcirc, Table, Tumme, SES, Ruler, Org, PGG, -Flymake, Password, Printing, Reveal, wdired, t-mouse, longlines, +TRAMP, URL, IDO, CUA, ERC, rcirc, Table, Image-Dired, SES, Ruler, Org, +PGG, Flymake, Password, Printing, Reveal, wdired, t-mouse, longlines, savehist, Conf mode, Python mode, DNS mode, etc. @cindex Multilingual Environment diff --git a/man/files.texi b/man/files.texi index 49c310452b4..16acf241433 100644 --- a/man/files.texi +++ b/man/files.texi @@ -1153,13 +1153,14 @@ recover are present in Emacs buffers. You should then save them. Only this---saving them---updates the files themselves. @vindex auto-save-list-file-prefix - Emacs records interrupted sessions for later recovery in files named + Emacs records information about interrupted sessions for later +recovery in files named @file{~/.emacs.d/auto-save-list/.saves-@var{pid}-@var{hostname}}. All -of this name except @file{@var{pid}-@var{hostname}} comes from the -value of @code{auto-save-list-file-prefix}. You can record sessions -in a different place by customizing that variable. If you set -@code{auto-save-list-file-prefix} to @code{nil} in your @file{.emacs} -file, sessions are not recorded for recovery. +of this name except the @file{@var{pid}-@var{hostname}} part comes +from the value of @code{auto-save-list-file-prefix}. You can record +sessions in a different place by customizing that variable. If you +set @code{auto-save-list-file-prefix} to @code{nil} in your +@file{.emacs} file, sessions are not recorded for recovery. @node File Aliases @section File Name Aliases @@ -2582,6 +2583,8 @@ requires the appropriate uncompression program. A separate but similar Archive mode is used for archives produced by the programs @code{arc}, @code{jar}, @code{lzh}, @code{zip}, and @code{zoo}, which have extensions corresponding to the program names. +Archive mode also works for those @code{exe} files that are +self-extracting executables. The key bindings of Archive mode are similar to those in Tar mode, with the addition of the @kbd{m} key which marks a file for subsequent @@ -2815,13 +2818,8 @@ works only when Emacs can display the specific image type. @findex thumbs-mode @findex mode, thumbs - Thumbs mode is a major mode for viewing directories containing many -image files. To use it, type @kbd{M-x thumbs} and specify the -directory to view. The images in that directory will be displayed in -a @samp{Thumbs} buffer as @dfn{thumbnails}; type @kbd{RET} on a -thumbnail to view the full-size image. Thumbs mode requires the -@file{convert} program, which is part of the ImageMagick software -package. + See also the Image-Dired package (@pxref{Image-Dired}) for viewing +images as thumbnails. @node Filesets @section Filesets diff --git a/man/flymake.texi b/man/flymake.texi index 4d6b8303f4a..16947d7f2de 100644 --- a/man/flymake.texi +++ b/man/flymake.texi @@ -44,6 +44,7 @@ license to the document, as described in section 6 of the license. @author Pavel Kobiakov(@email{pk_at_work@@yahoo.com}) @page @vskip 0pt plus 1filll +@insertcopying @end titlepage @contents @@ -59,6 +60,7 @@ license to the document, as described in section 6 of the license. * Using Flymake:: * Configuring Flymake:: * Flymake Implementation:: +* GNU Free Documentation License:: * Index:: @end menu @@ -744,6 +746,10 @@ Flymake also provides an alternative command for starting compilation, It just kills all the active syntax check processes before calling @code{compile}. +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi + @node Index @unnumbered Index diff --git a/man/forms.texi b/man/forms.texi index 46210dc8e41..4114453df6c 100644 --- a/man/forms.texi +++ b/man/forms.texi @@ -53,9 +53,9 @@ license to the document, as described in section 6 of the license. @sp 4 @center Forms-Mode version 2 @sp 1 -@center for GNU Emacs 20.1 +@center for GNU Emacs 22.1 @sp 1 -@center June 1997 +@center April 2007 @sp 5 @center Johan Vromans @center @i{jvromans@@squirrel.nl} @@ -91,6 +91,7 @@ how to present it. * Miscellaneous:: Forms mode messages and other remarks. * Error Messages:: List of error messages forms mode can produce. * Long Example:: A more complex control file example. +* GNU Free Documentation License:: The license for this documentation. * Credits:: Thanks everyone. * Index:: Index to this manual. @end menu @@ -968,6 +969,10 @@ mode'' by Paul Davis at Schlumberger Cambridge Research None of this would have been possible without GNU Emacs of the Free Software Foundation. Thanks, Richard! +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi + @node Index @unnumbered Index @printindex cp diff --git a/man/frames.texi b/man/frames.texi index 965ccb0a7b0..a45b582b455 100644 --- a/man/frames.texi +++ b/man/frames.texi @@ -515,6 +515,8 @@ frame. This runs @code{find-file-read-only-other-frame}. @cindex default-frame-alist @cindex initial-frame-alist +@cindex face customization, in @file{~/.emacs} +@cindex color customization, in @file{~/.emacs} You can control the appearance of new frames you create by setting the frame parameters in @code{default-frame-alist}. You can use the variable @code{initial-frame-alist} to specify parameters that affect @@ -538,6 +540,11 @@ Here's a similar example for specifying a foreground color: (add-to-list 'default-frame-alist '(foreground-color . "blue")) @end example +@noindent +By putting such customizations in your @file{~/.emacs} init file, you +can control the appearance of all the frames Emacs creates, including +the initial one. + @node Frame Commands @section Frame Commands @@ -874,7 +881,7 @@ feature, use @kbd{M-x mouse-wheel-mode}. @vindex mouse-wheel-follow-mouse @vindex mouse-wheel-scroll-amount @vindex mouse-wheel-progressive-speed - The variables @code{mouse-wheel-follow-mouse} and + The two variables @code{mouse-wheel-follow-mouse} and @code{mouse-wheel-scroll-amount} determine where and by how much buffers are scrolled. The variable @code{mouse-wheel-progressive-speed} determines whether the scroll diff --git a/man/glossary.texi b/man/glossary.texi index 2a55b49645b..d082e6ec077 100644 --- a/man/glossary.texi +++ b/man/glossary.texi @@ -601,6 +601,10 @@ have. To make a character Hyper, type it while holding down the @kbd{Hyper-} (usually written @kbd{H-} for short). @xref{User Input, Hyper}. +@item Iff +``Iff'' means ``if and only if.'' This terminology comes from +mathematics. + @item Inbox An inbox is a file in which mail is delivered by the operating system. Rmail transfers mail from inboxes to Rmail files (q.v.@:) in which the diff --git a/man/gnu.texi b/man/gnu.texi index 3b8a8e17f0a..1cf85f41c3c 100644 --- a/man/gnu.texi +++ b/man/gnu.texi @@ -41,10 +41,9 @@ Since that time, we have learned about certain common misunderstandings that different wording could help avoid. Footnotes added in 1993 help clarify these points. -For up-to-date information about the available GNU software, please -see @uref{http://www.gnu.org}. For software tasks to work on, see -@uref{http://savannah.gnu.org/projects/tasklist}. For other ways to -contribute, see @uref{http://www.gnu.org/help}. +For up-to-date information about available GNU software, please see +our web site, @uref{http://www.gnu.org}. For software tasks and other +ways to contribute, see @uref{http://www.gnu.org/help}. @end quotation @unnumberedsec What's GNU? Gnu's Not Unix! @@ -503,10 +502,11 @@ The sale of teaching, hand-holding and maintenance services could also employ programmers. People with new ideas could distribute programs as -freeware@footnote{Subsequently we have learned to distinguish between -"free software" and "freeware". The term "freeware" means software -you are free to redistribute, but usually you are not free to study -and change the source code, so most of it is not free software. See +freeware@footnote{Subsequently we have discovered the need to +distinguish between ``free software'' and ``freeware''. The term +``freeware'' means software you are free to redistribute, but usually +you are not free to study and change the source code, so most of it is +not free software. See @uref{http://www.gnu.org/philosophy/words-to-avoid.html} for more explanation.}, asking for donations from satisfied users, or selling hand-holding services. I have met people who are already working this diff --git a/man/gnus.texi b/man/gnus.texi index 7e5ab5a5342..48ecd630265 100644 --- a/man/gnus.texi +++ b/man/gnus.texi @@ -402,6 +402,7 @@ the program. * Various:: General purpose settings. * The End:: Farewell and goodbye. * Appendices:: Terminology, Emacs intro, @acronym{FAQ}, History, Internals. +* GNU Free Documentation License:: The license for this documentation. * Index:: Variable, function and concept index. * Key Index:: Key Index. @@ -29028,6 +29029,10 @@ former). The manual is unambiguous, but it can be confusing. @page @include gnus-faq.texi +@node GNU Free Documentation License +@chapter GNU Free Documentation License +@include doclicense.texi + @node Index @chapter Index @printindex cp diff --git a/man/idlwave.texi b/man/idlwave.texi index 49ee0b7a110..94f59249892 100644 --- a/man/idlwave.texi +++ b/man/idlwave.texi @@ -106,6 +106,7 @@ Interactive Data Language (IDL), and running IDL as an inferior shell. * Configuration Examples:: The user is king * Windows and MacOS:: What still works, and how * Troubleshooting:: When good computers turn bad +* GNU Free Documentation License:: The license for this documentation. * Index:: Fast access @detailmenu @@ -4096,7 +4097,7 @@ help can skip the browser and use the HTMLHelp functionality directly. @html <A NAME="TROUBLE"></A> @end html -@node Troubleshooting, Index, Windows and MacOS, Top +@node Troubleshooting, GNU Free Documentation License, Windows and MacOS, Top @appendix Troubleshooting @cindex Troubleshooting @@ -4302,7 +4303,11 @@ IDLWAVE is @samp{fsf-compat, xemacs-base, mail-lib}. @end enumerate -@node Index, , Troubleshooting, Top +@node GNU Free Documentation License, Index, Troubleshooting, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Index, , GNU Free Documentation License, Top @unnumbered Index @printindex cp diff --git a/man/killing.texi b/man/killing.texi index 3903db82166..b626bfab385 100644 --- a/man/killing.texi +++ b/man/killing.texi @@ -551,13 +551,13 @@ Insert blank space to fill the space of the region-rectangle (@code{open-rectangle}). This pushes the previous contents of the region-rectangle rightward. @item C-x r c -Clear the region-rectangle by replacing its contents with spaces +Clear the region-rectangle by replacing all of its contents with spaces (@code{clear-rectangle}). @item M-x delete-whitespace-rectangle Delete whitespace in each of the lines on the specified rectangle, starting from the left edge column of the rectangle. @item C-x r t @var{string} @key{RET} -Replace rectangle contents with @var{string} on each line. +Replace rectangle contents with @var{string} on each line (@code{string-rectangle}). @item M-x string-insert-rectangle @key{RET} @var{string} @key{RET} Insert @var{string} on each line of the rectangle. diff --git a/man/macos.texi b/man/macos.texi index c38c03817ab..28d7f43df8e 100644 --- a/man/macos.texi +++ b/man/macos.texi @@ -319,8 +319,9 @@ by the name: -apple-monaco-medium-r-normal--12-*-*-*-*-*-iso10646-1 @end example -Note that it must be specified in a format containing 14 @samp{-}s -(e.g., not by @samp{-apple-monaco-medium-r-normal--12-*-iso10646-1}), +Note that these names must be specified using a format containing all +14 @samp{-}s (not by +@samp{-apple-monaco-medium-r-normal--12-*-iso10646-1}, for instance), because every @acronym{ATSUI}-compatible font is a scalable one. QuickDraw Text fonts have maker name @code{apple} and various charset @@ -340,7 +341,7 @@ font for Latin-1 characters introduces wrong glyphs. Native Apple Traditional Chinese, Simplified Chinese, Japanese, Korean, Central European, Cyrillic, Symbol, and Dingbats fonts have -charsets @samp{big5-0}, @samp{gb2312.1980-0}, +the charsets @samp{big5-0}, @samp{gb2312.1980-0}, @samp{jisx0208.1983-sjis} and @samp{jisx0201.1976-0}, @samp{ksc5601.1989-0}, @samp{mac-centraleurroman}, @samp{mac-cyrillic}, @samp{mac-symbol}, and @samp{mac-dingbats}, diff --git a/man/message.texi b/man/message.texi index ccf44f2bade..c843d8c58d9 100644 --- a/man/message.texi +++ b/man/message.texi @@ -63,6 +63,7 @@ Message mode buffers. * Variables:: Customizing the message buffers. * Compatibility:: Making Message backwards compatible. * Appendices:: More technical things. +* GNU Free Documentation License:: The license for this documentation. * Index:: Variable, function and concept index. * Key Index:: List of Message mode keys. @end menu @@ -2338,6 +2339,9 @@ basis of the new @code{Cc} header, except if this header is @end table +@node GNU Free Documentation License +@chapter GNU Free Documentation License +@include doclicense.texi @node Index @chapter Index diff --git a/man/misc.texi b/man/misc.texi index e3eca68532e..c4cdea4359d 100644 --- a/man/misc.texi +++ b/man/misc.texi @@ -2177,8 +2177,9 @@ also use the command @kbd{M-x scroll-all-mode} or set the variable @item EDT (DEC VMS editor) @findex edt-emulation-on @findex edt-emulation-off -Turn on EDT emulation with @kbd{M-x edt-emulation-on}. @kbd{M-x -edt-emulation-off} restores normal Emacs command bindings. +Turn on EDT emulation with the command @kbd{M-x edt-emulation-on}, +while @kbd{M-x edt-emulation-off} restores normal Emacs command +bindings. Most of the EDT emulation commands are keypad keys, and most standard Emacs key bindings are still available. The EDT emulation rebindings @@ -2234,7 +2235,7 @@ not use it. key bindings. @end table -@node Hyperlinking, Thumbnails, Emulation, Top +@node Hyperlinking, Dissociated Press, Emulation, Top @section Hyperlinking and Navigation Features @cindex hyperlinking @@ -2400,76 +2401,7 @@ Display a menu of files and URLs mentioned in current buffer, then find the one you select (@code{ffap-menu}). @end table -@node Thumbnails, Dissociated Press, Hyperlinking, Top -@section Viewing Images as Thumbnails -@cindex tumme mode -@cindex thumbnails - - Tumme is a facility for browsing image files. It provides viewing -the images either as thumbnails or in full size, either inside Emacs -or through an external viewer. - - To enter Tumme, type @kbd{M-x tumme}. It prompts for a directory; -specify one that has images files. This creates thumbnails for all -the images in that directory, and displays them all in the ``thumbnail -buffer.'' This takes a long time if the directory contains many image -files, and it asks for confirmation if the number of image files -exceeds @code{tumme-show-all-from-dir-max-files}. - -@kindex C-t d @r{(Tumme)} -@findex tumme-display-thumbs - You can also enter Tumme through Dired. Mark the image files you -want to look at, using @kbd{m} as usual, then type @kbd{C-t d} -(@code{tumme-display-thumbs}). This too creates and switches to -a buffer containing thumbnails, corresponding to the marked files. - - With point in the thumbnail buffer, type @kbd{RET} -(@code{tumme-display-thumbnail-original-image}) to display a sized -version of it in another window. This sizes the image to fit the -window. Use the arrow keys to move around in the buffer. For easy -browsing, type @kbd{SPC} (@code{tumme-display-next-thumbnail-original}) -to advance and display the next image. Typing @kbd{DEL} -(@code{tumme-display-previous-thumbnail-original}) backs up to the -previous thumbnail and displays that instead. - -@vindex tumme-external-viewer - To view and the image in its original size, either provide a prefix -argument (@kbd{C-u}) before pressing @kbd{RET}, or type @kbd{C-@key{RET}} -(@code{tumme-thumbnail-display-external}) to display the image in an -external viewer. You must first configure -@code{tumme-external-viewer}. - - You can delete images through Tumme also. Type @kbd{d} -(@code{tumme-flag-thumb-original-file}) to flag the image file for -deletion in the Dired buffer. You can also delete the thumbnail image -from the thumbnail buffer with @kbd{C-d} (@code{tumme-delete-char}). - - More advanced features include @dfn{image tags}, which are metadata -used to categorize image files. The tags are stored in a plain text -file configured by @code{tumme-db-file}. - - To tag image files, mark them in the dired buffer (you can also mark -files in Dired from the thumbnail buffer by typing @kbd{m}) and type -@kbd{C-t t} (@code{tumme-tag-files}). You will be prompted for a tag. -To mark files having a certain tag, type @kbd{C-t f} -(@code{tumme-mark-tagged-files}). After marking image files with a -certain tag, you can use @kbd{C-t d} to view them. - - You can also tag a file directly from the thumbnail buffer by typing -@kbd{t t} and you can remove a tag by typing @kbd{t r}. There is also -a special ``tag'' called ``comment'' for each file (it is not a tag in -the exact same sense as the other tags, it is handled slightly -different). That is used to enter a comment or description about the -image. You comment a file from the thumbnail buffer by typing -@kbd{c}. You will be prompted for a comment. Type @kbd{C-t c} to add -a comment from Dired (@code{tumme-dired-comment-files}). - - Tumme also provides simple image manipulation. In the thumbnail -buffer, type @kbd{L} to rotate the original image 90 degrees anti -clockwise, and @kbd{R} to rotate it 90 degrees clockwise. This -rotation is lossless, and uses an external utility called JpegTRAN. - -@node Dissociated Press, Amusements, Thumbnails, Top +@node Dissociated Press, Amusements, Hyperlinking, Top @section Dissociated Press @findex dissociated-press diff --git a/man/mule.texi b/man/mule.texi index a812cf398b9..c71c820dc27 100644 --- a/man/mule.texi +++ b/man/mule.texi @@ -261,6 +261,9 @@ Thai, Tibetan, Turkish, UTF-8 (for a setup which prefers Unicode characters and files encoded in UTF-8), Ukrainian, Vietnamese, Welsh, and Windows-1255 (for a setup which prefers Cyrillic characters and files encoded in Windows-1255). +@tex +\hbadness=10000\par % just avoid underfull hbox warning +@end tex @end quotation @cindex fonts for various scripts diff --git a/man/newsticker.texi b/man/newsticker.texi index 95934792a02..48d7f992667 100644 --- a/man/newsticker.texi +++ b/man/newsticker.texi @@ -48,6 +48,7 @@ license to the document, as described in section 6 of the license. @author @uref{http://de.geocities.com/ulf_jasper} @page @vskip 0pt plus 1filll +@insertcopying @end titlepage @contents @@ -64,6 +65,7 @@ license to the document, as described in section 6 of the license. * Usage:: Basic newsticker instructions. * Configuration:: Customizable newsticker settings. * Remarks:: Remarks about newsticker. +* GNU Free Documentation License:: The license for this documentation. * Index:: Variable, function, and concept index. @end menu @@ -270,7 +272,9 @@ every once in a while. Byte-compiling newsticker.el is recommended. - +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi @node Index @unnumbered Index diff --git a/man/org.texi b/man/org.texi index 4b484f25409..aacc2929d13 100644 --- a/man/org.texi +++ b/man/org.texi @@ -89,6 +89,7 @@ Software Foundation raise funds for GNU development.'' * Miscellaneous:: All the rest which did not fit elsewhere * Extensions and Hacking:: It is possible to write add-on code * History and Acknowledgments:: How Org-mode came into being +* GNU Free Documentation License:: The license for this documentation. * Index:: The fast road to specific information * Key Index:: Key bindings and where they are described @@ -1478,9 +1479,9 @@ described below, see @ref{Advanced features}. @cindex syntax, of formulas A formula can be any algebraic expression understood by the Emacs -@file{Calc} package. Note that @file{calc} has the slightly +@file{Calc} package. @b{Note that @file{calc} has the non-standard convention that @samp{/} has lower precedence than -@samp{*}, so that @samp{a/b*c} is interpreted as @samp{a/(b*c)}. Before +@samp{*}, so that @samp{a/b*c} is interpreted as @samp{a/(b*c)}.} Before evaluation by @code{calc-eval} (@pxref{Calling Calc from Your Programs,calc-eval,Calling calc from Your Lisp Programs,calc,GNU Emacs Calc Manual}), @@ -6416,7 +6417,7 @@ MATCH is being ignored." @end lisp -@node History and Acknowledgments, Index, Extensions and Hacking, Top +@node History and Acknowledgments, GNU Free Documentation License, Extensions and Hacking, Top @appendix History and Acknowledgments @cindex acknowledgments @cindex history @@ -6567,8 +6568,12 @@ work on a tty. and contributed various ideas and code snippets. @end itemize +@node GNU Free Documentation License, Index, History and Acknowledgments, Top +@appendix GNU Free Documentation License +@include doclicense.texi -@node Index, Key Index, History and Acknowledgments, Top + +@node Index, Key Index, GNU Free Documentation License, Top @unnumbered Index @printindex cp diff --git a/man/pcl-cvs.texi b/man/pcl-cvs.texi index e2030c5f758..93bd54eb456 100644 --- a/man/pcl-cvs.texi +++ b/man/pcl-cvs.texi @@ -91,6 +91,7 @@ of the various commands and major modes for further information. * Customization:: How you can tailor PCL-CVS to suit your needs. * Bugs:: Bugs (known and unknown). +* GNU Free Documentation License:: The license for this documentation. * Function and Variable Index:: List of functions and variables. * Concept Index:: List of concepts. * Key Index:: List of keystrokes. @@ -1363,7 +1364,7 @@ Used to highlight CVS messages. @end table -@node Bugs, Function and Variable Index, Customization, Top +@node Bugs, GNU Free Documentation License, Customization, Top @chapter Bugs (known and unknown) @cindex Reporting bugs and ideas @cindex Bugs, how to report them @@ -1403,7 +1404,13 @@ output of the CVS process (which should be found in the @samp{ *cvs-tmp*} buffer), and the versions of Emacs, PCL-CVS and CVS you are using. @end table -@node Function and Variable Index, Concept Index, Bugs, Top +@node GNU Free Documentation License, Function and Variable Index, Bugs, Top +@appendix GNU Free Documentation License +@include doclicense.texi + + + +@node Function and Variable Index, Concept Index, GNU Free Documentation License, Top @unnumbered Function and Variable Index This is an index of all the functions and variables documented in this diff --git a/man/pgg.texi b/man/pgg.texi index 263169374d4..6a175db4cb9 100644 --- a/man/pgg.texi +++ b/man/pgg.texi @@ -52,6 +52,7 @@ user interface to encrypt, decrypt, sign, and verify MIME messages. * How to use:: Getting started quickly. * Architecture:: * Parsing OpenPGP packets:: +* GNU Free Documentation License:: The license for this documentation. * Function Index:: * Variable Index:: @end menu @@ -474,12 +475,16 @@ and @var{end}. If non-@code{nil}, don't check the checksum of the packets. @end defvar +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi + @node Function Index -@chapter Function Index +@unnumbered Function Index @printindex fn @node Variable Index -@chapter Variable Index +@unnumbered Variable Index @printindex vr @summarycontents diff --git a/man/programs.texi b/man/programs.texi index 5283a1de288..2472d7daabe 100644 --- a/man/programs.texi +++ b/man/programs.texi @@ -338,13 +338,13 @@ buffer. @findex which-function-mode @vindex which-func-modes - To enable (or disable) Which Function mode, use the command @kbd{M-x -which-function-mode}. This command is global; it applies to all -buffers, both existing ones and those yet to be created. However, it -takes effect only in certain major modes, those listed in the value of -@code{which-func-modes}. If the value is @code{t}, then Which Function -mode applies to all major modes that know how to support it---in other -words, all the major modes that support Imenu. + To either enable or disable Which Function mode, use the command +@kbd{M-x which-function-mode}. This command is global; it applies to +all buffers, both existing ones and those yet to be created. However, +it takes effect only in certain major modes, those listed in the value +of @code{which-func-modes}. If the value is @code{t}, then Which +Function mode applies to all major modes that know how to support +it---in other words, all the major modes that support Imenu. @node Program Indent @section Indentation for Programs diff --git a/man/rcirc.texi b/man/rcirc.texi index 7b2d6b1c945..6d5319cef4e 100644 --- a/man/rcirc.texi +++ b/man/rcirc.texi @@ -55,6 +55,7 @@ just one other user. * Basics:: * Reference:: * Hacking and Tweaking:: +* GNU Free Documentation License:: * Key Index:: * Variable Index:: * Index:: @@ -589,7 +590,7 @@ activation of this mode: (rcirc-track-minor-mode 1))) @end example -@node Hacking and Tweaking, Key Index, Reference, Top +@node Hacking and Tweaking, GNU Free Documentation License, Reference, Top @chapter Hacking and Tweaking @cindex hacking and tweaking @@ -743,7 +744,12 @@ The real answer, therefore, is a @code{/reconnect} command: channels)))) @end smallexample -@node Key Index, Variable Index, Hacking and Tweaking, Top +@node GNU Free Documentation License, Key Index, Hacking and Tweaking, Top +@appendix GNU Free Documentation License +@include doclicense.texi + + +@node Key Index, Variable Index, GNU Free Documentation License, Top @unnumbered Key Index @printindex ky diff --git a/man/reftex.texi b/man/reftex.texi index 10943c9d65e..a2c0a9689b2 100644 --- a/man/reftex.texi +++ b/man/reftex.texi @@ -116,6 +116,7 @@ needed. * Options:: How to extend and configure RefTeX. * Keymaps and Hooks:: For customization. * Changes:: A List of recent changes to RefTeX. +* GNU Free Documentation License:: The license for this documentation. The Index @@ -5149,7 +5150,7 @@ their own keymaps and mode hooks. See the respective sections. There are many more hooks which are described in the relevant sections about options for a specific part of @b{Ref@TeX{}}. -@node Changes, , Keymaps and Hooks, Top +@node Changes, GNU Free Documentation License, Keymaps and Hooks, Top @chapter Changes @cindex Changes @@ -5880,11 +5881,11 @@ new labels. released on 7 Jan 1997. @end itemize +@node GNU Free Documentation License, Index, Changes, Top +@appendix GNU Free Documentation License +@include doclicense.texi - - - -@node Index, , , Top +@node Index, , GNU Free Documentation License, Top @unnumbered Index @printindex cp diff --git a/man/rmail.texi b/man/rmail.texi index 16ecfee9015..7c36a31ff18 100644 --- a/man/rmail.texi +++ b/man/rmail.texi @@ -1382,9 +1382,10 @@ then Rmail will ask you for the password to use. Otherwise, Rmail assumes no password is required. @end enumerate - For compatibility with previous versions, @code{rmail-pop-password} -and @code{rmail-pop-password-required} may be used instead of -@code{rmail-remote-password} and @code{rmail-remote-password-required}. + For compatibility with previous versions, the variables +@code{rmail-pop-password} and @code{rmail-pop-password-required} may +be used instead of @code{rmail-remote-password} and +@code{rmail-remote-password-required}. @vindex rmail-movemail-flags If you need to pass additional command-line flags to @code{movemail}, diff --git a/man/sc.texi b/man/sc.texi index d3f7264f4cc..5ac3b882ccd 100644 --- a/man/sc.texi +++ b/man/sc.texi @@ -1,5 +1,5 @@ \input texinfo @comment -*-texinfo-*- -@comment 3.47 +@comment 3.48 @comment %**start of header (This is for running Texinfo on a region.) @setfilename ../info/sc @settitle Supercite Version 3.1 User's Manual @@ -52,8 +52,8 @@ license to the document, as described in section 6 of the license. @sp 2 @center @titlefont{Supercite Version 3.1} @sp 4 -@center Manual Revision: 3.47 -@center August 1993 +@center Manual Revision: 3.48 +@center April 2007 @sp 5 @center Barry A@. Warsaw @center @t{bwarsaw@@cen.com} @@ -86,6 +86,7 @@ subsystems. The manual is divided into the following chapters. * Thanks and History:: * The Supercite Mailing List:: +* GNU Free Documentation License:: * Concept Index:: * Command Index:: * Key Index:: @@ -2444,7 +2445,7 @@ for adding the magic lisp to their code to support this. All who have helped and contributed have been greatly appreciated. -@node The Supercite Mailing List, Concept Index, Thanks and History, Top +@node The Supercite Mailing List, GNU Free Documentation License, Thanks and History, Top @comment node-name, next, previous, up @cindex supercite mailing list address @cindex mailing list address @@ -2481,7 +2482,11 @@ will set up a mail buffer automatically with this address on the supercite-help@@python.org @end example -@node Concept Index, Command Index, The Supercite Mailing List, Top +@node GNU Free Documentation License, Concept Index, The Supercite Mailing List, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Concept Index, Command Index, GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Concept Index @printindex cp diff --git a/man/search.texi b/man/search.texi index 47d73bd26f6..1a8a6372ba2 100644 --- a/man/search.texi +++ b/man/search.texi @@ -1002,6 +1002,9 @@ C-@key{SPC}} to move back there. A numeric argument restricts replacement to matches that are surrounded by word boundaries. The argument's value doesn't matter. + @xref{Replacement and Case}, for details about case-sensitivity in +replace commands. + What if you want to exchange @samp{x} and @samp{y}: replace every @samp{x} with a @samp{y} and vice versa? You can do it this way: @example @@ -1155,9 +1158,9 @@ This command finds occurrences of @samp{foo} one by one, displays each occurrence and asks you whether to replace it. Aside from querying, @code{query-replace} works just like @code{replace-string}. It preserves case, like @code{replace-string}, provided -@code{case-replace} is non-@code{nil}, as it normally is. A numeric -argument means consider only occurrences that are bounded by -word-delimiter characters. +@code{case-replace} is non-@code{nil}, as it normally is +(@pxref{Replacement and Case}). A numeric argument means consider +only occurrences that are bounded by word-delimiter characters. @kindex C-M-% @findex query-replace-regexp diff --git a/man/sending.texi b/man/sending.texi index a130a58816a..5d6a7c83f3e 100644 --- a/man/sending.texi +++ b/man/sending.texi @@ -240,11 +240,11 @@ yourself, Emacs puts in one for you. The variable @item nil Use just the email address, as in @samp{king@@grassland.com}. @item parens -Use both email address and full name, as in @samp{king@@grassland.com (Elvis -Parsley)}. +Use both email address and full name, as in:@* +@samp{king@@grassland.com (Elvis Parsley)}. @item angles -Use both email address and full name, as in @samp{Elvis Parsley -<king@@grassland.com>}. +Use both email address and full name, as in:@* +@samp{Elvis Parsley <king@@grassland.com>}. @item system-default Allow the system to insert the @samp{From} field. @end table diff --git a/man/ses.texi b/man/ses.texi index ff4b47f2ee4..089e13a9cc0 100644 --- a/man/ses.texi +++ b/man/ses.texi @@ -77,6 +77,7 @@ To report bugs, send email to @email{jyavner@@member.fsf.org}. * For Gurus:: Want to know @emph{even more}? * Index:: Concept, Function and Variable Index * Acknowledgements:: Acknowledgements +* GNU Free Documentation License:: The license for this documentation. @end menu @c =================================================================== @@ -929,7 +930,7 @@ cell. @c =================================================================== -@node Acknowledgements, , Index, Top +@node Acknowledgements, GNU Free Documentation License, Index, Top @chapter Acknowledgements Coding by: @@ -970,6 +971,10 @@ Jean-Philippe Theberge @email{jphil@@acs.pagesjaunes.fr} @c =================================================================== +@node GNU Free Documentation License, , Acknowledgements, Top +@appendix GNU Free Documentation License +@include doclicense.texi + @bye @ignore diff --git a/man/sieve.texi b/man/sieve.texi index 5e11adcaac2..1030babd593 100644 --- a/man/sieve.texi +++ b/man/sieve.texi @@ -73,6 +73,7 @@ A good online Sieve resources is @uref{http://www.cyrusoft.com/sieve/}. * Examples :: A few Sieve code snippets. * Manage Sieve API :: Interfacing to the Manage Sieve Protocol API. * Standards:: A summary of RFCs and working documents used. +* GNU Free Documentation License:: The license for this documentation. * Index:: Function and variable index. @end menu @@ -349,9 +350,12 @@ A Protocol for Remotely Managing Sieve Scripts @end table +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi @node Index -@chapter Index +@unnumbered Index @printindex cp @summarycontents diff --git a/man/smtpmail.texi b/man/smtpmail.texi index 860e06de0e1..644cd061b74 100644 --- a/man/smtpmail.texi +++ b/man/smtpmail.texi @@ -55,6 +55,7 @@ license to the document, as described in section 6 of the license. * Queued delivery:: Sending mail without an internet connection. * Server workarounds:: Mail servers with special requirements. * Debugging:: Tracking down problems. +* GNU Free Documentation License:: The license for this documentation. Indices @@ -403,6 +404,10 @@ cannot accept mail. @end table +@node GNU Free Documentation License +@chapter GNU Free Documentation License +@include doclicense.texi + @node Index @chapter Index diff --git a/man/speedbar.texi b/man/speedbar.texi index 42f9f3dcc48..2a05993f569 100644 --- a/man/speedbar.texi +++ b/man/speedbar.texi @@ -82,6 +82,7 @@ on. @xref{Basic Navigation}. * Minor Modes:: Additional minor modes such as Info and RMAIL. * Customizing:: Changing speedbar behavior. * Extending:: Extend speedbar for your own project. +* GNU Free Documentation License:: The license for this documentation. * Index:: @end menu @@ -885,7 +886,7 @@ Set this to implement your own scanning or rescan safe functions with state data. @end table -@node Extending, Index, Customizing, Top +@node Extending, GNU Free Documentation License, Customizing, Top @comment node-name, next, previous, up @chapter Extending @cindex extending @@ -1241,7 +1242,12 @@ Two good values are @code{nil} and @code{statictag}. @end defun -@node Index, , Extending, Top +@node GNU Free Documentation License, Index, Extending, Top +@appendix GNU Free Documentation License +@include doclicense.texi + + +@node Index, , GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Concept Index @printindex cp diff --git a/man/tramp.texi b/man/tramp.texi index 9597344ee0c..7acef2663e4 100644 --- a/man/tramp.texi +++ b/man/tramp.texi @@ -159,6 +159,8 @@ For the developer: * Files directories and localnames:: How file names, directories and localnames are mangled and managed. * Issues:: Debatable Issues and What Was Decided. +* GNU Free Documentation License:: The license for this documentation. + @detailmenu --- The Detailed Node Listing --- @c @@ -2406,6 +2408,10 @@ for @value{emacsothername}. @end ifset @end itemize +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi + @node Concept Index @comment node-name, next, previous, up @unnumbered Concept Index diff --git a/man/url.texi b/man/url.texi index aeabc435bfd..0fc6b08acdc 100644 --- a/man/url.texi +++ b/man/url.texi @@ -74,6 +74,7 @@ License.'' * General Facilities:: URLs can be cached, accessed via a gateway and tracked in a history list. * Customization:: Variables you can alter. +* GNU Free Documentation License:: The license for this documentation. * Function Index:: * Variable Index:: * Concept Index:: @@ -1176,6 +1177,10 @@ Connect directly. @end table @end defopt +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include doclicense.texi + @node Function Index @unnumbered Command and Function Index @printindex fn diff --git a/man/vip.texi b/man/vip.texi index 11c21cbdf6e..a3f4a447f82 100644 --- a/man/vip.texi +++ b/man/vip.texi @@ -73,6 +73,8 @@ Comments and bug reports are welcome. Please send messages to * Vi Commands:: Details of Vi commands. * Ex Commands:: Details of Ex commands. * Customization:: How to customize VIP. +* GNU Free Documentation License:: The license for this documentation. + @end menu @iftex @unnumbered Introduction @@ -1935,6 +1937,11 @@ file. (define-key vip-command-mode-map "X" 'vip-delete-backward-char) @end example +@node GNU Free Documentation License,,, Top +@appendix GNU Free Documentation License +@include doclicense.texi + + @unnumbered Key Index @printindex ky diff --git a/man/viper.texi b/man/viper.texi index af78bd99e47..55c97f18c9c 100644 --- a/man/viper.texi +++ b/man/viper.texi @@ -42,7 +42,7 @@ license to the document, as described in section 6 of the license. @titlepage @title Viper Is a Package for Emacs Rebels @subtitle a Vi emulator for Emacs -@subtitle January 2002, Viper Version 3.11.2 +@subtitle April 2007, Viper Version 3.13.1 @author Michael Kifer (Viper) @author Aamod Sane (VIP 4.4) @@ -114,6 +114,8 @@ Please use the Ex command @kbd{:submitReport} for this purpose.@refill * Concept Index:: Vi, Ex and Emacs concepts * Acknowledgments:: +* GNU Free Documentation License:: The license for this documentation. + @end menu @iftex @unnumbered Introduction @@ -4534,6 +4536,9 @@ whicken@@dragon.parasoft.com (Wendell Hicken), zapman@@cc.gatech.edu (Jason Zapman II), @end example +@node GNU Free Documentation License,,, Top +@appendix GNU Free Documentation License +@include doclicense.texi @node Key Index,Function Index,,Top @comment node-name, next, previous, up diff --git a/man/widget.texi b/man/widget.texi index 72157289524..0cf77ee4600 100644 --- a/man/widget.texi +++ b/man/widget.texi @@ -57,6 +57,7 @@ Software Foundation raise funds for GNU development.'' * Widget Minor Mode:: * Utilities:: * Widget Wishlist:: +* GNU Free Documentation License:: * Index:: @end menu @@ -1774,7 +1775,7 @@ Get the item which @var{widget} is assumed to toggle. This is only meaningful for radio buttons or checkboxes in a list. @end defun -@node Widget Wishlist, Index, Utilities, Top +@node Widget Wishlist, GNU Free Documentation License, Utilities, Top @comment node-name, next, previous, up @section Wishlist @cindex todo @@ -1833,7 +1834,11 @@ See @code{TeX-printer-list} for an explanation. Add a @code{mailto} widget. @end itemize -@node Index, , Widget Wishlist, Top +@node GNU Free Documentation License, Index, Widget Wishlist, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Index, , GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Index diff --git a/man/woman.texi b/man/woman.texi index 575c90309ae..868bb510f50 100644 --- a/man/woman.texi +++ b/man/woman.texi @@ -99,6 +99,7 @@ Mile End Road, London E1 4NS, UK * Technical:: Technical Details * Bugs:: Reporting Bugs * Acknowledgements:: Acknowledgements +* GNU Free Documentation License:: The license for this documentation. * Command Index:: Command Index * Variable Index:: Variable Index * Keystroke Index:: Keystroke Index @@ -1334,7 +1335,7 @@ man source file from, but do not send it unless asked to send it. @c =================================================================== -@node Acknowledgements, Command Index, Bugs, Top +@node Acknowledgements, GNU Free Documentation License, Bugs, Top @comment node-name, next, previous, up @chapter Acknowledgements @cindex acknowledgements @@ -1390,7 +1391,12 @@ Eli Zaretskii, @email{eliz@@is.elta.co.il} @comment END OF MANUAL TEXT @page -@node Command Index, Variable Index, Acknowledgements, Top + +@node GNU Free Documentation License, Command Index, Acknowledgements, Top +@appendix GNU Free Documentation License +@include doclicense.texi + +@node Command Index, Variable Index, GNU Free Documentation License, Top @comment node-name, next, previous, up @unnumbered Command Index diff --git a/man/xresources.texi b/man/xresources.texi index 45a890e7c39..c402ec89f88 100644 --- a/man/xresources.texi +++ b/man/xresources.texi @@ -58,14 +58,15 @@ collection of related options, for one program or for several programs (optionally even for all programs). @cindex Registry (MS-Windows) - MS-Windows systems don't support @file{~/.Xdefaults} files, but -Emacs compiled for Windows looks for X resources in the Windows -Registry, under the key @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs} -and then under the key @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}. -The menu and scroll bars are native widgets on MS-Windows, so they are -only customizable via the system-wide settings in the Display Control -Panel. You can also set resources using the @samp{-xrm} command line -option (see below.) + MS-Windows systems do not support @file{~/.Xdefaults} files, so +instead Emacs compiled for Windows looks for X resources in the +Windows Registry, first under the key +@samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs} and then under the key +@samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}. The menu and scroll +bars are native widgets on MS-Windows, so they are only customizable +via the system-wide settings in the Display Control Panel. You can +also set resources using the @samp{-xrm} command line option (see +below.) @iftex Applications such as Emacs look for resources with specific names |