Skip to content

Commit

Permalink
dylan-tool -> deft
Browse files Browse the repository at this point in the history
  • Loading branch information
cgay committed Apr 23, 2024
1 parent a4c5697 commit e6245bc
Show file tree
Hide file tree
Showing 15 changed files with 35 additions and 42 deletions.
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

0 comments on commit e6245bc

Please sign in to comment.