more .adoc markup fixes.

This is mostly mechanical-ish fixups to adjust markup style
for cross references. A bit of care and feeding needed, so
we haven't finished the list, but this gets a significant chunk
of them.

Author: gdamore

Diff for: docs/man/nng_aio.5.adoc

@@ -37,34 +37,34 @@ This callback will be executed exactly once.
 
 The asynchronous I/O framework in _nng_ also supports cancellation of
 operations that are already in progress
-(see `<<nng_aio_cancel.3#,nng_aio_cancel()>>`), as well setting a maximum
+(see xref:nng_aio_cancel.3.adoc[`nng_aio_cancel()`]), as well setting a maximum
 timeout for them to complete within
-(see `<<nng_aio_set_timeout.3#,nng_aio_set_timeout()>>`).
+(see xref:nng_aio_set_timeout.3.adoc[`nng_aio_set_timeout()`]).
 
 It is also possible to initiate an asynchronous operation, and wait for it to
-complete using `<<nng_aio_wait.3#,nng_aio_wait()>>`.
+complete using xref:nng_aio_wait.3.adoc[`nng_aio_wait()`].
 
-These structures are created using the `<<nng_aio_alloc.3#,nng_aio_alloc()>>`,
-and destroyed using `<<nng_aio_free.3#,nng_aio_free()>>`.
+These structures are created using the xref:nng_aio_alloc.3.adoc[`nng_aio_alloc()`],
+and destroyed using xref:nng_aio_free.3.adoc[`nng_aio_free()`].
 
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_abort.3#,nng_aio_abort(3)>>,
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_cancel.3#,nng_aio_cancel(3)>>,
-<<nng_aio_count.3#,nng_aio_count(3)>>,
-<<nng_aio_free.3#,nng_aio_free(3)>>,
-<<nng_aio_get_input.3#,nng_aio_get_input(3)>>,
-<<nng_aio_get_msg.3#,nng_aio_get_msg(3)>>,
-<<nng_aio_get_output.3#,nng_aio_get_output(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio_set_input.3#,nng_aio_set_input(3)>>,
-<<nng_aio_set_iov.3#,nng_aio_set_iov(3)>>,
-<<nng_aio_set_msg.3#,nng_aio_set_msg(3)>>,
-<<nng_aio_set_timeout.3#,nng_aio_set_timeout(3)>>,
-<<nng_aio_stop.3#,nng_aio_stop(3)>>,
-<<nng_aio_wait.3#,nng_aio_wait(3)>>,
-<<nng_strerror.3#,nng_strerror(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_abort.3.adoc[nng_aio_abort(3)],
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_cancel.3.adoc[nng_aio_cancel(3)],
+xref:nng_aio_count.3.adoc[nng_aio_count(3)],
+xref:nng_aio_free.3.adoc[nng_aio_free(3)],
+xref:nng_aio_get_input.3.adoc[nng_aio_get_input(3)],
+xref:nng_aio_get_msg.3.adoc[nng_aio_get_msg(3)],
+xref:nng_aio_get_output.3.adoc[nng_aio_get_output(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio_set_input.3.adoc[nng_aio_set_input(3)],
+xref:nng_aio_set_iov.3.adoc[nng_aio_set_iov(3)],
+xref:nng_aio_set_msg.3.adoc[nng_aio_set_msg(3)],
+xref:nng_aio_set_timeout.3.adoc[nng_aio_set_timeout(3)],
+xref:nng_aio_stop.3.adoc[nng_aio_stop(3)],
+xref:nng_aio_wait.3.adoc[nng_aio_wait(3)],
+xref:nng_strerror.3.adoc[nng_strerror(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_abort.3.adoc

@@ -28,7 +28,7 @@ The `nng_aio_abort()` function aborts an operation previously started
 with the handle _aio_.
 If the operation is aborted, then the callback
 for the handle will be called, and the function
-`<<nng_aio_result.3#,nng_aio_result()>>` will return the error _err_.
+xref:nng_aio_result.3.adoc[`nng_aio_result()`] will return the error _err_.
 
 This function does not wait for the operation to be fully aborted, but
 returns immediately.
@@ -48,8 +48,8 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_cancel.3#,nng_aio_cancel(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_cancel.3.adoc[nng_aio_cancel(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_alloc.3.adoc

@@ -34,22 +34,22 @@ NOTE: The callback _callb_ must not perform any blocking operations, and
 must complete its execution quickly.  If _callb_ does block, this can
 lead ultimately to an apparent "hang" or deadlock in the application.
 
-Asynchronous I/O operations all take an `<<nng_aio.5#,nng_aio>>`
+Asynchronous I/O operations all take an xref:nng_aio.5.adoc[`nng_aio`]
 handle such as allocated by this function.
 Such operations are usually started by a function that returns immediately.
 The operation is then run asynchronously, and completes sometime later.
 When that operation is complete, the callback supplied here is called,
 and that callback is able to determine the result of the operation using
-`<<nng_aio_result.3#,nng_aio_result()>>`,
-`<<nng_aio_count.3#,nng_aio_count()>>`,
-and `<<nng_aio_get_output.3#,nng_aio_get_output()>>`.
+xref:nng_aio_result.3.adoc[`nng_aio_result()`],
+xref:nng_aio_count.3.adoc[`nng_aio_count()`],
+and xref:nng_aio_get_output.3.adoc[`nng_aio_get_output()`].
 
 It is possible to wait synchronously for an otherwise asynchronous operation
-by using the function `<<nng_aio_wait.3#,nng_aio_wait()>>`.
+by using the function xref:nng_aio_wait.3.adoc[`nng_aio_wait()`].
 In that case, it is permissible for _callb_ and _arg_ to both be `NULL`.
 Note that if these are `NULL`, then it will not be possible to determine when the
 operation is complete except by calling the aforementioned
-`<<nng_aio_wait.3#,nng_aio_wait()>>`.
+xref:nng_aio_wait.3.adoc[`nng_aio_wait()`].
 
 == RETURN VALUES
 
@@ -63,20 +63,20 @@ This function returns 0 on success, and non-zero otherwise.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_abort.3#,nng_aio_abort(3)>>,
-<<nng_aio_cancel.3#,nng_aio_cancel(3)>>,
-<<nng_aio_count.3#,nng_aio_count(3)>>,
-<<nng_aio_free.3#,nng_aio_free(3)>>,
-<<nng_aio_get_input.3#,nng_aio_get_input(3)>>,
-<<nng_aio_get_msg.3#,nng_aio_get_msg(3)>>,
-<<nng_aio_get_output.3#,nng_aio_get_output(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio_set_input.3#,nng_aio_set_input(3)>>,
-<<nng_aio_set_iov.3#,nng_aio_set_iov(3)>>,
-<<nng_aio_set_msg.3#,nng_aio_set_msg(3)>>,
-<<nng_aio_set_timeout.3#,nng_aio_set_timeout(3)>>,
-<<nng_aio_stop.3#,nng_aio_stop(3)>>,
-<<nng_aio_wait.3#,nng_aio_wait(3)>>,
-<<nng_strerror.3#,nng_strerror(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_abort.3.adoc[nng_aio_abort(3)],
+xref:nng_aio_cancel.3.adoc[nng_aio_cancel(3)],
+xref:nng_aio_count.3.adoc[nng_aio_count(3)],
+xref:nng_aio_free.3.adoc[nng_aio_free(3)],
+xref:nng_aio_get_input.3.adoc[nng_aio_get_input(3)],
+xref:nng_aio_get_msg.3.adoc[nng_aio_get_msg(3)],
+xref:nng_aio_get_output.3.adoc[nng_aio_get_output(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio_set_input.3.adoc[nng_aio_set_input(3)],
+xref:nng_aio_set_iov.3.adoc[nng_aio_set_iov(3)],
+xref:nng_aio_set_msg.3.adoc[nng_aio_set_msg(3)],
+xref:nng_aio_set_timeout.3.adoc[nng_aio_set_timeout(3)],
+xref:nng_aio_stop.3.adoc[nng_aio_stop(3)],
+xref:nng_aio_wait.3.adoc[nng_aio_wait(3)],
+xref:nng_strerror.3.adoc[nng_strerror(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_begin.3.adoc

@@ -35,7 +35,7 @@ This operation should be called at the start of any I/O operation, and must
 be called not more than once for a given I/O operation on a given _aio_.
 
 Once this function is called, if `true` is returned, then the provider MUST
-guarantee that `<<nng_aio_finish.3#,nng_aio_finish()>>` is called for the _aio_
+guarantee that xref:nng_aio_finish.3.adoc[`nng_aio_finish()`] is called for the _aio_
 exactly once, when the operation is complete or canceled.
 
 NOTE: This function is only for I/O providers (those actually performing
@@ -55,10 +55,10 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_cancel.3#,nng_aio_cancel(3)>>,
-<<nng_aio_defer.3#,nng_aio_defer(3)>>,
-<<nng_aio_finish.3#,nng_aio_finish(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_cancel.3.adoc[nng_aio_cancel(3)],
+xref:nng_aio_defer.3.adoc[nng_aio_defer(3)],
+xref:nng_aio_finish.3.adoc[nng_aio_finish(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_cancel.3.adoc

@@ -28,7 +28,7 @@ The `nng_aio_cancel()` function aborts an operation previously started
 with the handle _aio_.
 If the operation is aborted, then the callback
 for the handle will be called, and the function
-`<<nng_aio_result.3#,nng_aio_result()>>` will return the error `NNG_ECANCELED`.
+xref:nng_aio_result.3.adoc[`nng_aio_result()`] will return the error `NNG_ECANCELED`.
 
 This function does not wait for the operation to be fully aborted, but
 returns immediately.
@@ -38,7 +38,7 @@ finished, or no operation has been started yet), then this function
 has no effect.
 
 NOTE: This function is the same as calling
-`<<nng_aio_abort.3#,nng_aio_abort()>>` with the error `NNG_ECANCELED`.
+xref:nng_aio_abort.3.adoc[`nng_aio_abort()`] with the error `NNG_ECANCELED`.
 
 == RETURN VALUES
 
@@ -51,8 +51,8 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_abort.3#,nng_aio_abort(3)>>,
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_abort.3.adoc[nng_aio_abort(3)],
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_count.3.adoc

@@ -33,13 +33,13 @@ transfer user data (they may transfer protocol data though) -- in this case
 this function will generally return zero.
 
 This function is most useful when used with operations that make use of
-of a scatter/gather vector (set by `<<nng_aio_set_iov.3#,nng_aio_set_iov()>>`).
+of a scatter/gather vector (set by xref:nng_aio_set_iov.3.adoc[`nng_aio_set_iov()`]).
 
 NOTE: The return value from this function is undefined if the operation
 has not completed yet.
 Either call this from the handle's completion callback,
 or after waiting for the operation to complete with
-`<<nng_aio_wait.3#,nng_aio_wait()>>`.
+xref:nng_aio_wait.3.adoc[`nng_aio_wait()`].
 
 == RETURN VALUES
 
@@ -52,10 +52,10 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio_set_iov.3#,nng_aio_set_iov(3)>>,
-<<nng_aio_wait.3#,nng_aio_wait(3)>>,
-<<nng_strerror.3#,nng_strerror(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio_set_iov.3.adoc[nng_aio_set_iov(3)],
+xref:nng_aio_wait.3.adoc[nng_aio_wait(3)],
+xref:nng_strerror.3.adoc[nng_strerror(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_defer.3.adoc

@@ -40,11 +40,11 @@ completed, or be in a state where it is no longer possible to unschedule it.
 In this case, the _cancelfn_ should just return without making any changes.
 
 If the cancellation routine successfully canceled the operation, it should
-ensure that `<<nng_aio_finish.3#,nng_aio_finish()>>` is called, with the
+ensure that xref:nng_aio_finish.3.adoc[`nng_aio_finish()`] is called, with the
 error code specified by _err_.
 
 IMPORTANT: It is mandatory that I/O providers call
-`<<nng_aio_finish.3#,nng_aio_finish()>>`
+xref:nng_aio_finish.3.adoc[`nng_aio_finish()`]
 *EXACTLY ONCE* when they are finished with the operation.
 
 NOTE: This function is only for I/O providers (those actually performing
@@ -70,9 +70,9 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_cancel.3#,nng_aio_cancel(3)>>,
-<<nng_aio_finish.3#,nng_aio_finish(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_cancel.3.adoc[nng_aio_cancel(3)],
+xref:nng_aio_finish.3.adoc[nng_aio_finish(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_finish.3.adoc

@@ -27,7 +27,7 @@ void nng_aio_finish(nng_aio *aio, int err);
 The `nng_aio_finish()` function marks operation associated with _aio_ as
 complete, with the status _err_.
 This will be the result returned by
-`<<nng_aio_result.3#,nng_aio_result()>>`.
+xref:nng_aio_result.3.adoc[`nng_aio_result()`].
 
 This function causes the callback associated with the _aio_ to called.
 
@@ -51,10 +51,10 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_begin.3#,nng_aio_begin(3)>>,
-<<nng_aio_cancel.3#,nng_aio_cancel(3)>>,
-<<nng_aio_defer.3#,nng_aio_defer(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_begin.3.adoc[nng_aio_begin(3)],
+xref:nng_aio_cancel.3.adoc[nng_aio_cancel(3)],
+xref:nng_aio_defer.3.adoc[nng_aio_defer(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_free.3.adoc

@@ -28,7 +28,7 @@ The `nng_aio_free()` function frees an allocated asynchronous I/O handle.
 If any operation is in progress, the operation is canceled, and the
 caller is blocked until the operation is completely canceled, to ensure
 that it is safe to deallocate the handle and any associated resources.
-(This is done by implicitly calling `<<nng_aio_stop.3#,nng_aio_stop()>>`.)
+(This is done by implicitly calling xref:nng_aio_stop.3.adoc[`nng_aio_stop()`].)
 
 == RETURN VALUES
 
@@ -41,7 +41,7 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_stop.3#,nng_aio_stop(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_stop.3.adoc[nng_aio_stop(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_get_input.3.adoc

@@ -26,7 +26,7 @@ void *nng_aio_get_input(nng_aio *aio, unsigned int index);
 
 The `nng_aio_get_input()` function returns the value of the input parameter
 previously set at _index_ on _aio_ with the
-`<<nng_aio_set_input.3#,nng_aio_set_input()>>` function.
+xref:nng_aio_set_input.3.adoc[`nng_aio_set_input()`] function.
 
 The valid values of _index_ range from zero (0) to three (3), as no operation
 currently defined can accept more than four parameters.
@@ -45,9 +45,9 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_get_output.3#,nng_aio_get_output(3)>>,
-<<nng_aio_set_input.3#,nng_aio_set_input(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_get_output.3.adoc[nng_aio_get_output(3)],
+xref:nng_aio_set_input.3.adoc[nng_aio_set_input(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_get_msg.3.adoc

@@ -26,10 +26,10 @@ nng_msg *nng_aio_get_msg(nng_aio *aio);
 
 The `nng_aio_get_msg()` function gets any message stored in _aio_ as
 either a result of a successful receive
-(see `<<nng_recv_aio.3#,nng_recv_aio()>>`)
-or that was previously stored with `<<nng_aio_set_msg.3#,nng_aio_set_msg()>>`.
+(see xref:nng_recv_aio.3.adoc[`nng_recv_aio()`])
+or that was previously stored with xref:nng_aio_set_msg.3.adoc[`nng_aio_set_msg()`].
 
-IMPORTANT: The `<<nng_aio.5#,nng_aio>>` must not have an operation in progress.
+IMPORTANT: The xref:nng_aio.5.adoc[`nng_aio`] must not have an operation in progress.
 
 == RETURN VALUES
 
@@ -42,8 +42,8 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_set_msg.3#,nng_aio_set_msg(3)>>,
-<<nng_recv_aio.3#,nng_recv_aio(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng_msg.5#,nng_msg(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_set_msg.3.adoc[nng_aio_set_msg(3)],
+xref:nng_recv_aio.3.adoc[nng_recv_aio(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng_msg.5.adoc[nng_msg(5)],
+xref:nng.7.adoc[nng(7)]

Diff for: docs/man/nng_aio_get_output.3.adoc

@@ -48,9 +48,9 @@ None.
 == SEE ALSO
 
 [.text-left]
-<<nng_aio_alloc.3#,nng_aio_alloc(3)>>,
-<<nng_aio_get_output.3#,nng_aio_get_output(3)>>,
-<<nng_aio_set_input.3#,nng_aio_set_input(3)>>,
-<<nng_aio_result.3#,nng_aio_result(3)>>,
-<<nng_aio.5#,nng_aio(5)>>,
-<<nng.7#,nng(7)>>
+xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
+xref:nng_aio_get_output.3.adoc[nng_aio_get_output(3)],
+xref:nng_aio_set_input.3.adoc[nng_aio_set_input(3)],
+xref:nng_aio_result.3.adoc[nng_aio_result(3)],
+xref:nng_aio.5.adoc[nng_aio(5)],
+xref:nng.7.adoc[nng(7)]