Opened 17 years ago

Last modified 17 years ago

#5626 closed

Mac OS X permissions command could be more succinct. — at Version 7

Reported by: blinks@… Owned by: Matt Boersma
Component: Documentation Version: dev
Severity: Keywords: terminal Mac OS X
Cc: Triage Stage: Design decision needed
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description (last modified by Matt Boersma)

In the Mac OSX Permissions box (at the top of Creating a Project), there is some text suggesting a possible permissions solution:

... To do this, open Terminal.app and navigate (using the cd command) to the directory where django-admin.py is installed, then run the command chmod +x django-admin.py.

This line could be made quicker and easier by replacing "and navigate... ." with "and run the command chmod +x `which django-admin.py`." This removes the work involved in locating the installation directory, making it a little less painless, and makes the fix a one-step process. It will also guarantee that the correct django-admin.py is modified.

Possible problem: Backticks can be difficult to recognize in some fonts, but monospace fonts usually show them correctly. The user will most likely copy and paste the command anyway, making this issue moot.

Change History (8)

by Matt Boersma, 17 years ago

Attachment: 5626.diff added

Fixes typo, shortens command to make django-admin.py executable

comment:1 by Matt Boersma, 17 years ago

Has patch: set
Keywords: Mac OS X added
Owner: changed from nobody to Matt Boersma
Status: newassigned
Triage Stage: UnreviewedReady for checkin

comment:2 by Matt Boersma, 17 years ago

Summary: Mac OSX Permissions, command could be more succinct.Mac OS X typo, permissions command could be more succinct.

comment:3 by James Bennett, 17 years ago

Triage Stage: Ready for checkinDesign decision needed

Using which assumes the user has successfully gotten django/bin into the PATH, which isn't necessarily a safe assumption.

in reply to:  3 comment:4 by anonymous, 17 years ago

Replying to ubernostrum:

Using which assumes the user has successfully gotten django/bin into the PATH, which isn't necessarily a safe assumption.

It is if they followed the previous instructions: python setup.py install places scripts in the path on OSX. However, even if they hadn't, the pull-out assumes that they have. (The first sentence ends with "... when you try to run django-admin.py startproject," which doesn't tell them where that script might be, if they don't already know.) It also doesn't help the user find that directory (django/bin), which could be difficult if it's installed into some random site-packages directory.

comment:5 by Matt Boersma, 17 years ago

The tutorial context already implies django-admin.py is on the search PATH. If that's not a safe assumption, more of the tutorial needs to be changed. Otherwise, this patch seems sane to me. Let's fix the "Max OS X" typo at least.

comment:6 by Matt Boersma, 17 years ago

(In [6535]) Fixed #5633, refs #5626: Change "Max OS X" to "Mac OS X" in tutorial01.

comment:7 by Matt Boersma, 17 years ago

Description: modified (diff)
Summary: Mac OS X typo, permissions command could be more succinct.Mac OS X permissions command could be more succinct.

This was really two bugs if we're being pedantic, so I fixed the "Max OS X" typo separately and changed the description to focus on the "chmod +x which django-admin.py" issue.

Note: See TracTickets for help on using tickets.
Back to Top