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

Update README.md #2421

Merged
merged 3 commits into from
Jan 31, 2018
Merged

Update README.md #2421

merged 3 commits into from
Jan 31, 2018

Conversation

jmh530
Copy link
Contributor

@jmh530 jmh530 commented Nov 21, 2017

Addressing discussion on the forum, that the repositories may not be the best option if you need the latest version of LDC (i.e., bringing the emphasis first to the stand-alone binaries).

[GitHub release page](https://github.com/ldc-developers/ldc/releases).

In addition, some package managers include recent (but not necessarily the
latest) versions of LDC, so manually installing it might not be necessary.

| | Command |
| ------------ | --------------------- |
| Arch Linux | `pacman -S ldc` |
Copy link
Contributor

Choose a reason for hiding this comment

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

While you're at it, you may as well mention the snap package:

sudo snap install --classic --channel=edge ldc

(Though it seems a little out of date - the latest available ldc snap is 1.4.0)

And more importantly (at least for me), the official D version manager, a.k.a the install script:

# Download the install script to '~/dlang/install.sh'
curl -fsS https://dlang.org/install.sh | bash -s update

# Download the latest stable ldc (1.5.0 at the moment),
# as well as the latest stable version of dub (1.6.0 at the moment)
~/dlang/install.sh install ldc

# Use it:
source ~/dlang/ldc-1.5.0/activate

# Stop using ldc-1.5.0:
deactivate

# Install the latest beta of LDC (1.6.0-beta1 at the moment):
~/dlang/install.sh install ldc-beta

# Use it:
source ~/dlang/ldc-1.6.0-beta1/activate

# Stop using ldc-1.6.0-beta1:
deactivate

# Uninstall a particular version:
~/dlang/install.sh uninstall ldc-1.5.0

# Install various versions of dmd:
~/dlang/install.sh install dmd-nightly
~/dlang/install.sh install dmd-beta
~/dlang/install.sh install dmd
~/dlang/install.sh install dmd-2.073.2

# List all installed D compilers:
~/dlang/install.sh list

Copy link
Contributor Author

@jmh530 jmh530 Nov 21, 2017

Choose a reason for hiding this comment

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

I hadn't realized that the D install script could be used that way. It might be a good idea if they document it on the dlang website.

EDIT: Submitted issue https://issues.dlang.org/show_bug.cgi?id=17998

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@ZombineDev I put all of that install.sh text in the latest commit for now.

Copy link
Contributor

Choose a reason for hiding this comment

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

Agreed, we need to put a dedicated page on dlang.org.

Copy link
Contributor

Choose a reason for hiding this comment

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

Copy link
Contributor

Choose a reason for hiding this comment

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

My personal favorite is curl i.dlang.io | bash -s (yep that's all you need to the latest, greatest DMD on your machine). For CI and other setups, usage of https:// is recommended though ;-)

README.md Outdated
[GitHub release page](https://github.com/ldc-developers/ldc/releases).

The [official D version manager (a.k.a. install script](https://dlang.org/install.sh) can also
Copy link
Contributor

Choose a reason for hiding this comment

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

close the parenthesis: script)

README.md Outdated
# Download the install script to '~/dlang/install.sh'
curl -fsS https://dlang.org/install.sh | bash -s update

# Download the latest stable ldc (1.5.0 at the moment),
Copy link
Contributor

Choose a reason for hiding this comment

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

Now 1.6.0.

Copy link
Member

Choose a reason for hiding this comment

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

No need to mention the version name here at all.

The examples on how to use ldc can be moved to where it says how to install a particular version.

README.md Outdated
# Stop using ldc-1.5.0:
deactivate

# Install the latest beta of LDC (1.6.0-beta1 at the moment):
Copy link
Member

Choose a reason for hiding this comment

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

also remove version here, otherwise the doc will go out-of-date very quickly.

README.md Outdated
# Uninstall a particular version:
~/dlang/install.sh uninstall ldc-1.5.0

# Install various versions of dmd:
Copy link
Member

Choose a reason for hiding this comment

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

why is there info about dmd?

@PetarKirov
Copy link
Contributor

FYI, we're preparing a new documentation page for the install.sh script: dlang/dlang.org#1936

@wilzbach
Copy link
Contributor

For those who weren't following the dlang.org PR. It's now online: https://dlang.org/install.html

@dnadlinger
Copy link
Member

Great, thanks, we'll just reference that page.

@jmh530
Copy link
Contributor Author

jmh530 commented Dec 25, 2017

@wilzbach That's great.

@kinke
Copy link
Member

kinke commented Jan 28, 2018

Updated.

@kinke
Copy link
Member

kinke commented Jan 31, 2018

Merging according to the good old 'clearly better than what we currently have' slogan. Nitpicks => direct edits pls.

@kinke kinke merged commit fe386b5 into ldc-developers:master Jan 31, 2018
@dnadlinger
Copy link
Member

Sorry, this definitely shouldn't have sat unmerged for more than two months. Some further tweaks for clarity/plain text readability: #2553

@joakim-noah
Copy link
Contributor

Johan had some comments that he never responded to, that's why it sat.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants