search

adamdruppe / arsd

This is a collection of modules that I've released over the years. Most of them stand alone, or have just one or two dependencies in here, so you don't have to download this whole repo.
http://arsd-official.dpldocs.info/arsd.html
530 stars 128 forks source link

cgi: Warning: Ddoc: Stray '(' #177

Closed andre2007 closed 5 years ago

andre2007 commented 5 years ago

There are 2 DDoc warnings raised for cgi.d:

Warning: Ddoc: Stray '('. This may cause incorrect Ddoc output. Use $(LPAREN) instead for unpaired left parentheses.

The line numbers does not really fit, maybe DMD gets somehow confused cgi.d(260,1): cgi.d(2235,20):

adamdruppe commented 5 years ago

On Tue, Dec 04, 2018 at 12:14:15AM -0800, andre2007 wrote:

Warning: Ddoc: Stray '('. This may cause incorrect Ddoc output. Use $(LPAREN) instead for unpaired left parentheses.

try it now on master

andre2007 commented 5 years ago

Thanks a lot.

That is very very strange. The 2 warnings caused the dub error: Cannot append empty path string. With your correction, dub is now able to generate the documentation. I will create a dub issue for this.

Please consider creating a new release:)

andre2007 commented 5 years ago

https://github.com/dlang/dub/issues/1607

adamdruppe commented 5 years ago

On Tue, Dec 04, 2018 at 10:07:28PM -0800, andre2007 wrote:

With your correction, dub is now able to generate the documentation. I will create a dub issue for this.

So keep in mind that my docs are NOT compatible with ddoc and there is no promise it will actually work at all, and will almost certainly not be super pretty.

Might be good enough, but for my docs you should use one of my websites, either arsd-official.dpldocs.info or the dpldocs.info/arsd.cgi site (the former link is updated less frequently, but less likely to break with my bleeding edge doc generation lol)