aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoakim Verona2013-02-10 00:03:41 +0100
committerJoakim Verona2013-02-10 00:03:41 +0100
commit33cc2cd4d53f845b7d1e681dbbe8166acdb652c3 (patch)
tree551834731473d23116e08cb89facebbc8bad03db /doc
parent4df065db6acba3975884b435422773ab97f32a00 (diff)
parenteff1c1900f47ec5dfb6d435325b366362d09d2db (diff)
downloademacs-33cc2cd4d53f845b7d1e681dbbe8166acdb652c3.tar.gz
emacs-33cc2cd4d53f845b7d1e681dbbe8166acdb652c3.zip
auto upstream
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/ChangeLog5
-rw-r--r--doc/emacs/msdog.texi23
-rw-r--r--doc/lispref/ChangeLog6
-rw-r--r--doc/lispref/elisp.texi2
-rw-r--r--doc/lispref/modes.texi5
-rw-r--r--doc/lispref/nonascii.texi58
-rw-r--r--doc/misc/texinfo.tex50
7 files changed, 38 insertions, 111 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 3b7ab6527aa..d2f44eabb0e 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,8 @@
12013-02-09 Eli Zaretskii <eliz@gnu.org>
2
3 * msdog.texi (Text and Binary): Delete the description of
4 file-name-buffer-file-type-alist.
5
12013-01-19 Paul Eggert <eggert@cs.ucla.edu> 62013-01-19 Paul Eggert <eggert@cs.ucla.edu>
2 7
3 * trouble.texi (Crashing): Suggest -p for newer addr2line. (Bug#13445) 8 * trouble.texi (Crashing): Suggest -p for newer addr2line. (Bug#13445)
diff --git a/doc/emacs/msdog.texi b/doc/emacs/msdog.texi
index 2c22c89a113..0f01958b51c 100644
--- a/doc/emacs/msdog.texi
+++ b/doc/emacs/msdog.texi
@@ -218,29 +218,6 @@ set conversion, only end-of-line conversion. Essentially, it directs
218Emacs to create new files with the Unix-style convention of using 218Emacs to create new files with the Unix-style convention of using
219newline at the end of a line. @xref{Coding Systems}. 219newline at the end of a line. @xref{Coding Systems}.
220 220
221@vindex file-name-buffer-file-type-alist
222@cindex binary files, on MS-DOS/MS-Windows
223 Some kinds of files should not be converted at all, because their
224contents are not really text. Therefore, Emacs on MS-Windows distinguishes
225certain files as @dfn{binary files}. (This distinction is not part of
226MS-Windows; it is made by Emacs only.) Binary files include executable
227programs, compressed archives, etc. Emacs uses the file name to decide
228whether to treat a file as binary: the variable
229@code{file-name-buffer-file-type-alist} defines the file-name patterns
230that indicate binary files. If a file name matches one of the patterns
231for binary files (those whose associations are of the type
232@code{(@var{pattern} . t)}, Emacs reads and writes that file using the
233@code{no-conversion} coding system (@pxref{Coding Systems}) which turns
234off @emph{all} coding-system conversions, not only the EOL conversion.
235@code{file-name-buffer-file-type-alist} also includes file-name patterns
236for files which are known to be Windows-style text files with
237carriage-return linefeed EOL format, such as @file{CONFIG.SYS}; Emacs
238always writes those files with Windows-style EOLs.
239
240 If a file that belongs to an untranslated file system matches one of
241the file-name patterns in @code{file-name-buffer-file-type-alist}, the
242EOL conversion is determined by @code{file-name-buffer-file-type-alist}.
243
244@node Windows Files 221@node Windows Files
245@section File Names on MS-Windows 222@section File Names on MS-Windows
246@cindex file names on MS-Windows 223@cindex file names on MS-Windows
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 7c444a038af..90b2349387f 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,9 @@
12013-02-09 Eli Zaretskii <eliz@gnu.org>
2
3 * modes.texi (%-Constructs): Remove the description of %t.
4
5 * nonascii.texi (MS-DOS File Types): Delete node.
6
12013-02-08 Glenn Morris <rgm@gnu.org> 72013-02-08 Glenn Morris <rgm@gnu.org>
2 8
3 * keymaps.texi (Active Keymaps, Searching Keymaps): 9 * keymaps.texi (Active Keymaps, Searching Keymaps):
diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi
index 127b22086d0..3d1c4cf577d 100644
--- a/doc/lispref/elisp.texi
+++ b/doc/lispref/elisp.texi
@@ -1209,8 +1209,6 @@ Coding Systems
1209 for a single file operation. 1209 for a single file operation.
1210* Explicit Encoding:: Encoding or decoding text without doing I/O. 1210* Explicit Encoding:: Encoding or decoding text without doing I/O.
1211* Terminal I/O Encoding:: Use of encoding for terminal I/O. 1211* Terminal I/O Encoding:: Use of encoding for terminal I/O.
1212* MS-DOS File Types:: How DOS "text" and "binary" files
1213 relate to coding systems.
1214 1212
1215Searching and Matching 1213Searching and Matching
1216 1214
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 29aba877ba2..71ce2bb9271 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -2150,11 +2150,6 @@ visible on screen; or @samp{Bottom} or @samp{All}.
2150The status of the subprocess belonging to the current buffer, obtained with 2150The status of the subprocess belonging to the current buffer, obtained with
2151@code{process-status}. @xref{Process Information}. 2151@code{process-status}. @xref{Process Information}.
2152 2152
2153@item %t
2154Whether the visited file is a text file or a binary file. This is a
2155meaningful distinction only on certain operating systems (@pxref{MS-DOS
2156File Types}).
2157
2158@item %z 2153@item %z
2159The mnemonics of keyboard, terminal, and buffer coding systems. 2154The mnemonics of keyboard, terminal, and buffer coding systems.
2160 2155
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index 9ad68be60cb..e462c3b4ce4 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -855,8 +855,6 @@ documented here.
855 for a single file operation. 855 for a single file operation.
856* Explicit Encoding:: Encoding or decoding text without doing I/O. 856* Explicit Encoding:: Encoding or decoding text without doing I/O.
857* Terminal I/O Encoding:: Use of encoding for terminal I/O. 857* Terminal I/O Encoding:: Use of encoding for terminal I/O.
858* MS-DOS File Types:: How DOS "text" and "binary" files
859 relate to coding systems.
860@end menu 858@end menu
861 859
862@node Coding System Basics 860@node Coding System Basics
@@ -1775,62 +1773,6 @@ for encoding terminal output from @var{terminal}. If
1775@code{nil}, that means the currently selected frame's terminal. 1773@code{nil}, that means the currently selected frame's terminal.
1776@end deffn 1774@end deffn
1777 1775
1778@node MS-DOS File Types
1779@subsection MS-DOS File Types
1780@cindex DOS file types
1781@cindex MS-DOS file types
1782@cindex Windows file types
1783@cindex file types on MS-DOS and Windows
1784@cindex text files and binary files
1785@cindex binary files and text files
1786
1787 On MS-DOS and Microsoft Windows, Emacs guesses the appropriate
1788end-of-line conversion for a file by looking at the file's name. This
1789feature classifies files as @dfn{text files} and @dfn{binary files}. By
1790``binary file'' we mean a file of literal byte values that are not
1791necessarily meant to be characters; Emacs does no end-of-line conversion
1792and no character code conversion for them. On the other hand, the bytes
1793in a text file are intended to represent characters; when you create a
1794new file whose name implies that it is a text file, Emacs uses DOS
1795end-of-line conversion.
1796
1797@defvar buffer-file-type
1798This variable, automatically buffer-local in each buffer, records the
1799file type of the buffer's visited file. When a buffer does not specify
1800a coding system with @code{buffer-file-coding-system}, this variable is
1801used to determine which coding system to use when writing the contents
1802of the buffer. It should be @code{nil} for text, @code{t} for binary.
1803If it is @code{t}, the coding system is @code{no-conversion}.
1804Otherwise, @code{undecided-dos} is used.
1805
1806Normally this variable is set by visiting a file; it is set to
1807@code{nil} if the file was visited without any actual conversion.
1808
1809Its default value is used to decide how to handle files for which
1810@code{file-name-buffer-file-type-alist} says nothing about the type:
1811If the default value is non-@code{nil}, then these files are treated as
1812binary: the coding system @code{no-conversion} is used. Otherwise,
1813nothing special is done for them---the coding system is deduced solely
1814from the file contents, in the usual Emacs fashion.
1815@end defvar
1816
1817@defopt file-name-buffer-file-type-alist
1818This variable holds an alist for recognizing text and binary files.
1819Each element has the form (@var{regexp} . @var{type}), where
1820@var{regexp} is matched against the file name, and @var{type} may be
1821@code{nil} for text, @code{t} for binary, or a function to call to
1822compute which. If it is a function, then it is called with a single
1823argument (the file name) and should return @code{t} or @code{nil}.
1824
1825When running on MS-DOS or MS-Windows, Emacs checks this alist to decide
1826which coding system to use when reading a file. For a text file,
1827@code{undecided-dos} is used. For a binary file, @code{no-conversion}
1828is used.
1829
1830If no element in this alist matches a given file name, then
1831the default value of @code{buffer-file-type} says how to treat the file.
1832@end defopt
1833
1834@node Input Methods 1776@node Input Methods
1835@section Input Methods 1777@section Input Methods
1836@cindex input methods 1778@cindex input methods
diff --git a/doc/misc/texinfo.tex b/doc/misc/texinfo.tex
index d64f45bbee9..85f184cc4cb 100644
--- a/doc/misc/texinfo.tex
+++ b/doc/misc/texinfo.tex
@@ -3,7 +3,7 @@
3% Load plain if necessary, i.e., if running under initex. 3% Load plain if necessary, i.e., if running under initex.
4\expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi 4\expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
5% 5%
6\def\texinfoversion{2013-01-01.15} 6\def\texinfoversion{2013-02-01.11}
7% 7%
8% Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, 8% Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
9% 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 9% 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -2496,7 +2496,7 @@ end
2496 \let-\codedash 2496 \let-\codedash
2497 \let_\codeunder 2497 \let_\codeunder
2498 \else 2498 \else
2499 \let-\realdash 2499 \let-\normaldash
2500 \let_\realunder 2500 \let_\realunder
2501 \fi 2501 \fi
2502 \codex 2502 \codex
@@ -2505,7 +2505,7 @@ end
2505 2505
2506\def\codex #1{\tclose{#1}\endgroup} 2506\def\codex #1{\tclose{#1}\endgroup}
2507 2507
2508\def\realdash{-} 2508\def\normaldash{-}
2509\def\codedash{-\discretionary{}{}{}} 2509\def\codedash{-\discretionary{}{}{}}
2510\def\codeunder{% 2510\def\codeunder{%
2511 % this is all so @math{@code{var_name}+1} can work. In math mode, _ 2511 % this is all so @math{@code{var_name}+1} can work. In math mode, _
@@ -2520,9 +2520,9 @@ end
2520} 2520}
2521 2521
2522% An additional complication: the above will allow breaks after, e.g., 2522% An additional complication: the above will allow breaks after, e.g.,
2523% each of the four underscores in __typeof__. This is undesirable in 2523% each of the four underscores in __typeof__. This is bad.
2524% some manuals, especially if they don't have long identifiers in 2524% @allowcodebreaks provides a document-level way to turn breaking at -
2525% general. @allowcodebreaks provides a way to control this. 2525% and _ on and off.
2526% 2526%
2527\newif\ifallowcodebreaks \allowcodebreakstrue 2527\newif\ifallowcodebreaks \allowcodebreakstrue
2528 2528
@@ -4188,7 +4188,7 @@ end
4188 % ..., but we might end up with active ones in the argument if 4188 % ..., but we might end up with active ones in the argument if
4189 % we're called from @code, as @code{@value{foo-bar_}}, though. 4189 % we're called from @code, as @code{@value{foo-bar_}}, though.
4190 % So \let them to their normal equivalents. 4190 % So \let them to their normal equivalents.
4191 \let-\realdash \let_\normalunderscore 4191 \let-\normaldash \let_\normalunderscore
4192 } 4192 }
4193} 4193}
4194 4194
@@ -9993,22 +9993,26 @@ directory should work if nowhere else does.}
9993@gdef@otherbackslash{@let\=@realbackslash} 9993@gdef@otherbackslash{@let\=@realbackslash}
9994 9994
9995% Same as @turnoffactive except outputs \ as {\tt\char`\\} instead of 9995% Same as @turnoffactive except outputs \ as {\tt\char`\\} instead of
9996% the literal character `\'. 9996% the literal character `\'. Also revert - to its normal character, in
9997% 9997% case the active - from code has slipped in.
9998@def@normalturnoffactive{% 9998%
9999 @let"=@normaldoublequote 9999{@catcode`- = @active
10000 @let$=@normaldollar %$ font-lock fix 10000 @gdef@normalturnoffactive{%
10001 @let+=@normalplus 10001 @let-=@normaldash
10002 @let<=@normalless 10002 @let"=@normaldoublequote
10003 @let>=@normalgreater 10003 @let$=@normaldollar %$ font-lock fix
10004 @let\=@normalbackslash 10004 @let+=@normalplus
10005 @let^=@normalcaret 10005 @let<=@normalless
10006 @let_=@normalunderscore 10006 @let>=@normalgreater
10007 @let|=@normalverticalbar 10007 @let\=@normalbackslash
10008 @let~=@normaltilde 10008 @let^=@normalcaret
10009 @markupsetuplqdefault 10009 @let_=@normalunderscore
10010 @markupsetuprqdefault 10010 @let|=@normalverticalbar
10011 @unsepspaces 10011 @let~=@normaltilde
10012 @markupsetuplqdefault
10013 @markupsetuprqdefault
10014 @unsepspaces
10015 }
10012} 10016}
10013 10017
10014% Make _ and + \other characters, temporarily. 10018% Make _ and + \other characters, temporarily.