service(8): direct user to rc(8) for a list of valid commands

New users may refer to service(8) to discover how to manage services,
but this manpage does not explain which commands are permitted besides
start/stop (for example, 'enable'). Add a paragraph that directs the
reader to rc(8) to discover this.

While here, add a few examples of common use-cases.

Reported by: Mina Galić <freebsd@igalic.co>
Pull request: https://github.com/freebsd/freebsd-src/pull/1057

Remove $FreeBSD$: two-line nroff pattern

Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/

service: Add -E option to set environment variables before starting a service.

This allows for quicker testing/debugging of rc scripts and is a pre-req
for automatic service jails.

Differential Revision: https://reviews.freebsd.org/D40369
Reviewed by: se

service(8): Bump date after commit 66d795ec191b994f317b0ad812bb6e7943347c1f .

Differential revision: https://reviews.freebsd.org/D32582
MFC after: 1 week
Sponsored by: NVIDIA Networking

service(8): Fix typo in man page.

Differential revision: https://reviews.freebsd.org/D32582
Submitted by: christos@
MFC after: 1 week
Sponsored by: NVIDIA Networking

service.8: Use entire section of literally displayed text

.Dl indents literal display text for one line, but .Bd can do it for a
whole subsection.

Pointy hat to: debdrup
Reported by: 0mp
Reviewed by: 0mp
Differential Revision: https://reviews.freebsd.org/D28198

service.8: Provide example for adding completions to (t)csh

service(8) has an example for bash completion, however bash is third
party and in /usr/share/examples/csh/dot.cshrc is a working example for
csh.

Since I use (t)csh, I've tested it, and it works for me.

PR: 179497
Submitted by: ohauer@

Reviewed by: kp (tentatively)
Differential Revision: https://reviews.freebsd.org/D28197

Fix a typo and sort options

MFC after: 1 week

service(1): Improve manual page

* Sort options..
* Fix some typos.
* Use one Bd macro for code blocks instead of a bunch of Dl macros.
* Improve formatting.
* Clarify 'jail' argument

PR: 228552
Submitted by: 0mp
MFC After: 3 weeks

service(8): Add support for interfacing with services in jails

Provide a -j option that can take a jail name or id. If -j is specified,
check that the jail exists and proxy the service request through to
service(8) in the jail.

This allows for cleaner workflows when updating services in a jail, turning
the following:

pkg -j dns upgrade
jexec dns service named restart

into:

pkg -j dns upgrade
service -j dns named restart

PR: 223325
Submitted by: David O'Rourke (with slight changes)
MFC after: 2 weeks

Use Mt macro to properly format mailto links

Approved by: hrs (mentor)

Add -R, an option to restart all enabled "local" services.

Discussed on: -rc@ (in September)
MFC after: 2 months

Fix a silly typo on my part.

Approved by: re (hrs)

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.

mdoc nitpicking: the title argument shall be uppercase

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.

MFC r200743:

The service command is an easy interface to the rc.d system.
Its primary purpose is to start and stop services provided by
the rc.d scripts, however it can also be used to list the scripts
using various criteria.

MFC r200809, r200980, r201035, r201069, 201070:

Updates/fixes suggested after the initial introducition

Update the "-l or -r" usage to better conform to the standard

Submitted by: ed

Further improve the description, and bump Dd.

Provide a better short description and fix SEE ALSO section entries.

By popular request, execute rc.d scripts in the same environment
as they are at boot time.

Original concept submitted by: ume

The service command is an easy interface to the rc.d system.
Its primary purpose is to start and stop services provided by
the rc.d scripts, however it can also be used to list the scripts
using various criteria.