diff options
Diffstat (limited to 'man')
45 files changed, 798 insertions, 844 deletions
diff --git a/man/.gitignore b/man/.gitignore index fd0f0aa73a..2e1fe64580 100644 --- a/man/.gitignore +++ b/man/.gitignore @@ -19,3 +19,4 @@ *.vr *.vrs Makefile +makefile diff --git a/man/ChangeLog b/man/ChangeLog index 5eb7c211e9..d3d0353e5d 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,111 @@ +2005-10-05 Nick Roberts <[email protected]> + + * speedbar.texi (GDB): Describe use of watch expressions. + +2005-10-03 Jan Dj,Ad(Brv <[email protected]> + + * frames.texi (Drag and Drop): Remove the x- from + x-dnd-open-file-other-window and xdnd-protocol-alist. + +2005-09-30 Romain Francoise <[email protected]> + + * mini.texi (Minibuffer): The default value now appears before the + colon in minibuffer prompts. + +2005-09-28 Simon Josefsson <[email protected]> + + * message.texi (IDNA): Fix. + +2005-09-28 Katsumi Yamaoka <[email protected]> + + * gnus.texi (NNTP): Remove nntp-buggy-select, nntp-read-timeout, + nntp-server-hook, and nntp-warn-about-losing-connection; fix + description of nntp-open-connection-function. + (Common Variables): Fix descriptions. + +2005-09-26 Katsumi Yamaoka <[email protected]> + + * gnus.texi (Server Buffer Format): Document the %a format spec. + +2005-09-25 Richard M. Stallman <[email protected]> + + * search.texi (Regexp Search): Doc search-whitespace-regexp. + +2005-09-22 Katsumi Yamaoka <[email protected]> + + * gnus.texi (Mail): Fix gnus-confirm-mail-reply-to-news entry. + +2005-09-20 Emanuele Giaquinta <[email protected]> (tiny change) + + * text.texi (Paragraphs): Correction about Paragraph-Indent Text mode. + +2005-09-23 Carsten Dominik <[email protected]> + + * org.texi Version 3.16 + +2005-09-21 YAMAMOTO Mitsuharu <[email protected]> + + * emacs.texi (Top): Update submenus from macos.texi. + + * macos.texi: Change `Mac OS 8 or 9' to `Mac OS Classic'. + (Mac OS): Update feature support status. + (Mac Input): List supported input scripts. Remove description + about `mac-keyboard-text-encoding'. Mention mouse button + emulation and related variables. + (Mac International): Mention Central European and Cyrillic + support. Now `keyboard-coding-system' is dynamically changed. + Add description about coding system for selection. Add + description about language environment. + (Mac Environment Variables): Mention + `~/.MacOSX/environment.plist'. Give example of command line + arguments. Add Preferences support. + (Mac Directories): Explicitly state that this node is for Mac OS + Classic only. + (Mac Font Specs): Mention specification for scalable fonts. List + supported charsets. Add preferred way of creating fontsets. Add + description about `mac-allow-anti-aliasing'. + (Mac Functions): Add descriptions about `mac-set-file-creator', + `mac-get-file-creator', `mac-set-file-type', `mac-get-file-type', + and `mac-get-preference'. + +2005-09-19 Miles Bader <[email protected]> + + * newsticker.texi: Get rid of CVS keywords. + +2005-09-15 Katsumi Yamaoka <[email protected]> + + * gnus.texi (Finding the Parent): Fix description of how Gnus + finds article. + +2005-09-14 Jari Aalto <[email protected]> + + * gnus.texi (Advanced Scoring Examples): New examples to teach how + to drop off non-answered articles. + +2005-09-19 Juanma Barranquero <[email protected]> + + * makefile.w32-in (newsticker.dvi): Use parentheses instead of curly + braces (which are unsupported by NMAKE) for macro `srcdir'. + +2005-09-17 Eli Zaretskii <[email protected]> + + * makefile.w32-in (INFO_TARGETS, DVI_TARGETS): Add newsticker targets. + (../info/newsticker, newsticker.dvi): New targets. + +2005-09-17 Ulf Jasper <[email protected]> + + * newsticker.texi: Replace @command with @code. Replace @example + with @lisp. + (Top): Added explanations to menu items. + (GNU Free Documentation License): Removed. + +2005-09-16 Romain Francoise <[email protected]> + + Update all files to specify GFDL version 1.2. + + * doclicense.texi (GNU Free Documentation License): Update to + version 1.2. + 2005-09-15 Richard M. Stallman <[email protected]> * buffers.texi (List Buffers): Fix xref. @@ -2817,8 +2925,8 @@ 2004-02-29 Juanma Barranquero <[email protected]> - * makefile.w32-in (mostlyclean, clean, maintainer-clean): Use - $(DEL) instead of rm, and ignore exit code. + * makefile.w32-in (mostlyclean, clean, maintainer-clean): + Use $(DEL) instead of rm, and ignore exit code. 2004-02-29 Kai Grossjohann <[email protected]> diff --git a/man/ada-mode.texi b/man/ada-mode.texi index 4a25440f99..7cac926169 100644 --- a/man/ada-mode.texi +++ b/man/ada-mode.texi @@ -13,7 +13,7 @@ Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 diff --git a/man/autotype.texi b/man/autotype.texi index f760a6f8ae..106d89f52e 100644 --- a/man/autotype.texi +++ b/man/autotype.texi @@ -17,7 +17,7 @@ Copyright @copyright{} 1994, 1995, 1999, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 diff --git a/man/calc.texi b/man/calc.texi index a4e66de1a3..36f9f68eec 100644 --- a/man/calc.texi +++ b/man/calc.texi @@ -88,7 +88,7 @@ Copyright (C) 1990, 1991, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 diff --git a/man/cc-mode.texi b/man/cc-mode.texi index 5f9164dbf3..a59c022625 100644 --- a/man/cc-mode.texi +++ b/man/cc-mode.texi @@ -71,7 +71,7 @@ Copyright @copyright{} 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 diff --git a/man/cl.texi b/man/cl.texi index 8fc54ed02d..92c93c487b 100644 --- a/man/cl.texi +++ b/man/cl.texi @@ -9,7 +9,7 @@ Copyright (C) 1993, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/doclicense.texi b/man/doclicense.texi index e74499daf0..a6b994ee4b 100644 --- a/man/doclicense.texi +++ b/man/doclicense.texi @@ -1,10 +1,10 @@ @c -*-texinfo-*- @node GNU Free Documentation License, Emacs Invocation, Copying, Top @appendix GNU Free Documentation License -@center Version 1.1, March 2000 +@center Version 1.2, November 2002 @display -Copyright (C) 2000 Free Software Foundation, Inc. +Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies @@ -16,12 +16,12 @@ of this license document, but changing it is not allowed. PREAMBLE The purpose of this License is to make a manual, textbook, or other -written document ``free'' in the sense of freedom: to assure everyone -the effective freedom to copy and redistribute it, with or without -modifying it, either commercially or noncommercially. Secondarily, -this License preserves for the author and publisher a way to get -credit for their work, while not being considered responsible for -modifications made by others. +functional and useful document ``free'' in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. This License is a kind of ``copyleft'', which means that derivative works of the document must themselves be free in the same sense. It @@ -40,11 +40,15 @@ principally for works whose purpose is instruction or reference. @item APPLICABILITY AND DEFINITIONS -This License applies to any manual or other work that contains a -notice placed by the copyright holder saying it can be distributed -under the terms of this License. The ``Document'', below, refers to any -such manual or work. Any member of the public is a licensee, and is -addressed as ``you.'' +This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The ``Document'', below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as ``you''. You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. A ``Modified Version'' of the Document means any work containing the Document or a portion of it, either copied verbatim, or with @@ -54,7 +58,7 @@ A ``Secondary Section'' is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly -within that overall subject. (For example, if the Document is in part a +within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, @@ -63,33 +67,41 @@ them. The ``Invariant Sections'' are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice -that says that the Document is released under this License. +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. The ``Cover Texts'' are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that -the Document is released under this License. +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. A ``Transparent'' copy of the Document means a machine-readable copy, represented in a format whose specification is available to the -general public, whose contents can be viewed and edited directly and +general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file -format whose markup has been designed to thwart or discourage -subsequent modification by readers is not Transparent. A copy that is -not ``Transparent'' is called ``Opaque.'' +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not ``Transparent'' is called ``Opaque.'' + Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple -HTML designed for human modification. Opaque formats include -PostScript, PDF, proprietary formats that can be read and edited only -by proprietary word processors, SGML or XML for which the DTD and/or +HTML, PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the -machine-generated HTML produced by some word processors for output -purposes only. +machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. The ``Title Page'' means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material @@ -97,6 +109,21 @@ this License requires to appear in the title page. For works in formats which do not have any title page as such, ``Title Page'' means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text. + +A section ``Entitled XYZ'' means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as ``Acknowledgements'', +``Dedications'', ``Endorsements'', or ``History''.) To ``Preserve the Title'' +of such a section when you modify the Document means that it remains a +section ``Entitled XYZ'' according to this definition. + +The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. @sp 1 @item VERBATIM COPYING @@ -117,9 +144,10 @@ you may publicly display copies. @item COPYING IN QUANTITY -If you publish printed copies of the Document numbering more than 100, -and the Document's license notice requires Cover Texts, you must enclose -the copies in covers that carry, clearly and legibly, all these Cover +If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present @@ -137,16 +165,15 @@ pages. If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy -a publicly-accessible computer-network location containing a complete -Transparent copy of the Document, free of added material, which the -general network-using public has access to download anonymously at no -charge using public-standard network protocols. If you use the latter -option, you must take reasonably prudent steps, when you begin -distribution of Opaque copies in quantity, to ensure that this -Transparent copy will remain thus accessible at the stated location -until at least one year after the last time you distribute an Opaque -copy (directly or through your agents or retailers) of that edition to -the public. +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give @@ -170,7 +197,8 @@ A. Use in the Title Page (and on the covers, if any) a title distinct B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the - Document (all of its principal authors, if it has less than five).@* + Document (all of its principal authors, if it has fewer than five), + unless they release you from this requirement.@* C. State on the Title page the name of the publisher of the Modified Version, as the publisher.@* D. Preserve all the copyright notices of the Document.@* @@ -182,10 +210,10 @@ F. Include, immediately after the copyright notices, a license notice G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.@* H. Include an unaltered copy of this License.@* -I. Preserve the section entitled ``History'', and its title, and add to - it an item stating at least the title, year, new authors, and +I. Preserve the section Entitled ``History'', Preserve its Title, and add + to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If - there is no section entitled ``History'' in the Document, create one + there is no section Entitled ``History'' in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.@* @@ -196,17 +224,18 @@ J. Preserve the network location, if any, given in the Document for You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.@* -K. In any section entitled ``Acknowledgements'' or ``Dedications'', - preserve the section's title, and preserve in the section all the - substance and tone of each of the contributor acknowledgements +K. For any section Entitled ``Acknowledgements'' or ``Dedications'', + Preserve the Title of the section, and preserve in the section all + the substance and tone of each of the contributor acknowledgements and/or dedications given therein.@* L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.@* -M. Delete any section entitled ``Endorsements.'' Such a section +M. Delete any section Entitled ``Endorsements.'' Such a section may not be included in the Modified Version.@* -N. Do not retitle any existing section as ``Endorsements'' +N. Do not retitle any existing section to be Entitled ``Endorsements'' or to conflict in title with any Invariant Section.@* +O. Preserve any Warranty Disclaimers.@* @sp 1 If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material @@ -215,7 +244,7 @@ of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles. -You may add a section entitled ``Endorsements'', provided it contains +You may add a section Entitled ``Endorsements'', provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a @@ -243,7 +272,7 @@ License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its -license notice. +license notice, and that you preserve all their Warranty Disclaimers. The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single @@ -254,11 +283,11 @@ author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work. -In the combination, you must combine any sections entitled ``History'' -in the various original documents, forming one section entitled -``History''; likewise combine any sections entitled ``Acknowledgements'', -and any sections entitled ``Dedications.'' You must delete all sections -entitled ``Endorsements.'' +In the combination, you must combine any sections Entitled ``History'' +in the various original documents, forming one section Entitled +``History''; likewise combine any sections Entitled ``Acknowledgements'', +and any sections Entitled ``Dedications.'' You must delete all sections +Entitled ``Endorsements.'' @sp 1 @item COLLECTIONS OF DOCUMENTS @@ -279,18 +308,20 @@ AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or -distribution medium, does not as a whole count as a Modified Version -of the Document, provided no compilation copyright is claimed for the -compilation. Such a compilation is called an ``aggregate'', and this -License does not apply to the other self-contained works thus compiled -with the Document, on account of their being thus compiled, if they -are not themselves derivative works of the Document. +distribution medium, is called an ``aggregate'' if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. If the Cover Text requirement of section 3 is applicable to these -copies of the Document, then if the Document is less than one quarter -of the entire aggregate, the Document's Cover Texts may be placed on -covers that surround only the Document within the aggregate. -Otherwise they must appear on covers around the whole aggregate. +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on +covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic form. +Otherwise they must appear on printed covers that bracket the whole +aggregate. @sp 1 @item TRANSLATION @@ -301,10 +332,17 @@ Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a -translation of this License provided that you also include the -original English version of this License. In case of a disagreement -between the translation and the original English version of this -License, the original English version will prevail. +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + +If a section in the Document is Entitled ``Acknowledgements'', +``Dedications'', or ``History'', the requirement (section 4) to Preserve +its Title (section 1) will typically require changing the actual +title. @sp 1 @item TERMINATION @@ -347,19 +385,28 @@ license notices just after the title page: @group Copyright (C) @var{year} @var{your name}. Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 +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, no Front-Cover Texts, and no Back-Cover Texts. +A copy of the license is included in the section entitled ``GNU +Free Documentation License''. +@end group +@end smallexample + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the ``with...Texts.'' line with this: + +@smallexample +@group with the Invariant Sections being @var{list their titles}, with the -Front-Cover Texts being @var{list}, and with the Back-Cover Texts being @var{list}. -A copy of the license is included in the section entitled "GNU -Free Documentation License." +Front-Cover Texts being @var{list}, and with the Back-Cover Texts being +@var{list}. @end group @end smallexample -If you have no Invariant Sections, write ``with no Invariant Sections'' -instead of saying which ones are invariant. If you have no -Front-Cover Texts, write ``no Front-Cover Texts'' instead of -``Front-Cover Texts being @var{list}''; likewise for Back-Cover Texts. +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of diff --git a/man/ebrowse.texi b/man/ebrowse.texi index 93c82fbbba..b48d5c2b98 100644 --- a/man/ebrowse.texi +++ b/man/ebrowse.texi @@ -15,7 +15,7 @@ Copyright @copyright{} 2000, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/ediff.texi b/man/ediff.texi index 1991aa642d..a9a7e592af 100644 --- a/man/ediff.texi +++ b/man/ediff.texi @@ -30,7 +30,7 @@ Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/emacs-mime.texi b/man/emacs-mime.texi index 7bd36f3ce4..35dbe1e579 100644 --- a/man/emacs-mime.texi +++ b/man/emacs-mime.texi @@ -14,7 +14,7 @@ Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/emacs-xtra.texi b/man/emacs-xtra.texi index d17a506a49..0c7cea886f 100644 --- a/man/emacs-xtra.texi +++ b/man/emacs-xtra.texi @@ -14,7 +14,7 @@ Copyright (C) 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/emacs.texi b/man/emacs.texi index 9faf6e19ae..d1fd4cc250 100644 --- a/man/emacs.texi +++ b/man/emacs.texi @@ -16,7 +16,7 @@ Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1996, 1997, 1998, 1999, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 @@ -877,13 +877,13 @@ X Options and Resources * LessTif Resources:: X resources for LessTif and Motif menus. * GTK resources:: Resources for GTK widgets. -Emacs and the Mac OS +Emacs and Mac OS -* Mac Input:: Keyboard input on the Mac. -* Mac International:: International character sets on the Mac. +* Mac Input:: Keyboard and mouse input on Mac. +* Mac International:: International character sets on Mac. * Mac Environment Variables:: Setting environment variables for Emacs. -* Mac Directories:: Volumes and directories on the Mac. -* Mac Font Specs:: Specifying fonts on the Mac. +* Mac Directories:: Volumes and directories on Mac. +* Mac Font Specs:: Specifying fonts on Mac. * Mac Functions:: Mac-specific Lisp functions. MS-DOS and Windows 95/98/NT diff --git a/man/eshell.texi b/man/eshell.texi index fe36780955..a9ec167ea6 100644 --- a/man/eshell.texi +++ b/man/eshell.texi @@ -13,7 +13,7 @@ Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/eudc.texi b/man/eudc.texi index 23df55bb97..beec0e01a7 100644 --- a/man/eudc.texi +++ b/man/eudc.texi @@ -17,7 +17,7 @@ Copyright (C) 1998, 2000, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/flymake.texi b/man/flymake.texi index 4f5223e3bd..bb1041609a 100644 --- a/man/flymake.texi +++ b/man/flymake.texi @@ -15,7 +15,7 @@ Copyright @copyright{} 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the license diff --git a/man/forms.texi b/man/forms.texi index adc3fe8a0b..c18987602b 100644 --- a/man/forms.texi +++ b/man/forms.texi @@ -23,7 +23,7 @@ Copyright (C) 1989, 1997, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/frames.texi b/man/frames.texi index 8e058867fc..2928aa7a62 100644 --- a/man/frames.texi +++ b/man/frames.texi @@ -857,10 +857,10 @@ case, dropping the file on a Dired buffer moves or copies the file (according to the conventions of the application it came from) into the directory displayed in that buffer. -@vindex x-dnd-open-file-other-window +@vindex dnd-open-file-other-window Dropping a file normally visits it in the window you drop it on. If you prefer to visit the file in a new window in such cases, customize -the variable @code{x-dnd-open-file-other-window}. +the variable @code{dnd-open-file-other-window}. @ignore @c ??? To Lisp manual @@ -881,10 +881,10 @@ or add a new type, customize @code{x-dnd-types-alist}. This requires detailed knowledge of what types other applications use for drag and drop. -@vindex x-dnd-protocol-alist +@vindex dnd-protocol-alist When an URL is dropped on Emacs it may be a file, but it may also be another URL type (ftp, http, etc.). Emacs first checks -@code{x-dnd-protocol-alist} to determine what to do with the URL. If +@code{dnd-protocol-alist} to determine what to do with the URL. If there is no match there and if @code{browse-url-browser-function} is an alist, Emacs looks for a match there. If no match is found the text for the URL is inserted. If you want to alter Emacs behavior, diff --git a/man/gnu.texi b/man/gnu.texi index 51e1a5615f..0f216152b1 100644 --- a/man/gnu.texi +++ b/man/gnu.texi @@ -10,7 +10,7 @@ Copyright (C) 1985, 1993, 2001, 2002, 2003, 2004, 2005 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.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/gnus.texi b/man/gnus.texi index d1eb932586..7ced947a5c 100644 --- a/man/gnus.texi +++ b/man/gnus.texi @@ -12,7 +12,7 @@ Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the @@ -9624,17 +9624,16 @@ by giving the @kbd{A T} command a numerical prefix. @kindex M-^ (Summary) @cindex Message-ID @cindex fetching by Message-ID -You can also ask the @acronym{NNTP} server for an arbitrary article, no -matter what group it belongs to. @kbd{M-^} -(@code{gnus-summary-refer-article}) will ask you for a -@code{Message-ID}, which is one of those long, hard-to-read thingies -that look something like @samp{<38o6up$6f2@@hymir.ifi.uio.no>}. You -have to get it all exactly right. No fuzzy searches, I'm afraid. -@end table +You can also ask Gnus for an arbitrary article, no matter what group it +belongs to. @kbd{M-^} (@code{gnus-summary-refer-article}) will ask you +for a @code{Message-ID}, which is one of those long, hard-to-read +thingies that look something like @samp{<38o6up$6f2@@hymir.ifi.uio.no>}. +You have to get it all exactly right. No fuzzy searches, I'm afraid. -The current select method will be used when fetching by -@code{Message-ID} from non-news select method, but you can override this -by giving this command a prefix. +Gnus looks for the @code{Message-ID} in the headers that have already +been fetched, but also tries all the select methods specified by +@code{gnus-refer-article-method} if it is not found. +@end table @vindex gnus-refer-article-method If the group you are reading is located on a back end that does not @@ -11432,13 +11431,15 @@ that have none when you do a @kbd{a}. @item gnus-confirm-mail-reply-to-news @vindex gnus-confirm-mail-reply-to-news -This can also be a function receiving the group name as the only -parameter which should return non-@code{nil} if a confirmation is -needed, or a regular expression matching group names, where -confirmation is should be asked for. +If non-@code{nil}, Gnus will ask you for a confirmation when you are +about to reply to news articles by mail. If it is @code{nil}, nothing +interferes in what you want to do. This can also be a function +receiving the group name as the only parameter which should return +non-@code{nil} if a confirmation is needed, or a regular expression +matching group names, where confirmation should be asked for. If you find yourself never wanting to reply to mail, but occasionally -press R anyway, this variable might be for you. +press @kbd{R} anyway, this variable might be for you. @item gnus-confirm-treat-mail-like-news @vindex gnus-confirm-treat-mail-like-news @@ -12198,6 +12199,9 @@ Where the news is to be fetched from---the address. @item s The opened/closed/denied status of the server. + +@item a +Whether this server is agentized. @end table @vindex gnus-server-mode-line-format @@ -12676,35 +12680,6 @@ that says how many seconds the @code{nntp} back end should wait for a connection before giving up. If it is @code{nil}, which is the default, no timeouts are done. -@c @item nntp-command-timeout -@c @vindex nntp-command-timeout -@c @cindex PPP connections -@c @cindex dynamic IP addresses -@c If you're running Gnus on a machine that has a dynamically assigned -@c address, Gnus may become confused. If the address of your machine -@c changes after connecting to the @acronym{NNTP} server, Gnus will simply sit -@c waiting forever for replies from the server. To help with this -@c unfortunate problem, you can set this command to a number. Gnus will -@c then, if it sits waiting for a reply from the server longer than that -@c number of seconds, shut down the connection, start a new one, and resend -@c the command. This should hopefully be transparent to the user. A -@c likely number is 30 seconds. -@c -@c @item nntp-retry-on-break -@c @vindex nntp-retry-on-break -@c If this variable is non-@code{nil}, you can also @kbd{C-g} if Gnus -@c hangs. This will have much the same effect as the command timeout -@c described above. - -@item nntp-server-hook -@vindex nntp-server-hook -This hook is run as the last step when connecting to an @acronym{NNTP} -server. - -@item nntp-buggy-select -@vindex nntp-buggy-select -Set this to non-@code{nil} if your select routine is buggy. - @item nntp-nov-is-evil @vindex nntp-nov-is-evil If the @acronym{NNTP} server does not support @acronym{NOV}, you could set this @@ -12736,11 +12711,6 @@ that fetching will probably be slower. If this variable is @code{nil}, @vindex nntp-prepare-server-hook A hook run before attempting to connect to an @acronym{NNTP} server. -@item nntp-warn-about-losing-connection -@vindex nntp-warn-about-losing-connection -If this variable is non-@code{nil}, some noise will be made when a -server closes connection. - @item nntp-record-commands @vindex nntp-record-commands If non-@code{nil}, @code{nntp} will log all commands it sends to the @@ -12753,8 +12723,8 @@ that doesn't seem to work. It is possible to customize how the connection to the nntp server will be opened. If you specify an @code{nntp-open-connection-function} parameter, Gnus will use that function to establish the connection. -Five pre-made functions are supplied. These functions can be grouped in -two categories: direct connection functions (three pre-made), and +Six pre-made functions are supplied. These functions can be grouped in +two categories: direct connection functions (four pre-made), and indirect ones (two pre-made). @item nntp-prepare-post-hook @@ -12772,14 +12742,6 @@ inhibit Gnus to add a @code{Message-ID} header, you could say: Note that not all servers support the recommended ID. This works for INN versions 2.3.0 and later, for instance. -@item nntp-read-timeout -@vindex nntp-read-timeout -How long nntp should wait between checking for the end of output. -Shorter values mean quicker response, but is more CPU intensive. The -default is 0.1 seconds. If you have a slow line to the server (and -don't like to see Emacs eat your available CPU power), you might set -this to, say, 1. - @end table @menu @@ -12954,7 +12916,9 @@ Address of the intermediate host to connect to. The following variables affect the behavior of all, or several of the pre-made connection functions. When not specified, all functions are -affected. +affected (the values of the following variables will be used as the +default if each virtual @code{nntp} server doesn't specify those server +variables individually). @table @code @@ -12962,7 +12926,7 @@ affected. @vindex nntp-pre-command A command wrapper to use when connecting through a non native connection function (all except @code{nntp-open-network-stream}, -@code{nntp-open-tls-stream}, and @code{nntp-open-ssl-stream}. This is +@code{nntp-open-tls-stream}, and @code{nntp-open-ssl-stream}). This is where you would put a @samp{SOCKS} wrapper for instance. @item nntp-address @@ -12973,7 +12937,7 @@ The address of the @acronym{NNTP} server. @vindex nntp-port-number Port number to connect to the @acronym{NNTP} server. The default is @samp{nntp}. If you use @acronym{NNTP} over -@acronym{tls}/@acronym{ssl}, you may want to use integer ports rather +@acronym{TLS}/@acronym{SSL}, you may want to use integer ports rather than named ports (i.e, use @samp{563} instead of @samp{snews} or @samp{nntps}), because external @acronym{TLS}/@acronym{SSL} tools may not work with named ports. @@ -20501,8 +20465,19 @@ very interesting: 1000) @end example -The possibilities are endless. +Suppose you're reading a high volume group and you're only interested +in replies. The plan is to score down all articles that don't have +subject that begin with "Re:", "Fw:" or "Fwd:" and then score up all +parents of articles that have subjects that begin with reply marks. +@example +((! ("subject" "re:\\|fwd?:" r)) + -200) +((1- ("subject" "re:\\|fwd?:" r)) + 200) +@end example + +The possibilities are endless. @node Advanced Scoring Tips @subsection Advanced Scoring Tips diff --git a/man/idlwave.texi b/man/idlwave.texi index f9e167893a..d628f7ae4e 100644 --- a/man/idlwave.texi +++ b/man/idlwave.texi @@ -33,7 +33,7 @@ Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, 2005 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.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the @@ -65,7 +65,7 @@ Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, @sp 2 @cindex Copyright, of IDLWAVE Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the @@ -2677,21 +2677,17 @@ buffers. The many debugging, compiling, and examination commands provided in IDLWAVE are available simultaneously through two different interfaces: the original, multi-key command interface, and the new Electric Debug -Mode. The functionality they offer is similar, but the way you -interact with them is quite different. The main difference is that, -in Electric Debug Mode, the source buffers are made read-only, and -single key-strokes are used to step through, examine expressions, set -and remove breakpoints, etc. The same variables, prefix arguments, -and settings apply to both versions, and both can be used -interchangeably. By default, when breakpoints are hit, Electric Debug -Mode is enabled. The traditional interface is described first. -@xref{Electric Debug Mode}, for more on that mode. - - -@sp 1 -@noindent @strong{Note that electric debug mode can be prevented from -activating automatically by customizing the variable -@code{idlwave-shell-automatic-electric-debug}.} +Mode. The functionality they offer is similar, but the way you interact +with them is quite different. The main difference is that, in Electric +Debug Mode, the source buffers are made read-only, and single +key-strokes are used to step through, examine expressions, set and +remove breakpoints, etc. The same variables, prefix arguments, and +settings apply to both versions, and both can be used interchangeably. +By default, when breakpoints are hit, Electric Debug Mode is enabled. +The traditional interface is described first. @xref{Electric Debug +Mode}, for more on that mode. Note that electric debug mode can be +prevented from activating automatically by customizing the variable +@code{idlwave-shell-automatic-electric-debug}. @node Debug Key Bindings, Breakpoints and Stepping, A Tale of Two Modes, Debugging IDL Programs @subsection Debug Key Bindings diff --git a/man/info.texi b/man/info.texi index 3a0ba2b394..95e736ab24 100644 --- a/man/info.texi +++ b/man/info.texi @@ -19,7 +19,7 @@ Copyright (C) 1989, 1992, 1996, 1997, 1998, 1999, 2000, 2001, 2002, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/macos.texi b/man/macos.texi index bcb25a7e52..9795294389 100644 --- a/man/macos.texi +++ b/man/macos.texi @@ -3,48 +3,47 @@ @c 2005 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @node Mac OS, MS-DOS, Antinews, Top -@appendix Emacs and the Mac OS +@appendix Emacs and Mac OS @cindex Mac OS @cindex Macintosh - Emacs built on Mac OS X supports most of its major features: -multiple frames, colors, scroll bars, menu bars, use of the mouse, -fontsets, international characters, input methods, coding systems, -asynchronous and synchronous subprocesses, unexec (@code{dump-emacs}), -and networking (@code{open-network-stream}). Support for various -image file formats has not been implemented yet. - - The following features of Emacs are not yet supported on the Mac OS -8 or 9: unexec (@code{dump-emacs}), asynchronous subprocesses -(@code{start-process}), and networking (@code{open-network-stream}). -As a result, packages such as Gnus, GUD, and Comint do not work. -However, synchronous subprocesses (@code{call-process}) are supported. -Since external programs to handle commands such as @code{print-buffer} -and @code{diff} are not available on Mac OS 8 or 9, they are not -supported. - - Most of the features that are supported work in the same way as on -other platforms and are therefore documented in the rest of this -manual. This section describes the peculiarities of using Emacs under -the Mac OS. + This section briefly describes the peculiarities of using Emacs +under Mac OS with native window system support. For Mac OS X, Emacs +can be built either without window system support, with X11, or with +Carbon API. This section only applies to the Carbon build. For Mac +OS Classic, Emacs can be built with or without Carbon API, and this +section applies to either of them because they run on the native +window system. + + Emacs built on Mac OS X supports most of its major features except +display support of PostScript images. The following features of Emacs +are not supported on Mac OS Classic: unexec (@code{dump-emacs}), +asynchronous subprocesses (@code{start-process}), and networking +(@code{open-network-stream}). As a result, packages such as Gnus, +GUD, and Comint do not work. Synchronous subprocesses +(@code{call-process}) are supported on non-Carbon build, but +specially-crafted external programs are needed. Since external +programs to handle commands such as @code{print-buffer} and +@code{diff} are not available on Mac OS Classic, they are not +supported. Non-Carbon build on Mac OS Classic does not support some +features such as file dialogs, drag-and-drop, and Unicode menus. @menu -* Input: Mac Input. Keyboard input on the Mac. -* Intl: Mac International. International character sets on the Mac. +* Input: Mac Input. Keyboard and mouse input on Mac. +* Intl: Mac International. International character sets on Mac. * Env: Mac Environment Variables. Setting environment variables for Emacs. -* Directories: Mac Directories. Volumes and directories on the Mac. -* Font: Mac Font Specs. Specifying fonts on the Mac. +* Directories: Mac Directories. Volumes and directories on Mac. +* Font: Mac Font Specs. Specifying fonts on Mac. * Functions: Mac Functions. Mac-specific Lisp functions. @end menu @node Mac Input -@section Keyboard Input on the Mac +@section Keyboard and Mouse Input on Mac @cindex Meta (Mac OS) @cindex keyboard coding (Mac OS) -@vindex mac-command-key-is-meta -@vindex mac-keyboard-text-encoding - On the Mac, Emacs can use either the @key{option} key or the +@vindex mac-command-key-is-meta + On Mac, Emacs can use either the @key{option} key or the @key{command} key as the @key{META} key. If the value of the variable @code{mac-command-key-is-meta} is non-@code{nil} (its default value), Emacs uses the @key{command} key as the @key{META} key. Otherwise it @@ -55,89 +54,124 @@ so that dead-key processing with the @key{option} key will still work. This is useful for entering non-@acronym{ASCII} Latin characters directly from the Mac keyboard, for example. - Emacs recognizes the setting in the Keyboard control panel and -supports international and alternative keyboard layouts (e.g., Dvorak). -Selecting one of the layouts from the keyboard layout pull-down menu -will affect how the keys typed on the keyboard are interpreted. - - The Mac OS intercepts and handles certain key combinations (e.g., + Emacs recognizes the setting in the Keyboard control panel (Mac OS +Classic) or the International system preference pane (Mac OS X) and +supports international and alternative keyboard layouts (e.g., Dvorak) +if its script is either Roman, Japanese, Traditional Chinese, Korean, +Cyrillic, Simplified Chinese, or Central European. Keyboard layouts +based on Unicode may not work properly. Selecting one of the layouts +from the keyboard layout pull-down menu will affect how the keys typed +on the keyboard are interpreted. + +@vindex mac-pass-command-to-system +@vindex mac-pass-control-to-system + Mac OS intercepts and handles certain key combinations (e.g., @key{command}-@key{SPC} for switching input languages). These will not -be passed to Emacs. - - The Mac keyboard ordinarily generates characters in the Mac Roman -encoding. To use it for entering ISO Latin-1 characters directly, set -the value of the variable @code{mac-keyboard-text-encoding} to -@code{kTextEncodingISOLatin1}. Note that not all Mac Roman characters -that can be entered at the keyboard can be converted to ISO Latin-1 -characters. - - To enter ISO Latin-2 characters directly from the Mac keyboard, set -the value of @code{mac-keyboard-text-encoding} to -@code{kTextEncodingISOLatin2}. Then let Emacs know that the keyboard -generates Latin-2 codes, by typing @kbd{C-x @key{RET} k iso-latin-2 -@key{RET}}. To make this setting permanent, put this in your -@file{.emacs} init file: - -@lisp -(set-keyboard-coding-system 'iso-latin-2) -@end lisp +be passed to Emacs. One can disable this interception by setting +@code{mac-pass-command-to-system} or @code{mac-pass-control-to-system} +to @code{nil}. + +@vindex mac-emulate-three-button-mouse + Especially for one-button mice, the multiple button feature can be +emulated by setting @code{mac-emulate-three-button-mouse} to @code{t} +or @code{reverse}. If set to @code{t} (@code{reverse}, respectively), +pressing the mouse button with the @key{option} key is recognized as +the second (third) button, and that with the @key{command} key is +recognized as the third (second) button. + +@vindex mac-wheel-button-is-mouse-2 + For multi-button mice, the wheel button and the secondary button are +recognized as the second and the third button, respectively. If +@code{mac-wheel-button-is-mouse-2} is set to @code{nil}, their roles +are exchanged. @node Mac International -@section International Character Set Support on the Mac +@section International Character Set Support on Mac @cindex Mac Roman coding system @cindex clipboard support (Mac OS) - The Mac uses a non-standard encoding for the upper 128 single-byte -characters. It also deviates from the ISO 2022 standard by using -character codes in the range 128-159. The coding system -@code{mac-roman} is used to represent this Mac encoding. It is used -for editing files stored in this native encoding, and for displaying -file names in Dired mode. - - Any native (non-symbol) Mac font can be used to correctly display -characters in the @code{mac-roman} coding system. + Mac uses non-standard encodings for the upper 128 single-byte +characters. They also deviate from the ISO 2022 standard by using +character codes in the range 128-159. The coding systems +@code{mac-roman}, @code{mac-centraleurroman}, and @code{mac-cyrillic} +are used to represent these Mac encodings. The fontset @code{fontset-mac} is created automatically when Emacs -is run on the Mac. It displays characters in the @code{mac-roman} -coding system using 12-point Monaco. - - To insert characters directly in the @code{mac-roman} coding system, -type @kbd{C-x @key{RET} k mac-roman @key{RET}}, customize the variable -@code{keyboard-coding-system}, or put this in your init file: - -@lisp -(set-keyboard-coding-system 'mac-roman) -@end lisp - -@noindent -This is useful for editing documents in native Mac encoding. +is run on Mac, and used by default. It displays as many kinds of +characters as possible using 12-point Monaco as a base font. If you +see some character as a hollow box with this fontset, then it's almost +impossible to display it only by customizing font settings (@pxref{Mac +Font Specs}). You can use input methods provided either by LEIM (@pxref{Input -Methods}) or the Mac OS to enter international characters. - - To use the former, see the International Character Set Support section -of the manual (@pxref{International}). +Methods}) or Mac OS to enter international characters. To use the +former, see the International Character Set Support section of the +manual (@pxref{International}). - To use input methods provided by the Mac OS, set the keyboard coding -system accordingly using the @kbd{C-x @key{RET} k} command -(@code{set-keyboard-coding-system}). For example, for Traditional -Chinese, use @samp{chinese-big5} as keyboard coding system; for -Japanese, use @samp{sjis}, etc. Then select the desired input method in -the keyboard layout pull-down menu. + Emacs on Mac OS automatically changes the value of +@code{keyboard-coding-system} according to the current keyboard +layout. So users don't need to set it manually, and even if set, it +will be changed when the keyboard layout change is detected next time. The Mac clipboard and the Emacs kill ring (@pxref{Killing}) are -connected as follows: the most recent kill is copied to the clipboard -when Emacs is suspended and the contents of the clipboard is inserted -into the kill ring when Emacs resumes. The result is that you can yank -a piece of text and paste it into another Mac application, or cut or copy -one in another Mac application and yank it into a Emacs buffer. - - The encoding of text selections must be specified using the commands -@kbd{C-x @key{RET} x} (@code{set-selection-coding-system}) or @kbd{C-x -@key{RET} X} (@code{set-next-selection-coding-system}) (e.g., for -Traditional Chinese, use @samp{chinese-big5-mac} and for Japanese, -@samp{sjis-mac}). @xref{Specify Coding}, for more details. - +synchronized by default: you can yank a piece of text and paste it +into another Mac application, or cut or copy one in another Mac +application and yank it into a Emacs buffer. This feature can be +disabled by setting @code{x-select-enable-clipboard} to @code{nil}. +One can still do copy and paste with another application from the Edit +menu. + + On Mac, the role of the coding system for selection that is set by +@code{set-selection-coding-system} (@pxref{Specify Coding}) is +two-fold. First, it is used as a preferred coding system for the +traditional text flavor that does not specify any particular encodings +and is mainly used by applications on Mac OS Classic. Second, it +specifies the intermediate encoding for the UTF-16 text flavor that is +mainly used by applications on Mac OS X. + + When pasting UTF-16 text data from the clipboard, it is first +converted to the encoding specified by the selection coding system +using the converter in the Mac OS system, and then decoded into the +Emacs internal encoding using the converter in Emacs. If the first +conversion failed, then the UTF-16 data is directly converted to Emacs +internal encoding using the converter in Emacs. Copying UTF-16 text +to the clipboard goes through the inverse path. The reason for this +two-path decoding is to avoid subtle differences in Unicode mappings +between the Mac OS system and Emacs such as various kinds of hyphens, +and to minimize users' customization. For example, users that mainly +use Latin characters would prefer Greek characters to be decoded into +the @code{mule-unicode-0100-24ff} charset, but Japanese users would +prefer them to be decoded into the @code{japanese-jisx0208} charset. +Since the coding system for selection is automatically set according +to the system locale setting, users usually don't have to set it +manually. + + The default language environment (@pxref{Language Environments}) is +set according to the locale setting at the startup time. On Mac OS, +the locale setting is consulted in the following order: + +@enumerate +@item +Environment variables @env{LC_ALL}, @env{LC_CTYPE} and @env{LANG} as +in other systems. + +@item +Preference @code{AppleLocale} that is set by default on Mac OS X 10.3 +and later. + +@item +Preference @code{AppleLanguages} that is set by default on Mac OS X +10.1 and later. + +@item +Variable @code{mac-system-locale} that is derived from the system +language and region codes. This variable is available on all +supported Mac OS versions including Mac OS Classic. +@end enumerate + + The default values of almost all variables about coding systems are +also set according to the language environment. So usually you don't +have to customize these variables manually. @node Mac Environment Variables @section Environment Variables and Command Line Arguments. @@ -145,10 +179,23 @@ Traditional Chinese, use @samp{chinese-big5-mac} and for Japanese, On Mac OS X, when Emacs is run in a terminal, it inherits the values of environment variables from the shell from which it is invoked. -However, when it is run from the Finder as a GUI application, it -inherits no environment variable values. +However, when it is run from the Finder as a GUI application, it only +inherits environment variable values defined in the file +@file{~/.MacOSX/environment.plist} that affects all the applications +invoked from the Finder or the @command{open} command. - On Mac OS 8 or 9, environment variables and command line arguments + Command line arguments are specified like + +@example +/Applications/Emacs.app/Contents/MacOS/Emacs -geometry 80x25 & +@end example + +@noindent +if Emacs is installed at @file{/Applications/Emacs.app}. If Emacs is +invoked like this, then it also inherits the values of environment +variables from the shell from which it is invoked. + + On Mac OS Classic, environment variables and command line arguments for Emacs can be set by modifying the @samp{STR#} resources 128 and 129, respectively. A common environment variable that one may want to set is @samp{HOME}. @@ -169,12 +216,45 @@ string EMACS_UNIBYTE=1 @end example +@cindex Mac Preferences + Although Emacs on Mac does not support X resources (@pxref{X +Resources}) directly, one can use the Preferences system in place of X +resources. For example, adding the line + +@example +Emacs.cursorType: bar +@end example + +@noindent +to @file{~/.Xresources} in X11 corresponds to the execution of + +@example +defaults write org.gnu.Emacs Emacs.cursorType bar +@end example + +@noindent +on Mac OS X. One can use boolean or numeric values as well as string +values as follows: + +@example +defaults write org.gnu.Emacs Emacs.toolBar -bool false +defaults write org.gnu.Emacs Emacs.lineSpacing -int 3 +@end example + +@noindent +Try @kbd{M-x man RET defaults RET} for the usage of the +@command{defaults} command. Alternatively, if you have Developer +Tools installed on Mac OS X, you can use Property List Editor to edit +the file @file{~/Library/Preferences/org.gnu.Emacs.plist}. + @node Mac Directories -@section Volumes and Directories on the Mac +@section Volumes and Directories on Mac @cindex file names (Mac OS) - The directory structure in the Mac OS is seen by Emacs as + This node applies to Mac OS Classic only. + + The directory structure in Mac OS Classic is seen by Emacs as @example /@var{volumename}/@var{filename} @@ -184,11 +264,11 @@ So when Emacs requests a file name, doing file name completion on @file{/} will display all volumes on the system. You can use @file{..} to go up a directory level. - On Mac OS 8 or 9, to access files and folders on the desktop, look + On Mac OS Classic, to access files and folders on the desktop, look in the folder @file{Desktop Folder} in your boot volume (this folder is usually invisible in the Mac @code{Finder}). - On Mac OS 8 or 9, Emacs creates the Mac folder + On Mac OS Classic, Emacs creates the Mac folder @file{:Preferences:Emacs:} in the @file{System Folder} and uses it as the temporary directory. Emacs maps the directory name @file{/tmp/} to that. Therefore it is best to avoid naming a volume @file{tmp}. @@ -199,12 +279,12 @@ created. @node Mac Font Specs -@section Specifying Fonts on the Mac +@section Specifying Fonts on Mac @cindex font names (Mac OS) It is rare that you need to specify a font name in Emacs; usually you specify face attributes instead. But when you do need to specify -a font name in Emacs on the Mac, use a standard X font name: +a font name in Emacs on Mac, use a standard X font name: @smallexample -@var{maker}-@var{family}-@var{weight}-@var{slant}-@var{widthtype}-@var{style}@dots{} @@ -216,11 +296,57 @@ a font name in Emacs on the Mac, use a standard X font name: Native Apple fonts in Mac Roman encoding has maker name @code{apple} and charset @code{mac-roman}. For example 12-point Monaco can be -specified by the name @samp{-apple-monaco-*-12-*-mac-roman}. +specified by the name @samp{-apple-monaco-*-12-*-mac-roman}. When +using a particular size of scalable fonts, it must be specified in a +format containing 14 @samp{-}s like +@samp{-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman}. + + You can specify a @code{mac-roman} font for @acronym{ASCII} +characters like - Native Apple Traditional Chinese, Simplified Chinese, Japanese, and -Korean fonts have charsets @samp{big5-0}, @samp{gb2312.1980-0}, -@samp{jisx0208.1983-sjis}, and @samp{ksc5601.1989-0}, respectively. +@lisp +(add-to-list + 'default-frame-alist + '(font . "-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman")) +@end lisp + +@noindent +but that does not extend to ISO-8859-1: specifying a @code{mac-roman} +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}, +@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}, +respectively. + + Since Emacs as of the current version uses QuickDraw Text routines +for drawing texts, only characters in the charsets listed above can be +displayed with the OS-bundled fonts, even if other applications that +use @acronym{ATSUI} or Cocoa can display variety of characters with +them. + + The use of @code{create-fontset-from-fontset-spec} (@pxref{Defining +Fontsets}) for defining fontsets often results in wrong ones +especially when using only OS-bundled fonts. The recommended way is +to create a fontset using @code{create-fontset-from-mac-roman-font}: + +@lisp +(create-fontset-from-mac-roman-font + "-apple-courier-medium-r-normal--13-*-*-*-*-*-mac-roman" + nil "foo") +@end lisp + +@noindent +and then optionally specifying Chinese, Japanese, or Korean font +families using @code{set-fontset-font}: + +@lisp +(set-fontset-font "fontset-foo" + 'chinese-gb2312 '("song" . "gb2312.1980-0")) +@end lisp Single-byte fonts converted from GNU fonts in BDF format, which are not in the Mac Roman encoding, have foundry, family, and character sets @@ -228,6 +354,12 @@ encoded in the names of their font suitcases. E.g., the font suitcase @samp{ETL-Fixed-ISO8859-1} contains fonts which can be referred to by the name @samp{-ETL-fixed-*-iso8859-1}. +@vindex mac-allow-anti-aliasing + Emacs uses the QuickDraw text rendering by default. On Mac OS X +10.2 and later, it can be changed so that it uses the Quartz 2D text +rendering (aka CG text rendering) by setting +@code{mac-allow-anti-aliasing} to @code{t}. However, it is reported +to sometimes leave some garbages. @node Mac Functions @section Mac-Specific Lisp Functions @@ -246,6 +378,19 @@ returns the GNU or Unix equivalent. The function are useful for constructing AppleScript commands to be passed to @code{do-applescript}. +@findex mac-set-file-creator +@findex mac-get-file-creator +@findex mac-set-file-type +@findex mac-get-file-type + The functions @code{mac-set-file-creator}, +@code{mac-get-file-creator}, @code{mac-set-file-type}, and +@code{mac-get-file-type} can be used to set and get creator and file +codes. + +@findex mac-get-preference + The function @code{mac-get-preference} returns the preferences value +converted to a Lisp object for a specified key and application. + @ignore arch-tag: a822c2ab-4273-4997-927e-c153bb71dcf6 @end ignore diff --git a/man/makefile.w32-in b/man/makefile.w32-in index a5543a8c44..df5d4c4521 100644 --- a/man/makefile.w32-in +++ b/man/makefile.w32-in @@ -41,7 +41,8 @@ INFO_TARGETS = $(infodir)/emacs $(infodir)/emacs-xtra $(infodir)/ccmode \ $(infodir)/eudc $(infodir)/ebrowse $(infodir)/pcl-cvs \ $(infodir)/woman $(infodir)/eshell $(infodir)/org \ $(infodir)/url $(infodir)/speedbar $(infodir)/tramp \ - $(infodir)/ses $(infodir)/smtpmail $(infodir)/flymake + $(infodir)/ses $(infodir)/smtpmail $(infodir)/flymake \ + $(infodir)/newsticker DVI_TARGETS = emacs.dvi calc.dvi cc-mode.dvi cl.dvi dired-x.dvi \ ediff.dvi forms.dvi gnus.dvi message.dvi emacs-mime.dvi \ gnus.dvi message.dvi sieve.dvi pgg.dvi mh-e.dvi \ @@ -49,7 +50,7 @@ DVI_TARGETS = emacs.dvi calc.dvi cc-mode.dvi cl.dvi dired-x.dvi \ ada-mode.dvi autotype.dvi idlwave.dvi eudc.dvi ebrowse.dvi \ pcl-cvs.dvi woman.dvi eshell.dvi org.dvi url.dvi \ speedbar.dvi tramp.dvi ses.dvi smtpmail.dvi flymake.dvi \ - emacs-xtra.dvi + newsticker.dvi emacs-xtra.dvi INFOSOURCES = info.texi # The following rule does not work with all versions of `make'. @@ -317,16 +318,19 @@ emacs-xtra.dvi: emacs-xtra.texi $(infodir)/org: org.texi $(MAKEINFO) org.texi - org.dvi: org.texi $(ENVADD) $(TEXI2DVI) $(srcdir)/org.texi $(infodir)/url: url.texi $(MAKEINFO) url.texi - url.dvi: url.texi $(ENVADD) $(TEXI2DVI) $(srcdir)/url.texi +$(infodir)/newsticker: newsticker.texi + $(MAKEINFO) newsticker.texi +newsticker.dvi: newsticker.texi + $(ENVADD) $(TEXI2DVI) $(srcdir)/newsticker.texi + mostlyclean: - $(DEL) *.log *.cp *.fn *.ky *.pg *.vr core *.tp *.core gnustmp.* diff --git a/man/message.texi b/man/message.texi index 7e4ffb84d7..35fb3e726c 100644 --- a/man/message.texi +++ b/man/message.texi @@ -13,7 +13,7 @@ Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the @@ -839,13 +839,14 @@ typed a non-@acronym{ASCII} domain name. The @code{message-use-idna} variable control whether @acronym{IDNA} is used. If the variable is @code{nil} no @acronym{IDNA} encoding will ever happen, if it is set to the symbol @code{ask} the user will be -queried (the default), and if set to @code{t} @acronym{IDNA} encoding -happens automatically. +queried, and if set to @code{t} @acronym{IDNA} encoding happens +automatically (the default). @findex message-idna-to-ascii-rhs If you want to experiment with the @acronym{IDNA} encoding, you can invoke @kbd{M-x message-idna-to-ascii-rhs RET} in the message buffer -to have the non-@acronym{ASCII} domain names encoded while you edit the message. +to have the non-@acronym{ASCII} domain names encoded while you edit +the message. Note that you must have @uref{http://www.gnu.org/software/libidn/, GNU Libidn} installed in order to use this functionality. diff --git a/man/mh-e.texi b/man/mh-e.texi index babe1a15aa..8530c31ce9 100644 --- a/man/mh-e.texi +++ b/man/mh-e.texi @@ -20,7 +20,7 @@ Copyright (C) 1995, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/mini.texi b/man/mini.texi index 3797260f9c..a76be23ba7 100644 --- a/man/mini.texi +++ b/man/mini.texi @@ -22,7 +22,7 @@ derived from the name of the command that the argument is for. The prompt normally ends with a colon. @cindex default argument - Sometimes a @dfn{default argument} appears in parentheses after the + Sometimes a @dfn{default argument} appears in parentheses before the colon; it too is part of the prompt. The default will be used as the argument value if you enter an empty argument (that is, just type @key{RET}). For example, commands that read buffer names always show a diff --git a/man/newsticker.texi b/man/newsticker.texi index 8a1f684bf6..5b90ef2399 100644 --- a/man/newsticker.texi +++ b/man/newsticker.texi @@ -1,9 +1,7 @@ \input texinfo @c -*-texinfo-*- -@comment $Id: newsticker.texi,v 1.4 2005/09/15 12:32:57 rms Exp $ @comment %**start of header @setfilename ../info/newsticker @set VERSION 1.8 -@set UPDATED ``$Id: newsticker.texi,v 1.4 2005/09/15 12:32:57 rms Exp $'' @settitle Newsticker @value{VERSION} @syncodeindex vr cp @syncodeindex fn cp @@ -20,9 +18,19 @@ Copyright @copyright{} 2004, 2005 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, no Front-Cover Texts, and no Back-Cover Texts. A -copy of the license is included in the section entitled ``GNU Free -Documentation License''. +Invariant Sections, 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 @@ -39,7 +47,6 @@ Documentation License''. @author @uref{http://de.geocities.com/ulf_jasper} @page @vskip 0pt plus 1filll -@insertcopying @end titlepage @contents @@ -47,19 +54,16 @@ Documentation License''. @ifnottex @node Top @top Newsticker - -@insertcopying @end ifnottex @menu -* Overview:: -* Requirements:: -* Installation:: -* Usage:: -* Configuration:: -* Remarks:: -* GNU Free Documentation License:: -* Index:: +* Overview:: General description of newsticker. +* Requirements:: Requirements for using newsticker. +* Installation:: Installing newsticker on your system. +* Usage:: Basic newsticker instructions. +* Configuration:: Customizable newsticker settings. +* Remarks:: Remarks about newsticker. +* Index:: Variable, function, and concept index. @end menu @node Overview @@ -120,19 +124,19 @@ prints them to stdout. By default Newsticker will use Place Newsticker in a directory where Emacs can find it. Add the following line to your Emacs startup file (@file{~/.emacs}). -@example +@lisp (add-to-list 'load-path "/path/to/newsticker/") (autoload 'newsticker-start "newsticker" "Emacs Newsticker" t) (autoload 'newsticker-show-news "newsticker" "Emacs Newsticker" t) -@end example +@end lisp Newsticker-mode supports imenu. This allows for navigating with the help of a menu. In order to use this feature you should also add the following. -@example +@lisp (add-hook 'newsticker-mode-hook 'imenu-add-menubar-index) -@end example +@end lisp That's it. @@ -140,33 +144,33 @@ That's it. @chapter Usage @findex newsticker-show-news -The command @command{newsticker-show-news} will display all available +The command @code{newsticker-show-news} will display all available headlines in a special buffer, called @samp{*newsticker*}. It will also start the asynchronous download of headlines. The modeline in the @samp{*newsticker*} buffer informs whenever new headlines have arrived. Clicking mouse-button 2 or pressing RET in this buffer on a -headline will call @command{browse-url} to load the corresponding news +headline will call @code{browse-url} to load the corresponding news story in your favourite web browser. @findex newsticker-start-ticker @findex newsticker-stop-ticker The scrolling, or flashing of headlines in the echo area, can be -started with the command @command{newsticker-start-ticker}. It can be -stopped with @command{newsticker-stop-ticker}. +started with the command @code{newsticker-start-ticker}. It can be +stopped with @code{newsticker-stop-ticker}. @findex newsticker-start @findex newsticker-stop If you just want to start the periodic download of headlines use the -command @command{newsticker-start}. Calling @command{newsticker-stop} -will stop the periodic download, but will call -@command{newsticker-stop-ticker} as well. +command @code{newsticker-start}. Calling @code{newsticker-stop} will +stop the periodic download, but will call +@code{newsticker-stop-ticker} as well. @node Configuration @chapter Configuration All Newsticker options are customizable, i.e. they can be changed with Emacs customization methods: Call the command -@command{customize-group} and enter @samp{newsticker} for the customization +@code{customize-group} and enter @samp{newsticker} for the customization group. All Newsticker options have reasonable default values, so that in most @@ -178,69 +182,69 @@ Newsticker options are organized in the following groups. @itemize @item -@command{newsticker-feed} contains options that define which news +@code{newsticker-feed} contains options that define which news feeds are retrieved and how this is done. @itemize @item @vindex newsticker-url-list -@command{newsticker-url-list} defines the list of headlines which are +@code{newsticker-url-list} defines the list of headlines which are retrieved. @item @vindex newsticker-retrieval-interval -@command{newsticker-retrieval-interval} defines how often headlines +@code{newsticker-retrieval-interval} defines how often headlines are retrieved. @end itemize @item -@command{newsticker-headline-processing} contains options that define +@code{newsticker-headline-processing} contains options that define how the retrieved headlines are processed. @itemize @item @vindex newsticker-keep-obsolete-items -@command{newsticker-keep-obsolete-items} decides whether unread +@code{newsticker-keep-obsolete-items} decides whether unread headlines that have been removed from the feed are kept in the Newsticker cache. @end itemize @item -@command{newsticker-layout} contains options that define how the +@code{newsticker-layout} contains options that define how the buffer for reading RSS headlines is formatted. @itemize @item @vindex newsticker-heading-format -@command{newsticker-item-format} defines how the title of a headline +@code{newsticker-item-format} defines how the title of a headline is formatted. @end itemize @item -@command{newsticker-ticker} contains options that define how headlines +@code{newsticker-ticker} contains options that define how headlines are shown in the echo area. @itemize @item @vindex newsticker-display-interval @vindex newsticker-scroll-smoothly -@command{newsticker-display-interval} and -@command{newsticker-scroll-smoothly} define how headlines are shown in +@code{newsticker-display-interval} and +@code{newsticker-scroll-smoothly} define how headlines are shown in the echo area. @end itemize @item -@command{newsticker-hooks} contains options for hooking other Emacs +@code{newsticker-hooks} contains options for hooking other Emacs commands to newsticker functions. @itemize @item @vindex newsticker-new-item-functions -@command{newsticker-new-item-functions} allows for automatic +@code{newsticker-new-item-functions} allows for automatic processing of headlines. See `newsticker-download-images', and `newsticker-download-enclosures' for sample functions. @end itemize @item -@command{newsticker-miscellaneous} contains other Newsticker options. +@code{newsticker-miscellaneous} contains other Newsticker options. @end itemize @@ -258,409 +262,6 @@ every once in a while. Byte-compiling newsticker.el is recommended. -@node GNU Free Documentation License -@chapter GNU Free Documentation License - -@verbatim - - GNU Free Documentation License - ============================== - - Version 1.2, November 2002 - Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. - 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA - - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - 0. PREAMBLE - - The purpose of this License is to make a manual, textbook, or other - functional and useful document "free" in the sense of freedom: to - assure everyone the effective freedom to copy and redistribute it, - with or without modifying it, either commercially or - noncommercially. Secondarily, this License preserves for the - author and publisher a way to get credit for their work, while not - being considered responsible for modifications made by others. - - This License is a kind of "copyleft", which means that derivative - works of the document must themselves be free in the same sense. - It complements the GNU General Public License, which is a copyleft - license designed for free software. - - We have designed this License in order to use it for manuals for - free software, because free software needs free documentation: a - free program should come with manuals providing the same freedoms - that the software does. But this License is not limited to - software manuals; it can be used for any textual work, regardless - of subject matter or whether it is published as a printed book. - We recommend this License principally for works whose purpose is - instruction or reference. - - 1. APPLICABILITY AND DEFINITIONS - - This License applies to any manual or other work, in any medium, - that contains a notice placed by the copyright holder saying it - can be distributed under the terms of this License. Such a notice - grants a world-wide, royalty-free license, unlimited in duration, - to use that work under the conditions stated herein. The - "Document", below, refers to any such manual or work. Any member - of the public is a licensee, and is addressed as "you". You - accept the license if you copy, modify or distribute the work in a - way requiring permission under copyright law. - - A "Modified Version" of the Document means any work containing the - Document or a portion of it, either copied verbatim, or with - modifications and/or translated into another language. - - A "Secondary Section" is a named appendix or a front-matter section - of the Document that deals exclusively with the relationship of the - publishers or authors of the Document to the Document's overall - subject (or to related matters) and contains nothing that could - fall directly within that overall subject. (Thus, if the Document - is in part a textbook of mathematics, a Secondary Section may not - explain any mathematics.) The relationship could be a matter of - historical connection with the subject or with related matters, or - of legal, commercial, philosophical, ethical or political position - regarding them. - - The "Invariant Sections" are certain Secondary Sections whose - titles are designated, as being those of Invariant Sections, in - the notice that says that the Document is released under this - License. If a section does not fit the above definition of - Secondary then it is not allowed to be designated as Invariant. - The Document may contain zero Invariant Sections. If the Document - does not identify any Invariant Sections then there are none. - - The "Cover Texts" are certain short passages of text that are - listed, as Front-Cover Texts or Back-Cover Texts, in the notice - that says that the Document is released under this License. A - Front-Cover Text may be at most 5 words, and a Back-Cover Text may - be at most 25 words. - - A "Transparent" copy of the Document means a machine-readable copy, - represented in a format whose specification is available to the - general public, that is suitable for revising the document - straightforwardly with generic text editors or (for images - composed of pixels) generic paint programs or (for drawings) some - widely available drawing editor, and that is suitable for input to - text formatters or for automatic translation to a variety of - formats suitable for input to text formatters. A copy made in an - otherwise Transparent file format whose markup, or absence of - markup, has been arranged to thwart or discourage subsequent - modification by readers is not Transparent. An image format is - not Transparent if used for any substantial amount of text. A - copy that is not "Transparent" is called "Opaque". - - Examples of suitable formats for Transparent copies include plain - ASCII without markup, Texinfo input format, LaTeX input format, - SGML or XML using a publicly available DTD, and - standard-conforming simple HTML, PostScript or PDF designed for - human modification. Examples of transparent image formats include - PNG, XCF and JPG. Opaque formats include proprietary formats that - can be read and edited only by proprietary word processors, SGML or - XML for which the DTD and/or processing tools are not generally - available, and the machine-generated HTML, PostScript or PDF - produced by some word processors for output purposes only. - - The "Title Page" means, for a printed book, the title page itself, - plus such following pages as are needed to hold, legibly, the - material this License requires to appear in the title page. For - works in formats which do not have any title page as such, "Title - Page" means the text near the most prominent appearance of the - work's title, preceding the beginning of the body of the text. - - A section "Entitled XYZ" means a named subunit of the Document - whose title either is precisely XYZ or contains XYZ in parentheses - following text that translates XYZ in another language. (Here XYZ - stands for a specific section name mentioned below, such as - "Acknowledgements", "Dedications", "Endorsements", or "History".) - To "Preserve the Title" of such a section when you modify the - Document means that it remains a section "Entitled XYZ" according - to this definition. - - The Document may include Warranty Disclaimers next to the notice - which states that this License applies to the Document. These - Warranty Disclaimers are considered to be included by reference in - this License, but only as regards disclaiming warranties: any other - implication that these Warranty Disclaimers may have is void and - has no effect on the meaning of this License. - - 2. VERBATIM COPYING - - You may copy and distribute the Document in any medium, either - commercially or noncommercially, provided that this License, the - copyright notices, and the license notice saying this License - applies to the Document are reproduced in all copies, and that you - add no other conditions whatsoever to those of this License. You - may not use technical measures to obstruct or control the reading - or further copying of the copies you make or distribute. However, - you may accept compensation in exchange for copies. If you - distribute a large enough number of copies you must also follow - the conditions in section 3. - - You may also lend copies, under the same conditions stated above, - and you may publicly display copies. - - 3. COPYING IN QUANTITY - - If you publish printed copies (or copies in media that commonly - have printed covers) of the Document, numbering more than 100, and - the Document's license notice requires Cover Texts, you must - enclose the copies in covers that carry, clearly and legibly, all - these Cover Texts: Front-Cover Texts on the front cover, and - Back-Cover Texts on the back cover. Both covers must also clearly - and legibly identify you as the publisher of these copies. The - front cover must present the full title with all words of the - title equally prominent and visible. You may add other material - on the covers in addition. Copying with changes limited to the - covers, as long as they preserve the title of the Document and - satisfy these conditions, can be treated as verbatim copying in - other respects. - - If the required texts for either cover are too voluminous to fit - legibly, you should put the first ones listed (as many as fit - reasonably) on the actual cover, and continue the rest onto - adjacent pages. - - If you publish or distribute Opaque copies of the Document - numbering more than 100, you must either include a - machine-readable Transparent copy along with each Opaque copy, or - state in or with each Opaque copy a computer-network location from - which the general network-using public has access to download - using public-standard network protocols a complete Transparent - copy of the Document, free of added material. If you use the - latter option, you must take reasonably prudent steps, when you - begin distribution of Opaque copies in quantity, to ensure that - this Transparent copy will remain thus accessible at the stated - location until at least one year after the last time you - distribute an Opaque copy (directly or through your agents or - retailers) of that edition to the public. - - It is requested, but not required, that you contact the authors of - the Document well before redistributing any large number of - copies, to give them a chance to provide you with an updated - version of the Document. - - 4. MODIFICATIONS - - You may copy and distribute a Modified Version of the Document - under the conditions of sections 2 and 3 above, provided that you - release the Modified Version under precisely this License, with - the Modified Version filling the role of the Document, thus - licensing distribution and modification of the Modified Version to - whoever possesses a copy of it. In addition, you must do these - things in the Modified Version: - - A. Use in the Title Page (and on the covers, if any) a title - distinct from that of the Document, and from those of - previous versions (which should, if there were any, be listed - in the History section of the Document). You may use the - same title as a previous version if the original publisher of - that version gives permission. - - B. List on the Title Page, as authors, one or more persons or - entities responsible for authorship of the modifications in - the Modified Version, together with at least five of the - principal authors of the Document (all of its principal - authors, if it has fewer than five), unless they release you - from this requirement. - - C. State on the Title page the name of the publisher of the - Modified Version, as the publisher. - - D. Preserve all the copyright notices of the Document. - - E. Add an appropriate copyright notice for your modifications - adjacent to the other copyright notices. - - F. Include, immediately after the copyright notices, a license - notice giving the public permission to use the Modified - Version under the terms of this License, in the form shown in - the Addendum below. - - G. Preserve in that license notice the full lists of Invariant - Sections and required Cover Texts given in the Document's - license notice. - - H. Include an unaltered copy of this License. - - I. Preserve the section Entitled "History", Preserve its Title, - and add to it an item stating at least the title, year, new - authors, and publisher of the Modified Version as given on - the Title Page. If there is no section Entitled "History" in - the Document, create one stating the title, year, authors, - and publisher of the Document as given on its Title Page, - then add an item describing the Modified Version as stated in - the previous sentence. - - J. Preserve the network location, if any, given in the Document - for public access to a Transparent copy of the Document, and - likewise the network locations given in the Document for - previous versions it was based on. These may be placed in - the "History" section. You may omit a network location for a - work that was published at least four years before the - Document itself, or if the original publisher of the version - it refers to gives permission. - - K. For any section Entitled "Acknowledgements" or "Dedications", - Preserve the Title of the section, and preserve in the - section all the substance and tone of each of the contributor - acknowledgements and/or dedications given therein. - - L. Preserve all the Invariant Sections of the Document, - unaltered in their text and in their titles. Section numbers - or the equivalent are not considered part of the section - titles. - - M. Delete any section Entitled "Endorsements". Such a section - may not be included in the Modified Version. - - N. Do not retitle any existing section to be Entitled - "Endorsements" or to conflict in title with any Invariant - Section. - - O. Preserve any Warranty Disclaimers. - - If the Modified Version includes new front-matter sections or - appendices that qualify as Secondary Sections and contain no - material copied from the Document, you may at your option - designate some or all of these sections as invariant. To do this, - add their titles to the list of Invariant Sections in the Modified - Version's license notice. These titles must be distinct from any - other section titles. - - You may add a section Entitled "Endorsements", provided it contains - nothing but endorsements of your Modified Version by various - parties--for example, statements of peer review or that the text - has been approved by an organization as the authoritative - definition of a standard. - - You may add a passage of up to five words as a Front-Cover Text, - and a passage of up to 25 words as a Back-Cover Text, to the end - of the list of Cover Texts in the Modified Version. Only one - passage of Front-Cover Text and one of Back-Cover Text may be - added by (or through arrangements made by) any one entity. If the - Document already includes a cover text for the same cover, - previously added by you or by arrangement made by the same entity - you are acting on behalf of, you may not add another; but you may - replace the old one, on explicit permission from the previous - publisher that added the old one. - - The author(s) and publisher(s) of the Document do not by this - License give permission to use their names for publicity for or to - assert or imply endorsement of any Modified Version. - - 5. COMBINING DOCUMENTS - - You may combine the Document with other documents released under - this License, under the terms defined in section 4 above for - modified versions, provided that you include in the combination - all of the Invariant Sections of all of the original documents, - unmodified, and list them all as Invariant Sections of your - combined work in its license notice, and that you preserve all - their Warranty Disclaimers. - - The combined work need only contain one copy of this License, and - multiple identical Invariant Sections may be replaced with a single - copy. If there are multiple Invariant Sections with the same name - but different contents, make the title of each such section unique - by adding at the end of it, in parentheses, the name of the - original author or publisher of that section if known, or else a - unique number. Make the same adjustment to the section titles in - the list of Invariant Sections in the license notice of the - combined work. - - In the combination, you must combine any sections Entitled - "History" in the various original documents, forming one section - Entitled "History"; likewise combine any sections Entitled - "Acknowledgements", and any sections Entitled "Dedications". You - must delete all sections Entitled "Endorsements." - - 6. COLLECTIONS OF DOCUMENTS - - You may make a collection consisting of the Document and other - documents released under this License, and replace the individual - copies of this License in the various documents with a single copy - that is included in the collection, provided that you follow the - rules of this License for verbatim copying of each of the - documents in all other respects. - - You may extract a single document from such a collection, and - distribute it individually under this License, provided you insert - a copy of this License into the extracted document, and follow - this License in all other respects regarding verbatim copying of - that document. - - 7. AGGREGATION WITH INDEPENDENT WORKS - - A compilation of the Document or its derivatives with other - separate and independent documents or works, in or on a volume of - a storage or distribution medium, is called an "aggregate" if the - copyright resulting from the compilation is not used to limit the - legal rights of the compilation's users beyond what the individual - works permit. When the Document is included in an aggregate, this - License does not apply to the other works in the aggregate which - are not themselves derivative works of the Document. - - If the Cover Text requirement of section 3 is applicable to these - copies of the Document, then if the Document is less than one half - of the entire aggregate, the Document's Cover Texts may be placed - on covers that bracket the Document within the aggregate, or the - electronic equivalent of covers if the Document is in electronic - form. Otherwise they must appear on printed covers that bracket - the whole aggregate. - - 8. TRANSLATION - - Translation is considered a kind of modification, so you may - distribute translations of the Document under the terms of section - 4. Replacing Invariant Sections with translations requires special - permission from their copyright holders, but you may include - translations of some or all Invariant Sections in addition to the - original versions of these Invariant Sections. You may include a - translation of this License, and all the license notices in the - Document, and any Warranty Disclaimers, provided that you also - include the original English version of this License and the - original versions of those notices and disclaimers. In case of a - disagreement between the translation and the original version of - this License or a notice or disclaimer, the original version will - prevail. - - If a section in the Document is Entitled "Acknowledgements", - "Dedications", or "History", the requirement (section 4) to - Preserve its Title (section 1) will typically require changing the - actual title. - - 9. TERMINATION - - You may not copy, modify, sublicense, or distribute the Document - except as expressly provided for under this License. Any other - attempt to copy, modify, sublicense or distribute the Document 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. - - 10. FUTURE REVISIONS OF THIS LICENSE - - The Free Software Foundation may publish new, revised versions of - the GNU Free Documentation 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. See - `http://www.gnu.org/copyleft/'. - - Each version of the License is given a distinguishing version - number. If the Document specifies that a particular numbered - version of this License "or any later version" applies to it, you - have the option of following the terms and conditions either of - that specified version or of any later version that has been - published (not as a draft) by the Free Software Foundation. If - the Document does not specify a version number of this License, - you may choose any version ever published (not as a draft) by the - Free Software Foundation. - -@end verbatim @node Index @unnumbered Index diff --git a/man/org.texi b/man/org.texi index 0545cf462f..92248c91e8 100644 --- a/man/org.texi +++ b/man/org.texi @@ -4,7 +4,7 @@ @setfilename ../info/org @settitle Org Mode Manual -@set VERSION 3.15 +@set VERSION 3.16 @set DATE September 2005 @dircategory Emacs @@ -100,7 +100,7 @@ Document Structure * Outlines:: Org-mode is based on outline-mode * Headlines:: How to typeset org-tree headlines -* Visibility cycling:: Show ad hide, much simplified +* Visibility cycling:: Show and hide, much simplified * Motion:: Jumping to other headlines * Structure editing:: Changing sequence and level of headlines * Archiving:: Move done task trees to a different place @@ -120,7 +120,7 @@ Calculations in tables * Advanced features:: Field names, parameters and automatic recalc * Named-field formulas:: Formulas valid in single fields * Editing/debugging formulas:: Changing a stored formula -* Appetizer:: +* Appetizer:: Taste the power of calc Hyperlinks @@ -169,6 +169,7 @@ Miscellaneous * Customization:: Adapting Org-mode to your taste * FAQ:: Frequently asked questions * Interaction:: Other Emacs packages +* TTY keys:: Using Org-mode on a tty * Bugs:: Things which do not work perfectly * Acknowledgments:: These people provided feedback and more @@ -312,7 +313,7 @@ edit the structure of the document. @menu * Outlines:: Org-mode is based on outline-mode * Headlines:: How to typeset org-tree headlines -* Visibility cycling:: Show ad hide, much simplified +* Visibility cycling:: Show and hide, much simplified * Motion:: Jumping to other headlines * Structure editing:: Changing sequence and level of headlines * Archiving:: Move done task trees to a different place @@ -475,14 +476,14 @@ Move subtree up (swap with previous subtree of same level) @kindex M-S-@key{down} @item M-S-@key{down} Move subtree down (swap with next subtree of same level) -@kindex C-c C-h C-w -@item C-c C-h C-w +@kindex C-c C-x C-w +@item C-c C-x C-w Kill subtree, i.e. remove it from buffer but save in kill ring. -@kindex C-c C-h M-w -@item C-c C-h M-w +@kindex C-c C-x M-w +@item C-c C-x M-w Copy subtree to kill ring. -@kindex C-c C-h C-y -@item C-c C-h C-y +@kindex C-c C-x C-y +@item C-c C-x C-y Yank subtree from kill ring. This does modify the level of the subtree to make sure the tree fits in nicely at the yank position. The yank level can also be specified with a prefix arg, or by yanking after a @@ -610,10 +611,18 @@ create the above table, you would only type |Name|Phone|Age |- @end example - @noindent and then press @key{TAB} to align the table and start filling in fields. +When typing text into a field, Org-mode treats @key{DEL}, +@key{Backspace}, and all character keys in a special way, so that +inserting and deleting avoids shifting other fields. Also, when +typing @emph{immediately after the cursor was moved into a new field +with @kbd{@key{TAB}}, @kbd{S-@key{TAB}} or @kbd{@key{RET}}}, the +field is automatically made blank. If this behavior is too +unpredictable for you, configure the variables +@code{org-enable-table-editor} and @code{org-table-auto-blank-field}. + @table @kbd @tsubheading{Creation and conversion} @item M-x org-table-create @@ -684,17 +693,17 @@ Insert a horizontal line below current row. With prefix arg, the line is created above the current line. @tsubheading{Regions} -@kindex C-c C-h M-w -@item C-c C-h M-w +@kindex C-c C-x M-w +@item C-c C-x M-w Copy a rectangular region from a table to a special clipboard. Point and mark determine edge fields of the rectangle. The process ignores horizontal separator lines. -@kindex C-c C-h C-w -@item C-c C-h C-w +@kindex C-c C-x C-w +@item C-c C-x C-w Copy a rectangular region from a table to a special clipboard, and blank all fields in the rectangle. So this is the ``cut'' operation. -@kindex C-c C-h C-y -@item C-c C-h C-y +@kindex C-c C-x C-y +@item C-c C-x C-y Paste a rectangular region into a table. The upper right corner ends up in the current field. All involved fields will be overwritten. If the rectangle does not fit into the present table, @@ -802,16 +811,16 @@ it off with @section Calculations in tables @cindex calculations, in tables -The table editor has some spreadsheet-like capabilities. The Emacs -@file{calc} package is required for this feature to work. There are -basically two levels of complexity for table calculations in Org-mode. -On the basic level, tables do only horizontal computations, so a field -can be computed from other fields @emph{in the same row}, and Org-mode -assumes that there is only one formula for each column. This is very -efficient to work with and enough for many tasks. On the complex -level, columns and individual fields can be named for easier -referencing in formulas, individual named fields can have their own -formula associated with them, and recalculation can be automated. +The table editor makes use of the Emacs @file{calc} package to +implement spreadsheet-like capabilities. Org-mode has two levels of +complexity for table calculations. On the basic level, tables do only +horizontal computations, so a field can be computed from other fields +@emph{in the same row}, and Org-mode assumes that there is only one +formula for each column. This is very efficient to work with and +enough for many tasks. On the complex level, columns and individual +fields can be named for easier referencing in formulas, individual +named fields can have their own formula associated with them, and +recalculation can be automated. @menu * Formula syntax:: How to write a formula @@ -859,8 +868,8 @@ A formula can contain an optional mode string after a semicolon. This string consists of flags to influence calc's modes@footnote{By default, Org-mode uses the standard calc modes (precision 12, angular units degrees, fraction and symbolic modes off). However, the display -format which has been changed to @code{(float 5)} to keep tables -compact. The default settings can be configured using the variable +format has been changed to @code{(float 5)} to keep tables compact. +The default settings can be configured using the variable @code{org-calc-default-modes}.} during execution, e.g. @samp{p20} to switch the internal precision to 20 digits, @samp{n3}, @samp{s3}, @samp{e2} or @samp{f4} to switch to normal, scientific, engineering, @@ -1357,8 +1366,9 @@ of working on an item, for example @end lisp @cindex completion, of TODO keywords +Changing these variables becomes only effective in a new Emacs session. With this setup, the command @kbd{C-c C-t} will cycle an entry from -TODO to FEEDBACK, then to VERIFY, and finally too DONE. You may also +TODO to FEEDBACK, then to VERIFY, and finally to DONE. You may also use a prefix argument to quickly select a specific state. For example @kbd{C-3 C-c C-t} will change the state immediately to VERIFY. If you define many keywords, you can use in-buffer completion (see @@ -1388,7 +1398,7 @@ one type to another. Therefore, in this case the behavior of the command @kbd{C-c C-t} is changed slightly@footnote{This is also true for the @kbd{t} command in the timeline and agenda buffers.}. When used several times in succession, it will still cycle through all -names. But when when you return to the item after some time and +names. But when you return to the item after some time and execute @kbd{C-c C-t} again, it will switch from each name directly to DONE. Use prefix arguments or completion to quickly select a specific name. @@ -1423,7 +1433,7 @@ only one of the two aspects of TODO keywords can be used. After changing one of these lines, use @kbd{C-c C-c} with the cursor still in the line to make the changes known to Org-mode@footnote{Org-mode parses these lines only when Org-mode is activated after visiting a -file. @kbd{C-c C-c} with the cursor in a line starting with @samp{#-} +file. @kbd{C-c C-c} with the cursor in a line starting with @samp{#+} is simply restarting Org-mode, making sure that these changes will be respected.}. @@ -1565,6 +1575,11 @@ this command is used twice in succession, a time range is inserted. Like @kbd{C-c .}, but use the alternative format which contains date and time. +@kindex C-c ! +@item C-c ! +Like @kbd{C-c .}, but insert an inactive time stamp not triggering the +agenda. + @kindex C-c < @item C-c < Insert a time stamp corresponding to the cursor date in the Calendar. @@ -2171,15 +2186,15 @@ warning. @kindex C-c C-x h @item C-c C-x h Export as HTML file @file{myfile.html}. -@kindex C-c C-x C-h -@item C-c C-x C-h +@kindex C-c C-x b +@item C-c C-x b Export as HTML file and open it with a browser. @kindex C-c C-x t @item C-c C-x t Insert template with export options, see below. @kindex C-c : @item C-c : -Toggle fixed-width for line or region, see below. +Toggle fixed-width for entry (QUOTE) or region, see below. @end table @node HTML formatting, Export options, Export commands, Exporting @@ -2242,7 +2257,7 @@ The exporter recognizes special lines in the buffer which provide additional information. These lines may be put anywhere in the file. The whole set of lines can be inserted into the buffer with @kbd{C-c C-x t}. For individual lines, a good way to make sure the keyword is -correct it to type @samp{#+} and then use @kbd{M-@key{TAB}} completion +correct is to type @samp{#+} and then use @kbd{M-@key{TAB}} completion (@pxref{Completion}). @example @@ -2304,6 +2319,7 @@ Toggle the COMMENT keyword at the beginning of an entry. * Customization:: Adapting Org-mode to your taste * FAQ:: Frequently asked questions * Interaction:: Other Emacs packages +* TTY keys:: Using Org-mode on a tty * Bugs:: Things which do not work perfectly * Acknowledgments:: These people provided feedback and more @end menu @@ -2436,7 +2452,7 @@ indentation of the first line and realign with @key{TAB}. @end enumerate -@node Interaction, Bugs, FAQ, Miscellaneous +@node Interaction, TTY keys, FAQ, Miscellaneous @section Interaction with other packages @cindex packages, interaction with other Org-mode can cooperate with the following packages: @@ -2498,7 +2514,44 @@ Integrate org files into the diary as described above, and then turn on the diary support of planner. @end table -@node Bugs, Acknowledgments, Interaction, Miscellaneous +@node TTY keys, Bugs, Interaction, Miscellaneous +@section Using org-mode on a tty + +Org-mode uses a number of keys that are not accessible on a tty. This +applies to most special keys like cursor keys, @key{TAB} and +@key{RET}, when these are combined with modifier keys like @key{Meta} +and/or @key{Shift}. Org-mode uses these bindings because it needs to +provide keys for a large number of commands, and because these keys +appeared particularly easy to remember. In order to still be able to +access the core functionality of Org-mode on a tty, alternative +bindings are provided. Here is a complete list of these bindings, +which are obviously more cumbersome to use. Note that sometimes a +work-around can be better. For example changing a time stamp is +really only fun with @kbd{S-@key{cursor}} keys. On a tty you would +rather use @kbd{C-c .} to re-insert the timestamp. + +@page +@multitable @columnfractions 0.15 0.2 0.2 +@item @b{Default} @tab @b{Alternative 1} @tab @b{Alternative 2} +@item @kbd{S-@key{TAB}} @tab @kbd{C-u @key{TAB}} @tab +@item @kbd{M-@key{left}} @tab @kbd{C-c C-x l} @tab @kbd{@key{Esc} @key{left}} +@item @kbd{M-S-@key{left}} @tab @kbd{C-c C-x L} @tab +@item @kbd{M-@key{right}} @tab @kbd{C-c C-x r} @tab @kbd{@key{Esc} @key{right}} +@item @kbd{M-S-@key{right}} @tab @kbd{C-c C-x R} @tab +@item @kbd{M-@key{up}} @tab @kbd{C-c C-x u} @tab @kbd{@key{Esc} @key{up}} +@item @kbd{M-S-@key{up}} @tab @kbd{C-c C-x U} @tab +@item @kbd{M-@key{down}} @tab @kbd{C-c C-x d} @tab @kbd{@key{Esc} @key{down}} +@item @kbd{M-S-@key{down}} @tab @kbd{C-c C-x D} @tab +@item @kbd{S-@key{RET}} @tab @kbd{C-c C-x c} @tab +@item @kbd{M-@key{RET}} @tab @kbd{C-c C-x m} @tab @kbd{@key{Esc} @key{RET}} +@item @kbd{M-S-@key{RET}} @tab @kbd{C-c C-x M} @tab +@item @kbd{S-@key{left}} @tab @kbd{C-c C-x @key{left}} @tab +@item @kbd{S-@key{right}} @tab @kbd{C-c C-x @key{right}} @tab +@item @kbd{S-@key{up}} @tab @kbd{C-c C-x @key{up}} @tab +@item @kbd{S-@key{down}} @tab @kbd{C-c C-x @key{down}} @tab +@end multitable + +@node Bugs, Acknowledgments, TTY keys, Miscellaneous @section Bugs @cindex bugs @@ -2514,13 +2567,21 @@ filling is correctly disabled. However, if some text directly normal text. Also, @code{fill-region} does bypass the @code{fill-paragraph} code and will fill tables like normal text. @item +Text in an entry protected with the @samp{QUOTE} keyword should not +autowrap. +@item When the application called by @kbd{C-c C-o} to open a file link fails (for example because the application does not exits or refuses to open the file), it does so silently. No error message is displayed. @item +The remote-editing commands in the agenda buffer cannot be undone with +@code{undo} called from within the agenda buffer. But you can go to +the corresponding buffer (using @key{TAB} or @key{RET} and execute +@code{undo} there. +@item Recalculating a table line applies the formulas from left to right. -If a formula calculated fields further down the row, multiple -recalculation may be needed to get all fields consistent. +If a formula uses @emph{calculated} fields further down the row, +multiple recalculation may be needed to get all fields consistent. @item Under XEmacs, if Org-mode entries are included into the diary, it is not possible to jump back from the diary to the org file. Apparently, @@ -2592,6 +2653,9 @@ Emacs-Lisp compiler happy. @item Kai Grossjohann pointed out that a number of key bindings in Org-mode conflict with other packages. +@item +Roland Winkler pointed out that additional keybindings are need to use +Org-mode on a tty. @end itemize @node Index, Key Index, Miscellaneous, Top diff --git a/man/pcl-cvs.texi b/man/pcl-cvs.texi index 26ca071d2e..3331590fcb 100644 --- a/man/pcl-cvs.texi +++ b/man/pcl-cvs.texi @@ -11,7 +11,7 @@ Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 diff --git a/man/pgg.texi b/man/pgg.texi index 203f0cda37..7b4b1143d6 100644 --- a/man/pgg.texi +++ b/man/pgg.texi @@ -13,7 +13,7 @@ Copyright (C) 2001 Daiki Ueno. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU diff --git a/man/reftex.texi b/man/reftex.texi index 12c4ce6e41..845190981e 100644 --- a/man/reftex.texi +++ b/man/reftex.texi @@ -7,9 +7,9 @@ @syncodeindex fn cp @c Version and Contact Info -@set VERSION 4.28 -@set EDITION 4.28 -@set DATE May 2005 +@set VERSION 4.30 +@set EDITION 4.30 +@set DATE September 2005 @set AUCTEXSITE @uref{http://www.nongnu.org/auctex/,AUCTeX distribution site} @set MAINTAINERSITE @uref{http://www.astro.uva.nl/~dominik/Tools/,maintainers webpage} @set MAINTAINER Carsten Dominik @@ -25,12 +25,11 @@ citations and indices for LaTeX documents with Emacs. This is edition @value{EDITION} of the @b{Ref@TeX{}} User Manual for @b{Ref@TeX{}} @value{VERSION} -Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2004, - 2005 Free Software Foundation, Inc. +Copyright (c) 1997, 1998, 1999, 2000, 2001, 2002, 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the @@ -154,7 +153,7 @@ Citations * Citation Info:: View the corresponding database entry. * Chapterbib and Bibunits:: Multiple bibliographies in a Document. * Citations Outside LaTeX:: How to make citations in Emails etc. -* BibTeX Database Subsets:: Extract parts of a big database. +* BibTeX Database Subsets:: Extract parts of a big database. Index Support @@ -1669,7 +1668,7 @@ support for citations helps to select the correct key quickly. * Citation Info:: View the corresponding database entry. * Chapterbib and Bibunits:: Multiple bibliographies in a Document. * Citations Outside LaTeX:: How to make citations in Emails etc. -* BibTeX Database Subsets:: Extract parts of a big database. +* BibTeX Database Subsets:: Extract parts of a big database. @end menu @node Creating Citations, Citation Styles, , Citations @@ -1773,12 +1772,12 @@ separate @code{\cite} macro for each of it. @item e Create a new BibTeX database file which contains all @i{marked} entries in the selection buffer. If no entries are marked, all entries are -selected. +selected. @item E Create a new BibTeX database file which contains all @i{unmarked} entries in the selection buffer. If no entries are marked, all entries -are selected. +are selected. @item @key{TAB} Enter a citation key with completion. This may also be a key which does @@ -3212,7 +3211,7 @@ way. Before calling a @b{Ref@TeX{}} function, the style hook should always test for the availability of the function, so that the style file will -also work for people who do not use @b{Ref@TeX{}}. +also work for people who do not use @b{Ref@TeX{}}. Additions made with style files in the way described below remain local to the current document. For example, if one package uses AMSTeX, the @@ -3493,7 +3492,7 @@ With @i{Viper} mode prior to Vipers version 3.01, you need to protect @b{Ref@TeX{}} was written by @i{Carsten Dominik} @email{dominik@@science.uva.nl}, with contributions by @i{Stephen -Eglen}. @b{Ref@TeX{}} is currently maintained by +Eglen}. @b{Ref@TeX{}} is currently maintained by @noindent Carsten Dominik <dominik@@science.uva.nl> @@ -3713,7 +3712,7 @@ Produce a list of all duplicate labels in the document. Create a new BibTeX database file with all entries referenced in document. The command prompts for a filename and writes the collected entries to that file. Only entries referenced in the current document with -any @code{\cite}-like macros are used. +any @code{\cite}-like macros are used. The sequence in the new file is the same as it was in the old database. @end deffn @@ -3818,7 +3817,7 @@ only in that frame. So when creating that frame (with @kbd{d} key in an ordinary TOC window), the automatic recentering is turned on. When the frame gets destroyed, automatic recentering is turned off again. -This feature can be turned on and off from the menu +This feature can be turned on and off from the menu (Ref->Options). @end defopt @@ -3928,7 +3927,7 @@ group which contains all labels. This may also be a function to do local parsing and identify point to be in a non-standard label environment. The function must take an argument @var{bound} and limit backward searches to this value. It -should return either @code{nil} or a cons cell @code{(@var{function} +should return either nil or a cons cell @code{(@var{function} . @var{position})} with the function symbol and the position where the special environment starts. See the Info documentation for an example. @@ -4085,7 +4084,7 @@ special packages like fancyref) are being used. RefTeX can and by default does parse around each label to detect the correct label type, but this process can be slow when a document contains thousands of labels. If you use label prefixes consistently, you may speed up -document parsing by setting this variable to a non-@code{nil} value. RefTeX +document parsing by setting this variable to a non-nil value. RefTeX will then compare the label prefix with the prefixes found in `reftex-label-alist' and derive the correct label type in this way. Possible values for this option are: @@ -4094,7 +4093,7 @@ Possible values for this option are: t @r{This means to trust any label prefixes found.} regexp @r{If a regexp, only prefixes matched by the regexp are trusted.} list @r{List of accepted prefixes, as strings. The colon is part of} - @r{the prefix, e.g. ("fn:" "eqn:" "item:").} + @r{the prefix, e.g. ("fn:" "eqn:" "item:").} nil @r{Never trust a label prefix.} @end example The only disadvantage of using this feature is that the label context @@ -4650,7 +4649,7 @@ case. @defopt reftex-index-verify-function A function which is called at each match during global indexing. -If the function returns @code{nil}, the current match is skipped. +If the function returns nil, the current match is skipped. @end defopt @defopt reftex-index-phrases-skip-indexed-matches @@ -4770,10 +4769,10 @@ escapes. @defopt reftex-revisit-to-echo Non-@code{nil} means, automatic citation display will revisit files if -necessary. When @code{nil}, citation display in echo area will only -be active for cached echo strings (see @code{reftex-cache-cite-echo}), -or for BibTeX database files which are already visited by a live -associated buffers. +necessary. When nil, citation display in echo area will only be active +for cached echo strings (see @code{reftex-cache-cite-echo}), or for +BibTeX database files which are already visited by a live associated +buffers. @end defopt @defopt reftex-cache-cite-echo @@ -5114,7 +5113,7 @@ See the AUCTeX documentation for more information. @defopt reftex-revisit-to-follow Non-@code{nil} means, follow-mode will revisit files if necessary. -When @code{nil}, follow-mode will be suspended for stuff in unvisited files. +When nil, follow-mode will be suspended for stuff in unvisited files. @end defopt @defopt reftex-allow-detached-macro-args @@ -5178,11 +5177,11 @@ Fixed bug with @samp{%F} in a label prefix. Added new escapes @noindent @b{Version 4.24} @itemize @bullet -@item +@item Inserting citation commands now prompts for optional arguments when called with a prefix argument. Related new options are @code{reftex-cite-prompt-optional-args} and -@code{reftex-cite-cleanup-optional-args}. +@code{reftex-cite-cleanup-optional-args}. @item New option @code{reftex-trust-label-prefix}. Configure this variable if you'd like RefTeX to base its classification of labels on prefixes. @@ -5190,7 +5189,7 @@ This can speed-up document parsing, but may in some cases reduce the quality of the context used by RefTeX to describe a label. @item Fixed bug in @code{reftex-create-bibtex-file} when @code{reftex-comment-citations} -is non-@code{nil}. +is non-nil. @item Fixed bugs in indexing: Case-sensitive search, quotes before and/or after words. Disabbled indexing in comment lines. @@ -5198,7 +5197,7 @@ after words. Disabbled indexing in comment lines. @noindent @b{Version 4.22} @itemize @bullet -@item +@item New command @code{reftex-create-bibtex-file} to create a new database with all entries referenced in the current document. @item @@ -5208,7 +5207,7 @@ from entries marked in a citation selection buffer. @noindent @b{Version 4.21} @itemize @bullet -@item +@item Renaming labels from the toc buffer with key @kbd{M-%}. @end itemize @@ -5424,7 +5423,7 @@ File search further refined. New option @code{reftex-file-extensions}. document, all labels and associated context. New keys @kbd{i}, @kbd{l}, and @kbd{c}. New options @code{reftex-toc-include-labels}, @code{reftex-toc-include-context}, -@code{reftex-toc-include-file-boundaries}. +@code{reftex-toc-include-file-boundaries}. @end itemize @noindent @b{Version 3.41} @@ -5537,7 +5536,7 @@ New option @code{reftex-cache-cite-echo}. @kbd{M-x reftex-reset-mode} now also removes the file with parsing info. @item -Default of @code{reftex-revisit-to-follow} changed to @code{nil}. +Default of @code{reftex-revisit-to-follow} changed to nil. @end itemize @noindent @b{Version 3.24} diff --git a/man/sc.texi b/man/sc.texi index 2189539476..7beb4aa88d 100644 --- a/man/sc.texi +++ b/man/sc.texi @@ -20,7 +20,7 @@ Copyright @copyright{} 1993, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/search.texi b/man/search.texi index b252e9c7c8..3c9e439e76 100644 --- a/man/search.texi +++ b/man/search.texi @@ -464,9 +464,12 @@ say, incremental regexp and non-regexp searches have independent defaults. They also have separate search rings that you can access with @kbd{M-p} and @kbd{M-n}. +@vindex search-whitespace-regexp If you type @key{SPC} in incremental regexp search, it matches any -sequence of whitespace characters, including newlines. If you want -to match just a space, type @kbd{C-q @key{SPC}}. +sequence of whitespace characters, including newlines. If you want to +match just a space, type @kbd{C-q @key{SPC}}. You can control what a +bare spece matches by setting the variable +@code{search-whitespace-regexp} to the desired regexp. Note that adding characters to the regexp in an incremental regexp search can make the cursor move back and start again. For example, if diff --git a/man/ses.texi b/man/ses.texi index 10d52dd66e..f697733566 100644 --- a/man/ses.texi +++ b/man/ses.texi @@ -15,7 +15,7 @@ Copyright @copyright{} 2002, 2003, 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/sieve.texi b/man/sieve.texi index 21da1f22c1..0d94f293fc 100644 --- a/man/sieve.texi +++ b/man/sieve.texi @@ -13,7 +13,7 @@ Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/smtpmail.texi b/man/smtpmail.texi index 847d7c7d74..d35d364ff5 100644 --- a/man/smtpmail.texi +++ b/man/smtpmail.texi @@ -7,7 +7,7 @@ Copyright @copyright{} 2003, 2004, 2005 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the license diff --git a/man/speedbar.texi b/man/speedbar.texi index 58dd4b435e..469de905a2 100644 --- a/man/speedbar.texi +++ b/man/speedbar.texi @@ -10,7 +10,7 @@ Copyright @copyright{} 1999, 2000, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 @@ -591,9 +591,10 @@ will follow the general rules of their major counterparts in terms of key bindings and visuals, but will have specialized behaviors. @menu -* RMAIL:: Managing folders in speedbar -* Info:: Browsing topics in speedbar -* GDB:: Managing the current stack trace in speedbar +* RMAIL:: Managing folders. +* Info:: Browsing topics. +* GDB:: Watching expressions or managing the current + stack trace. @end menu @node RMAIL, Info, Minor Modes, Minor Modes @@ -639,7 +640,15 @@ a @samp{[+]}, indicating that there are no sub-topics. @cindex gdb @cindex gud -If you are debugging an application with GDB in Emacs, speedbar can show +You can debug an application with GDB in Emacs using graphical mode or +text command mode (@pxref{GDB Graphical Interface,,, emacs, The +extensible self-documenting text editor}). + +If you are using graphical mode you can see how selected variables +change each time your program stops (@pxref{Watch Expressions,,, +emacs, The extensible self-documenting text editor}). + +If you are using text command mode, speedbar can show you the current stack when the current buffer is the @file{*gdb*} buffer. Usually, it will just report that there is no stack, but when the application is stopped, the current stack will be shown. diff --git a/man/text.texi b/man/text.texi index 01cacc1a62..5abb736a89 100644 --- a/man/text.texi +++ b/man/text.texi @@ -266,10 +266,11 @@ Put point and mark around this or next paragraph (@code{mark-paragraph}). @kbd{M-@{} moves to the beginning of the current or previous paragraph, while @kbd{M-@}} moves to the end of the current or next paragraph. Blank lines and text-formatter command lines separate -paragraphs and are not considered part of any paragraph. In Indented -Text mode, but not in Text mode, an indented line also starts a new -paragraph. If there is a blank line before the paragraph, @kbd{M-@{} -moves to the blank line, because that is convenient in practice. +paragraphs and are not considered part of any paragraph. In +Paragraph-Indent Text mode, but not in Text mode, an indented line +also starts a new paragraph. If there is a blank line before the +paragraph, @kbd{M-@{} moves to the blank line, because that is +convenient in practice. In major modes for programs, paragraphs begin and end only at blank lines. This makes the paragraph commands continue to be useful even diff --git a/man/tramp.texi b/man/tramp.texi index b28292cff8..ccaa0cd3c6 100644 --- a/man/tramp.texi +++ b/man/tramp.texi @@ -30,7 +30,7 @@ Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/url.texi b/man/url.texi index f60890afb2..cfc62fe073 100644 --- a/man/url.texi +++ b/man/url.texi @@ -26,7 +26,7 @@ Copyright (C) 1996, 1997, 1998, 1999, 2002, 2004, Copyright (C) 1993, 1994, 1995, 1996 William M. Perry Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 ``GNU GENERAL PUBLIC LICENSE''. A copy of the @@ -55,7 +55,7 @@ Copyright @copyright{} 1996, 1997, 1998, 1999, 2002, 2003, 2004, 2005 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.1 or +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 ``GNU GENERAL PUBLIC LICENSE''. A copy of the diff --git a/man/vip.texi b/man/vip.texi index 5bc1e23da3..e98d51aeca 100644 --- a/man/vip.texi +++ b/man/vip.texi @@ -9,7 +9,7 @@ Copyright @copyright{} 1987, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/viper.texi b/man/viper.texi index 4e71eaee29..237e247454 100644 --- a/man/viper.texi +++ b/man/viper.texi @@ -12,7 +12,7 @@ Copyright @copyright{} 1995, 1996, 1997, 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual'', and with the Back-Cover Texts as in (a) below. A copy of the diff --git a/man/widget.texi b/man/widget.texi index a11b66be76..5b4a4b1252 100644 --- a/man/widget.texi +++ b/man/widget.texi @@ -14,7 +14,7 @@ Copyright @copyright{} 2000, 2002, 2003, 2004, 2005 Free Software Foundation, In @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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 diff --git a/man/woman.texi b/man/woman.texi index 0d827ef34c..8ba04675ac 100644 --- a/man/woman.texi +++ b/man/woman.texi @@ -22,7 +22,7 @@ Copyright @copyright{} 2001, 2002, 2003, 2004, @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +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, with the Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the |