i[PATCH] drist.1: fix mandoc warnings and a typo "thoses", use Pp for paragraphs - 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 31472da6fc412eb26c5ba6f80487be2b332909da /scm/drist/commit/31472da6fc412eb26c5ba6f80487be2b332909da.gph bitreich.org 70 1parent 378f9360b6ef2c17edfea83a0ba5dd38ffa2c98a /scm/drist/commit/378f9360b6ef2c17edfea83a0ba5dd38ffa2c98a.gph bitreich.org 70 hAuthor: Hiltjo Posthuma URL:mailto:hiltjo@codemadness.org bitreich.org 70 iDate: Fri, 20 Jul 2018 23:18:36 +0200 Err bitreich.org 70 i Err bitreich.org 70 i[PATCH] drist.1: fix mandoc warnings and a typo "thoses", use Pp for paragraphs Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M drist.1 | 48 +++++++++++++++---------------- Err bitreich.org 70 i Err bitreich.org 70 i1 file changed, 23 insertions(+), 25 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@@ -5,19 +5,18 @@ Err bitreich.org 70 i .Nm drist Err bitreich.org 70 i .Nd dumb remote installer shell tool, a remote deployment tool Err bitreich.org 70 i .Sh SYNOPSIS Err bitreich.org 70 i-.Nm Err bitreich.org 70 i+.Nm Err bitreich.org 70 i .Ar server Err bitreich.org 70 i .Sh DESCRIPTION Err bitreich.org 70 i- Err bitreich.org 70 i .Nm Err bitreich.org 70 i is a tool to configure remote servers using Err bitreich.org 70 i-.Xr ssh 1 Err bitreich.org 70 i+.Xr ssh 1 Err bitreich.org 70 i and Err bitreich.org 70 i .Xr rsync 1 . Err bitreich.org 70 i .Nm Err bitreich.org 70 i 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+.Pp Err bitreich.org 70 i When you run 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@@ -28,76 +27,75 @@ will connect to Err bitreich.org 70 i via ssh(1) and request the remote Err bitreich.org 70 i .Em HOSTNAME 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+.Ql uname -n . Err bitreich.org 70 i+.Pp 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 .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+.Xr rsync 1 . Err bitreich.org 70 i .It 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+using Err bitreich.org 70 i+.Xr rsync 1 . Err bitreich.org 70 i .It Err bitreich.org 70 i If folder Err bitreich.org 70 i .Ar absent Err bitreich.org 70 i exists, filenames in it are deleted on Err bitreich.org 70 i-.Ar server. 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 .Ar absent- Ns Em HOSTNAME Err bitreich.org 70 i exists, filenames in it are deleted on Err bitreich.org 70 i-.Ar server. 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 .Ar script 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+.Ar server Err bitreich.org 70 i+and executed there. Err bitreich.org 70 i .It 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 copied to Err bitreich.org 70 i-.Ar server and executed there. Err bitreich.org 70 i+.Ar server Err bitreich.org 70 i+and executed there. Err bitreich.org 70 i .El Err bitreich.org 70 i- Err bitreich.org 70 i+.Pp 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+.Pp Err bitreich.org 70 i All files in either Err bitreich.org 70 i .Ar files 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-etc. are relative to the root (/) directory. The specific files Err bitreich.org 70 i-for Err bitreich.org 70 i+etc. are relative to the root (/) directory. Err bitreich.org 70 i+The specific files for Err bitreich.org 70 i .Em HOSTNAME Err bitreich.org 70 i are worked on after the common files. Err bitreich.org 70 i- Err bitreich.org 70 i+.Pp 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 i-.Nm Err bitreich.org 70 i-does not handle file permissions and ownership. Thoses should be Err bitreich.org 70 i-modified by the Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+does not handle file permissions and ownership. Err bitreich.org 70 i+Those should be modified by the Err bitreich.org 70 i .Ar script Err bitreich.org 70 i file. Err bitreich.org 70 i-. Err bitreich.org 70 i .Sh EXAMPLES Err bitreich.org 70 i Please see the Err bitreich.org 70 i .Ar examples Err bitreich.org 70 i directory in the Err bitreich.org 70 i .Nm Err bitreich.org 70 i distribution. Err bitreich.org 70 i- Err bitreich.org 70 i-.Sh EXIT Err bitreich.org 70 i+.Sh EXIT Err bitreich.org 70 i .Ex -std drist Err bitreich.org 70 i .Sh SEE ALSO Err bitreich.org 70 i .Xr rsync 1 Err bitreich.org 70 .