I'm programming with Apple's Bonjour SDK for Windows, that contains dns_sd.h
. This file is full of documentation that seems to follow a fixed format. Some excerpts follow.
This is apparently Emacs syntax:
/* -*- Mode: C; tab-width: 4 -*-
*
* Copyright (c) 2003-2004, Apple Computer, Inc. All rights reserved.
...
This appears near the top:
/*! @header DNS Service Discovery
*
* @discussion This section describes the...
This is an abbreviated excerpt from function documentation:
/* DNSServiceEnumerateDomains() Parameters:
*
* sdRef: A pointer to an...
*
* flags: Possible values are:
* ...
So, my questions are:
- What format is Apple following here?
- Is there a tool like Doxygen that understands it and can generate a sane documentation set?
Thanks in advance.