aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref
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/lispref
parent4df065db6acba3975884b435422773ab97f32a00 (diff)
parenteff1c1900f47ec5dfb6d435325b366362d09d2db (diff)
downloademacs-33cc2cd4d53f845b7d1e681dbbe8166acdb652c3.tar.gz
emacs-33cc2cd4d53f845b7d1e681dbbe8166acdb652c3.zip
auto upstream
Diffstat (limited to 'doc/lispref')
-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
4 files changed, 6 insertions, 65 deletions
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