Documentation that needs a small expansion

[KathyManwaring]

This issue relates to this page: ​http://docs.djangoproject.com/en/dev/topics/install/#installing-development-version

This has two references in file paths to 'pwd'. Unfortunately, being a newbie to Linux, I typed this exactly, including the quotes, as there was no note to change this to my actual environment. This meant that I had to delete the links and recreate them once I worked out what was actually meant.

It would be nice if a note was included to replace that with your working directory, like the note to change SITE-PACKAGES-DIR.

[stumbles]

The commands with pwd are intended to be run unmodified (pwd is a sub-command that prints the name of the directory you're in - a shortcut to save typing in this case).

This command relies on being run in the same directory that the "svn co" command was run in. My first instinct after checking out some files is to "cd" into the new directory and have a poke around. In this case the pwd shortcut wouldn't work for me. This is a neat shortcut, but perhaps it would be less troublesome to just spell out that the full path to the new "django-trunk/django" directory must be used.

[Adam Nelson]

pwd with the backticks should be interpreted by the command line and use the working directory (the directory you're in now). You must have manually copied the backquotes into tick marks - simply copying and pasting the command would have worked fine.

Or am I missing something?

[stumbles]

Adamnelson, you're correct, pasting should have worked fine. I think the patch is a useful change though, as people installing Django may not understand the significance of backticks or the shell command "pwd". Making this one-liner more explicit should hopefully reduce the chance of problems or at least give the person a better chance of figuring it out themselves.

[Adam Nelson]

In that case, can the patch keep the backticks but add a note explaining that backticks are interpreted by the shell and maybe link here:

​http://tldp.org/LDP/abs/html/commandsub.html

[stumbles]

I think using pwd is an unnecessary complication here. Better to just be explicit.

[Gabriel Hurley]

(In [14062]) Fixed #13279 -- Made the paths in the Unix install docs more explicit. Thanks to KathyManwaring for the report and stumbles for the patch.

[Gabriel Hurley]

(In [14063]) [1.2.X] Fixed #13279 -- Made the paths in the Unix install docs more explicit. Thanks to KathyManwaring for the report and stumbles for the patch.

Backport of [14062] from trunk.