iRewrite manpage to remove duplicates and be more clear. - drist - a remote deployment tool Err bitreich.org 70 hgit clone git://bitreich.org/drist/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/drist/ URL:git://bitreich.org/drist/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/drist/ bitreich.org 70 1Log /scm/drist/log.gph bitreich.org 70 1Files /scm/drist/files.gph bitreich.org 70 1Refs /scm/drist/refs.gph bitreich.org 70 1Tags /scm/drist/tag bitreich.org 70 1README /scm/drist/file/README.gph bitreich.org 70 1LICENSE /scm/drist/file/LICENSE.gph bitreich.org 70 i--- Err bitreich.org 70 1commit 378f9360b6ef2c17edfea83a0ba5dd38ffa2c98a /scm/drist/commit/378f9360b6ef2c17edfea83a0ba5dd38ffa2c98a.gph bitreich.org 70 1parent b62625b79ee16f841d0a3693aea3d8521cc6a2ba /scm/drist/commit/b62625b79ee16f841d0a3693aea3d8521cc6a2ba.gph bitreich.org 70 hAuthor: Christoph Lohmann <20h@r-36.net> URL:mailto:20h@r-36.net bitreich.org 70 iDate: Fri, 20 Jul 2018 14:10:47 +0200 Err bitreich.org 70 i Err bitreich.org 70 iRewrite manpage to remove duplicates and be more clear. Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M drist.1 | 87 ++++++++++++------------------- Err bitreich.org 70 i Err bitreich.org 70 i1 file changed, 33 insertions(+), 54 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/drist.1 b/drist.1 /scm/drist/file/drist.1.gph bitreich.org 70 i@@ -19,89 +19,68 @@ has been designed to be simple, so it may not offer all the features Err bitreich.org 70 i you want. Err bitreich.org 70 i Err bitreich.org 70 i When you run Err bitreich.org 70 i-.Nm Ns Err bitreich.org 70 i+.Nm Err bitreich.org 70 i , it will look at a set of special directories in the current working Err bitreich.org 70 i directory. Err bitreich.org 70 i- Err bitreich.org 70 i-Here is the whole sequence, with Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+will connect to Err bitreich.org 70 i+.Ar server Err bitreich.org 70 i+via ssh(1) and request the remote Err bitreich.org 70 i .Em HOSTNAME Err bitreich.org 70 i-being the result of Err bitreich.org 70 i-.Ql uname -n Err bitreich.org 70 i-on the remote system: Err bitreich.org 70 i+by calling Err bitreich.org 70 i+.Ql uname -n. Err bitreich.org 70 i+ Err bitreich.org 70 i+After that following steps will be executed: Err bitreich.org 70 i Err bitreich.org 70 i .Bl -enum -offset indent -compact Err bitreich.org 70 i .It Err bitreich.org 70 i-if folder Err bitreich.org 70 i+If folder Err bitreich.org 70 i .Ar files Err bitreich.org 70 i exists, its content is copied to Err bitreich.org 70 i .Ar server Err bitreich.org 70 i+using rsync(1). Err bitreich.org 70 i .It Err bitreich.org 70 i-if folder Err bitreich.org 70 i+If folder Err bitreich.org 70 i .Ar files- Ns Em HOSTNAME Err bitreich.org 70 i exists, its content copied to Err bitreich.org 70 i .Ar server Err bitreich.org 70 i+using rsync(1). Err bitreich.org 70 i .It Err bitreich.org 70 i-if folder Err bitreich.org 70 i+If folder Err bitreich.org 70 i .Ar absent Err bitreich.org 70 i-exists, filenames in it are removed from Err bitreich.org 70 i-.Ar server Err bitreich.org 70 i+exists, filenames in it are deleted on Err bitreich.org 70 i+.Ar server. Err bitreich.org 70 i .It Err bitreich.org 70 i-if folder Err bitreich.org 70 i+If folder Err bitreich.org 70 i .Ar absent- Ns Em HOSTNAME Err bitreich.org 70 i-exists, filenames in it are removed from Err bitreich.org 70 i-.Ar server Err bitreich.org 70 i+exists, filenames in it are deleted on Err bitreich.org 70 i+.Ar server. Err bitreich.org 70 i .It Err bitreich.org 70 i-if file Err bitreich.org 70 i+If file Err bitreich.org 70 i .Ar script Err bitreich.org 70 i-exists, it is executed remotely on Err bitreich.org 70 i-.Ar server Err bitreich.org 70 i+exists, it is copied to Err bitreich.org 70 i+.Ar server and executed there. Err bitreich.org 70 i .It Err bitreich.org 70 i-if file Err bitreich.org 70 i+If file Err bitreich.org 70 i .Ar script- Ns Em HOSTNAME Err bitreich.org 70 i-exists, it is executed remotely on Err bitreich.org 70 i-.Ar server Err bitreich.org 70 i+exists, it is copied to Err bitreich.org 70 i+.Ar server and executed there. Err bitreich.org 70 i .El Err bitreich.org 70 i Err bitreich.org 70 i The presence of each of those files or directories is optional. Err bitreich.org 70 i Err bitreich.org 70 i-If the directory Err bitreich.org 70 i+All files in either Err bitreich.org 70 i .Ar files Err bitreich.org 70 i-is present, its content will be copied to the remote Err bitreich.org 70 i-.Ar server Err bitreich.org 70 i-relatively to the root / directory. You can create Err bitreich.org 70 i+or Err bitreich.org 70 i+.Ar absent Err bitreich.org 70 i+or Err bitreich.org 70 i .Ar files- Ns Em HOSTNAME Err bitreich.org 70 i-with Err bitreich.org 70 i+etc. are relative to the root (/) directory. The specific files Err bitreich.org 70 i+for Err bitreich.org 70 i .Em HOSTNAME Err bitreich.org 70 i-being the result of the command Err bitreich.org 70 i-.Ql uname -n Err bitreich.org 70 i-on the remote server. The content of this folder will be copied to the Err bitreich.org 70 i-remote server after the Err bitreich.org 70 i-.Ar files Err bitreich.org 70 i-directory has been processed. This folder is useful for adding Err bitreich.org 70 i-.Em HOSTNAME Ns -specific Err bitreich.org 70 i-files. Err bitreich.org 70 i- Err bitreich.org 70 i-After the files are copied, Err bitreich.org 70 i-.Nm Err bitreich.org 70 i-will look at two the folders Err bitreich.org 70 i-.Ar absent Err bitreich.org 70 i-and Err bitreich.org 70 i-.Ar absent Ns Em HOSTNAME Err bitreich.org 70 i-in the current working directory. Err bitreich.org 70 i-.Nm Err bitreich.org 70 i-will remotely delete all files listed in this directory tree. Err bitreich.org 70 i- Err bitreich.org 70 i-Finally, the file Err bitreich.org 70 i-.Ar script Err bitreich.org 70 i-be copied to the remote server, executed and deleted (shall the script Err bitreich.org 70 i-succeed or not). If Err bitreich.org 70 i-.Ar script- Ns Em HOSTNAME Err bitreich.org 70 i-exists, it will be processed in the same way. This is useful if you Err bitreich.org 70 i-need to run Err bitreich.org 70 i-.Em HOSTNAME Ns -specific Err bitreich.org 70 i-commands. Err bitreich.org 70 i+are worked on after the common files. Err bitreich.org 70 i Err bitreich.org 70 i-I recommend writing small "modules" which would install the required Err bitreich.org 70 i+I recommend to write small "modules" which would install the required Err bitreich.org 70 i packages for a task and provide the files needed, rather than writing a Err bitreich.org 70 i full-blown module for deploying an entire system at once. Err bitreich.org 70 i Err bitreich.org 70 .