Skip to content
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.

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

dylan-tool -> deft #1579

Merged
merged 1 commit into from
Apr 24, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
6 changes: 3 additions & 3 deletions .gitmodules
Original file line number Diff line number Diff line change
Expand Up @@ -31,9 +31,9 @@
[submodule "sources/lib/meta"]
path = sources/lib/meta
url = https://github.com/dylan-lang/meta.git
[submodule "sources/app/dylan-tool"]
path = sources/app/dylan-tool
url = https://github.com/dylan-lang/dylan-tool
[submodule "documentation/website"]
path = documentation/website
url = https://github.com/dylan-lang/website
[submodule "sources/app/deft"]
path = sources/app/deft
url = https://github.com/dylan-lang/deft
5 changes: 3 additions & 2 deletions Makefile.in
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ BOOTSTRAP_3_ROOT = $(abs_builddir)/Bootstrap.3
BOOTSTRAP_3_LIBRARIES = \
dylan-compiler dylan-environment parser-compiler dswank
BOOTSTRAP_3_STATICS = \
dylan-tool-app
deft-app

BOOTSTRAP_3_COMPILER = \
$(BOOTSTRAP_2_ROOT)/bin/dylan-compiler \
Expand Down Expand Up @@ -348,7 +348,8 @@ dist: 3-stage-bootstrap
rm -rf release/opendylan-$(version)/sources/bootstrap1-registry
cp -R Bootstrap.3/bin release/opendylan-$(version)/
cp -R Bootstrap.3/sbin/* release/opendylan-$(version)/bin
ln -s dylan-tool-app release/opendylan-$(version)/bin/dylan
ln -s deft-app release/opendylan-$(version)/bin/deft
ln -s deft-app release/opendylan-$(version)/bin/dylan # ease transition to "deft"
cp -R Bootstrap.3/databases release/opendylan-$(version)/
-cp -R Bootstrap.3/include/opendylan release/opendylan-$(version)/include
cp -R Bootstrap.3/lib release/opendylan-$(version)/
Expand Down
16 changes: 8 additions & 8 deletions build/windows/Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -302,7 +302,7 @@ SIMPLE_DAYTIME_CLIENT_SOURCE = $(NETWORK_EXAMPLES_SOURCE)\simple-daytime-client
SIMPLE_DAYTIME_CLIENT_INSTALL_DIRECTORY = $(NETWORK_EXAMPLES_INSTALL_DIRECTORY)\simple-daytime-client
SIMPLE_DAYTIME_SERVER_SOURCE = $(NETWORK_EXAMPLES_SOURCE)\simple-daytime-server
SIMPLE_DAYTIME_SERVER_INSTALL_DIRECTORY = $(NETWORK_EXAMPLES_INSTALL_DIRECTORY)\simple-daytime-server
DYLAN_TOOL_SOURCE = $(APP_DIRECTORY)\dylan-tool
DEFT_SOURCE = $(APP_DIRECTORY)\deft

#
# CORBA projects
Expand Down Expand Up @@ -380,7 +380,7 @@ PARSER_COMPILER = $(INSTALL_BIN_DIRECTORY)\parser-compiler.exe
TESTWORKS_REPORT = $(INSTALL_BIN_DIRECTORY)\testworks-report.exe
WIN32_ENVIRONMENT = $(INSTALL_BIN_DIRECTORY)\win32-environment.exe
WITH_SPLASH_SCREEN = $(INSTALL_BIN_DIRECTORY)\with-splash-screen.exe
DYLAN_TOOL_APP = $(INSTALL_BIN_DIRECTORY)\dylan-tool-app.exe
DEFT_APP = $(INSTALL_BIN_DIRECTORY)\deft-app.exe

BIG_INTEGERS_DLL = $(RUNTIME_PREFIX)bigint
CHANNELS_DLL = $(RUNTIME_PREFIX)chnnls
Expand Down Expand Up @@ -753,7 +753,7 @@ devel-dbg-ui: $(DEVEL_DBG_UI)
dll-wrap: $(DLL_WRAP)
parser-compiler: $(PARSER_COMPILER)
testworks-report: $(TESTWORKS_REPORT)
dylan-tool-app: $(DYLAN_TOOL_APP)
deft-app: $(DEFT_APP)

project-manager-libraries: tools-interface user-projects
core-compiler-libraries: file-source-records release-info dood binary-manager coff-manager binary-builder coff-builder build-system parser-run-time dfmc-management dfmc-browser-support project-manager-libraries dfmc-debug-back-end
Expand Down Expand Up @@ -1070,7 +1070,7 @@ rel-environment: dylan-environment win32-environment with-splash-screen
libraries: user-libraries win32-libraries duim ole-libraries duim-ole database-libraries network dylan-orb naming-client midi
example-projects: console-example-projects duim-example-projects win32-example-projects ole-example-projects duim-ole-example-projects network-example-projects corba-example-projects
install-examples: install-examples-css install-console-examples install-duim-examples install-win32-examples install-basic-doc-examples install-templates install-database-examples install-ole-examples install-duim-ole-examples install-network-examples install-corba-examples install-enhanced-doc-examples install-midi-examples
tools: install-wdbgdylan dll-wrap dylan-playground gui-dylan-playground create-id console-scepter naming-service remote-debugger testworks-libraries debugger parser-compiler dylan-tool-app
tools: install-wdbgdylan dll-wrap dylan-playground gui-dylan-playground create-id console-scepter naming-service remote-debugger testworks-libraries debugger parser-compiler deft-app
release: release-info dylan-compiler compiler environment rel-environment libraries tools install-runtime-dlls install-examples

reinstall-examples:
Expand Down Expand Up @@ -1991,14 +1991,14 @@ $(TESTWORKS_REPORT):
$(ENSURE_SOURCES) testworks-report $(TESTWORKS_REPORT_SOURCE)
$(BUILD_APPLICATION) testworks-report

$(DYLAN_TOOL_APP):
$(DEFT_APP):
$(ENSURE_RUNTIME_LIBRARY) $(COMMON_DYLAN_DLL) common-dylan
$(ENSURE_RUNTIME_LIBRARY) $(IO_DLL) io
$(ENSURE_RUNTIME_LIBRARY) $(SYSTEM_DLL) system
$(ENSURE_RUNTIME_LIBRARY) $(STRINGS_DLL) strings
$(ENSURE_SOURCES) dylan-tool $(DYLAN_TOOL_SOURCE)
$(BUILD_APPLICATION) dylan-tool-app
$(COPY) $(DYLAN_TOOL_APP) $(INSTALL_BIN_DIRECTORY)\dylan.exe
$(ENSURE_SOURCES) deft $(DEFT_SOURCE)
$(BUILD_APPLICATION) deft-app
$(COPY) $(DEFT_APP) $(INSTALL_BIN_DIRECTORY)\deft.exe

# Test Suites

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,21 +29,21 @@ Setting `OPEN_DYLAN_USER_REGISTRIES
that's how DIME finds your projects. Above we set it to the dime-test registry
that is created in the example below.

For this tutorial let's use a "dime-test" project created with the
:program:`dylan` tool. Create the project with ::
For this tutorial let's use a "dime-test" project created with :program:`deft`.
Create the project with ::

$ dylan new application dime-test
$ deft new application dime-test

which creates a library named "dime-test" and a corresponding executable
library and test suite, as well as downloading dependencies and creating
registry files. See the `dylan new application
<https://opendylan.org/package/dylan-tool/index.html#dylan-new-application>`_
registry files. See the `deft new application
<https://opendylan.org/package/deft/index.html#deft-new-application>`_
command for more.

**Start dime:** ::

$ export PATH=/opt/opendylan/bin:$PATH
$ cd dime-test # Created by dylan new application, above.
$ cd dime-test # Created by deft new application, above.
$ emacs dime-test-app.dylan
M-x dime <Enter>

Expand Down
26 changes: 9 additions & 17 deletions documentation/getting-started-cli/source/hello-world.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,24 +6,24 @@ how do you write the canonical Hello World app? This example assumes the
``bash`` shell is used. You may need to adjust for your local shell. ::

$ export PATH=/opt/opendylan/bin:$PATH
$ dylan new application --simple hello-world
$ deft new application --simple hello-world
$ cd hello-world
$ dylan build --all
$ deft build --all
...lots of output...
$ _build/bin/hello-world
Hello, world!

Ta da! Now a quick review of the steps with a little bit of explanation.

First you must set ``PATH`` so that the :program:`dylan` and
First you must set ``PATH`` so that the :program:`deft` and
:program:`dylan-compiler` executables will be found. ``./_build/bin`` is where
:program:`dylan-compiler` puts the executables it builds.

.. note:: Some of these differ on Windows, so please be sure
to read :doc:`windows` if you are on Windows.
:class: alert alert-block alert-warning

``dylan new application --simple hello-world`` creates a directory named
``deft new application --simple hello-world`` creates a directory named
"hello-world", and several files. The ``--simple`` flag says to skip generating
a test suite library and instead of a separate ``hello-world`` library and
``hello-world-app`` executable library to just make one ``hello-world``
Expand All @@ -42,27 +42,19 @@ executable library.
library.

4. The :file:`registry` directory is how :program:`dylan-compiler` locates each
used library. When using the :program:`dylan` tool, this directory is
generated for you. See :doc:`source-registries` for details on the registry
format.
used library. :program:`deft` generates this directory for you. See
:doc:`source-registries` for details on the registry format.

5. :file:`dylan-package.json` describes the new "hello-world" package. This is
where you can specify dependencies, the package location, etc. See the
`dylan tool documentation
<https://opendylan.org/package/dylan-tool/index.html>`_ for more on
where you can specify dependencies, the package location, etc. See the `deft
documentation <https://opendylan.org/package/deft/index.html>`_ for more on
this. Note that the existence of this file turns the "hello-world" directory
into a :program:`dylan` workspace.
into a :program:`deft` workspace.

The first time you build your project all used libraries are built, all the
way down to the ``dylan`` library itself. Subsequent builds only need to
recompile ``hello-world`` itself and are therefore much faster.

.. note:: Don't confuse the ``dylan`` library with the :program:`dylan`
executable program. The ``dylan`` library contains the core Dylan
language features that are not implemented inside the compiler. The
``dylan`` program is a tool to help manage Dylan projects and is
created from a library called ``dylan-tool``.

The compiler places its output in the ``_build`` directory in the current
working directory. This includes the libraries and executables that it builds.
You can run the executable from this location, as noted above.
2 changes: 1 addition & 1 deletion dylan-package.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
"dependencies": [
"[email protected]",
"[email protected]",
"dylan-tool@0.11",
"deft@0.12",
"[email protected]",
"[email protected]",
"[email protected]",
Expand Down
1 change: 1 addition & 0 deletions sources/app/deft
Submodule deft added at 86583a
1 change: 0 additions & 1 deletion sources/app/dylan-tool
Submodule dylan-tool deleted from e2fcc4
1 change: 1 addition & 0 deletions sources/registry/generic/deft
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
abstract://dylan/app/deft/sources/deft.lid
1 change: 1 addition & 0 deletions sources/registry/generic/deft-app
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
abstract://dylan/app/deft/sources/deft-app.lid
1 change: 1 addition & 0 deletions sources/registry/generic/deft-test-suite
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
abstract://dylan/app/deft/sources/test-suite.lid
1 change: 0 additions & 1 deletion sources/registry/generic/dylan-tool

This file was deleted.

1 change: 0 additions & 1 deletion sources/registry/generic/dylan-tool-app

This file was deleted.

1 change: 0 additions & 1 deletion sources/registry/generic/dylan-tool-test-suite

This file was deleted.

2 changes: 1 addition & 1 deletion sources/registry/generic/uncommon-dylan
Original file line number Diff line number Diff line change
@@ -1 +1 @@
abstract://dylan/app/dylan-tool/ext/uncommon-dylan/uncommon-dylan.lid
abstract://dylan/app/deft/ext/uncommon-dylan/uncommon-dylan.lid