Remove groffisms from the man page.  This changes "\(dq" to a double-quote

character ("), "\(cq" to a single-quote character ('), and eliminates the

use of "\&" except where it's needed at the beginning of the line.

@@ -35,11 +35,11 @@

 destination.  Rsync is widely used for backups and mirroring and as an

 improved copy command for everyday use.

 .PP 

-Rsync finds files that need to be transferred using a \(dq\&quick check\(dq\&

+Rsync finds files that need to be transferred using a "quick check"

 algorithm (by default) that looks for files that have changed in size or

 in last\-modified time.  Any changes in the other preserved attributes (as

 requested by options) are made on the destination file directly when the

-quick check indicates that the file\(cq\&s data does not need to be updated.

+quick check indicates that the file's data does not need to be updated.

 .PP 

 Some of the additional features of rsync are:

 .PP 

@@ -73,17 +73,17 @@

 a host specification.  Contacting an rsync daemon directly happens when the

 source or destination path contains a double colon (::) separator after a

 host specification, OR when an rsync:// URL is specified (see also the

-\(dq\&USING RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION\(dq\& section for

+"USING RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION" section for

 an exception to this latter rule).

 .PP 

 As a special case, if a single source arg is specified without a

-destination, the files are listed in an output format similar to \(dq\&ls \-l\(dq\&.

+destination, the files are listed in an output format similar to "ls \-l".

 .PP 

 As expected, if neither the source or destination path specify a remote

 host, the copy occurs locally (see also the \fB\-\-list\-only\fP option).

 .PP 

-Rsync refers to the local side as the \(dq\&client\(dq\& and the remote side as the

-\(dq\&server\(dq\&.  Don\(cq\&t confuse \(dq\&server\(dq\& with an rsync daemon \-\- a daemon is always a

+Rsync refers to the local side as the "client" and the remote side as the

+"server".  Don't confuse "server" with an rsync daemon \-\- a daemon is always a

 server, but a server can be either a daemon or a remote\-shell spawned process.

 .PP 

 .SH "SETUP"

 .PP 

 This would recursively transfer all files from the directory src/bar on the

 machine foo into the /data/tmp/bar directory on the local machine. The

-files are transferred in \(dq\&archive\(dq\& mode, which ensures that symbolic

+files are transferred in "archive" mode, which ensures that symbolic

 links, devices, attributes, permissions, ownerships, etc. are preserved

 in the transfer.  Additionally, compression will be used to reduce the

 size of data portions of the transfer.

 .PP 

 A trailing slash on the source changes this behavior to avoid creating an

 additional directory level at the destination.  You can think of a trailing

-/ on a source as meaning \(dq\&copy the contents of this directory\(dq\& as opposed

-to \(dq\&copy the directory by name\(dq\&, but in both cases the attributes of the

+/ on a source as meaning "copy the contents of this directory" as opposed

+to "copy the directory by name", but in both cases the attributes of the

 containing directory are transferred to the containing directory on the

 destination.  In other words, each of the following commands copies the

 files in the same way, including their setting of the attributes of

 .RE

 .PP 

-Note also that host and module references don\(cq\&t require a trailing slash to

+Note also that host and module references don't require a trailing slash to

 copy the contents of the default directory.  For example, both of these

-copy the remote directory\(cq\&s contents into \(dq\&/dest\(dq\&:

+copy the remote directory's contents into "/dest":

 .PP 

 .RS 

 \f(CWrsync \-av host: /dest\fP

 .PP 

 You can also use rsync in local\-only mode, where both the source and

-destination don\(cq\&t have a \(cq\&:\(cq\& in the name. In this case it behaves like

+destination don't have a ':' in the name. In this case it behaves like

 an improved copy command.

 .PP 

 Finally, you can list all the (listable) modules available from a

 examples:

 .PP 

 .RS 

-\f(CWrsync \-av host:'\&dir1/file1 dir2/file2'\& /dest\fP

+\f(CWrsync \-av host:'dir1/file1 dir2/file2' /dest\fP

 .br 

-\f(CWrsync host::'\&modname/dir1/file1 modname/dir2/file2'\& /dest\fP

+\f(CWrsync host::'modname/dir1/file1 modname/dir2/file2' /dest\fP

 .RE

 .PP 

 not as easy to use as the first method.

 .PP 

 If you need to transfer a filename that contains whitespace, you can either

-specify the \fB\-\-protect\-args\fP (\fB\-s\fP) option, or you\(cq\&ll need to escape

+specify the \fB\-\-protect\-args\fP (\fB\-s\fP) option, or you'll need to escape

 the whitespace in a way that the remote shell will understand.  For

 instance:

 .PP 

 .RS 

-\f(CWrsync \-av host:'\&file\e name\e with\e spaces'\& /dest\fP

+\f(CWrsync \-av host:'file\e name\e with\e spaces' /dest\fP

 .RE

 .PP 

 you either use a double colon :: instead of a single colon to

 separate the hostname from the path, or you use an rsync:// URL.

 .IP o 

-the first word of the \(dq\&path\(dq\& is actually a module name.

+the first word of the "path" is actually a module name.

 .IP o 

 the remote daemon may print a message of the day when you

 connect.

 you must not specify the \fB\-\-rsh\fP (\fB\-e\fP) option.

 .PP 

-An example that copies all the files in a remote module named \(dq\&src\(dq\&:

+An example that copies all the files in a remote module named "src":

 .PP 

 .nf 

     rsync \-av host::src /dest

 .PP 

 You may establish the connection via a web proxy by setting the

 environment variable RSYNC_PROXY to a hostname:port pair pointing to

-your web proxy.  Note that your web proxy\(cq\&s configuration must support

+your web proxy.  Note that your web proxy's configuration must support

 proxy connections to port 873.

 .PP 

 You may also establish a daemon connection using a program as a proxy by

 setting the environment variable RSYNC_CONNECT_PROG to the commands you

 wish to run in place of making a direct socket connection.  The string may

-contain the escape \(dq\&%H\(dq\& to represent the hostname specified in the rsync

-command (so use \(dq\&%%\(dq\& if you need a single \(dq\&%\(dq\& in your string).  For

+contain the escape "%H" to represent the hostname specified in the rsync

+command (so use "%%" if you need a single "%" in your string).  For

 example:

 .PP 

 .nf 

-  export RSYNC_CONNECT_PROG='\&ssh proxyhost nc %H 873'\&

+  export RSYNC_CONNECT_PROG='ssh proxyhost nc %H 873'

   rsync \-av targethost1::module/src/ /dest/

   rsync \-av rsync:://targethost2/module/src/ /dest/ 

 .fi 

 named modules) without actually allowing any new socket connections into a

 system (other than what is already required to allow remote\-shell access).

 Rsync supports connecting to a host using a remote shell and then spawning

-a single\-use \(dq\&daemon\(dq\& server that expects to read its config file in the

+a single\-use "daemon" server that expects to read its config file in the

 home dir of the remote user.  This can be useful if you want to encrypt a

-daemon\-style transfer\(cq\&s data, but since the daemon is started up fresh by

+daemon\-style transfer's data, but since the daemon is started up fresh by

 the remote user, you may not be able to use features such as chroot or

 change the uid used by the daemon.  (For another way to encrypt a daemon

 transfer, consider using ssh to tunnel a local port to a remote machine and

 configure a normal rsync daemon on that remote host to only allow

-connections from \(dq\&localhost\(dq\&.)

+connections from "localhost".)

 .PP 

-From the user\(cq\&s perspective, a daemon transfer via a remote\-shell

+From the user's perspective, a daemon transfer via a remote\-shell

 connection uses nearly the same command\-line syntax as a normal

 rsync\-daemon transfer, with the only exception being that you must

 explicitly set the remote shell program on the command\-line with the

 If you need to specify a different remote\-shell user, keep in mind that the

 user@ prefix in front of the host is specifying the rsync\-user value (for a

 module that requires user\-based authentication).  This means that you must

-give the \(cq\&\-l user\(cq\& option to ssh when specifying the remote\-shell, as in

+give the '\-l user' option to ssh when specifying the remote\-shell, as in

 this example that uses the short version of the \fB\-\-rsh\fP option:

 .PP 

 .nf 

-    rsync \-av \-e \(dq\&ssh \-l ssh\-user\(dq\& rsync\-user@host::module /dest

+    rsync \-av \-e "ssh \-l ssh\-user" rsync\-user@host::module /dest

 .fi 

 .PP 

-The \(dq\&ssh\-user\(dq\& will be used at the ssh level; the \(dq\&rsync\-user\(dq\& will be

-used to log\-in to the \(dq\&module\(dq\&.

+The "ssh\-user" will be used at the ssh level; the "rsync\-user" will be

+used to log\-in to the "module".

 .PP 

 .SH "STARTING AN RSYNC DAEMON TO ACCEPT CONNECTIONS"

+WARNING: Daemon mode does not participate in the core Solaris security

+policies, including Authentication, limit of privileges, Audit and Audit

+of any subprocessing.

 In order to connect to an rsync daemon, the remote system needs to have a

 daemon already running (or it needs to have configured something like inetd

 file for the daemon, and it contains the full details for how to run the

 daemon (including stand\-alone and inetd configurations).

 .PP 

-If you\(cq\&re using one of the remote\-shell transports for the transfer, there is

+If you're using one of the remote\-shell transports for the transfer, there is

 no need to manually start an rsync daemon.

 .PP 

 .SH "SORTED TRANSFER ORDER"

 .PP 

 If you need a particular file to be transferred prior to another, either

 separate the files into different rsync calls, or consider using

-\fB\-\-delay\-updates\fP (which doesn\(cq\&t affect the sorted transfer order, but

+\fB\-\-delay\-updates\fP (which doesn't affect the sorted transfer order, but

 does make the final file\-updating phase happen much more rapidly).

 .PP 

 .SH "EXAMPLES"

 .PP 

 Here are some examples of how I use rsync.

 .PP 

-To backup my wife\(cq\&s home directory, which consists of large MS Word

+To backup my wife's home directory, which consists of large MS Word

 files and mail folders, I use a cron job that runs

 .PP 

 .RS 

 .PP 

 each night over a PPP connection to a duplicate directory on my machine

-\(dq\&arvidsjaur\(dq\&.

+"arvidsjaur".

 .PP 

 To synchronize my samba source trees I use the following Makefile

 targets:

 .PP 

 .nf 

     get:

-            rsync \-avuzb \-\-exclude '\&*~'\& samba:samba/ .

+            rsync \-avuzb \-\-exclude '*~' samba:samba/ .

     put:

             rsync \-Cavuzb . samba:samba/

     sync: get put

 .PP 

 this allows me to sync with a CVS directory at the other end of the

 connection. I then do CVS operations on the remote machine, which saves a

-lot of time as the remote CVS protocol isn\(cq\&t very efficient.

+lot of time as the remote CVS protocol isn't very efficient.

 .PP 

-I mirror a directory between my \(dq\&old\(dq\& and \(dq\&new\(dq\& ftp sites with the

+I mirror a directory between my "old" and "new" ftp sites with the

 command:

 .PP 

-\f(CWrsync \-az \-e ssh \-\-delete ~ftp/pub/samba nimbus:\(dq\&~ftp/pub/tridge\(dq\&\fP

+\f(CWrsync \-az \-e ssh \-\-delete ~ftp/pub/samba nimbus:"~ftp/pub/tridge"\fP

 .PP 

 This is launched from cron every few hours.

 .PP 

      \-\-no\-OPTION             turn off an implied OPTION (e.g. \-\-no\-D)

  \-r, \-\-recursive             recurse into directories

  \-R, \-\-relative              use relative path names

-     \-\-no\-implied\-dirs       don'\&t send implied dirs with \-\-relative

+     \-\-no\-implied\-dirs       don't send implied dirs with \-\-relative

  \-b, \-\-backup                make backups (see \-\-suffix & \-\-backup\-dir)

      \-\-backup\-dir=DIR        make backups into hierarchy based in DIR

      \-\-suffix=SUFFIX         backup suffix (default ~ w/o \-\-backup\-dir)

  \-d, \-\-dirs                  transfer directories without recursing

  \-l, \-\-links                 copy symlinks as symlinks

  \-L, \-\-copy\-links            transform symlink into referent file/dir

-     \-\-copy\-unsafe\-links     only \(dq\&unsafe\(dq\& symlinks are transformed

+     \-\-copy\-unsafe\-links     only "unsafe" symlinks are transformed

      \-\-safe\-links            ignore symlinks that point outside the tree

      \-\-munge\-links           munge symlinks to make them safer

  \-k, \-\-copy\-dirlinks         transform symlink to dir into referent dir

      \-\-preallocate           allocate dest files before writing

  \-n, \-\-dry\-run               perform a trial run with no changes made

  \-W, \-\-whole\-file            copy files whole (w/o delta\-xfer algorithm)

- \-x, \-\-one\-file\-system       don'\&t cross filesystem boundaries

+ \-x, \-\-one\-file\-system       don't cross filesystem boundaries

  \-B, \-\-block\-size=SIZE       force a fixed checksum block\-size

  \-e, \-\-rsh=COMMAND           specify the remote shell to use

      \-\-rsync\-path=PROGRAM    specify the rsync to run on remote machine

      \-\-delete\-missing\-args   delete missing source args from destination

      \-\-ignore\-errors         delete even if there are I/O errors

      \-\-force                 force deletion of dirs even if not empty

-     \-\-max\-delete=NUM        don'\&t delete more than NUM files

-     \-\-max\-size=SIZE         don'\&t transfer any file larger than SIZE

-     \-\-min\-size=SIZE         don'\&t transfer any file smaller than SIZE

+     \-\-max\-delete=NUM        don't delete more than NUM files

+     \-\-max\-size=SIZE         don't transfer any file larger than SIZE

+     \-\-min\-size=SIZE         don't transfer any file smaller than SIZE

      \-\-partial               keep partially transferred files

      \-\-partial\-dir=DIR       put a partially transferred file into DIR

      \-\-delay\-updates         put all updated files into place at end

  \-m, \-\-prune\-empty\-dirs      prune empty directory chains from file\-list

-     \-\-numeric\-ids           don'\&t map uid/gid values by user/group name

+     \-\-numeric\-ids           don't map uid/gid values by user/group name

      \-\-usermap=STRING        custom username mapping

      \-\-groupmap=STRING       custom groupname mapping

      \-\-chown=USER:GROUP      simple username/groupname mapping

      \-\-timeout=SECONDS       set I/O timeout in seconds

      \-\-contimeout=SECONDS    set daemon connection timeout in seconds

- \-I, \-\-ignore\-times          don'\&t skip files that match size and time

+ \-I, \-\-ignore\-times          don't skip files that match size and time

      \-\-size\-only             skip files that match in size

      \-\-modify\-window=NUM     compare mod\-times with reduced accuracy

  \-T, \-\-temp\-dir=DIR          create temporary files in directory DIR

      \-\-skip\-compress=LIST    skip compressing files with suffix in LIST

  \-C, \-\-cvs\-exclude           auto\-ignore files in the same way CVS does

  \-f, \-\-filter=RULE           add a file\-filtering RULE

- \-F                          same as \-\-filter='\&dir\-merge /.rsync\-filter'\&

-                             repeated: \-\-filter='\&\- .rsync\-filter'\&

+ \-F                          same as \-\-filter='dir\-merge /.rsync\-filter'

+                             repeated: \-\-filter='\- .rsync\-filter'

      \-\-exclude=PATTERN       exclude files matching PATTERN

      \-\-exclude\-from=FILE     read exclude patterns from FILE

-     \-\-include=PATTERN       don'\&t exclude files matching PATTERN

+     \-\-include=PATTERN       don't exclude files matching PATTERN

      \-\-include\-from=FILE     read include patterns from FILE

      \-\-files\-from=FILE       read list of source\-file names from FILE

  \-0, \-\-from0                 all *from/filter files are delimited by 0s

  \-i, \-\-itemize\-changes       output a change\-summary for all updates

  \-M, \-\-remote\-option=OPTION  send OPTION to the remote side only

      \-\-out\-format=FORMAT     output updates using the specified FORMAT

-     \-\-log\-file=FILE         log what we'\&re doing to the specified FILE

+     \-\-log\-file=FILE         log what we're doing to the specified FILE

      \-\-log\-file\-format=FMT   log updates using the specified FMT

      \-\-password\-file=FILE    read daemon\-access password from FILE

      \-\-list\-only             list the files instead of copying them

  \-M, \-\-dparam=OVERRIDE       override global daemon config parameter

      \-\-no\-detach             do not detach from the parent

      \-\-port=PORT             listen on alternate port number

-     \-\-log\-file=FILE         override the \(dq\&log file\(dq\& setting

-     \-\-log\-file\-format=FMT   override the \(dq\&log format\(dq\& setting

+     \-\-log\-file=FILE         override the "log file" setting

+     \-\-log\-file\-format=FMT   override the "log format" setting

      \-\-sockopts=OPTIONS      specify custom TCP options

  \-v, \-\-verbose               increase verbosity

  \-4, \-\-ipv4                  prefer IPv4

 Some options only have a long variant, not a short.  If the option takes a

 parameter, the parameter is only listed after the long variant, even though it

 must also be specified for the short.  When specifying a parameter, you can

-either use the form \-\-option=param or replace the \(cq\&=\(cq\& with whitespace.  The

-parameter may need to be quoted in some manner for it to survive the shell\(cq\&s

+either use the form \-\-option=param or replace the '=' with whitespace.  The

+parameter may need to be quoted in some manner for it to survive the shell's

 command\-line parsing.  Keep in mind that a leading tilde (~) in a filename is

 substituted by your shell, so \-\-option=~/foo will not change the tilde into

-your home directory (remove the \(cq\&=\(cq\& for that).

+your home directory (remove the '=' for that).

 .PP 

 .IP "\fB\-\-help\fP"

 Print a short help page describing the options

 .fi 

 .IP 

-Note that \fB\-\-info=name\fP\(cq\&s output is affected by the \fB\-\-out\-format\fP and

+Note that \fB\-\-info=name\fP's output is affected by the \fB\-\-out\-format\fP and

 \fB\-\-itemize\-changes\fP (\fB\-i\fP) options.  See those options for more

 information on what is output and when.

 .IP 

 This option affects the information that is output

 by the client at the start of a daemon transfer.  This suppresses the

 message\-of\-the\-day (MOTD) text, but it also affects the list of modules

-that the daemon sends in response to the \(dq\&rsync host::\(dq\& request (due to

+that the daemon sends in response to the "rsync host::" request (due to

 a limitation in the rsync protocol), so omit this option if you want to

 request the list of modules from the daemon.

 .IP 

 .IP "\fB\-I, \-\-ignore\-times\fP"

 Normally rsync will skip any files that are

 already the same size and have the same modification timestamp.

-This option turns off this \(dq\&quick check\(dq\& behavior, causing all files to

+This option turns off this "quick check" behavior, causing all files to

 be updated.

 .IP 

 .IP "\fB\-\-size\-only\fP"

-This modifies rsync\(cq\&s \(dq\&quick check\(dq\& algorithm for

+This modifies rsync's "quick check" algorithm for

 finding files that need to be transferred, changing it from the default of

 transferring files with either a changed size or a changed last\-modified

 time to just looking for files that have changed in size.  This is useful

 .IP "\fB\-c, \-\-checksum\fP"

 This changes the way rsync checks if the files have

 been changed and are in need of a transfer.  Without this option, rsync

-uses a \(dq\&quick check\(dq\& that (by default) checks if each file\(cq\&s size and time

+uses a "quick check" that (by default) checks if each file's size and time

 of last modification match between the sender and receiver.  This option

 changes this to compare a 128\-bit checksum for each file that has a

 matching size.  Generating the checksums means that both sides will expend

 The sending side generates its checksums while it is doing the file\-system

 scan that builds the list of the available files.  The receiver generates

 its checksums when it is scanning for changed files, and will checksum any

-file that has the same size as the corresponding sender\(cq\&s file:  files with

+file that has the same size as the corresponding sender's file:  files with

 either a changed size or a changed checksum are selected for transfer.

 .IP 

 Note that rsync always verifies that each \fItransferred\fP file was

 correctly reconstructed on the receiving side by checking a whole\-file

 checksum that is generated as the file is transferred, but that

 automatic after\-the\-transfer verification has nothing to do with this

-option\(cq\&s before\-the\-transfer \(dq\&Does this file need to be updated?\(dq\& check.

+option's before\-the\-transfer "Does this file need to be updated?" check.

 .IP 

 For protocol 30 and beyond (first supported in 3.0.0), the checksum used is

 MD5.  For older protocols, the checksum used is MD4.

 .IP 

 .IP "\-\-no\-OPTION"

 You may turn off one or more implied options by prefixing

-the option name with \(dq\&no\-\(dq\&.  Not all options may be prefixed with a \(dq\&no\-\(dq\&:

+the option name with "no\-".  Not all options may be prefixed with a "no\-":

 only options that are implied by other options (e.g. \fB\-\-no\-D\fP,

 \fB\-\-no\-perms\fP) or have different defaults in various circumstances

 (e.g. \fB\-\-no\-whole\-file\fP, \fB\-\-no\-blocking\-io\fP, \fB\-\-no\-dirs\fP).  You may

-specify either the short or the long option name after the \(dq\&no\-\(dq\& prefix

+specify either the short or the long option name after the "no\-" prefix

 (e.g. \fB\-\-no\-R\fP is the same as \fB\-\-no\-relative\fP).

 .IP 

-For example: if you want to use \fB\-a\fP (\fB\-\-archive\fP) but don\(cq\&t want

+For example: if you want to use \fB\-a\fP (\fB\-\-archive\fP) but don't want

 \fB\-o\fP (\fB\-\-owner\fP), instead of converting \fB\-a\fP into \fB\-rlptgD\fP, you

 could specify \fB\-a \-\-no\-o\fP (or \fB\-a \-\-no\-owner\fP).

 .IP 

 .IP 

 then a file named /tmp/foo/bar/baz.c would be created on the remote

 machine, preserving its full path.  These extra path elements are called

-\(dq\&implied directories\(dq\& (i.e. the \(dq\&foo\(dq\& and the \(dq\&foo/bar\(dq\& directories in the

+"implied directories" (i.e. the "foo" and the "foo/bar" directories in the

 above example).

 .IP 

 Beginning with rsync 3.0.0, rsync always sends these implied directories as

 real directories in the file list, even if a path element is really a

 symlink on the sending side.  This prevents some really unexpected

-behaviors when copying the full path of a file that you didn\(cq\&t realize had

+behaviors when copying the full path of a file that you didn't realize had

 a symlink in its path.  If you want to duplicate a server\-side symlink,