update guide's X11 requirements (headers needed if libraries present)

[afb@…]

If user has X11User (runtime) installed, but not X11SDK (developer), an error shows:

configure: error: Broken X11 install. No X11 headers

The code (configure) says: "If the libraries are present, so must the headers be."

[nox@…]

Adding the doc guys to Cc field.

[markd@…]

From  http://geeklair.net/new_macports_guide/#installing.x11 it says:

"NOTE

X11 and the X11SDK (from Xcode Tools) are both required for X11 apps. To verify the presence of both, check for files X11User.pkg and X11SDK.pkg in /Library/Receipts/."

Have you seen that?

[afb@…]

Apparently it can be missed... Maybe we should just make it more redundant:

X11 and the X11 SDK (from Xcode Tools) are both required for X11 apps. If the X11 libraries (User) are present, so must the X11 headers (SDK) be. To verify the presence of both, check for files X11User.pkg and X11SDK.pkg in /Library/Receipts/.

Note that on Leopard, the package receipts are split into boms and pkg db now:

/Library/Receipts/boms/com.apple.pkg.X11User.bom
/Library/Receipts/boms/com.apple.pkg.X11SDKLeo.bom
/Library/Receipts/boms/com.apple.pkg.X11DocumentationLeo.bom
/Library/Receipts/db/a.receiptdb

[markd@…]

Anything can be missed. But instructions for installing X11SDK is already redundant because it is an explicit step in the Installing Xcode Tools step:

"Click the button Customize, expand the Applications category and click the check box beside X11 SDK to add it to the default items."

So X11 is an explicit step, X11SDK is also, and there is the note explaining they both must be present. I'm sure the instructions can be improved upon, and I am open to suggestions, but I don't see how the added sentence makes it better.

Also, I didn't realize that Apple changed the receipts for Leopard. I modified the docs to try to accommodate that (r31069). Thanks for pointing it out.

[afb@…]

Looks good to me.

[markd@…]

Also, I reordered the steps afterwards so installing X11 comes first. Someone on the list confirmed that X11SDK won't install without X11, which I didn't know or forgot. But I left in the verbage telling users to manually select X11 (even though default on 10.5) and X11SDK (though it is installed automatically if X11 present) to keep it as compatible across OS version as possible and make it obvious that you need both. Also, I didn't want to rely on automatic things to work right.

[anonymous]

Milestone Website & Documentation deleted