man: try to repair some nonsensical paragraph

man: fix typos

importd: drop dkr support The current code is not compatible with current dkr protocols anyway, and dkr has a different focus ("microservices") than nspawn anyway ("whole machine containers"), hence drop support for it, we cannot reasonably keep this up to date, and it creates the impression we'd actually care for the microservices usecase.

man: tweak description of machinectl show Also, machinectl status is anything but terse. Remove "terse".

doc: use expanded forms for written style

doc: correct orthography, word forms and missing/extraneous words

doc: correct punctuation and improve typography in documentation

man: minor extension to the machinectl man page s/an/any/, as reported by Vito Caputo. Also mention explicitly that the security properties (i.e. SELinux) are also isolated when "machinectl shell" is used.

machinectl: extend the "shell" syntax to take user@container names In order to make "machinectl shell" more similar to ssh, allow the following syntax to connect to a container under a specific username: machinectl shell lennart@fedora Also beefs up related man page documentation.

machinectl: make machine name parameters for "shell" and "login" optional If no machine name is specified, imply that we connect to ".host", i.e. the local host.

machinectl: add new "machinectl shell" command This makes use of machined's new OpenShell() command and allows opening a new interactive shell in any container.

man: typo fixes

man: remove repeated word "the" and polish

fix machinectl bind man entry

man: revert dynamic paths for split-usr setups This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.

man: generate configured paths in manpages In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.

man: document that nspawn -x, --template= and machinectl clone leave hostname and machine id unmodified

man: fix typos in machinectl The s/now/not/ unfortunately inverted the meaning.

man: Resolve how to refer to derived names for machinectl containers "the name it is" is clumsy english, and since the most recently referred to thing was a name anyway we can just leave the "it is". This matches later uses in the same document.

man: fix links to compressors

man: document "machinectl export-tar" and "export-raw"

man: document machinectl import-tar and import-raw

man: document that machinectl set-limit creates a btrfs loopback too

machined,machinectl: add calls for changing container/VM quotas

man: add newlines to the pull-raw example in machinectl(1) They were removed in commit 798d3a52 ("Reindent man pages to 2ch").

Reindent man pages to 2ch

man: document new download magic

man: use one description of --no-legend

nspawn,machined: change default container image location from /var/lib/container to /var/lib/machines Given that this is also the place to store raw disk images which are very much bootable with qemu/kvm it sounds like a misnomer to call the directory "container". Hence, let's change this sooner rather than later, and use the generic name, in particular since we otherwise try to use the generic "machine" preferably over the more specific "container" or "vm".

man: bring machinectl man page up-to-date

machinectl: given that machinectl invokes a number of polkit enabled methods, start the polkit agent on terminals

machinectl: show most recent log output in "machinectl status", too

machinectl: add new commands for copying files from/to containers

machinectl: implement "bind" command to create additional bind mounts from host to container during runtime

machinectl: reimplement machinectl's "reboot" verb on top of "kill", and add new verb "poweroff" There's really no point to send the reboot SIGINT from machinectl directly, if machined can do that anyway. This saves code, and makes machinectl network transparent for these verbs. And while we are at it we can easily add a "poweroff" verb in addition to "reboot". Yay!

man: xinclude --host/--machine As usual, those common options are pushed to the end.

man: xinclude --help/--version/--no-pager

machinectl: remove unused --no-ask-password

machinectl: add bash completion

man: machinectl: there is no command 'kill-machine'

man: use xinclude to de-deduplicate common text I only tested with python-lxml. I'm not sure if xml.etree should be deprecated.

pager: support SYSTEMD_LESS environment variable This allows customization of the arguments used by less. The main motivation is that some folks might not like having --no-init on every invocation of less.

machinectl: add new "machinectl reboot" call

Help output spring cleaning Use [brackets] only for optional elements. Use <optional> in XML sources.

man: wording and grammar updates This is a recurring submission and includes corrections to various issue spotted: comma setting, missing words/preposition choice.

machinectl: add new command to spawn a getty inside a container

bus: add API call to create bus connection to the system bus of local containers Also, add support for this to machinectl, so that we can enumerate the machines that run inside a container. We must go deeper!

man: drop references to "cgroup" wher appropriate Since cgroups are mostly now an implementation detail of systemd lets deemphasize it a bit in the man pages. This renames systemd.cgroup(5) to systemd.resource-control(5) and uses the term "resource control" rather than "cgroup" where appropriate. This leaves the word "cgroup" in at a couple of places though, like for example systemd-cgtop and systemd-cgls where cgroup stuff is at the core of what is happening.

man: wording and grammar updates This includes regularly-submitted corrections to comma setting and orthographical mishaps that appeared in man/ in recent commits.

man: a few corrections to the machinectl man page

man: document four basic slices

man: wording and grammar updates

man: document machinectl and systemd-machined