man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

gettimeofday.2: miscellaneous manpage cleanup

Highlights:

- Tweak the one-liner description.
- Better variable names.
- Reorder DESCRIPTION to reflect the importance of each interface.
- Advise against using gettimeofday(2) for measuring elapsed time.
- Isolate discussion of the historical timezone parameter to its
own paragraph at the end of the DESCRIPTION.
- Update ERRORS. Mention the securelevel(7) EPERM for settimeofday(2).
- Expand SEE ALSO.
- Note settimeofday(2) in STANDARDS. It is available on many systems.

Discussed with jmc@, millert@, and deraadt@. Possibly discussed with
schwarze@, though I can't find the email.

Thread: https://marc.info/?t=162765632800002&r=1&w=2

"reads fine to me" jmc@, ok millert@

gettimeofday, settimeofday(2): limit timezone support

For gettimeofday(2), always copy out an empty timezone struct. For
settimeofday(2), still copyin(9) the struct but ignore the contents.

In gettimeofday(2)'s case we have not changed the original BSD semantics:
the kernel only tracks UTC time without an offset for DST, so a zeroed
timezone struct is the correct thing to return to the caller.

Future work could move these out into libc as stubs for clock_gettime and
clock_settime(2). But, definitely a "later" thing, given that we are in
beta.

Update the manpage to de-emphasize the timezone parameters for these
syscalls.

Discussed with tedu@, deraadt@, millert@, kettenis@, yasuoka@, jca@, and
guenther@. Tested by job@. Ports input from jca@ and sthen@. Manpage
input from jca@.

ok jca@ deraadt@

adjtime(2), settimeofday(2), clock_settime(2): validate input

Add documentation for the new EINVAL cases for adjtime(2) and
settimeofday(2).

adjtime.2 docs ok schwarze@,
settimeofday(2)/clock_settime(2) stuff ok tedu@,
"stop waiting" deraadt@

use .In rather than .Fd #include

use .Rv; no change of meaning; from Kaspars at Bankovskis dot net

obvious .Pa fixes; found with mandocdb(8)

Align suseconds_t with POSIX: it's the type of the tv_usec member of timeval.
Use useconds_t in the ualarm() declaration.
Bump libstdc++ major to be sure there isn't ABI issues.

ok deraadt@ jca@ jmc@ millert@
ports testing by landry@

Correct type of tv_sec to time_t.

Pointed out by Dawe via tech@.

more library history
facts checked by sobrado@
style tweaks and ok jmc@

add clock_gettime to see also. i think guenther was ok with this.

Updates to SYNOPSIS, ERRORS, and STANDARDS.

More .At v1 HISTORY.
All information from http://minnie.tuhs.org/cgi-bin/utree.pl .
All facts checked by sobrado@.
Feedback and ok on an earlier version jmc@.

timed's time is up. use ntpd(8). Even our own fossil developers
switched a while back.
ok miod, kettenis

WARNINGS -> CAVEATS, and a little neccessary cleanup;

typo

document that setting the time of the machine is unsafe. explain why,
and suggest workarounds
ok guenther

convert to new .Dd format;

.Xr getitimer 2 ,
from jacob meuser;

more macro simplification;

various improvements to lists and displays:

.Pp removal
-compact removal for displays
other list/display errors

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

Another round of man page cleanup, this time to remove more hard sentence
breaks and getting rid of short lines, making these files easier to work with.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Consistify naming of RETURN VALUES section.

- change references to nil to null; tschroed@acm.org
- remove trailing spaces from end of lines
- add some .Dv
- change -1 to \-1, so `-' is taken as a negative sign
- other misc formatting fixes

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

allow settimeofday() at securelevel < 2, rather than < 1.
the consensus was that it was too annoying to not be able to change
the clock at securelevel == 1.

update to lite2 -- note restriction when securelevel > 0

Minor formatting tweak from NetBSD (perry) + OpenBSD tags.

from netbsd:
add & fix a bunch of system call pages

branches: 1.1.1;
Initial revision

gettimeofday.2: miscellaneous manpage cleanup

Highlights:

- Tweak the one-liner description.
- Better variable names.
- Reorder DESCRIPTION to reflect the importance of each interface.
- Advise against using gettimeofday(2) for measuring elapsed time.
- Isolate discussion of the historical timezone parameter to its
own paragraph at the end of the DESCRIPTION.
- Update ERRORS. Mention the securelevel(7) EPERM for settimeofday(2).
- Expand SEE ALSO.
- Note settimeofday(2) in STANDARDS. It is available on many systems.

Discussed with jmc@, millert@, and deraadt@. Possibly discussed with
schwarze@, though I can't find the email.

Thread: https://marc.info/?t=162765632800002&r=1&w=2

"reads fine to me" jmc@, ok millert@

gettimeofday, settimeofday(2): limit timezone support

For gettimeofday(2), always copy out an empty timezone struct. For
settimeofday(2), still copyin(9) the struct but ignore the contents.

In gettimeofday(2)'s case we have not changed the original BSD semantics:
the kernel only tracks UTC time without an offset for DST, so a zeroed
timezone struct is the correct thing to return to the caller.

Future work could move these out into libc as stubs for clock_gettime and
clock_settime(2). But, definitely a "later" thing, given that we are in
beta.

Update the manpage to de-emphasize the timezone parameters for these
syscalls.

Discussed with tedu@, deraadt@, millert@, kettenis@, yasuoka@, jca@, and
guenther@. Tested by job@. Ports input from jca@ and sthen@. Manpage
input from jca@.

ok jca@ deraadt@

adjtime(2), settimeofday(2), clock_settime(2): validate input

Add documentation for the new EINVAL cases for adjtime(2) and
settimeofday(2).

adjtime.2 docs ok schwarze@,
settimeofday(2)/clock_settime(2) stuff ok tedu@,
"stop waiting" deraadt@

use .In rather than .Fd #include

use .Rv; no change of meaning; from Kaspars at Bankovskis dot net

obvious .Pa fixes; found with mandocdb(8)

Align suseconds_t with POSIX: it's the type of the tv_usec member of timeval.
Use useconds_t in the ualarm() declaration.
Bump libstdc++ major to be sure there isn't ABI issues.

ok deraadt@ jca@ jmc@ millert@
ports testing by landry@

Correct type of tv_sec to time_t.

Pointed out by Dawe via tech@.

more library history
facts checked by sobrado@
style tweaks and ok jmc@

add clock_gettime to see also. i think guenther was ok with this.

Updates to SYNOPSIS, ERRORS, and STANDARDS.

More .At v1 HISTORY.
All information from http://minnie.tuhs.org/cgi-bin/utree.pl .
All facts checked by sobrado@.
Feedback and ok on an earlier version jmc@.

timed's time is up. use ntpd(8). Even our own fossil developers
switched a while back.
ok miod, kettenis

WARNINGS -> CAVEATS, and a little neccessary cleanup;

typo

document that setting the time of the machine is unsafe. explain why,
and suggest workarounds
ok guenther

convert to new .Dd format;

.Xr getitimer 2 ,
from jacob meuser;

more macro simplification;

various improvements to lists and displays:

.Pp removal
-compact removal for displays
other list/display errors

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

Another round of man page cleanup, this time to remove more hard sentence
breaks and getting rid of short lines, making these files easier to work with.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Consistify naming of RETURN VALUES section.

- change references to nil to null; tschroed@acm.org
- remove trailing spaces from end of lines
- add some .Dv
- change -1 to \-1, so `-' is taken as a negative sign
- other misc formatting fixes

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

allow settimeofday() at securelevel < 2, rather than < 1.
the consensus was that it was too annoying to not be able to change
the clock at securelevel == 1.

update to lite2 -- note restriction when securelevel > 0

Minor formatting tweak from NetBSD (perry) + OpenBSD tags.

from netbsd:
add & fix a bunch of system call pages

branches: 1.1.1;
Initial revision

gettimeofday, settimeofday(2): limit timezone support

For gettimeofday(2), always copy out an empty timezone struct. For
settimeofday(2), still copyin(9) the struct but ignore the contents.

In gettimeofday(2)'s case we have not changed the original BSD semantics:
the kernel only tracks UTC time without an offset for DST, so a zeroed
timezone struct is the correct thing to return to the caller.

Future work could move these out into libc as stubs for clock_gettime and
clock_settime(2). But, definitely a "later" thing, given that we are in
beta.

Update the manpage to de-emphasize the timezone parameters for these
syscalls.

Discussed with tedu@, deraadt@, millert@, kettenis@, yasuoka@, jca@, and
guenther@. Tested by job@. Ports input from jca@ and sthen@. Manpage
input from jca@.

ok jca@ deraadt@

adjtime(2), settimeofday(2), clock_settime(2): validate input

Add documentation for the new EINVAL cases for adjtime(2) and
settimeofday(2).

adjtime.2 docs ok schwarze@,
settimeofday(2)/clock_settime(2) stuff ok tedu@,
"stop waiting" deraadt@

use .In rather than .Fd #include

use .Rv; no change of meaning; from Kaspars at Bankovskis dot net

obvious .Pa fixes; found with mandocdb(8)

Align suseconds_t with POSIX: it's the type of the tv_usec member of timeval.
Use useconds_t in the ualarm() declaration.
Bump libstdc++ major to be sure there isn't ABI issues.

ok deraadt@ jca@ jmc@ millert@
ports testing by landry@

Correct type of tv_sec to time_t.

Pointed out by Dawe via tech@.

more library history
facts checked by sobrado@
style tweaks and ok jmc@

add clock_gettime to see also. i think guenther was ok with this.

Updates to SYNOPSIS, ERRORS, and STANDARDS.

More .At v1 HISTORY.
All information from http://minnie.tuhs.org/cgi-bin/utree.pl .
All facts checked by sobrado@.
Feedback and ok on an earlier version jmc@.

timed's time is up. use ntpd(8). Even our own fossil developers
switched a while back.
ok miod, kettenis

WARNINGS -> CAVEATS, and a little neccessary cleanup;

typo

document that setting the time of the machine is unsafe. explain why,
and suggest workarounds
ok guenther

convert to new .Dd format;

.Xr getitimer 2 ,
from jacob meuser;

more macro simplification;

various improvements to lists and displays:

.Pp removal
-compact removal for displays
other list/display errors

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

Another round of man page cleanup, this time to remove more hard sentence
breaks and getting rid of short lines, making these files easier to work with.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Consistify naming of RETURN VALUES section.

- change references to nil to null; tschroed@acm.org
- remove trailing spaces from end of lines
- add some .Dv
- change -1 to \-1, so `-' is taken as a negative sign
- other misc formatting fixes

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

allow settimeofday() at securelevel < 2, rather than < 1.
the consensus was that it was too annoying to not be able to change
the clock at securelevel == 1.

update to lite2 -- note restriction when securelevel > 0

Minor formatting tweak from NetBSD (perry) + OpenBSD tags.

from netbsd:
add & fix a bunch of system call pages

branches: 1.1.1;
Initial revision

adjtime(2), settimeofday(2), clock_settime(2): validate input

Add documentation for the new EINVAL cases for adjtime(2) and
settimeofday(2).

adjtime.2 docs ok schwarze@,
settimeofday(2)/clock_settime(2) stuff ok tedu@,
"stop waiting" deraadt@

use .In rather than .Fd #include

use .Rv; no change of meaning; from Kaspars at Bankovskis dot net

obvious .Pa fixes; found with mandocdb(8)

Align suseconds_t with POSIX: it's the type of the tv_usec member of timeval.
Use useconds_t in the ualarm() declaration.
Bump libstdc++ major to be sure there isn't ABI issues.

ok deraadt@ jca@ jmc@ millert@
ports testing by landry@

Correct type of tv_sec to time_t.

Pointed out by Dawe via tech@.

more library history
facts checked by sobrado@
style tweaks and ok jmc@

add clock_gettime to see also. i think guenther was ok with this.

Updates to SYNOPSIS, ERRORS, and STANDARDS.

More .At v1 HISTORY.
All information from http://minnie.tuhs.org/cgi-bin/utree.pl .
All facts checked by sobrado@.
Feedback and ok on an earlier version jmc@.

timed's time is up. use ntpd(8). Even our own fossil developers
switched a while back.
ok miod, kettenis

WARNINGS -> CAVEATS, and a little neccessary cleanup;

typo

document that setting the time of the machine is unsafe. explain why,
and suggest workarounds
ok guenther

convert to new .Dd format;

.Xr getitimer 2 ,
from jacob meuser;

more macro simplification;

various improvements to lists and displays:

.Pp removal
-compact removal for displays
other list/display errors

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

Another round of man page cleanup, this time to remove more hard sentence
breaks and getting rid of short lines, making these files easier to work with.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Consistify naming of RETURN VALUES section.

- change references to nil to null; tschroed@acm.org
- remove trailing spaces from end of lines
- add some .Dv
- change -1 to \-1, so `-' is taken as a negative sign
- other misc formatting fixes

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

allow settimeofday() at securelevel < 2, rather than < 1.
the consensus was that it was too annoying to not be able to change
the clock at securelevel == 1.

update to lite2 -- note restriction when securelevel > 0

Minor formatting tweak from NetBSD (perry) + OpenBSD tags.

from netbsd:
add & fix a bunch of system call pages

branches: 1.1.1;
Initial revision

use .In rather than .Fd #include

use .Rv; no change of meaning; from Kaspars at Bankovskis dot net

obvious .Pa fixes; found with mandocdb(8)

Align suseconds_t with POSIX: it's the type of the tv_usec member of timeval.
Use useconds_t in the ualarm() declaration.
Bump libstdc++ major to be sure there isn't ABI issues.

ok deraadt@ jca@ jmc@ millert@
ports testing by landry@

Correct type of tv_sec to time_t.

Pointed out by Dawe via tech@.

more library history
facts checked by sobrado@
style tweaks and ok jmc@

add clock_gettime to see also. i think guenther was ok with this.

Updates to SYNOPSIS, ERRORS, and STANDARDS.

More .At v1 HISTORY.
All information from http://minnie.tuhs.org/cgi-bin/utree.pl .
All facts checked by sobrado@.
Feedback and ok on an earlier version jmc@.

timed's time is up. use ntpd(8). Even our own fossil developers
switched a while back.
ok miod, kettenis

WARNINGS -> CAVEATS, and a little neccessary cleanup;

typo

document that setting the time of the machine is unsafe. explain why,
and suggest workarounds
ok guenther

convert to new .Dd format;

.Xr getitimer 2 ,
from jacob meuser;

more macro simplification;

various improvements to lists and displays:

.Pp removal
-compact removal for displays
other list/display errors

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

Another round of man page cleanup, this time to remove more hard sentence
breaks and getting rid of short lines, making these files easier to work with.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Consistify naming of RETURN VALUES section.

- change references to nil to null; tschroed@acm.org
- remove trailing spaces from end of lines
- add some .Dv
- change -1 to \-1, so `-' is taken as a negative sign
- other misc formatting fixes

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

allow settimeofday() at securelevel < 2, rather than < 1.
the consensus was that it was too annoying to not be able to change
the clock at securelevel == 1.

update to lite2 -- note restriction when securelevel > 0

Minor formatting tweak from NetBSD (perry) + OpenBSD tags.

from netbsd:
add & fix a bunch of system call pages

branches: 1.1.1;
Initial revision