procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve the "Files" chapter of the Emacs manual

Browse source 
* doc/emacs/files.texi (File Shadowing): Rearrange text to explain
the notion of shadowing before describing the commands.  Suggested
by Will Korteland <emacs-devel@korte.land> in
emacs-manual-bugs@gnu.org.
This commit is contained in:
Eli Zaretskii 2018-01-27 13:17:24 +02:00
parent 9afc86d1fa
commit 372fda682a
1 changed files with 24 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

46
doc/emacs/files.texi
View file

@ -824,6 +824,25 @@ diff-buffer-with-file} command. @xref{Comparing Files}.
@cindex file shadows @cindex file shadows
@findex shadow-initialize @findex shadow-initialize
You can arrange to keep identical @dfn{shadow} copies of certain
files in more than one place---possibly on different machines. To do
this, first you must set up a @dfn{shadow file group}, which is a set
of identically-named files shared between a list of sites. The file
group is permanent and applies to further Emacs sessions as well as
the current one. Once the group is set up, every time you exit Emacs,
it will copy the file you edited to the other files in its group. You
can also do the copying without exiting Emacs, by typing @w{@kbd{M-x
shadow-copy-files}}.
@cindex shadow cluster
A @dfn{shadow cluster} is a group of hosts that share directories, so
that copying to or from one of them is sufficient to update the file
on all of them. Each shadow cluster has a name, and specifies the
network address of a primary host (the one we copy files to), and a
regular expression that matches the host names of all the other hosts
in the cluster. You can define a shadow cluster with @w{@kbd{M-x
shadow-define-cluster}}.
@table @kbd @table @kbd
@item M-x shadow-initialize @item M-x shadow-initialize
Set up file shadowing. Set up file shadowing.
@ -839,32 +858,15 @@ Copy all pending shadow files.
Cancel the instruction to shadow some files. Cancel the instruction to shadow some files.
@end table @end table
You can arrange to keep identical @dfn{shadow} copies of certain files To set up a shadow file group, use @w{@kbd{M-x
in more than one place---possibly on different machines. To do this, shadow-define-literal-group}} or @w{@kbd{M-x
first you must set up a @dfn{shadow file group}, which is a set of shadow-define-regexp-group}}. See their documentation strings for
identically-named files shared between a list of sites. The file further information.
group is permanent and applies to further Emacs sessions as well as
the current one. Once the group is set up, every time you exit Emacs,
it will copy the file you edited to the other files in its group. You
can also do the copying without exiting Emacs, by typing @kbd{M-x
shadow-copy-files}.
To set up a shadow file group, use @kbd{M-x
shadow-define-literal-group} or @kbd{M-x shadow-define-regexp-group}.
See their documentation strings for further information.
Before copying a file to its shadows, Emacs asks for confirmation. Before copying a file to its shadows, Emacs asks for confirmation.
You can answer ``no'' to bypass copying of this file, this time. If You can answer ``no'' to bypass copying of this file, this time. If
you want to cancel the shadowing permanently for a certain file, use you want to cancel the shadowing permanently for a certain file, use
@kbd{M-x shadow-cancel} to eliminate or change the shadow file group. @w{@kbd{M-x shadow-cancel}} to eliminate or change the shadow file group.
A @dfn{shadow cluster} is a group of hosts that share directories, so
that copying to or from one of them is sufficient to update the file
on all of them. Each shadow cluster has a name, and specifies the
network address of a primary host (the one we copy files to), and a
regular expression that matches the host names of all the other hosts
in the cluster. You can define a shadow cluster with @kbd{M-x
shadow-define-cluster}.
@node Time Stamps @node Time Stamps
@subsection Updating Time Stamps Automatically @subsection Updating Time Stamps Automatically