Re: HeaderDoc 8 resolveLinks questions
Re: HeaderDoc 8 resolveLinks questions
- Subject: Re: HeaderDoc 8 resolveLinks questions
- From: Brian Smith <email@hidden>
- Date: Thu, 15 Jul 2004 11:25:18 -0600
I don't have any specific answers to you questions, but, since
HeaderDoc is some perl scripts, you may find some answers on the
perl.org site. The file names problem you see with spaces may be a
perl limitation and the resolveLinks tool is most likely a perl module
which you may find documentation for on perl.org. In the source
distribution, there is a folder that has the modules that HeaderDoc
uses, so you can check for information there. (I'm not sure where they
get install.) Hope this helps.
Brian
On 14 Jul, 2004, at 5:57 PM, Bill Cheeseman wrote:
Trying again here since I didn't get a response on HeaderDoc-dev
(which I
imagine is only lightly populated):
Two questions:
1. The HeaderDoc 8 @link tag apparently generates absolute links in the
resulting HTML file. As a result, if a user changes the name of the
enclosing folder after documentation is generated, all links in the
documentation stop working. This makes generated HeaderDoc
documentation
very fragile if it is distributed separately, outside of an
application or
framework bundle.
Moving the enclosing folder doesn't cause any problems. Links keep
working.
2. The HeaderDoc 8 gatherHeaderDoc script fails if the name of the
directory
to be gathered includes a space. No amount of quoting or escaping
solves
this problem. The error message implicates the resolveLinks tool,
saying
that it failed.
Is there a cure for either of these issues? Am I misunderstanding
something?
The HeaderDoc documentation says link generation is handled by a
separate
tool, resolveLinks, but I don't see any documentation for it that
would help
me understand this.
--
Bill Cheeseman - email@hidden
Quechee Software, Quechee, Vermont, USA
http://www.quecheesoftware.com
The AppleScript Sourcebook - http://www.AppleScriptSourcebook.com
Vermont Recipes - http://www.stepwise.com/Articles/VermontRecipes
_______________________________________________
xcode-users mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/xcode-users
Do not post admin requests to the list. They will be ignored.
_______________________________________________
xcode-users mailing list | email@hidden
Help/Unsubscribe/Archives: http://www.lists.apple.com/mailman/listinfo/xcode-users
Do not post admin requests to the list. They will be ignored.