man: fix manpage

The manpage is moved to section 8 (System Management Commands) since
that is more appropriate.  This also makes it no longer necessary to
handle the conflict with the dtrace manpage provided by systemtap for
its dtrace-lookalike utility.

The formatting macros have been updated to use the simpler (standard)
ones described in groff_man.

References to the Oracle Linux DTrace Guide have been updated.

Signed-off-by: Kris Van Hees <kris.van.hees@oracle.com>
Reviewed-by: Eugene Loh <eugene.loh@oracle.com>

GNUmakefile

@@ -91,7 +91,7 @@ SYSTEMDUNITDIR := $(prefix)/lib/systemd/system
 INSTSYSTEMDUNITDIR := $(DESTDIR)$(SYSTEMDUNITDIR)
 DOCDIR := $(prefix)/share/doc/dtrace-$(VERSION)
 INSTDOCDIR := $(DESTDIR)$(DOCDIR)
-MANDIR := $(prefix)/share/man/man1
+MANDIR := $(prefix)/share/man/man8
 INSTMANDIR := $(DESTDIR)$(MANDIR)
 TESTDIR := $(prefix)/lib$(BITNESS)/dtrace/testsuite
 INSTTESTDIR := $(DESTDIR)$(TESTDIR)

cmd/Build

@@ -46,5 +46,5 @@ install::
 	      $(INSTLIBDIR)/dtrace
 	$(call describe-install-target,$(INSTSBINDIR),dtrace)
 	install -m 755 $(objdir)/dtrace $(INSTSBINDIR)
-	$(call describe-install-target,$(INSTMANDIR),dtrace.1)
-	install -m 644 $(dtrace_DIR)/dtrace.1 $(INSTMANDIR)
+	$(call describe-install-target,$(INSTMANDIR),dtrace.8)
+	install -m 644 $(dtrace_DIR)/dtrace.8 $(INSTMANDIR)