docs: fix syntax highlighting of code blocks
And various other cleanups
Change-Id: I240badc5358c09f006c2a22d4706ce373f2dd188
diff --git a/docs/release-notes/release-notes-0.1.0.rst b/docs/release-notes/release-notes-0.1.0.rst
index 03b1ce0..a6fea30 100644
--- a/docs/release-notes/release-notes-0.1.0.rst
+++ b/docs/release-notes/release-notes-0.1.0.rst
@@ -7,8 +7,8 @@
- **Packet Format**
- + `NDN-TLV <http://named-data.net/doc/ndn-tlv/>`_
- + LocalControlHeader, to allow apps to set outgoing face and learn incoming face.
+ + `NDN-TLV <https://named-data.net/doc/NDN-packet-spec/0.1/>`__
+ + LocalControlHeader, to allow apps to set outgoing face and learn incoming face
- **Faces**
@@ -21,8 +21,7 @@
.. note::
Ethernet support will not work properly on Linux kernels with TPACKET_V3 flexible
buffer implementation (>= 3.2.0) and libpcap >= 1.5.0 (e.g., Ubuntu Linux 14.04).
- Refer to `Issue 1551 <http://redmine.named-data.net/issues/1511>`_ for more
- detail and implementation progress.
+ Refer to :issue:`1551` for more details and implementation progress.
- **Management**
@@ -64,7 +63,6 @@
+ ``nfd-status``, a command-line tool to query NFD status.
+ ``nfd-status-http-server``, which reads the NFD status and publishes over HTTP.
-
Planned Functions and Features for Next Releases
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/docs/release-notes/release-notes-0.2.0.rst b/docs/release-notes/release-notes-0.2.0.rst
index a6df316..7a884e8 100644
--- a/docs/release-notes/release-notes-0.2.0.rst
+++ b/docs/release-notes/release-notes-0.2.0.rst
@@ -7,8 +7,8 @@
- **Documentation**
- + `"NFD Developer's Guide" by NFD authors
- <http://named-data.net/wp-content/uploads/2014/07/NFD-developer-guide.pdf>`_ that
+ + `"NFD Developer's Guide" by the NFD authors
+ <https://named-data.net/wp-content/uploads/2019/05/ndn-0023-2-nfd-developer-guide.pdf>`_ that
explains NFD's internals including the overall design, major modules, their
implementation, and their interactions
@@ -29,9 +29,9 @@
- **Faces**
- + `WebSocket <http://tools.ietf.org/html/rfc6455>`_ Face support (:issue:`1468`)
+ + `WebSocket <https://tools.ietf.org/html/rfc6455>`_ Face support (:issue:`1468`)
- + Fix Ethernet Face support on Linux with ``libpcap`` version >=1.5.0 (:issue:`1511`)
+ + Fix Ethernet Face support on Linux with ``libpcap`` version >= 1.5.0 (:issue:`1511`)
+ Fix to recognize IPv4-mapped IPv6 addresses in ``FaceUri`` (:issue:`1635`)
diff --git a/docs/release-notes/release-notes-0.3.0.rst b/docs/release-notes/release-notes-0.3.0.rst
index acc6c15..051931a 100644
--- a/docs/release-notes/release-notes-0.3.0.rst
+++ b/docs/release-notes/release-notes-0.3.0.rst
@@ -5,8 +5,8 @@
Changes since version 0.2.0:
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
- **Build**
@@ -89,11 +89,11 @@
- **Core**
- + New scheduler::ScopedEventId class to automatically handle scheduled event lifetime
+ + New ``scheduler::ScopedEventId`` class to automatically handle scheduled event lifetime
(:issue:`2295`)
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
- **Documentation**
@@ -107,23 +107,23 @@
+ Use implementations moved to ndn-cxx library
- + Use Signal from ndn-cxx (:issue:`2272`, :issue:`2300`)
+ + Use ``Signal`` from ndn-cxx (:issue:`2272`, :issue:`2300`)
- + use ethernet::Address from ndn-cxx (:issue:`2142`)
+ + use ``ethernet::Address`` from ndn-cxx (:issue:`2142`)
+ Use MAX_NDN_PACKET_SIZE constant from ndn-cxx (:issue:`2099`)
+ Use DEFAULT_INTEREST_LIFETIME from ndn-cxx (:issue:`2202`)
- + Use FaceUri from ndn-cxx (:issue:`2143`)
+ + Use ``FaceUri`` from ndn-cxx (:issue:`2143`)
- + Use DummyClientFace from ndn-cxx (:issue:`2186`)
+ + Use ``DummyClientFace`` from ndn-cxx (:issue:`2186`)
- + Use ndn::dns from ndn-cxx (:issue:`2207`)
+ + Use ``ndn::dns`` from ndn-cxx (:issue:`2207`)
- + Move Network class implementation from ``tools/`` to ``core/``
+ + Move ``Network`` class implementation from ``tools/`` to ``core/``
- + Ignore non-Ethernet ``AF_LINK`` addresses when enumerating NICs on OSX and other BSD systems
+ + Ignore non-Ethernet ``AF_LINK`` addresses when enumerating NICs on OS X and other BSD systems
+ Fix bug on not properly setting FreshnessPeriod inside SegmentPublisher (:issue:`2438`)
@@ -217,9 +217,10 @@
+ Ensure that ``ndn-autoconfig`` canonizes FaceUri before sending commands to NFD
(:issue:`2387`)
- + Refactored ndn-autoconfig implementation (:issue:`2421`)
+ + Refactored ``ndn-autoconfig`` implementation (:issue:`2421`)
- + ndn-autoconfig will now register also ``/localhop/nfd`` prefix towards the hub (:issue:`2416`)
+ + ``ndn-autoconfig`` will now register also ``/localhop/nfd`` prefix towards the hub
+ (:issue:`2416`)
- **Tests**
diff --git a/docs/release-notes/release-notes-0.3.1.rst b/docs/release-notes/release-notes-0.3.1.rst
index 59ecfce..45340cc 100644
--- a/docs/release-notes/release-notes-0.3.1.rst
+++ b/docs/release-notes/release-notes-0.3.1.rst
@@ -5,8 +5,8 @@
Changes since version 0.3.0:
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
- ``nfd`` and ``nrd`` daemons are now merged into a single process using separate threads
(:issue:`2489`)
@@ -32,16 +32,16 @@
- ContentStore now recognizes CachingPolicy-NoCache from LocalControlHeader (:issue:`2185`)
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
- **Faces**
- - Remove Tcp|UdpChannel::connect overloads that perform DNS resolution (:issue:`2422`)
+ - Remove ``Tcp|UdpChannel::connect`` overloads that perform DNS resolution (:issue:`2422`)
- - Properly handle error conditions in UdpChannel::newPeer (:issue:`2516`)
+ - Properly handle error conditions in ``UdpChannel::newPeer`` (:issue:`2516`)
- - Fix inconsistency of UDP face timeouts in sample `nfd.conf` and actual defaults
+ - Fix inconsistency between UDP face timeouts in sample ``nfd.conf`` and actual defaults
(:issue:`2473`)
- Introduce Face-specific logging macros (:issue:`2450`)
diff --git a/docs/release-notes/release-notes-0.3.2.rst b/docs/release-notes/release-notes-0.3.2.rst
index c785ccb..1506c3a 100644
--- a/docs/release-notes/release-notes-0.3.2.rst
+++ b/docs/release-notes/release-notes-0.3.2.rst
@@ -5,8 +5,8 @@
Changes since version 0.3.1:
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
- **Tables**
@@ -16,8 +16,8 @@
* Perform FIB updates before modifying RIB (:issue:`1941`)
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
- **Documentation**
@@ -30,7 +30,7 @@
* Refactor channel acceptors to avoid use of shared pointers (:issue:`2613`)
- * Refactor code to avoid deprecated `Block::fromBuffer` overloads (:issue:`2553`)
+ * Refactor code to avoid deprecated ``Block::fromBuffer`` overloads (:issue:`2553`)
* Refactor code to use move semantics for sockets where possible (:issue:`2613`)
@@ -48,7 +48,7 @@
- **Tools**
- * Fix hanging of `nfdc` on wrong input (:issue:`2690`)
+ * Fix hanging of ``nfdc`` on wrong input (:issue:`2690`)
- **Build**
@@ -62,7 +62,7 @@
* Use C version of snprintf (:issue:`2299`)
- * Emulate `std::to_string` when it is missing (:issue:`2299`)
+ * Emulate ``std::to_string`` when it is missing (:issue:`2299`)
* Fix several "defined but not used" warnings with gcc-5 (:issue:`2767`)
diff --git a/docs/release-notes/release-notes-0.3.3.rst b/docs/release-notes/release-notes-0.3.3.rst
index 25010c5..3aa3ea3 100644
--- a/docs/release-notes/release-notes-0.3.3.rst
+++ b/docs/release-notes/release-notes-0.3.3.rst
@@ -5,14 +5,14 @@
Changes since version 0.3.2:
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
- Content Store replacement policy interface (:issue:`1207`)
- Add unit file and instructions for systemd (:issue:`1586`)
-- NDN Essential Tools version 0.1 `<https://github.com/named-data/ndn-tools>`__ featuring:
+- NDN Essential Tools version 0.1 (https://github.com/named-data/ndn-tools) featuring:
* ``ndnpeek``, ``ndnpoke``: a pair of programs to request and make available for retrieval of
a single Data packet
@@ -22,23 +22,23 @@
either an input file or the standard input, and displays the Type-Length-Value (TLV)
structure of those packets on the standard output.
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
- Avoid loopback new Interest in AccessStrategy (:issue:`2831`)
- Simplified implementation of ``nfd-status`` using SegmentFetcher utility class (:issue:`2456`)
-Deprecated:
-^^^^^^^^^^^
+Deprecations
+^^^^^^^^^^^^
- ``ndn-tlv-peek`` and ``ndn-tlv-poke`` command-line tools: use ``ndnpeek`` and ``ndnpoke``
- programs from NDN Essential Tools repository `<https://github.com/named-data/ndn-tools>`__.
+ programs from the `NDN Essential Tools repository <https://github.com/named-data/ndn-tools>`__.
-Upcoming features:
-^^^^^^^^^^^^^^^^^^
+Upcoming features
+^^^^^^^^^^^^^^^^^
-- NDNLPv2 (http://redmine.named-data.net/projects/nfd/wiki/NDNLPv2, :issue:`2520`,
+- `NDNLPv2 <https://redmine.named-data.net/projects/nfd/wiki/NDNLPv2>`__ (:issue:`2520`,
:issue:`2879`, :issue:`2763`, :issue:`2883`, :issue:`2841`, :issue:`2866`)
- Refactored implementation of NFD management (:issue:`2200`, :issue:`2107`)
diff --git a/docs/release-notes/release-notes-0.3.4.rst b/docs/release-notes/release-notes-0.3.4.rst
index 822c4ff..62f56ba 100644
--- a/docs/release-notes/release-notes-0.3.4.rst
+++ b/docs/release-notes/release-notes-0.3.4.rst
@@ -5,10 +5,10 @@
Changes since version 0.3.3:
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
-- Boolean Face property IsOnDemand has been replaced with multistate FacePersistency
+- The boolean Face property ``IsOnDemand`` has been replaced with multistate FacePersistency
property (:issue:`2989`, :issue:`3018`): persistent (Face exists as long as there are no
system or socket errors), on-demand (Face is removed after inactivity period), and
permanent (Face exists unless explicitly destroyed by the management).
@@ -22,16 +22,8 @@
Currently, changing the policy requires a minor change in NFD source code.
Configuration interface is coming in the next release (:issue:`3148`)
-
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
-
-- Update of NDN Essential Tools to version 0.2 `<https://github.com/named-data/ndn-tools>`__
- with code improvements and the following new tools:
-
- * PIB service to manage the public information of keys and publish certificates
- (:issue:`3018`)
- * A Wireshark dissector for NDN packets (:issue:`3092`)
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
- RibManager constructor now accepts KeyChain as a parameter, preparing it for simplifying
implementation with the new ``ndn::Dispatcher`` class (:issue:`2390`)
@@ -41,18 +33,18 @@
- Enable automatic re-creation of multicast faces when network connectivity changes
(:issue:`2460`)
-- Enhance exception throwing with Boost Exception library (:issue:`2541`)
+- Enhance exception throwing with the Boost Exception library (:issue:`2541`)
-Deprecated:
-^^^^^^^^^^^
+Deprecations
+^^^^^^^^^^^^
-- BroadcastStrategy (``/localhost/nfd/strategy/broadcast``) renamed as MulticastStrategy
+- BroadcastStrategy (``/localhost/nfd/strategy/broadcast``) renamed to MulticastStrategy
(``/localhost/nfd/strategy/multicast``) (:issue:`3011`)
-Upcoming features (partially finished in development branches):
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Upcoming features (partially finished in development branches)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-- NDNLPv2 (http://redmine.named-data.net/projects/nfd/wiki/NDNLPv2, :issue:`2520`,
+- `NDNLPv2 <https://redmine.named-data.net/projects/nfd/wiki/NDNLPv2>`__ (:issue:`2520`,
:issue:`2879`, :issue:`2763`, :issue:`2883`, :issue:`2841`, :issue:`2866`)
- Refactored implementation of NFD management (:issue:`2200`, :issue:`2107`)
diff --git a/docs/release-notes/release-notes-0.4.0.rst b/docs/release-notes/release-notes-0.4.0.rst
index 725894e..9530cfb 100644
--- a/docs/release-notes/release-notes-0.4.0.rst
+++ b/docs/release-notes/release-notes-0.4.0.rst
@@ -8,8 +8,8 @@
Changes since version 0.3.4:
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
- **(breaking change)** Refactored implementation of face system (:issue:`3088`, :issue:`3104`,
:issue:`3165`, :issue:`3168`, :issue:`3225`, :issue:`3226`, :issue:`3253`, :issue:`3259`,
@@ -40,8 +40,8 @@
LocalControlHeader features, it must be updated to use the new protocol (e.g., update
to use ndn-cxx >= 0.4.0)
-- Support for NDNLPv2 (http://redmine.named-data.net/projects/nfd/wiki/NDNLPv2,
- :issue:`2520`, :issue:`2763`, :issue:`2841`)
+- Support for the following `NDNLPv2 <https://redmine.named-data.net/projects/nfd/wiki/NDNLPv2>`__
+ features (:issue:`2520`, :issue:`2763`, :issue:`2841`):
* Network NACK (:issue:`2883`)
* Fragmentation and reassembly (:issue:`3171`)
@@ -61,8 +61,8 @@
- Automatic start of NDN auto-configuration client (``ndn-autoconfig``) when starting NFD
using ``nfd-start``, when enabled in ``autoconfig.conf`` (:issue:`2716`)
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
- **(breaking change)** Redesign of automatic prefix propagation, formerly known as remote
prefix registration (:issue:`3211`, :issue:`2413`)
@@ -90,8 +90,8 @@
- Multiple test suite improvements (:issue:`3322`, :issue:`3306`, :issue:`3305`, :issue:`3307`,
:issue:`3346`, :issue:`3327`)
-Deprecated:
-^^^^^^^^^^^
+Deprecations
+^^^^^^^^^^^^
- BroadcastStrategy (``/localhost/nfd/strategy/broadcast``) renamed as MulticastStrategy
(``/localhost/nfd/strategy/multicast``) (:issue:`3011`)
@@ -99,13 +99,13 @@
- ForwarderStatus dataset retrievable using ``/localhost/nfd/status`` name, use
``/localhost/nfd/status/general`` instead.
-Deleted:
+Removals
^^^^^^^^
-- NotificationStream, replaced by the version in ndn-cxx library (:issue:`2144`)
+- ``NotificationStream``, replaced by the version in ndn-cxx library (:issue:`2144`)
-Known issues:
-^^^^^^^^^^^^^
+Known issues
+^^^^^^^^^^^^
- NFD currently has a known limitation in supporting the retrieval of data using full names,
i.e., names with the implicit digest (:issue:`3363`). This limitation will be addressed
diff --git a/docs/release-notes/release-notes-0.4.1.rst b/docs/release-notes/release-notes-0.4.1.rst
index a1e5f0c..c75afd0 100644
--- a/docs/release-notes/release-notes-0.4.1.rst
+++ b/docs/release-notes/release-notes-0.4.1.rst
@@ -5,8 +5,8 @@
Changes since version 0.4.0:
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
- Fix retrieval of data using full names, i.e., names with the implicit digest (:issue:`3363`)
@@ -23,9 +23,9 @@
- Remove assumption from the management test suites that data packets are always published
in NFD's content store (:issue:`2182`)
-Deleted:
+Removals
^^^^^^^^
- ``ndn-tlv-peek`` and ``ndn-tlv-poke`` command-line tools: use ``ndnpeek`` and ``ndnpoke``
- programs from `NDN Essential Tools repository <https://github.com/named-data/ndn-tools>`__
+ programs from the `NDN Essential Tools repository <https://github.com/named-data/ndn-tools>`__
(:issue:`2819`)
diff --git a/docs/release-notes/release-notes-0.5.0.rst b/docs/release-notes/release-notes-0.5.0.rst
index c1a8fb6..48eaf26 100644
--- a/docs/release-notes/release-notes-0.5.0.rst
+++ b/docs/release-notes/release-notes-0.5.0.rst
@@ -14,7 +14,7 @@
compiled on such systems, but requires separate installation of a newer version of the compiler
(e.g., clang-3.4) and dependencies.
-Changes since version 0.4.1
+Changes since version 0.4.1:
New features
^^^^^^^^^^^^
@@ -105,8 +105,8 @@
- ``StrategyInfoHost::getOrCreateStrategyInfo``, which is renamed to
``StrategyInfoHost::insertStrategyInfo`` (:issue:`3205`)
-Deletions
-^^^^^^^^^
+Removals
+^^^^^^^^
- Previously deprecated BroadcastStrategy (:issue:`3206`)
diff --git a/docs/release-notes/release-notes-0.5.1.rst b/docs/release-notes/release-notes-0.5.1.rst
index 795b2a6..33dff3e 100644
--- a/docs/release-notes/release-notes-0.5.1.rst
+++ b/docs/release-notes/release-notes-0.5.1.rst
@@ -3,7 +3,7 @@
Release date: January 25, 2017
-Changes since version 0.5.0
+Changes since version 0.5.0:
New features
^^^^^^^^^^^^
@@ -98,8 +98,8 @@
list`` and ``nfdc status report xml``. The argument-less ``nfd-status`` is retained as an
alias of ``nfdc status report`` (:issue:`3780`)
-Deletions
-^^^^^^^^^
+Removals
+^^^^^^^^
- Delete deprecated ``Strategy::sendInterest`` overload and ``violatesScope`` (:issue:`1756`,
:issue:`3841`)
diff --git a/docs/release-notes/release-notes-0.6.0.rst b/docs/release-notes/release-notes-0.6.0.rst
index 1c33eea..34e44e3 100644
--- a/docs/release-notes/release-notes-0.6.0.rst
+++ b/docs/release-notes/release-notes-0.6.0.rst
@@ -91,8 +91,8 @@
- Fix potential misaligned memory accesses (:issue:`4191`)
-Deletions
-^^^^^^^^^
+Removals
+^^^^^^^^
- Deprecated code, including ``faces/enable-local-control`` and ``faces/disable-local-control``
management commands (:issue:`3988`)
diff --git a/docs/release-notes/release-notes-0.6.1.rst b/docs/release-notes/release-notes-0.6.1.rst
index 9339172..7295b83 100644
--- a/docs/release-notes/release-notes-0.6.1.rst
+++ b/docs/release-notes/release-notes-0.6.1.rst
@@ -3,8 +3,8 @@
Release date: February 19, 2018
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
- (potentially breaking change) ``nfd-status-http-server`` now requires Python 3
diff --git a/docs/release-notes/release-notes-0.6.2.rst b/docs/release-notes/release-notes-0.6.2.rst
index 643b789..cab63d1 100644
--- a/docs/release-notes/release-notes-0.6.2.rst
+++ b/docs/release-notes/release-notes-0.6.2.rst
@@ -3,13 +3,8 @@
Release date: May 4, 2018
-Note that this is the last release that process packets with [NDN packet format version
-0.2.1](https://named-data.net/doc/NDN-packet-spec/0.2.1/) semantics. A future release will
-continue to decode v0.2.1 format, but will process packets with
-[v0.3](https://named-data.net/doc/NDN-packet-spec/0.3/) semantics.
-
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
- ``afterContentStoreHit``, ``afterReceiveData`` strategy trigger (:issue:`4290`)
@@ -41,7 +36,7 @@
- Upgrade build environment to latest version of ``waf`` and other improvements
-Removals:
-~~~~~~~~~
+Removals
+^^^^^^^^
- ``onInterestUnsatisfied`` pipeline stage (:issue:`4290`)
diff --git a/docs/release-notes/release-notes-0.6.6.rst b/docs/release-notes/release-notes-0.6.6.rst
index a328ac0..822a8d0 100644
--- a/docs/release-notes/release-notes-0.6.6.rst
+++ b/docs/release-notes/release-notes-0.6.6.rst
@@ -3,10 +3,10 @@
Release date: April 29, 2019
-Note that this is the last release that encodes to `NDN packet format version 0.2.1
-<https://named-data.net/doc/NDN-packet-spec/0.2.1/>`__. A future release will continue to
-decode v0.2.1 format, but will encode to `v0.3 format
-<https://named-data.net/doc/NDN-packet-spec/0.3/>`__.
+.. note::
+ This is the last release to support the `NDN packet format version 0.2.1
+ <https://named-data.net/doc/NDN-packet-spec/0.2.1/>`__. The next release will support
+ only the `v0.3 packet format <https://named-data.net/doc/NDN-packet-spec/0.3/>`__.
New features
^^^^^^^^^^^^