Opened 17 years ago

Closed 17 years ago

Last modified 16 years ago

#13274 closed defect (fixed)

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

Reported by: afb@… Owned by: markd@…
Priority: Normal Milestone:
Component: guide Version: 1.6.0
Keywords: Cc: afb@…, simon@…, boeyms@…, markd@…
Port:

Description

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."

Change History (7)

comment:1 Changed 17 years ago by nox@…

Cc: rhwood@… simon@… added

Adding the doc guys to Cc field.

comment:2 Changed 17 years ago by markd@…

Cc: afb@… boeyms@… markd@… added; rhwood@… removed

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?

comment:3 Changed 17 years ago by 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

comment:4 Changed 17 years ago by 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.

comment:5 Changed 17 years ago by afb@…

Resolution: fixed
Status: newclosed

Looks good to me.

comment:6 Changed 17 years ago by 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.

comment:7 Changed 16 years ago by (none)

Milestone: Website & Documentation

Milestone Website & Documentation deleted

Note: See TracTickets for help on using tickets.