Remove findtags in favor of using chmgen-emitted tags

[CyberShadow]

This makes Dman use the d.tag file generated by chmgen, which is highly (if not completely) comprehensive of the D spec, Phobos and Druntime.

As findtags is no longer needed, it is removed.

Requires dlang/dlang.org#873

CC @WalterBright

[CyberShadow]

I don't know what to write here.

[andralex]

FWIW a concatenation of $(SPEC_ROOT) with druntime and phobos documentables sounds like a good start.

[CyberShadow]

1. There is no SPEC_ROOT in tools/posix.mak or tools/win32.mak.
2. How am I supposed to get the "druntime and phobos documentables" without three pages of copy-pasta?

[mihails-strasuns]

btw, I am currently experimenting with providing a meta-repository that would host all existing ones as submodules. If it will work, we could move such scripts to that repo. Maybe even integrate Digger with it ;)

[CyberShadow]

Something like https://bitbucket.org/cybershadow/d ?

[MartinNowak]

I don't know what to write here.

I'd say $(wildcard $(DOCS)/*.html) $(wildcard $(DOCS)/Phobos/*.html) if we'd use gmake on Windows.
How about you pass the DOCS folder to chmgen and let it find all HTML files. Might add an explicit exclude argument if really necessary.

[CyberShadow]

How about you pass the DOCS folder to chmgen and let it find all HTML files.

It already finds HTML files by itself (though the directory is currently hardcoded). The difficulty is Make target dependencies (i.e. we want dman.exe to be rebuilt if lex.dd changed).

[MartinNowak]

That won't work without another hand maintained list of all files. Rather rebuild it every time.

[CyberShadow]

That won't work without another hand maintained list of all files.

Yeah.

Rather rebuild it every time.

Is this really the best solution? For such a relatively unimportant utility, I think it makes more sense to let it rebuild only after a make clean.

[MartinNowak]

That would work as well, d a comment. The release scripts are probably the only place this is used.

[MartinNowak]

Nice the findtags tool doesn't yet work with the new layout anyhow and blocks release building.

[MartinNowak]

Somethings wrong with the pathes for chmgen, seems like I need to build from dlang.org/web or I get.

object.Exception@../dlang.org/chmgen.d(138): Phobos documentation not present. Please place Phobos documentation HTML files into the "phobos" subdirectory.

[CyberShadow]

Hmm, that's the default location for the Phobos documentation on Windows. I guess it might make sense to make the makefile pass the location to chmgen instead.

[MartinNowak]

I guess it might make sense to make the makefile pass the location to chmgen instead.

It's dlang.org/web/phobos on posix.mak, so yes, passing as argument makes sense.

[CyberShadow]

#160

[CyberShadow]

BTW, I wonder if we can refactor the makefiles into parts that can be included from makefiles of other components. Then we can get a precise dependency graph.

[MartinNowak]

Hey, this was really great, now dman is 100x more useful.
Might be worth an announcement, e.g. in the changelog.

[MartinNowak]

We recently added a fuzzy string matcher to dub (yet unused and untested ◔_◔), which might be useful here as well.
https://github.com/D-Programming-Language/dub/blob/ad9b43d6a150b53872db73c161e745c000cf8577/source/dub/internal/utils.d#L246

I still want to write a real string matcher library à la Lucene, but didn't yet got to it.