Earlier today I was trying to find out how to add comments to a bundle's manifest file. Was it going to be a semicolon? A number (hash) sign? Maybe a double slash?
It turns out the correct answer is "None of the above".
The OSGi bundle manifest file is a regular Java manifest file that follows Sun's Manifest format specification. According to that specification you can't add comments to the MANIFEST.MF file.
Sun has a bug that requests for support for comments in manifest files but it doesn't look like that is going to happen any time soon. Why o why didn't Sun include support for comments when they initially wrote the manifest format specification?