time(1): Add EXAMPLES section

[fernape]

Summary

• Add EXAMPLES showing all five flags: -a, -h, -l, -o, -p
• Not updating .Dd deliberately

Test Plan

• mandoc -Tlint clean
• igor clean
• aspell happy
• man ./time.1 renders the page properly

[bcr]

Some suggestions for improvement...

usr.bin/time/time.1

137

You're using the shell built-in time here versus the one in /usr/bin/time below. Is that intended?

151

Maybe we can find a different example that does not give 0 as result in both cases.
How about a copy operation, for example an ISO file or a backup of some sort. The second time the command is repeated, the effects of caching should result in a much faster execution time.

[fernape]

Address comments by bcr@:

• Execute time(1) instead of shell builtin
• Use an example that shows some non-zero times

[fernape]

usr.bin/time/time.1

137

Arrrg. That was a mistake. Sorry.

151

I don't get a big difference, maybe because the bootonly iso is not so big, but I think it is clearer now. Thanks!

[bcr]

Looks good to me now, although I would use amd64 in the example as i386 is going the way of the dodo. But it does not matter much for the example.

[fernape]

s/i386/amd64/g as suggested by bcr@

[fernape]

In D25548#564975, @bcr wrote:

Looks good to me now, although I would use amd64 in the example as i386 is going the way of the dodo. But it does not matter much for the example.

Done in https://svnweb.freebsd.org/base?view=revision&revision=362992

Thanks for reviewing this!

[fernape]

Abandoning revision since it is committed and Phabricator does not give me the option of just closing it.

[gbe]

@fernape that's because you have forgotten the differential version in the commit message, please also include a 'reviewed by' in future commits.

[fernape]

In D25548#565873, @gbe wrote:

@fernape that's because you have forgotten the differential version in the commit message, please also include a 'reviewed by' in future commits.

Sorry, for that. I sent a follow up email