sd_login: Be slightly more verbose with type names.

1 files changed, 9 insertions, 7 deletions

diff --git a/sd_login/doc.go b/sd_login/doc.go
index 33c31be..00e7250 100644
--- a/sd_login/doc.go
+++ b/sd_login/doc.go
@@ -17,14 +17,16 @@
 // Package sd_login introspects session and login information from
 // systemd, logind, and machined.
 //
-// There are 5 basic object types that these three system services manage.
+// There are 5 basic object types that these three system services
+// manage and are introspected by this package.
 //
 // The machine manager maintains a list of "machines":
 //
 //  1. machine: A local container or virtual machine
 //
 // The host system, and machines hosted on it, may each run their own
-// login manager, which keeps track of seats, sessions, and users:
+// login manager, which keeps track of "seats", "sessions", and
+// "users":
 //
 //  2. seat: A set of hardware devices for a workspace; i.e. a screen
 //     and keyboard
@@ -36,10 +38,10 @@
 //     more sessions
 //
 // Finally, sessions and users can be used to group together
-// processes, which are kept track of by cgroup manager:
+// "processes", which are kept track of by cgroup manager:
 //
-//  5. pid: A process may belong to a session, or directly to a user
-//     if it is not part of a session.  This "belonging" is separate
-//     accounting by the login manager; it is NOT the same as the
-//     EUID/RUID.
+//  5. process: A process may belong to a session, or directly to a
+//     user if it is not part of a session.  This "belonging" is
+//     separate accounting by the cgroup manager; it is NOT the same
+//     as the EUID/RUID.
 package sd_login