Skip to content

Commit

Permalink
Update 'Seealso' to 'seealso' directive and use more 'manpage' direct…
Browse files Browse the repository at this point in the history
…ive instead of 'doc'.
  • Loading branch information
gthess committed Oct 20, 2022
1 parent 0d245cf commit b9f5536
Show file tree
Hide file tree
Showing 3 changed files with 7 additions and 9 deletions.
10 changes: 4 additions & 6 deletions source/topics/core/serve-stale.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
.. _doc_serve_stale:

.. versionadded:: 1.11.0

Serving Stale Data
Expand All @@ -10,8 +8,8 @@ Serving stale data would normally break the contract between an authoritative
name server and a caching resolver on the amount of time a record is permitted
to be cached. However, the TTL definition of :RFC:`8767#section-4` states that:

If the data is unable to be authoritatively refreshed when the TTL expires,
the record MAY be used as though it is unexpired.
"If the data is unable to be authoritatively refreshed when the TTL
expires, the record MAY be used as though it is unexpired."

Serving expired records is not a novel idea and it was already present in
various forms (e.g., increased cache-hit ratio, fallback when upstream is not
Expand Down Expand Up @@ -135,9 +133,9 @@ your installed Unbound for defaults and suggested values. And always remember
that serving expired records should be approached with caution; you may be
directing your clients to places long gone.

.. Seealso:: :term:`serve-expired<serve-expired: <yes or no>>`,
.. seealso:: :term:`serve-expired<serve-expired: <yes or no>>`,
:term:`serve-expired-ttl<serve-expired-ttl: <seconds>>`,
:term:`serve-expired-ttl-reset<serve-expired-ttl-reset: <yes or no>>`,
:term:`serve-expired-reply-ttl<serve-expired-reply-ttl: <seconds>>` and
:term:`serve-expired-client-timeout<serve-expired-client-timeout: <msec>>`
in the :doc:`/manpages/unbound.conf` manpage.
in the :manpage:`unbound.conf(5)` manpage.
2 changes: 1 addition & 1 deletion source/topics/filtering/rpz.rst
Original file line number Diff line number Diff line change
Expand Up @@ -385,7 +385,7 @@ malware.rpz.example.com zone will be used.
Queries coming from 127.0.0.20 will be subjected to the policies from both
zones.

.. Seealso:: :ref:`manpages/unbound.conf:Response Policy Zone Options`,
.. seealso:: :ref:`manpages/unbound.conf:Response Policy Zone Options`,
:term:`module-config<module-config: <"module names">>`,
:term:`define-tag<define-tag: <"list of tags">>`,
:term:`access-control-tag<access-control-tag: <IP netblock> <"list
Expand Down
4 changes: 2 additions & 2 deletions source/topics/filtering/tags-views.rst
Original file line number Diff line number Diff line change
Expand Up @@ -160,5 +160,5 @@ This behaviour can be changed by setting ``view-first`` to yes.
If view-first is enabled, Unbound will try to use the view's local-zone tree,
and if there is no match it will search the global tree.

.. Seealso:: :ref:`manpages/unbound.conf:View Options` in
the :doc:`/manpages/unbound.conf` manpage.
.. seealso:: :ref:`manpages/unbound.conf:View Options` in
the :manpage:`unbound.conf(5)` manpage.

0 comments on commit b9f5536

Please sign in to comment.