4 ms·
My own pet peeve about D is the lack of local documentation. If I install my system's compiler packages¹ I receive basically no documentation at all. That is
by JNRowe 7y ago
My own pet peeve about D is the lack of local documentation. If I install my system's compiler packages¹ I receive basically no documentation at all. That is a huge difference to the experience with nim/rustc/go/$others which all provide a nice fat $lang-doc package in their Suggests field, and all of those contain full standard library docs/tutorials/etc.
1. gdc or ldc on Debian. The experience /may/ be different with the dmd repositories, but being external they're of less interest to me.
- alphaglosined 7y agoIt is provided by dmd as part of the download. You can also get soft copies (i.e. mobi, pdf) and the docs as part of the d-apt repository for debian. Depending on the nature of distribution it is probably just in a different package (or the package maintainer needs yelling at). https://d-apt.sourceforge.io https://d-apt.sourceforge.io
- JNRowe 7y ago> It is provided by dmd as part of the download. Which leads me to wonder why we don't have dmd{,-doc} in Debian now, given it has been ~3 years since the compiler was open sourced. I can't even find an ITP in a quick search :/
- WalterBright 7y agoD command line tools have a `-man` switch which will open the browser on the manual for the tool, such as: dmd -man
- dguaraglia 7y agoI'd recommend using Dash (on Os X) or Zeal (Linux and Windows) if you want to have an easily browseable local version of the docs.
- WalterBright 7y agoD comes with an interesting utility called `dman`. Run it from the command line and as an argument give it a D topic and it'll open a browser on the topic. dman dman will, of course, open the browser on a page about dman.
- JNRowe 7y agoWhich, as I noted, is still a very different experience from go/nim/rust in Debian. It wasn't a pet peeve about no documentation, it is about how I can interact with it compared to to other languages.