[Emacs-diffs] /srv/bzr/emacs/trunk r106987: Document SELinux support.

[Glenn Morris]

------------------------------------------------------------
revno: 106987
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2012-01-28 18:49:57 -0800
message:
  Document SELinux support.
  
  * doc/lispref/files.texi (Changing Files): Document SELinux support.
  * etc/NEWS: Markup.
modified:
  doc/lispref/ChangeLog
  doc/lispref/files.texi
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-01-29 01:50:40 +0000
+++ b/doc/lispref/ChangeLog     2012-01-29 02:49:57 +0000
@@ -1,5 +1,7 @@
 2012-01-29  Glenn Morris  <address@hidden>
 
+       * files.texi (Changing Files): Document SELinux support.
+
        * windows.texi (Window Sizes): Fix typo.
 
 2012-01-28  Chong Yidong  <address@hidden>

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2012-01-19 07:21:25 +0000
+++ b/doc/lispref/files.texi    2012-01-29 02:49:57 +0000
@@ -1480,7 +1480,7 @@
 same effect as renaming, aside from momentary intermediate states.
 @end deffn
 
address@hidden Command copy-file oldname newname &optional ok-if-exists time 
preserve-uid-gid
address@hidden Command copy-file oldname newname &optional ok-if-exists time 
preserve-uid-gid preserve-selinux
 This command copies the file @var{oldname} to @var{newname}.  An
 error is signaled if @var{oldname} does not exist.  If @var{newname}
 names a directory, it copies @var{oldname} into that directory,
@@ -1501,6 +1501,19 @@
 address@hidden, we attempt to copy the user and group ownership of the
 file.  This works only on some operating systems, and only if you have
 the correct permissions to do so.
+
address@hidden SELinux
+If the optional argument @var{preserve-selinux} is address@hidden, we
+attempt to copy the address@hidden@samp{Security-Enhanced Linux}
+is a kernel feature that allows for finer access controls to be set on
+files, and a system security policy to define who can access what.
+The functions @code{file-selinux-context} and @code{set-file-selinux-context}
+get and set, respectively, the SELinux properties of a file.}
+context of the file.  For this to work, Emacs must have been built
+with libselinux support.
+
+Functions like @code{backup-buffer} use these optional arguments
+to preserve information about their input files.
 @end deffn
 
 @deffn Command make-symbolic-link filename newname  &optional ok-if-exists

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-01-28 05:02:02 +0000
+++ b/etc/NEWS  2012-01-29 02:49:57 +0000
@@ -24,8 +24,10 @@
 
 * Installation Changes in Emacs 24.1
 
+---
 ** Configure links against libselinux if it is found.
-You can disable this by using --without-selinux.
+You can disable this by using --without-selinux.  See below for
+information on SELinux support.
 
 ---
 ** By default, the installed Info and man pages are compressed.
@@ -263,14 +265,17 @@
 Also, the first dash (which does not indicate anything) is just
 displayed as a space.
 
++++
 ** Basic SELinux support has been added.
 This requires Emacs to be linked with libselinux at build time.
 
++++
 *** Emacs preserves the SELinux file context when backing up, and
 optionally when copying files. To this end, copy-file has an extra
 optional argument, and backup-buffer and friends include the SELinux
 context in their return values.
 
++++
 *** The new functions file-selinux-context and set-file-selinux-context
 get and set the SELinux context of a file.
 ---