Skip to content

Incomplete documentation of the Posix build, install, and test #4097

Open
@dlangBugzillaToGithub

Description

@dlangBugzillaToGithub

Alan.W.Irwin1234 reported this on 2019-10-30T04:50:15Z

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

Description

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).

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions