Opened 17 years ago

Closed 16 years ago

Last modified 15 years ago

#12854 closed defect (fixed)

InstallingMacPorts steps out of order, or confusing

Reported by: logicf@… Owned by: markd@…
Priority: Normal Milestone:
Component: guide Version: 1.5.0
Keywords: Cc: logicf@…, markd@…
Port:

Description

I'm a new user of MacPorts. Reading through InstallingMacPorts, step 3 "Set the shell enviornment" feels out of place.

Quoting InstallingMacPorts#RequirementsfortheMacPortsshellenvironment

The MacPorts binary installer places a .profile file in your home directory

It makes sense if the point of step 3 is for those who will be using the "Install From Source Method" shown in step 4.

After installation using the binary installer, the installed .profile shows:

# Your previous .profile (if any) is saved as .profile.mpsaved

Seems that either step 3 and 4 should be reversed, or step three broken into two parts with the second part after step 4. Either way, it might be best to let binary installer users know that they should either wait until after installing to complete step 3, or be aware that any changes they make will be moved out of the way and will need to be put back before continuing.

Change History (6)

comment:1 Changed 17 years ago by logicf@…

Might also be helpful to add /usr/X11R6/bin to the path when editing your .profile

comment:2 Changed 17 years ago by nox@…

Milestone: Website & Documentation

comment:3 Changed 17 years ago by jmpp@…

Component: infrastructureguide
Owner: changed from kvv@… to markd@…

Even though I believe the ticket was filed against the InstallingMacPorts wiki doc, I'll still assign it to Mark as the comments here may apply to the equivalent guide section.

-jmpp

comment:4 Changed 16 years ago by markd@…

Cc: logicf@… markd@… added

I agree that the steps are out of order. I think I have rectified that in the new guide, along with an ambiguity you pointed out that implied that a ~./profile was only created if MacPorts was installed with the OS X package, which isn't true.

So please look at this and see if it satisfies your concerns. http://geeklair.net/new_macports_guide/#installing

The install instructions on the Wiki will be discarded soon in favor of better information.

comment:5 Changed 16 years ago by markd@…

Resolution: fixed
Status: newclosed

comment:6 Changed 15 years ago by (none)

Milestone: Website & Documentation

Milestone Website & Documentation deleted

Note: See TracTickets for help on using tickets.