[Issue 20337] New: Incomplete documentation of the Posix build, install, and test

[d-bugmail at puremagic.com]

https://issues.dlang.org/show_bug.cgi?id=20337

          Issue ID: 20337
           Summary: Incomplete documentation of the Posix build, install,
                    and test
           Product: D
           Version: D2
          Hardware: x86_64
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody at puremagic.com
          Reporter: Alan.W.Irwin1234 at gmail.com

The documentation at <https://wiki.dlang.org/Building_under_Posix> is
incomplete.   A minor issue is that page does not state the default target name
(which turns out to be "all" for dmd and phobos). A more major issue is that
wiki page says absolutely nothing about the "clean" (dmd, phobos, and druntime)
targets that must be built before the "all" (dmd and phobos) targets; the
"install" (dmd, phobos, and druntime) targets that can optionally be be built
after the "all" targets; and the test (dmd) and unittest(phobos) targets that
(optionally) can be built after the "install" targets.  N.B. the reason I
mention clean is I recently experienced bad installs (missing symbols, see the
discussion at <https://github.com/dlang/dmd/pull/10441/>) because of stale
build results from a previous build.  Anyhow, all these currently undocumented
targets and especially the order in which they should be built and for which
repositories should be of interest to any serious builder/installer/tester of
dmd and phobos.

A bash script to clone the needed repositories (when needed for the first build
or otherwise update the local repositories that exist because of those git
clone commands) and build all the correct targets in the correct order [is
provided here](http://airwin.users.sourceforge.net/dmd_git_build.sh.gz).

--