• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
HeaderDoc 8 resolveLinks questions
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

HeaderDoc 8 resolveLinks questions


  • Subject: HeaderDoc 8 resolveLinks questions
  • From: Bill Cheeseman <email@hidden>
  • Date: Wed, 14 Jul 2004 19:57:16 -0400

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.


  • Follow-Ups:
    • Re: HeaderDoc 8 resolveLinks questions
      • From: Brian Smith <email@hidden>
  • Prev by Date: syntax highlighting bug?
  • Next by Date: Re: How can I get the source code?
  • Previous by thread: Re: syntax highlighting bug?
  • Next by thread: Re: HeaderDoc 8 resolveLinks questions
  • Index(es):
    • Date
    • Thread