jexec man: Add examples section

[dbaio]

Summary

jexec man: Add examples section

MFC after:      3 days

Test Plan

$ mandoc -T lint ./jexec.8
<null>

[pauamma_gundo.com]

Nits fixable on commit

usr.sbin/jexec/jexec.8

69

78

83

87

[danfe]

usr.sbin/jexec/jexec.8

75

Shouldn't we expand contractions?

79

uname(8) -> .Xr uname 1

$ man 8 uname
No manual entry for uname

84

sh(1) -> .Xr sh 1

87

login(1) -> .Xr login 1

90

motd(5) -> .Xr motd 5

[dbaio]

• Fix references

[dbaio]

• Remove contraction

[dbaio]

Thank you both for reviewing.

usr.sbin/jexec/jexec.8

69

This is rendering correct.

87

I couldn't use this macro in the example title; it doesn't render in the same line.
But the reference is in the next paragraph.

[danfe]

usr.sbin/jexec/jexec.8

75

It should read "It is also possible ...", its is a possessive pronoun. :-)

87

I couldn't use this macro in the example title; it doesn't render in the same line.

Oh, so .Xr references cannot be used with .Ss? Interesting...

[dbaio]

• Fix Its

[dbaio]

usr.sbin/jexec/jexec.8

87

it seems so, I couldn't find any other man page doing that.

[0mp]

Looks nice. I just have some minor suggestions.

usr.sbin/jexec/jexec.8

75

s/by is/by its/

80

Perhaps this could be rephrased into

The following command runs
.Ql uname -a
in a jail called
.Dq name .
Since a command is specified explicitly,
.Nm
does not spawn an interactive shell.
Instead,
.Nm
executes the specified command directly.

87

In that case I'd replace "login(1)" with "the login command" to avoid confusion.

90

A newline would be nice here.

92

Usually, .Xr should be on its own line. Perhaps it renders correctly, but it is not how Xr is usually used :)

[dbaio]

• Improve examples

[dbaio]

@0mp, thanks for the tips and feedback; much appreciated.

[gbe]

LGTM from manpages

[dbaio]

Thank you everyone for reviewing this.