Skip to content

Remove outdated info from dmd manual #4194

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dkorpel merged 2 commits into from
Dec 11, 2025
Merged

Remove outdated info from dmd manual #4194

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2a904d1
Remove outdated info from dmd manual
dkorpel Mar 21, 2025
060d825
Fix parens
dkorpel Dec 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
119 changes: 5 additions & 114 deletions dcompiler.dd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,13 +27,8 @@ $(H2 $(LNAME2 requirements, Requirements and Downloads))

$(WINDOWS
$(LI Windows operating system, Windows 7 or later, 32 or 64 bit)

$(LI Download
<a href="http://ftp.digitalmars.com/dmc.zip" title="download dmc.zip">
dmc.zip (C and C++ compiler)</a> for Win32
(not required, but it complements dmd for Windows)
)
)
Copy link
Contributor

@thewilsonator thewilsonator Mar 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this last one you want to keep

Copy link
Contributor Author

@dkorpel dkorpel Dec 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks


$(LINUX
$(LI 32 bit x86 and 64 bit x86-64 Linux operating system
($(LINK2 https://github.com/ldc-developers/ldc, LDC)
Expand Down Expand Up @@ -69,16 +64,13 @@ performs these steps automatically.
Unzip the files in the root directory.
$(D dmd.zip) will create
a $(D $(DMDDIR)) directory with all the files in it.
$(D dmc.zip) will create
a $(D \dm) directory with all the files in it.
)
Copy link
Contributor

@thewilsonator thewilsonator Mar 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ditto


$(P A typical session might look like:)

$(CONSOLE
C:\Documents and Settings\Your Name&gt;cd \
C:\\&gt;unzip dmd.zip
C:\\&gt;unzip dmc.zip
)
)
$(LINUX
Expand Down Expand Up @@ -251,19 +243,6 @@ sudo cp $(DMDDIR)/{phobos/std,phobos/etc,druntime/import} /usr/include/d/dmd
))
)

$(WINDOWS
$(H2 $(H2 $(LNAME2 example, Example)))

$(P Run:)

$(CONSOLE
$(DMDDIR)$(SEP)$(OS)$(SEP)bin$(SEP)$(SHELL) all.sh
)

$(P in the $(D $(DMDDIR)$(SEP)samples$(SEP)d) directory for several small examples.)
)


$(H2 $(LNAME2 switches, Compiler Arguments and Switches))

$(DL
Expand All @@ -279,10 +258,6 @@ $(H2 $(LNAME2 switches, Compiler Arguments and Switches))
$(TH File Type)
)
$(TR
$(TD $(I none))
$(TD D source files)
)
$(TR
$(TD $(B .c))
$(TD C source files)
)
Expand Down Expand Up @@ -315,10 +290,6 @@ $(H2 $(LNAME2 switches, Compiler Arguments and Switches))
$(TD Object code libraries to search)
)
$(WINDOWS
$(TR
$(TD $(B .exe))
$(TD Output executable file)
)
$(TR
$(TD $(B .def))
$(TD $(LINK2 http://www.digitalmars.com/ctg/ctgDefFiles.html, module definition file))
Expand Down Expand Up @@ -346,7 +317,7 @@ $(WINDOWS
)

$(WINDOWS
$(P Empty switches, i.e. "", are ignored.)
$(P Empty command line arguments, i.e. "", are ignored.)
)

$(H2 $(LNAME2 files, Files))
Expand All @@ -365,55 +336,32 @@ $(H2 $(LNAME2 files, Files))
$(DD Documentation)
)

$(DT $(D $(DMDDIR)$(SEP)samples$(SEP)d$(SEP))
$(DD Sample D programs)
)
$(WINDOWS

$(DT $(D $(DMDDIR)\windows\bin\ddemangle.exe)
$(DD D symbol demangler)
)

$(DT $(D $(DMDDIR)\windows\bin\dman.exe)
$(DD D manual lookup tool)
)

$(DT $(D $(DMDDIR)\windows\bin\dmd.exe)
$(DD D compiler executable)
)

$(DT $(D $(DMDDIR)\windows\bin\$(DUB))
$(DT $(D $(DMDDIR)\windows\bin\dub.exe)
$(DD D's package manager)
)

$(DT $(D $(DMDDIR)\windows\bin\$(DUSTMITE))
$(DT $(D $(DMDDIR)\windows\bin\dustmite.exe)
$(DD D source code minimizer)
)

$(DT $(D $(DMDDIR)\windows\bin\$(OPTLINK))
$(DD OPTLINK)
)

$(DT $(D $(DMDDIR)\windows\bin\$(LINK2 http://www.digitalmars.com/ctg/make.html, make.exe))
$(DD Digitalmars Make)
)

$(DT $(D $(DMDDIR)\windows\bin\replace.exe)
$(DD Find/replace text in files)
)

$(DT $(D $(DMDDIR)\windows\bin\$(RDMD))
$(DT $(D $(DMDDIR)\windows\bin\rdmd.exe)
$(DD D build tool for script-like D code execution)
)

$(DT $(D $(SC_INI))
$(DD Global compiler settings)
)

$(DT $(D $(DMDDIR)\windows\bin\$(LINK2 http://www.digitalmars.com/ctg/shell.html, shell.exe))
$(DD Simple command line shell)
)

$(DT $(D $(DMDDIR)\windows\lib\$(LIB))
$(DD D runtime library)
)
Expand All @@ -423,10 +371,6 @@ $(H2 $(LNAME2 files, Files))
$(DD D symbol demangler)
)

$(DT $(D $(DMDDIR)/linux/bin/dman)
$(DD D manual lookup tool)
)

$(DT $(D $(DMDDIR)/linux/bin/dmd)
$(DD D compiler executable)
)
Expand All @@ -439,18 +383,10 @@ $(H2 $(LNAME2 files, Files))
$(DD D's package manager)
)

$(DT $(D $(DMDDIR)/linux/bin/$(DUMPOBJ))
$(DD ELF file dumper)
)

$(DT $(D $(DMDDIR)/linux/bin/$(DUSTMITE))
$(DD D source code minimizer)
)

$(DT $(D $(DMDDIR)/linux/bin/$(OBJ2ASM))
$(DD ELF file disassembler)
)

$(DT $(D $(DMDDIR)/linux/bin/$(RDMD))
$(DD D build tool for script-like D code execution)
)
Expand All @@ -464,10 +400,6 @@ $(H2 $(LNAME2 files, Files))
$(DD D symbol demangler)
)

$(DT $(D $(DMDDIR)/freebsd/bin/dman)
$(DD D manual lookup tool)
)

$(DT $(D $(DMDDIR)/freebsd/bin/dmd)
$(DD D compiler executable)
)
Expand Down Expand Up @@ -907,47 +839,6 @@ dmd -lib foo.d bar.d abc.$(OBJEXT) def.$(LIBEXT)
up the modules.
)
)

$(H2 $(LEGACY_LNAME2 compiling_dmd, compiling-dmd, Compiling dmd))

$(P Complete source code is provided to build the compiler.
Follow these steps:)
Comment on lines -911 to -914
Copy link
Member

@0xEAB 0xEAB Mar 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn’t we keep at least some of that? Maybe replace it with a link to a Windows build of GNU Make (as in the Makefile itself) and note that building is as easy as running make from a Phobos directory that sits next to the dmd directory.

Copy link
Member

@0xEAB 0xEAB Mar 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

make unittest and make unittest-debug might also be noteworthy mentions.

Copy link
Contributor Author

@dkorpel dkorpel Dec 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Build instructions are in the contributor guides and in the readme of the relevant repositories. I think it's best to keep pages focused on one thing, so contributors don't land on a suboptimal page when Googling build instructions (like what happened with Google Summer of Code).


$(WINDOWS
$(CONSOLE
cd $(DMDDIR)\src\dmd
make -f win32.mak
)
)
$(UNIX
$(CONSOLE
cd ~/$(DMDDIR)/src/dmd
make -f posix.mak
)
)

$(H2 $(LEGACY_LNAME2 compiling_phobos, compiling-phobos, Compiling Phobos))

$(P Complete source code is provided to build Phobos, the D runtime library.
Follow these steps:)


$(WINDOWS
$(CONSOLE
cd $(DMDDIR)\src\druntime
make -f win32.mak
cd ..\phobos
make -f win32.mak
)
)
$(UNIX
$(CONSOLE
cd ../phobos
make -f posix.mak
)
)


)

Macros:
Expand Down