From: Andre Noll <maan@systemlinux.org>
Date: Fri, 3 Jan 2014 05:59:22 +0000 (+0000)
Subject: Overhaul doxygen main page.
X-Git-Tag: v0.5.2~6^2~11
X-Git-Url: http://git.tue.mpg.de/?a=commitdiff_plain;h=418050d3422358c01ea4a87a3a58d6e53fb69436;p=paraslash.git

Overhaul doxygen main page.

It got way too large, and contained quite a few links to .c files
whose doxygen page is not very interesting. For example, the doxygen
page of the .c files of filters, receivers and writers contain only
the init function since all other functions are static.

This commit limits the number of links on the main page considerably.
The new page tries to focus on important data structures and APIs
and does not strive for completeness.
---

diff --git a/server.c b/server.c
index a9e9495f..342946ab 100644
--- a/server.c
+++ b/server.c
@@ -6,62 +6,32 @@
 
 /** \file server.c Paraslash's main server. */
 
-
 /**
- * \mainpage Starting points for getting an overview:
+ * \mainpage Main data structures:
  *
- * 	- The main programs: \ref server.c, \ref audiod.c, \ref client.c,
- *	  \ref audioc.c, \ref afh.c, \ref play.c,
  *	- Server: \ref server_command, \ref sender,
- *	- Audio file selector: \ref audio_format_handler, \ref afs_table,
- *	- Client: \ref receiver, \ref receiver_node, \ref filter,
- *	  \ref filter_node, \ref writer_node.
- *
- *
- * The gory details, listed by topic:
+ *	- Audio file selector: \ref afs_info, \ref afs_table,
+ *	- Audio format handler: \ref audio_format_handler, \ref afh_info
+ *	- Receivers/filters/writers: \ref receiver, \ref receiver_node,
+ *	  \ref filter, \ref filter_node, \ref writer_node, \ref writer.
  *
- * 	- Audio format handlers: \ref send_common.c \ref mp3_afh.c,
- *	  \ref ogg_afh.c, \ref aac_afh.c, \ref wma_afh.c, \ref spx_afh.c
- * 	- Decoders: \ref mp3dec_filter.c, \ref oggdec_filter.c,
- *	  \ref aacdec_filter.c, \ref wmadec_filter.c, spxdec_filter.c,
- *	  \ref flacdec_filter.c,
- *	- Volume normalizer: \ref compress_filter.c,
- *	- Output: \ref alsa_write.c, \ref osx_write.c, \ref oss_write.c,
- * 	- http: \ref http_recv.c, \ref http_send.c,
- *	- udp: \ref udp_recv.c, \ref udp_send.c,
- *	- dccp: \ref dccp_recv.c, \ref dccp_send.c,
- *	- Audio file selector: \ref afs.c, \ref aft.c, \ref mood.c,
- *	- Afs structures: \ref afs_table, \ref audio_file_data,
- *	  \ref afs_info \ref afh_info,
- *	- Afs tables: \ref aft.c, \ref mood.c, \ref playlist.c,
- *	  \ref attribute.c, \ref score.c,
- *	- The virtual streaming system: \ref vss.c, \ref chunk_queue.c.
+ * Selected APIs:
  *
- * Lower levels:
- *
- *	- Scheduling: \ref sched.c, \ref sched.h,
- * 	- Networking: \ref net.c,
- *	- File descriptors: \ref fd.c,
- *	- Signals: \ref signal.c,
- *	- Daemons: \ref daemon.c,
- *	- Strings: \ref string.c, \ref string.h,
+ *	- Scheduling: \ref sched.h,
+ *	- Buffer trees: \ref buffer_tree.h,
+ *	- Sideband API: \ref sideband.h,
+ *	- Crypto: \ref crypt.h, \ref crypt_backend.h,
+ *	- Error subsystem: \ref error.h, \ref error2.c,
+ *	- Inter process communication: \ref ipc.h,
+ *	- Forward error correction: \ref fec.h,
+ *	- Daemons: \ref daemon.h,
+ *	- Mixer API: \ref mix.h,
+ *	- Interactive sessions: \ref interactive.h,
+ *	- File descriptors: \ref fd.h,
+ *	- Signals: \ref signal.h,
+ * 	- Networking: \ref net.h,
  *	- Time: \ref time.c,
- *	- Spawning processes: \ref exec.c,
- *	- Inter process communication: \ref ipc.c,
- *	- Blob tables: \ref blob.c,
- *	- The error subsystem: \ref error.h, \ref error2.c,
- *	- Access control for paraslash senders: \ref acl.c, \ref acl.h,
- *	- Internal crypto API: \ref crypt.h,
- *	- interactive sessions (libreadline): \ref interactive.c,
- *	- sideband API: \ref sideband.h.
- *
- * Low-level data structures:
- *
- *	- Doubly linked lists: \ref list.h,
- *	- Ring buffer: \ref ringbuffer.c, \ref ringbuffer.h,
- *	- openssl: \ref crypt.c
- *	- libgcrypt: \ref gcrypt.c
- *	- Forward error correction: \ref fec.c.
+ *	- Doubly linked lists: \ref list.h.
  */
 
 #include <signal.h>