[Issue 2473] New: Linux system install instructions incorrect

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=2473

           Summary: Linux system install instructions incorrect
           Product: D
           Version: 1.036
          Platform: PC
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: www.digitalmars.com
        AssignedTo: bugzilla at digitalmars.com
        ReportedBy: wbaxter at gmail.com


The instructions here:
   http://www.digitalmars.com/d/2.0/dmd-linux.html
Say that you can do a system-wide install of dmd with the following
* copy dmd.conf to /etc/
* copy dmd to /usr/local/bin
* copy *.a to /usr/local/lib

However, if dmd.conf is in /etc, then dmd appears to search for files relative
to /etc when encountering %@P% rather than relative to the dmd binary.   So the
default -L-L%@P%/../lib in dmd.conf needs to be changed to
-L-L%@P%/../usr/local/lib (or just -L-L/usr/local/lib).

The path to the phobos src will also be wrong if dmd.conf is in /etc. The
instructions should probably say for a system install to do a "cp -r
dmd/src/phobos /usr/local/src"  Then dmd.conf should say
-I/usr/local/src/phobos

Instructions-wise probably the easiest thing is just to tell users to put
dmd.conf in /usr/local/bin instead of /etc.  Then the paths in dmd.conf don't
need to be changed (as long as you also copy src/phobos to /usr/local/src in
addition to following the other instructions).

If it's not acceptable to recommend putting dmd.conf in /usr/local/bin, then
the next best thing would be to bundle a dmd.system.conf with correct system
install paths, and instruct users to copy that one to /etc/dmd.conf instead of
the regular dmd.conf, when doing a system-wide install.


--