views:

11

answers:

0

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.