doubled word; from Leon Fischer

time.3: miscellaneous manpage cleanup

- Change "tloc" variable to "now" to reinforce meaning.
- Simplify DESCRIPTION.
- No point in describing how gettimeofday(2) can fail here.
- Add a STANDARDS section.
- Rework the HISTORY section.

With input from jmc@, millert@, and schwarze@.

Thread: https://marc.info/?l=openbsd-tech&m=162766815024823&w=2

"reads fine" jmc@, ok schwarze@

Use .Rv where appropriate, and move it to RETURN VALUES;
remove .Tn, and a few minor macro adjustments.
Patch from Kaspars at Bankovskis dot net.

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

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze

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

convert to new .Dd format;

- sync prototypes and header file excerpts to reality
- many grammar, punctuation, macro, layout, spelling/typos,
rewording, etc. fixes
- avoid first person
- sprinkle crossrefs where relevant

help & ok jmc

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

ellaborate on history

Various repairs, mostly to get rid of short lines.

fix printing error; marc

After some constructive criticism from pjanzen@ and some e-mail tag:

- only use the .Dv NULL form when referring explicitly to a function
argument or return value
- otherwise, use these forms:
o non-null
o null-terminated (hyphenated form for predicate adjective)
o else, null terminated, or null terminate, whichever the case
o null pointer, null byte, null string, etc.
- may use NUL to refer to an ASCII NUL, but it doesn't need a .Tn macro

In general, capitalizing the word "null" everywhere is unnecessary and makes
the man pages harder to read. The above is consistent with popular programming
texts (i.e., K&R, Stevens).

repairs; go back over some old files, because we should properly distinguish
between NUL and NULL, i.e., don't use the .Dv (defined variable) macro when
referring to an ASCII NUL

more missing .El macros filled in

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

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly

branches: 1.1.1;
Initial revision

time.3: miscellaneous manpage cleanup

- Change "tloc" variable to "now" to reinforce meaning.
- Simplify DESCRIPTION.
- No point in describing how gettimeofday(2) can fail here.
- Add a STANDARDS section.
- Rework the HISTORY section.

With input from jmc@, millert@, and schwarze@.

Thread: https://marc.info/?l=openbsd-tech&m=162766815024823&w=2

"reads fine" jmc@, ok schwarze@

Use .Rv where appropriate, and move it to RETURN VALUES;
remove .Tn, and a few minor macro adjustments.
Patch from Kaspars at Bankovskis dot net.

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

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze

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

convert to new .Dd format;

- sync prototypes and header file excerpts to reality
- many grammar, punctuation, macro, layout, spelling/typos,
rewording, etc. fixes
- avoid first person
- sprinkle crossrefs where relevant

help & ok jmc

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

ellaborate on history

Various repairs, mostly to get rid of short lines.

fix printing error; marc

After some constructive criticism from pjanzen@ and some e-mail tag:

- only use the .Dv NULL form when referring explicitly to a function
argument or return value
- otherwise, use these forms:
o non-null
o null-terminated (hyphenated form for predicate adjective)
o else, null terminated, or null terminate, whichever the case
o null pointer, null byte, null string, etc.
- may use NUL to refer to an ASCII NUL, but it doesn't need a .Tn macro

In general, capitalizing the word "null" everywhere is unnecessary and makes
the man pages harder to read. The above is consistent with popular programming
texts (i.e., K&R, Stevens).

repairs; go back over some old files, because we should properly distinguish
between NUL and NULL, i.e., don't use the .Dv (defined variable) macro when
referring to an ASCII NUL

more missing .El macros filled in

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

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly

branches: 1.1.1;
Initial revision

Use .Rv where appropriate, and move it to RETURN VALUES;
remove .Tn, and a few minor macro adjustments.
Patch from Kaspars at Bankovskis dot net.

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

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze

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

convert to new .Dd format;

- sync prototypes and header file excerpts to reality
- many grammar, punctuation, macro, layout, spelling/typos,
rewording, etc. fixes
- avoid first person
- sprinkle crossrefs where relevant

help & ok jmc

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

ellaborate on history

Various repairs, mostly to get rid of short lines.

fix printing error; marc

After some constructive criticism from pjanzen@ and some e-mail tag:

- only use the .Dv NULL form when referring explicitly to a function
argument or return value
- otherwise, use these forms:
o non-null
o null-terminated (hyphenated form for predicate adjective)
o else, null terminated, or null terminate, whichever the case
o null pointer, null byte, null string, etc.
- may use NUL to refer to an ASCII NUL, but it doesn't need a .Tn macro

In general, capitalizing the word "null" everywhere is unnecessary and makes
the man pages harder to read. The above is consistent with popular programming
texts (i.e., K&R, Stevens).

repairs; go back over some old files, because we should properly distinguish
between NUL and NULL, i.e., don't use the .Dv (defined variable) macro when
referring to an ASCII NUL

more missing .El macros filled in

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

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly

branches: 1.1.1;
Initial revision