diff --git a/core/random.hpp b/core/random.hpp
index 03ae9d3..27e1067 100644
--- a/core/random.hpp
+++ b/core/random.hpp
@@ -1,6 +1,6 @@
 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
-/**
- * Copyright (c) 2014-2016,  Regents of the University of California,
+/*
+ * Copyright (c) 2014-2017,  Regents of the University of California,
  *                           Arizona Board of Regents,
  *                           Colorado State University,
  *                           University Pierre & Marie Curie, Sorbonne University,
@@ -24,14 +24,15 @@
  */
 
 /**
- * This file declares the global pseudorandom number generator (PRNG).
+ * \file
+ * \brief Declares the global pseudorandom number generator (PRNG) for NFD
  *
  * All random numbers generated by NFD should use this global generator,
  * so that it can be properly seeded when necessary.
  *
- * This PRNG is not suitable for security purposes; security-critical
- * code must use a cryptographically secure PRNG, such as those provided
- * by OpenSSL and Crypto++.
+ * \warning This PRNG is not suitable for security purposes; security-critical
+ *          code must use a cryptographically secure PRNG, such as that provided
+ *          by OpenSSL.
  */
 
 #ifndef NFD_CORE_RANDOM_HPP