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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Remove outdated info from dmd manual #4194

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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: 4 additions & 115 deletions dcompiler.dd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,6 @@ $(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

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

$(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 +63,12 @@ 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

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 +241,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 +256,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 @@ -311,10 +284,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 @@ -342,7 +311,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 @@ -361,55 +330,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 @@ -419,10 +365,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 @@ -435,18 +377,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 @@ -460,10 +394,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 @@ -903,47 +833,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 -907 to -910
Copy link
Member

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

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.


$(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