From: Andre Noll <maan@tuebingen.mpg.de>
Date: Mon, 2 Jun 2025 22:35:37 +0000 (+0200)
Subject: .
X-Git-Url: https://git.tuebingen.mpg.de/?a=commitdiff_plain;h=21a5c0457e97c6dff0d6143f5749bf2701e99899;p=paraslash.git

.
---

diff --git a/sched.h b/sched.h
index 36391c4d..60c49cab 100644
--- a/sched.h
+++ b/sched.h
@@ -42,7 +42,8 @@ struct sched {
 
 struct task;
 
-/** \par Information that must be supplied by callers of \ref task_register().
+/**
+ * Information that must be supplied by callers of \ref task_register().
  *
  * The structure may be safely discarded after the task has been registered.
  */
diff --git a/web/documentation.in.html b/web/documentation.in.html
index e570c5f5..61239b8f 100644
--- a/web/documentation.in.html
+++ b/web/documentation.in.html
@@ -30,16 +30,15 @@
 
 <h2> Source code documentation </h2>
 
-<p> All public functions and variables are documented, but static functions,
-structures and macros defined in .c files are not. Most source files contain
-additional comments not shown here which describe particular implementation
-details. </p>
+<p> All public functions and variables are documented, but static functions
+and variables are not, Most source files contain additional comments not
+shown here which describe particular implementation details. </p>
 
 <h3> Subsystems </h3>
 
 <p> To get started in a particular subsystem, follow one of the links
-below. Each link points to a header file which defines the public API of a
-paraslash subsystem. This selection is not exhaustive, though. </p>
+below, each of which describes the public API of a particular paraslash
+subsystem. This selection is not exhaustive, though. </p>
 
 <p>
 	[<a href="doxygen/html/sched_8h.html">Scheduler</a>]
@@ -58,10 +57,10 @@ paraslash subsystem. This selection is not exhaustive, though. </p>
 <h3> Executables </h3>
 
 <p> The detailed description of each executable usually mentions relevant
-other object files which are linked into the executable. The comment of the
-main function talks about public functions defined elsewhere and called from
-this file. The comment also describes which tasks are created and registered
-to the paraslash scheduler. </p>
+other object files which are linked into the executable. The comment of
+the main function talks about public functions defined elsewhere and called
+from this file. The comment also describes the tasks which are created and
+registered to the paraslash scheduler. </p>
 
 <p>
 	[<a href="doxygen/html/server_8c.html">para_server</a>]